企信数据通使用手册doc.doc

《企信数据通使用手册doc.doc》由会员分享，可在线阅读，更多相关《企信数据通使用手册doc.doc（9页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、文件版本：V1.001 发布时间：2008.12.01深圳市麦深圳市麦讯讯通科技有限公司企信数据通科技有限公司企信数据通使用手册通使用手册 （ （V1.0） ）深圳市麦深圳市麦讯讯通科技有限公司通科技有限公司2008-12深圳市麦讯通-企信数据通使用手册Copyright 2004-2008，中国联通浙江分公司研发中心 注意事项： 1、 本手册介绍企信数据通应用短信平台的二次开发接口的安装调试方法。如果需要对帐号进行日 常管理（如子帐号管理、费用查询、客户端下载发送短信等） ，请登录到网站下载企信直通车 软件 http:/ 进行操作。这方面的操作指南请参考网页界面的使用手册。1简介简介1.1

2、系统的结构和特点系统的结构和特点企信数据通应用短信平台具备二次开发接口（后面简称接口或接口软件） ，接口软件在整个方 案中的位置如下图中蓝色部分所示，在安装了接口软件以后，企业内部所有的短信应用系统只要 对接口数据库进行数据存储，就能完成收发短信的工作，并且可以查询到所发送短信当前的状态， 避免了企业内部软件开发人员在 HTTP、SMPP 等短信通讯协议上浪费大量的人力和物力。 和使用 API 接口在 HTTP 或 SMPP 协议层次上开发短信应用程序相比，企业直接使用本系统 提供的数据库接口开发短信应用程序，可以至少节省一个开发小组几个月的工作量，在时间就是 金钱的现代社会，本系统为企业带来

3、的时间效益是惊人的。图例：绿色箭头采用 SGIP 或 SMPP 协议传输短信的链路 红色箭头采用加密数据包传输短信的链路本系统采用了各种方法保证企业短信收发的安全性和稳定性：断线重连：软件具备断线自动重连的功能，当因为网络异常等各种原因造成链路中断时，软 件能够自动重复尝试连接，以保证短信收发的及时性和可靠性。 免维护：接口服务软件采用系统服务的方式在后台运行，无须用户干预，即使遇到服务器断企业内部网络麦讯通企业短信平台内部网络短信中心短信网关互联网专线短信接口软件麦讯通企业行业应用短信平台服务器短信接口数据库应用系统 1应用系统 2应用系统 n用户手机深圳市麦讯通-企信数据通使用手册Copy

4、right 2004-2008，中国联通浙江分公司研发中心电等异常情况，只要按动电源按钮重新将计算机开机，重新登录软件即可。接口软件和企业内部的短信应用系统之间采用容易编程的数据库接口，使开发人员能够以最 简便的方式实现最强大的功能：发送简单方便：软件自动对接口数据库进行扫描，企业内部的短信应用系统只要将短信发送 号码和内容保存到接口数据库里面，就可以将短信发送到用户的手机上。 信息双向交流：当用户向企业发送短信时，软件自动从服务器端接收短信并保存到接口数据 库中，其他应用程序只要查询接口数据库，就可以获取该短信。 号码扩展：企业可以对短信号码进行多达 4 位的扩展，便于多个内部应用系统同时通

5、过该接 口收发短信，真正实现一点接入，多点使用。 支持广泛：现在最新版本的短信接口服务软件已经支持最常用的 Oracle、SQLServer 和 Sybase 数据库。1.2 运行环境运行环境接口软件的运行环境为：硬件要求：CPU PIII 700 以上，内存 128M 软件要求：Windows 2000/XP，如果接口数据库使用 Oracle，则需安装 Oracle 客户端软件。和软件配套使用的接口数据库可以使用 Oracle、SQL Server 或 Sybase 三种类型，接口数据库 和接口服务软件既可以安装在不同的计算机上，也可以安装在同一台计算机上，如果两者安装在 同一台服务器上，那

