48b109e5bcda16ae22aa87dad0213602.pdf绚华短信平台V2.0系统开发手册深圳市绚华软件有限公司2011-08一短信平台业务简述1 概述 短信平台业务模块3.6.4是在3.6.3基础上发展改进的新版本.目的是支持最新的infomaster3.6.4版和兼容以前的3个子版本，包括V2.5R120,V3.0R170,V3.5R627。版本环境操作系统: 运行于win2000或XP或更高版本的MS操作系统.不能在UNIX或LINUX或其他系统下运行.数据库 :基于MS SQL SERVER 2000的数据库环境数据库连接:支持ADO方式或基于ORACLE 9i 数据库环境 数据库连接: 支持ADO2 业务模式业务模块支持2种业务1. 上行消息处理2. 主动下行业务2.1.1 上行消息处理业务l 业务处理过程:n 通过被叫业务代码和消息内容命令字进行命令解析n 命令解析结果定位处理该上行消息的业务逻辑n 根据逻辑接口赋值实际参数,调用该逻辑n 根据业务逻辑返回值构造返回的下行消息包,发出下行消息l 支持的业务逻辑方式n 直接存储过程调用存储过程,根据存储过程返回的结果集,直接发出下行信息n 直接URL ：在V3.6.4版本中又分为通过命令解析直接URL 2.1.2 主动下行通过存储过程接口,定时调用,获得下行信息,主动发出支持业务的模式为:n 群发3 请求业务处理模式3.1 上行点播的消息处理步骤 业务平台模块通过TCP/IP连接到switch平台，接收到用户上行消息，通过命令解析存储过程返回的结果集中得到存储过程或者URL，并且调用该处理方式。 HTTP方式处理是构造对应的URL发出HTTP请求，处理的业务逻辑在后台的WEB服务中完成。 存储过程接口方式处理首先通过路由匹配算法根据目标号码和消息内容匹配查找，定位出处理此上行短信的存储过程，再调用存储过程接口，处理的业务逻辑在存储过程中完成。3.2 业务处理流程在HTTP的接口流程中，是通过路由匹配定位处理的URL。上行点播消息路由匹配存储过程存储过程.存储过程URLURL.URLHTTP请求HTTP请求HTTP请求HTTP请求存储过程接口存储过程接口存储过程接口存储过程接口switch平台1 HTTP接口2 存储过程接口业务平台对于两种接口，都是用路由匹配算法定位处理上行短信的业务逻辑，决定是哪个URL或者哪个存储过程来处理，在根据接口的不同，构造URL发出HTTP请求或者调用存储过程，完成对上行短信的处理。3.3 存储过程接口规则3.3.1 逻缉图 说明：当手机点播时，手机短信经过switch平台，由平台路由到请求业务模块。请求业务模块在初始化和执行期间加载命令解析表。上行消息根据其中的接入码，命令字与命令解析表中的内容进行匹配。找到用于处理该条消息的存储过程。执行该存储过程，从库中取得数据并返回给手机用户。3.3.2 MO的业务业务程序接收到从switch传过来的消息，通过调用命令解析的存储过程，找到相应的记录，记录中的FPROC表明本次点播所对应的存储过程。并把记录中FTOPID，FSRVCODE，FCODE ，FFEETYPE，FEXTPARAM的值及手机号码，接入码，内容。传入存储过程的输入参数： topid，srvcode， cmd，param1，param2 , srcaddr，srcaddrtype，dstaddr，msg，switchid，zoneid；如果消息中有LINKID也会传入，然后执行存储过程。如果想返回消息给手机，则只要在存储过程中将需要返回的消息各字段写入输出参数retmsgs的结构体中。所以，要做一下处理MO的业务，只要编写一个存储过程即可。 存储过程的输入参数的个数，含义是固定的，而存储过程名是可变的，由自已定义。 输出参数也是是固定的，结构中每个字段的含义也是固定的。3.3.3 存储过程接口 l ADO方式存储过程接口说明srcaddr varchar(50), -源号码 srcadd_type varchar(1), -源号码类型，0真号码，1伪号码 destaddr varchar(50), -目的号码 msg varchar(300), -消息内容 topid varchar(20), -栏目代码 srvcode varchar(20), -业务代码 cmd varchar(300), -命令码linkid varchar(60), -mo的linkidswitchid varchar(50), - switchID zoneid varchar(50), -地区编号SubmitMsgType varchar(3), -发送消息类型SPDealResult varchar(1), - Sp对消息的处理结果 param1 varchar(20) -备用参数param2 varchar(20) -备用参数ret int OUTPUT3.4 直接URL接口规则3.4.1 URL参数传递规则采用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 下行URL response包规则 反馈response包格式,可包含协议字段(包括短消息内容),但是必须按照规则格式填写. 协议字段填写格式是”名称=值”.例如”szMsg=您已经成功订购.” 反馈response包中可以包含多个消息体，每个消息体中均包含szDestAddr，szSrcAddr ，szMsg等各协议字段。消息体分隔符为”%split”.例如：Response=”DestAddr=13900000001$Msg=您已经成功订购%split DestAddr=13900000002$Msg=您已经成功订购%splitDestAddr=13900000003 $Msg=您已经成功订购” 可以同时给多个用户发送消息 反馈response包中每个消息体的格式为：各协议字段分割符为$，消息内容分割符为”%end”。 如果在一个消息体中包含众多协议字段的时候 ,则消息内容协议字段必须放在最后例如:Response=”DestAddr=13970890052$Msg=您已经成功订购.”合法,而:Response=”Msg=您已经成功订购. $DestAddr=13970890052 ”则不合法. 各消息体中可以不包含协字段 ,直接返回消息内容,消息内容可用”%end”分割,多条下发例如:Response=”Msg=您已经成功订购%end此条是免费赠送笑话” 以上各分割符均可以在配置文件中配置。 反馈response包中协议字段可选,可以包含一个或若干个协议字段u 所有协议字段所有协议字段序号协议字段名称说明规则1Msg命令字2DestAddr目标地址号码3SrcAddr源地址号码4PIDGSM协议类型一般填05SrcTon发送号码的TON国际号码（86开头）为1，国内为26SrcNpi发送号码的NPI填17DestTon接收号码的TON国际号码（86开头）为1，国内为28DestNpi接收号码的NPI填19DCS数据的编码方式数据的编码方式 0 ASCLL 4 二进制 8 UCS2 15 GB编码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消息1-MO点播引起的非第一条MT消息 2-非MO点播引起的MT消息3-系统反馈引起的MT消息( 比如发包月扣费消息时)22ServiceU内部业务码23FixedFee封顶资费24MsgType消息子类型25Fee_termial_id_Type扣费号码类型0 真实号码 1 伪码26DestAddr_Type目标地址号码类型27AreaCode区域码28InforMasterIDID号29SubmitMsgType Sp发送消息类型30SPDealResult Sp对消息的处理结果31MServiceID 业务代码（用于移动网业务）3.5 下行业务处理通过存储过程接口,定时调用,获得下行信息,主动发出。3.5.1 任务发布l ADO方式任务发布接口eachcount int,ret