绚华Pango短信平台V20业务开发手册--参考

绚华短信平台V2.0系统开发手册深圳市绚华软件有限公司2011-081571536092874深圳市绚华软件有限公司第2页2019-10-20一．短信平台业务简述1概述短信平台业务模块3.6.4是在3.6.3基础上发展改进的新版本.目的是支持最新的infomaster3.6.4版和兼容以前的3个子版本，包括V2.5R120,V3.0R170,V3.5R627。版本环境操作系统:运行于win2000或XP或更高版本的MS操作系统.不能在UNIX或LINUX或其他系统下运行.数据库:基于MSSQLSERVER2000的数据库环境数据库连接:支持ADO方式或基于ORACLE9i数据库环境数据库连接:支持ADO2业务模式业务模块支持2种业务1.上行消息处理2.主动下行业务2.1.1上行消息处理业务业务处理过程:通过被叫业务代码和消息内容命令字进行命令解析命令解析结果定位处理该上行消息的业务逻辑根据逻辑接口赋值实际参数,调用该逻辑根据业务逻辑返回值构造返回的下行消息包,发出下行消息支持的业务逻辑方式直接存储过程调用存储过程,根据存储过程返回的结果集,直接发出下行信息直接URL：在V3.6.4版本中又分为通过命令解析直接URL1571536092874深圳市绚华软件有限公司第3页2019-10-202.1.2主动下行通过存储过程接口,定时调用,获得下行信息,主动发出支持业务的模式为:群发3请求业务处理模式3.1上行点播的消息处理步骤业务平台模块通过TCP/IP连接到switch平台，接收到用户上行消息，通过命令解析存储过程返回的结果集中得到存储过程或者URL，并且调用该处理方式。HTTP方式处理是构造对应的URL发出HTTP请求，处理的业务逻辑在后台的WEB服务中完成。存储过程接口方式处理首先通过路由匹配算法根据目标号码和消息内容匹配查找，定位出处理此上行短信的存储过程，再调用存储过程接口，处理的业务逻辑在存储过程中完成。3.2业务处理流程在HTTP的接口流程中，是通过路由匹配定位处理的URL。对于两种接口，都是用路由匹配算法定位处理上行短信的业务逻辑，决定是哪个URL或者哪个存储过程来处理，在根据接口的不同，构造URL发出HTTP请求或者调用存储过程，完成对上行短信的处理。上行点播消息路由匹配存储过程存储过程…..存储过程URLURL…..URLHTTP请求HTTP请求HTTP请求HTTP请求存储过程接口存储过程接口存储过程接口存储过程接口switch平台1HTTP接口2存储过程接口业务平台1571536092874深圳市绚华软件有限公司第4页2019-10-203.3存储过程接口规则3.3.1逻缉图请求业务模块下发业务模块5取得结果数组34执行MO存储过程InfoMaster网关Mobile1Mobile22取得游标1定时执行MT存储过程数据库数据库67345主动MT流程Mo流程218说明：当手机点播时，手机短信经过switch平台，由平台路由到请求业务模块。请求业务模块在初始化和执行期间加载命令解析表。上行消息根据其中的接入码，命令字与命令解析表中的内容进行匹配。找到用于处理该条消息的存储过程。执行该存储过程，从库中取得数据并返回给手机用户。3.3.2MO的业务业务程序接收到从switch传过来的消息，通过调用命令解析的存储过程，找到相应的记录，记录中的FPROC表明本次点播所对应的存储过程。并把记录中FTOPID，FSRVCODE，FCODE，FFEETYPE，FEXTPARAM的值及手机号码，接入码，内容。传入存储过程的输入参数：topid，srvcode，cmd，param1，param2,srcaddr，srcaddrtype，dstaddr，msg，switchid，zoneid；如果消息中有LINKID也会传入，然后执行存储过程。如果想返回消息给手机，则只要在存储过程中将需要返回的消息各字段写入输出参数retmsgs的结构体中。所以，要做一下处理MO的业务，只要编写一个存储过程即可。存储过程的输入参数的个数，含义是固定的，而存储过程名是可变的，由自已定义。输出参数也是是固定的，结构中每个字段的含义也是固定的。3.3.3存储过程接口ADO方式存储过程接口说明@srcaddrvarchar(50),--源号码@srcadd_typevarchar(1),--源号码类型，0真号码，1伪号码@destaddrvarchar(50),--目的号码@msgvarchar(300),--消息内容@topidvarchar(20),--栏目代码@srvcodevarchar(20),--业务代码@cmdvarchar(300),--命令码@linkidvarchar(60),--mo的linkid@switchidvarchar(50),--switchID@zoneidvarchar(50),--地区编号@SubmitMsgTypevarchar(3),--发送消息类型1571536092874深圳市绚华软件有限公司第5页2019-10-20@SPDealResultvarchar(1),--Sp对消息的处理结果@param1varchar(20)--备用参数@param2varchar(20)--备用参数@retintOUTPUT3.4直接URL接口规则3.4.1URL参数传递规则采用URL处理时,默认的URL串为命令解析表中的URL前缀加上实际的参数.?SRCADDR=&SRCADDR_TYPE=&DESTADDR=&MSG=&TOPID=&SRVCODE=&CMD=&PARAM1=&PARAM2=&LinkID=（注：上行消息处理方式有3种，存储过程、直接url。在存储过程中输入接口扩展了2个参数switchid、zoneid。由于实际用途不大没有对直接url和url存储过程与处理2种方式的借口没有进行扩展，所以存储过程接口同其它接口有点不同，不过不影响其它功能。）这些参数在命令表中可以进行转换配置.这些参数的值1,2,3,4由上行的命令决定,其他字段由命令解析表决定.序号传出字段名称描述规则1SRCADDR主叫号码(源地址)2SRCADDR_TYPE主叫号码(源地址)类型3DESTADDR目标号码(目标地址)4MSG消息内容(命令字)5TOPID栏目编号6SRVCODE子业务号码7CMD命令字8LinkID上行linkid9PARAM1参数110PARAM2参数2设值规则为命令表里的FSMSURL字段决定.名称=实际参数名称;名称=实际参数名称;名称=实际参数名称中间用分号”;”隔开.如果在URL参数里面设定,则按照规则进行参数变换,填写实际的值,构造实际的URL发出去.3.4.2下行URLresponse包规则反馈response包格式,可包含协议字段(包括短消息内容),但是必须按照规则格式填写.协议字段填写格式是”名称=值”.例如”szMsg=您已经成功订购….”反馈response包中可以包含多个消息体，每个消息体中均包含szDestAddr，szSrcAddr，szMsg等各协议字段。消息体分隔符为”%split”.1571536092874深圳市绚华软件有限公司第6页2019-10-20例如：Response=”DestAddr=13900000001$Msg=您已经成功订购%splitDestAddr=13900000002$Msg=您已经成功订购%splitDestAddr=13900000003$Msg=您已经成功订购”可以同时给多个用户发送消息反馈response包中每个消息体的格式为：各协议字段分割符为’$’，消息内容分割符为”%end”。如果在一个消息体中包含众多协议字段的时候,则消息内容协议字段必须放在最后例如:Response=”DestAddr=13970890052$Msg=您已经成功订购….”合法,而:Response=”Msg=您已经成功订购….$DestAddr=13970890052”则不合法.各消息体中可以不包含协字段,直接返回消息内容,消息内容可用”%end”分割,多条下发例如:Response=”Msg=您已经成功订购…%end此条是免费赠送笑话”以上各分割符均可以在配置文件中配置。反馈response包中协议字段可选,可以包含一个或若干个协议字段所有协议字段所有协议字段序号协议字段名称说明规则1Msg命令字2DestAddr目标地址号码3SrcAddr源地址号码4PIDGSM协议类型一般填05SrcTon发送号码的TON国际号码（86开头）为1，国内为26SrcNpi发送号码的NPI填17DestTon接收号码的TON国际号码（86开头）为1，国内为28DestNpi接收号码的NPI填19DCS数据的编码方式数据的编码方式0ASCLL4二进制8UCS215GB编码10ServiceType下行业务代码11Pri优先级1为高，0为普通12Report是否需要状态报告1为要，0为不要,2为包月扣费消息13Fee_UserType计费用户类型字段0真实号码1伪码14Fee_termial_id被计费用户的号码15TP_Udhi数据里是否含头结构1为有，0为无16Msg_src信息内容来源(即sp代码)17FeeType资费类别18FeeCode资费代码19Reserve保留字段20GivenCode赠送话费(以分为单位)(联通适用)21Mt引起MT消息的原因0-MO点播引起的第一条MT消1571536092874深圳市绚华软件有限公司第7页2019-10-20息1-MO点播引起的非第一条MT消息2-非MO点播引起的MT消息3-系统反馈引起的MT消息(比如发包月扣费消息时)22ServiceU内部业务码23FixedFee封顶资费24MsgType消息子类型25Fee_termial_id_Type扣费号码类型0真实号码1伪码26DestAddr_Type目标地址号码类型27AreaCode区域码28InforMasterIDID号29SubmitMsgTypeSp发送消息类型30SPDealResultSp对消息的处理结果31MServiceID业务代码（用于移动网业务）3.5下行业务处理通过存储过程接口,定时调用,获得下行信息,主动发出。3.5.1任务发布ADO方式任务发布接口@eachcountint,@retintOUTPUT3.5.2任务控制接口在ADO方式环境下，V3.6.4版本不支持任务控制无。4业务程序及业务配置文件4.1.1.1业务平台界面程序启动后，界面如图所示：1571536092874深圳市绚华软件有限公司第8页2019-10-20业务程序界面短消息连接参数：参数参数说明数据库指示灯绿灯表示与指定的数据库连接正常，红灯表示不正常短信平台指示灯绿灯表示与InfoMaster连接正常，红灯表示不正常命令解析指示灯绿灯表示命令解析正常，红灯表示不正常清零把统计数置0接收MO数接收从Infomaster过来的短信个数发送MT数提交到Infomaster过来的短信个数MO成功数发送到Infomaster成功的个数MT成功数下行成功个数URL成功数URL方式提交数ACK失败数发送产生ACK失败的个数时钟消息内部数据普通MO消息数主动上行点播的个数普通MT消息数点播引起的下行的个数4.1.1.2命令解析表界面显示当前命令解析表中的内容1571536092874深圳市绚华软件有限公司第9页2019-10-204.1.1.3业务模块配置文件：smservic.ini[smconnect]count=1#连接平台（INFOMASTER）的个数[connection0]#连接平台（INFOMASTER）帐户信息ipaddr=10.108.20.120port=5047loginname=ser47password=systemtype=rcvsnd=2#初始化数据源[broadcastmng]#数据源名datasource