6、么服务器的硬件配置应该相应提高。建议采用下列配置的专用服务器： 双 P4 1600 CPU，1G 内存，36.4G x 2 热插拔硬盘（Raid1）深圳市麦讯通-企信数据通使用手册Copyright 2004-2008，中国联通浙江分公司研发中心2数据库的安装和配置数据库的安装和配置在安装接口服务软件之前，需要首先安装数据库并初始化接口表，下面的内容将分 SQLServer 数据库为代表类型说明如何创建接口表。2.1 使用使用 SQLServer 数据库数据库在使用 SQLServer 数据库的情况下，最好为短信接口表单独创建一个数据库，并为其单独分 配一个用户，以便和其他短信应用系统使用的数

7、据表隔离。2.2.1 数据字典数据字典下面是短信接口表的初始化脚本，各字段的取值和含义已经包含在字段的注释中：- - 短信发送表!- if exists (select * from dbo.sysobjects where id = object_id(Ndbo.sms_send) and OBJECTPROPERTY(id, NIsUserTable) = 1)drop table dbo.sms_sendGOCREATE TABLE dbo.sms_send (id int IDENTITY (1, 1) NOT NULL , - 唯一 id（自动递增）mobile ntext COLL

8、ATE Chinese_PRC_CI_AS NULL , -要发送的手机号码content nvarchar (255) COLLATE Chinese_PRC_CI_AS NULL , - 要发送的短信内容send_time smalldatetime NULL , - 短信定时发送时间，格式为 yyyy-mm-dd hh:mm:ss- 如果不填写，表示马上发送priority int NULL , -发送短信的优先级sms_type int NULL , -手机号码类型 1 :移动、联通 2 小灵通submit_time smalldatetime NULL , -短信提交时间sms_ex

9、tend int NULL , - - 扩展短号result int NULL , - - 供用户程序使用，表示记录是否被处理，缺省为0- 0 等待提交，表示短信尚未提交到短信群发平台的服务器- 1 已提交，表示短信已经提交到发送处理列表- 2 已发送，表示短信已经发送到网关，等待用户接收- ! 注意 ! ：- 接口服务程序扫描 result=0的记录并发送，然后根据结果更新 result 字段- 如果在 sms_send 表上面建触发器，请严格测试，保证 result 从 0 更新到其他深圳市麦讯通-企信数据通使用手册Copyright 2004-2008，中国联通浙江分公司研发中心- 状态

10、的语句不会执行失败，否则该条记录会被接口服务程序重复扫描到并- 一直重复发送 !job_id nvarchar (50) COLLATE Chinese_PRC_CI_AS NULL ) ON PRIMARY TEXTIMAGE_ON PRIMARYGOALTER TABLE dbo.sms_send ADD CONSTRAINT PK_sms_send PRIMARY KEY CLUSTERED (id) ON PRIMARY GO- - 短信接收表- if exists (select * from dbo.sysobjects where id = object_id(Ndbo.sms_

11、recive) and OBJECTPROPERTY(id, NIsUserTable) = 1)drop table dbo.sms_reciveGOCREATE TABLE dbo.sms_recive (id int IDENTITY (1, 1) NOT NULL , - 唯一 idmobile nvarchar (50) COLLATE Chinese_PRC_CI_AS NULL , - - 发送方的手机号码sms_extend int NULL , - - 扩展短号recv_time smalldatetime NULL , - - 短信接收时间content nvarchar

12、(255) COLLATE Chinese_PRC_CI_AS NULL - - 接收的短信内容) ON PRIMARYGOALTER TABLE dbo.sms_recive ADD CONSTRAINT PK_sms_recive PRIMARY KEY CLUSTERED (id) ON PRIMARY GO2.2.2 示范示范 SQL 语句语句下面是短信应用程序收发短信以及查询短信状态的 SQL 语句示范： 发送短信：深圳市麦讯通-企信数据通使用手册Copyright 2004-2008，中国联通浙江分公司研发中心下面的第 1 条 SQL 语句向 13305710000 与 13900

