短信平台二次开发文档

《短信平台二次开发文档》由会员分享，可在线阅读，更多相关《短信平台二次开发文档（31页珍藏版）》请在装配图网上搜索。

1、公司短信服务器二次开发平台V4.1(支持长短信收发）使用说明书目录一、短信服务器二次开发平台简介4二、短信服务器二次开发平台原理5三、短信服务器二次开发平台特点8四、二次开发平台数据库表阐明:94.1短信禁发词汇表BkWoTl:104错误日记表ErrorLable:104.3设备管理表ModemTabl：104.4顾客短信条数日记表ayLogae：1145短信接受日记表RcvSmsTabe:114.待发短信表SeningSmsTable:24.7短信发送日记表SetSsTa:1348系统日记表SyemLTabe:134.9顾客管理表UTable:13410定期发送信息表TimeedmsTae:

2、1五、OEM短信服务器产品信息155.1开发目的15.2开发措施155.开发难度5六、实现应用系统的短信功能166. 基于命令行方式的短信功能实现661.1使用特点6.12开发措施166.1.开发难度166.2基于外部数据库的开发接口176.21使用特点176.22开发措施176.3开发难度96.基于系统数据库的开发接口206.3.1使用特点206.3.2开发措施2053.开发难度26.4基于ocket客户端的开发接口226.41使用特点226.4.2开发措施26.4.3开发难度226.5 基于网络客户端C控件的开发接口236.5.1使用特点3.52开发措施3.开发难度566 基于TP合同的开

3、发接口66.6.1使用特点66.6.2开发措施2.6.3开发难度27七、六种开发接口的分析比较28八、在MSQ SEVER中安装开发平台数据库298.1措施一:通过附加数据库方式实现982措施二：通过DTS方式实现30九、如何修改系统默认数据库31附录修订记录错误!未定义书签。一、短信服务器二次开发平台简介为了简化软件开发流程,减少各应用系统相似模块的反复开发工作,提高系统稳定性和可靠性,我们开发了本套“公司短信服务器二次开发平台”。功能1：基于本短信服务器二次开发平台，可以迅速地使您的应用系统实现短信功能，多种接口方式供二次开发时选择，系统具有良好的可扩展性。功能2:基于本短信服务器二次开发

4、平台，可使同一网络(局域网或广域网)内众多客户端，共享一种短信服务器进行短信收发,短信服务器具有对客户端的管理功能。企事业单位通过短信服务器方式实现短信功能,既实现了资源的共享和有效使用,便于公司对进出信息的管理、监控和记录，同步为后来短信功能的扩展提供了便利。短信服务器二次开发平台涉及了下列可使用二次开发措施：1、 修改短信服务器软件界面信息,M成自己的产品;2、 应用系统通过命令行方式来收发短信；3、 通过设立外部数据库，使应用系统实现短信收发功能;4、 通过应用系统操作短信服务器数据库的方式,实现短信收发功能；5、 通过ock客户端方式，实现应用系统的短信收发功能；6、 使用短信客户端C

5、X控件,实现应用系统的短信收发功能;7、 在网页上运用TP合同来发送短信。上述多种二次开发措施的具体应用场合和使用措施，在后续章节中将有具体描述。二、短信服务器二次开发平台原理下面是短信服务器原理图:下面是某市建设银行采用本短信二次开发平台时实行的系统方案图:在该方案中，考虑到银行是对信息安全性规定很高的行业，采用GSM MOEM作为短信收发设备,避免了常用的通过移动互联网网关与移动短信中心相连接的方式,从而避免了来自互联网的安全性威胁。短信收发记录采用通用数据库（如Orale、SQL Servr等）存储,为新建系统或应用系统新增功能提供了以便。例如,在该方案中,要对储户短信查询进行按条数计费

6、，计费系统可直接记录本数据库中的各储户的查询记录即可。短信服务器使用基本环节:1、 安装服务器软件、加密狗驱动程序。2、 点击“开始”菜单顶部的“短信服务器”运营软件,然后点击界面“设备管理” 进行设备配备，当“设备状态”是绿色的“启用”状态时,表白正常连接了设备,软件可正常工作。3、运用软件提供的种开发接口进行二次开发。若设备“工作状态”是“无法启动”，那么请按以上环节检查：1、 短信设备与电脑与否连接好2、 短信设备天线与否拧紧3、 短信设备插入手机卡0秒后,插卡旁边的工作批示灯应当是有规律的闪烁,如果是始终红灯，表白没有插卡或者卡没有插好、卡内无话费、卡有开机密码,需要换手机卡。三、短信

7、服务器二次开发平台特点1、 基于此平台可迅速开发网络短信的应用,哪怕在不波及编程的状况下也可以让你的既有系统迅速集成短信功能。2、 以便、灵活、简朴的六种开发接口供选择，任何一位软件开发人员都能选择到一种自己得心应手的开发接口进行开发。3、 采用数据库与应用系统接口,支持WINWS下的多种编程开发工具。支持常用的数据库,如Ocle、SQL Serer、css等。4、 本平台具有性能稳定的短信群发功能。5、 短信服务器可以外接20个SM模块，自动调节模块间的负载平衡,从而非常简朴地就可实现多模块并行发送扩展。6、 可以控制各个GSM模块的发送范畴(如移动或联通）,能分别设定各个客户端容许使用的G

8、S模块,以及各个客户端的使用优先级。7、 短信服务器涉及禁发词汇过滤功能,系统操作员可定义禁发词汇,一旦客户端提交了涉及禁发词汇的短信内容,服务器可以自动删除该短信。8、 可以分别设定各个GM模块的发送速度,以及实时查看各个GM模块目前实际发送速率。9、 可以自动检测短信服务器上各个M模块的设备运营状况。10、 可以通过手机短信远程查询服务器的运营状况。11、 可以设定系统发送工作时间段。12、 可按软件定义规则向各客户端转发GSM模块收到的短信（有明确转发和隐式转发两种方式。明确转发,规定短信格式为:客户端名称短信内容;隐式转发不规定短信格式，服务器自动按“谁近来往该手机号码上发过短信,则转

9、发给谁”的原则解决。系统优先使用明确转发方式，如果明确转发方式失败,自动使用隐式转发方式）。13、 短信服务器有短信发送和接受的日记记录，有收发权限管理。14、 系统能实时记录完整的系统操作员的操作日记以及出错日记。15、 系统维护和升级比较简朴。四、二次开发平台数据库表阐明：4.1短信禁发词汇表BlakWorbe：字段名类型阐明BlacWod文本短信禁发词汇42错误日记表rLogTabl：字段名类型阐明rodx自动编号错误编号,主键,自动生成ErrTime日期时间出错时间rrorTxt文本错误描述4设备管理表ModemTle:字段名类型阐明Mdende文本设备序号,如短信设备1、短信设备、短

10、信设备3Modeate文本标记设备状态:启用或禁用oNam文本连接串口(COM）号,例如:C1、OM2、COM3ModemTye文本设备类型:工业GSM Mod或西门子手机ComRt文本设备连接波特率,根据设备的不同也许为600、120、3840、5700、5200。注:SM em的波特率为9600NberAra文本发送对象的范畴，值可为：不限范畴,移动号码,联通号码SendRate文本发送速度SnducceeCoun数字本设备已合计发送成功的短信条数SendErorunt数字本设备已合计发送失败的短信条数MaxndCoun数字限制发送短信条数(只计算发送成功数，0为不限制)Rark文本备注信

11、息,可为任意文本.4顾客短信条数日记表ayLogale：字段名类型阐明PayIndex自动编号记录编号，主键,自动生成PayTime日期时间操作时间UserID文本顾客代码PayVau数字添加或删除短信条数5短信接受日记表RecvSmsTab：字段名类型阐明SsIndex自动编号接受短信编号,主键,自动生成SmsTime日期/时间接受时间SenNumr文本短信发送号码sContent文本短信内容RecvModS文本接受本条短信的设备序号NewFlg数字未解决标志(预留给应用系统使用）。默认值为1endme日期/时间短信发送的时间注：本表记录的增长由短信服务器二次开发平台来完毕；应用系统只需查询

12、有无新记录，(NewFlag字段值为1,表达是新记录）,有则读出解决。.6待发短信表SendingmTble：字段名类型阐明Ssndex自动编号发送短信编号，主键,自动生成msse文本发送短信的顾客(或类型）Poneuer文本短信接受号码Smsonten文本短信内容UserDefineNo数字顾客自定义编号（可用于短信的标记)tInTpe文本信息提交方式SendMem数字发送短信的设备，如:1、2、3表达使用某号短信设备来发送,如为0，则表达不作发送设备限制。默认值为SndLevl数字短信发送优先级，数值越低，优先级越高。范畴：-2，-1,0，1，;默认值为1ewFa数字未解决标志,默认值为1

13、R文本供顾客使用R2文本供顾客使用RM3文本供顾客使用注：本表记录的增长由应用系统来完毕，至少需要更新如下字段值：PoeNumber、Smsontent、NewFla。具体开发措施请参见：.2章节。4.7短信发送日记表SeSmTable：字段名类型阐明SmsIdx自动编号已发短信编号，主键,自动生成honeNuer文本短信接受号码msotent文本短信内容SmsTim日期时间发送时间Smsse文本提交短信的顾客（或类型）Stats数字发送成果，为成功，否则为失败Nlag数字未解决标志(预留给应用系统使用)，默认值为1erDfineNo数字顾客短信自定义编号(用于短信标记使用)SendSeInx

14、数字发送该短信的设备序号R1文本供顾客使用R文本供顾客使用R文本供顾客使用注： 本表记录的增长亦由短信服务器二次开发平台来完毕;应用系统只需查询有无新记录,有则读出解决4.系统日记表SytemLoTble:字段名类型阐明Inde自动编号系统日记编号,主键，自动生成oTime日期/时间记录时间LogText文本记录内容NewFag数字未解决标志,默认值为149顾客管理表serable：字段名类型阐明UerID文本顾客代码seDesc文本顾客描述UsrKey文本顾客口令UsSst文本顾客可以使用短信设备列表，如：短信设备短信设备4UerLel数字数值越低，优先级越高;0为最高档，1为优先级，2为一

15、般级SmsCount数字剩余可发送短信条数,默认值为041定期发送信息表TienSmsTble：字段名类型阐明mInde自动编号定期发短信编号，主键,自动生成PhoeNbe文本短信接受号码Smsen文本短信内容msr文本提交短信的顾客（或类型）UserDefineo数字顾客短信自定义编号(用于短信标记使用)SenLvel数字设立短信的优先级,数值越低，优先级越高，默认值为0endodm数字发送短信的设备，如：、2、3表达使用某号短信设备来发送,如为，则表达不作发送设备限制。默认值为dTim数字设立发送短信的时间表达措施:yyy-m-ddhh：mm:ss，即年(4位）-月(2位)-日（位） 时(

16、2位）：分（2位）:秒(2位)RM1文本供顾客使用M2文本供顾客使用RM3文本供顾客使用五、OEM短信服务器产品信息5.开发目的修改短信服务器界面和标记,使之与公司产品统一和配套。52开发措施服务器软件的界面图片文献为m1.bp、m2.mp,修改界面图片信息,即可完毕短信服务器界面的修改。5.开发难度简朴，不波及编程，只需要会使用图像解决工具（如Phtoshp等)即可。六、实现应用系统的短信功能.1 基于命令行方式的短信功能实现.1.使用特点迅速、简朴地实现短信收发功能,对开发语言的支持性好,indows平台上的多种开发语言都可以非常简朴地完毕。使用简朴,调试过程短。.12开发措施、发送短信程

17、序中执行命令行：endSms 发送手机号码 发送短信内容如：Wnxc（SndS 生日快乐！ , SW_HIE)2、接受短信在短信服务器界面的“系统设立/命令行方式设立接受日记文献”中,设立好接受日记文献,则短信服务器每接受到手机顾客发过来的短信，就会自动写入该接受日记文献中。 应用系统定期检测接受日记文献的内容即可接受短信。3、查询发送短信状况在短信服务器界面的“系统设立命令行方式设立发送日记文献”中，设立好发送日记文献,则通过命令行发送短信的发送成果(成功或失败，发送时间)将自动写入该文献中。应用系统定期检测发送日记文献的内容来判断短信发送状况。6.1.3开发难度简朴,要实现发送短信,一般只

18、需添加一行代码即可完毕。6.基于外部数据库的开发接口.2.1使用特点迅速地使既有的应用系统具有短信收发功能,不需要编程,不需要对原应用系统进行代码修改,只需要在短信服务器界面上作些配备即可，特别适合已存在系统的功能升级（特别是源代码已不存在的系统）。6.2.2开发措施建立应用系统数据库的BC连接，然后在短信服务器上指定应用系统的发送表和接受表(相对于短信服务器系统而言,称之为外部发送表和外部接受表）。发送短信原理与配备措施：短信服务器通过定期扫描外部发送表,来判断外部发送表中与否有新记录，如果有新记录，则将新记录读出来,并将该记录写入短信服务器自带的待发短信表中（凡被写入该表的记录均会被自动用

19、短信发送出去)，然后在外部发送表中删除本条记录、或修改本条记录的状态标志。短信服务器应用系统应用系统数据库应用系统数据表1应用系统数据表2（设定为发送表）应用系统数据表3应用系统数据表4应用系统数据表5短信服务器数据库顾客管理表设备管理表短信发送日记表短信接受日记表待发短信表定期检测与否有新记录有新记录，取入内部待发送表中，待发外部发送表的配备在短信服务器软件的“系统设立/配备外部发送表”中进行,配备界面如下图所示(图中数据仅为示例）:配备完毕后,向发送表中插入一条新记录，更新“手机号码字段”、“短信内容字段”值即可。接受短信原理与配备措施:短信服务器通过短信设备接受到手机顾客发过来的短信后,

20、一方面把接受到的短信写到自带的短信接受日记表中，同步也把该短信写入外部接受表中(假设已把应用系统的某张表指定为外部接受表)。应用系统即可通过定期(或事件触发）检查接受表中有无新记录,如有记录，则读进应用系统，然后应用系统再作分析解决。短信服务器应用系统应用系统数据库应用系统数据表1应用系统数据表2应用系统数据表3（设定为接受表）应用系统数据表4应用系统数据表5短信服务器数据库顾客管理表设备管理表短信发送日记表短信接受日记表待发短信表收到手机短信同步写入外部接受表的配备在短信服务器软件的“系统设立配备外部接受表”中进行,配备界面如下图所示(图中数据仅为示例)：6.2.3开发难度简朴,不波及编程，

21、不需要对原系统的代码进行修改。6.基于系统数据库的开发接口.3.1使用特点多种应用系统共享一种短信服务器来收发短信，但愿是一种简朴的网络应用,应用系统在收发选项上但愿比命令行方式更多某些，更灵活某些。需要相应用系统代码进行修改,需要编程。63.2开发措施注：系统数据库连接文献为短信服务器二次开发平台安装目录下的GWDBlink.ii文献，要修改系统数据库连接，直接修改GWBlikii文献即可。(若无，运营二次开发平台,将自动生成;然后可以修改。）系统安装时，默认安装的数据库为Accs类型数据库,数据库文献是位于短信服务器二次开发平台安装目录下的SmSerermdb文献。1、 短信发送：把您要发

22、送的短信写入Sdingmable表里(注意:请按字段描述的规定写入)，系统将自动读出该记录并发送;已发送记录保存在SeSmle表中。示例Q语句：PhoneNumber，SmConten,NwFla三个字段值必须添加,NFlag为表达新加入（未解决）:inr no edingSsable (PhneNumer,SmsContet,eFa) vue (,文字短信测试消息一,)采用1号短信设备发送,且该短信优先级为insert io ningSsale（Poeumbe,Smsonnt,SmMm，SmsLevel,NewFg）vales (，文字短信测试消息二,1，,1）2、查看短信发送状况：通过查看

23、SentSmsable下记录得Staus字段来获知该记录发送成功还是失败，当taus值为时,表达发送成功;否则为失败。3、短信接受：短信服务器通过短信设备接受到手机顾客发过来的短信后,均写入了数据库RecmsTable表中,应用系统可从中读取接受到的短信。4、设立短信设备信息和查看短信设备状态:设立MdmT表中的oame和oemSatu值可以向开发平台系统传递所连接短信设备的Cm标语和让该设备工作与否。设立MSendCount值可以向开发平台传递该设备的限制发送条数(以成功计算,为不限制）。读取Seuedou可以懂得该设备上合计发送成功了多少条信息；读取SnErrorCoun可以懂得该设备上合

24、计发送失败的信息条数。5、查看出错信息:读取EorTabl表中的记录,即可获取出错信息。5.3开发难度中档难度,只要会数据库读写操作，一般都可以顺利完毕开发。.基于Socket客户端的开发接口6.1使用特点以便于网络(局域网或广域网)上多顾客使用。网络上要发送短信的软件,只需要通过TP与服务器相连,并按照规定合同与服务器进行指令交互，即可完毕短信的收发操作。642开发措施连接端标语:CP合同，端标语9518，长连接。命令语法：指令名参数1#参数2#参数3#功能发起过程客户端服务器登陆客户端服务器顾客名密码#成功可发送条数#顾客名错误#登陆口令错误#发送短信客户端服务器发短信自定义编号#手机号#

25、短信内容#服务器即时返回:提交成功可发送条数#；发短信失败：无授权条数#；发短信未登陆#。服务器稍后返回:发送成功#自定义编号#发送失败#自定义编号接受短信服务器客户端(客户端在线时才转达接受的短信）手机号码#短信内容注:仅客户端在线时才转达接受的短信，转发规则见第三章。注:如果服务器暂停服务，则上述客户端的每条指令返回均为“服务暂停服务暂停#”。6.4.3开发难度中档，需要有网络程序开发经验。65 基于网络客户端OCX控件的开发接口6.5.1使用特点以便于网络（局域网或广域网）上多顾客使用。只需要插入客户端cx控件后，简朴地调用控件接口函数，就可以以便地发送和接受短信。简朴、易用。.52开发

26、措施应用系统中嵌入短信客户端CX控件,通过调用控件接口函数实现网络（涉及互联网）方式的短信发送和接受。控件文献名:Smsi.cx 控件接口名:SsClin。短信客户端CX控件接口函数:接口函数一:函数名Ln ConnectSmrver(Crg ServerP,CStrig UerName，SringPassWod)函数描述连接短信服务器。参数描述mServerP服务器P地址。UserName登陆顾客名。assr登陆口令。返回值1为成功登陆,其他为连接失败;-、连接失败；、顾客名错误；-3、密码错误。接口函数二：函数名lng etCnSdSAout (）函数描述获得该客户端的可发送短信条数。参数

27、描述无无。返回值可发送短信条数接口函数三：函数名og SenSms(CSrng honeNmb,CStrng SmsConte，lng SmIndex)函数描述发送短信。参数描述honeNme接罢手机号码。SContnt短新内容SmsIe自定义编号返回值1、提交成功；-1、服务器回绝祈求；-2、尚未连接服务器。接口函数四:函数名void DiconnectSmsrvr（)函数描述断开与服务器的连接。参数描述无无。返回值无短信客户端OCX控件接口事件事件一:事件名RecvS （LPCTT PhNumer, LCTSTR SmContent)事件描述收到短信。参数描述PhoneNuber发送者手机

28、号码SmsCntent短信内容事件二:事件名SendmsResut （ong Relt,ong Smsdex);事件描述短信发送报告。参数描述Rut发送成果，1为成功发送,其他为失败。SmIdex发送短信的自定义标记编号事件三:事件名Srverisonne()；事件描述服务器关闭了与本客户端的连接。参数描述无无。653开发难度简朴,需要进行程序开发。6.6 基于HTP合同的开发接口6.6.1使用特点在网页程序或Ja程序中直接调用UL语句来完毕发送短信的提交以及接受短信。简朴、易用。6.2开发措施1、发送短信调用格式：tp:/服务器地址:9618/Uer=,asord=，MsgD=，Pon=,M

29、s注：如Usr、Ms内容中有特殊字符,请先按TP合同措施做code编码(常用rver.urlencode（)函数进行转换）。MsID内容为数字，用于短信的标记（也可无值）。各项参数的排列顺序不可以颠倒。示例：:968/Uer=b,Pasword=111,MsgD=1，Pone，Msg=%B2%2%CA%D2%B%C%C2%D0%A7%BB+%COK%E返回值：0：成功 01：密码或口令错 0：无可发送条数 03：其他因素回绝2、 接受短信UR调用格式:在短信服务器软件上设立一条传递收到短信信息的URL语句，短信服务器作为调用方，应用系统作为Web erve方。当短信服务器接后到短信后,短信服务

30、器调用该U向应用系统传递接受到的短信。在该URL语句中需要具有发送号码、短信内容、接受时间、接受串标语等信息元素，元素内容用替代符来标记，替代符定义如下：发送号码的替代符为1，短信内容的替代符为2,接受时间的替代符为3,接受串标语的替代符为4。在URL语句中同一替代符只能浮现一次。某应用系统的接受L示例：1&s_t&date3&smport46.6.开发难度一般,需要进行程序开发。比较适于we网站上使用七、六种开发接口的分析比较开发方式与否波及编程调试难易度工作量开发难易度所需技能命令行要编程简朴小简朴无外部数据库可以不编程简朴小简朴理解数据库开发系统数据库要编程中档中档简朴理解数据库开发OK

31、ET客户端要编程中档中档中档理解网络编程客户端OX控件要编程简朴小简朴无HTP合同方式要编程简朴小简朴无注:开发工作量不不小于4小时为“小”，2工作日之内为“中档”。八、在MS SQL Srver中安装开发平台数据库1措施一：通过附加数据库方式实现环节如下：打开公司管理器，依次展开Q Sevr组，右键单击“数据库”，选择“所有任务”“附加数据库”。如图：然后点击浏览按钮,找到安装目录(默认安装目录为：:Prora FilesSsSDK）下的smsDta.DF。单击“拟定”完毕。如图:注意事项:由于重装软件会覆盖掉安装目录下的sms_ata.DF和smsDta.LDF文献,因此您可以将这2个文献

32、复制到其她目录再附加;或者在重装软件时，做好这2个文献的备份工作。8.2措施二：通过DTS方式实现环节如下：、创立数据库表信息。打开公司管理器,新建一种数据库,如Smsk,然后单击菜单栏的“工具”“数据转换服务”“导入数据”，在浮现的“DTS 导入/导出向导”窗口中,点击“下一步”,在“数据源”中，选择“Miosoft ccs”，在“文献名”右边,单击浏览按钮，浏览到安装目录，（默认安装为：C:ProgramilesSsS）,选择Ssrvr.mdb文献,打开。然后始终点击“下一步”,在“选择源表和视图”对话框中，选择“全选”，然后点击“下一步”，最后点击“完毕”。、对数据库的各个表进行有关设计

33、。将每个表的第一列设立为主键;对于主键,有标记内容的要将“否”改为“是”；将有关日期的字段的默认值设为:gette()。九、如何修改系统默认数据库本系统安装之后，默认使用的是Aes数据库,数据文献为软件安装目录下的SsServermb文献。如果要使用新的数据库，请修改软件安装目录下的B_ln.i文献内容。修改措施如下：访问OBC数据:Prvidr=ASQL；SN=snNam;UID=usrNa；PWD=uerssword;访问ORACLE数据库： rovideSDOA;Data Suce=serverNa;UsrID=erNme； Pssword=uerPsword；访问MSSQ数据库： Provder=SOLEDB;Dataorce=srveName;Initil Cag=databaeae; UserD=usrName；ssword=serPswor；访问ACCESS 数据库： Provder=Microsf.et.ODB.4.0;DtaordatbaseNae；User I=userName;Pssword=srPassword; 访问Y SQL数据库【联系方式】:深圳百利通科技有限公司 全国服务热线：【400057-890】服务热线： 875526 在线客服QQ： 公司地址:深圳市福田区华强北燕南路96号格林网苑大厦