13、022000 发送短信“您好！” ；第 2 条 SQL 语 句向 13305710000 发送短信“Hello!” ；第 3 条 SQL 语句向 0755820118888 小灵通号码发送短信 “您好” ，发送时间定在 2004 年 2 月 2 日 18 点 0 分。insert into sms_send(mobile,content,sms_type) values (138305710000;13900022000;,您好！,1)insert into sms_send(sms_extend , mobile, content,sms_type) values (12345, 13305

14、710000;, 您好！,1)insert into sms_send (sms_extend , mobile, content, send_time,sms_type) values (6789, 075520118888;, 您好！, 2004-02-02 18:00:00,2)注意：定时发送以接口数据库服务器的时间作为基准，请务必将数据库服务器的系统时间调整为 正确的时间！3安装系统服务程序安装系统服务程序系统服务程序由两个文件组成：企信数据通.exe 短信接口服务程序。config.ini 短信接口服务程序使用的配置文件。文件不需要安装，只要在系统中创建一个单独的目录并把这两个文件拷

15、贝到该目录中即可。3.1 配置文件配置文件config.ini 是一个文本格式的配置文件，可以用记事本打开编辑，其格式如下：serverDBtype=SqlServer /数据库类型AutoRun=0 /是否启动自动运行RememberPWD=0 /记住密码Account=999099 /短信平台登录帐号Password= /短信平台登录密码SqlServerProvider=SQLOLEDB.1;Persist Security Info=FalseDataSource=127.0.0.1 /数据库的 IPinitialCatalog=sms_db /数据库名称UserID=sa /数据库登

16、录名Password=ffffff3 /数据库登录密码深圳市麦讯通-企信数据通使用手册Copyright 2004-2008，中国联通浙江分公司研发中心3.1 试运行服务试运行服务在安装并初始化数据库表，并且根据数据库参数和连接参数配置好 config.ini 文件后，就可以 开始应用服务程序了，企信数据通.exe 输入用户名与密码，点击登录深圳市麦讯通-企信数据通使用手册Copyright 2004-2008，中国联通浙江分公司研发中心如果成功切换到登录成功页面就表示安装成功4.1 修改登录密码修改登录密码需要在深圳麦讯通网站 下载企信直通车进行密码修改。也可以联系本公司 客服人员帮助修改

17、密码。注：企信直通车与企信数据通不能同时登录。4常见问题解答（常见问题解答（FAQ）4.1 使用二次开发接口需要怎样的网络环境？使用二次开发接口需要怎样的网络环境？ 安装接口程序的计算机需要有直接访问互联网的网络，不能使用代理服务器上网，但是可以 在防火墙内部通过 NAT 方式访问互联网。由于接口的工作方式是接口程序主动发起连接到服务器， 服务器不需要主动连接到接口程序，所以使用 NAT 方式的话，不必在防火墙的公网 IP 上打开任何 映射端口。4.2 调试的时候，连接数据库失败怎么办？调试的时候，连接数据库失败怎么办？ 1、 确认安装了接口程序的计算机上数据库客户端程序已经正常安装，并已经通

18、过其他工具成功连 接过数据库（如使用 Oracle 数据库时，先安装 Oracle 数据库客户端，并通过 Sqlplus 工具先行 成功连接数据库） ，确认数据库用户名和密码正确。 2、 接口程序使用 ODBC 驱动访问数据库，所以需要在安装接口程序的计算机的“控制面板” “数据源 ODBC”中检查数据库的 ODBC 驱动程序有没有安装（使用 Oracle 数据库则检查深圳市麦讯通-企信数据通使用手册Copyright 2004-2008，中国联通浙江分公司研发中心Oracle 的 ODBC 驱动，使用 SQLServer 数据库则检查 SQLServer 的 ODBC 驱动） 。4.3 调试的时候，登录时显示调试的时候，登录时显示“帐号已经在其他地方登录帐号已经在其他地方登录” ，怎么办？，怎么办？ 企信直通车与企信数据通不能同时登录。请先退出软件后再登录别一个软件