金龙卡一卡通短信平台说明书

金龙卡一卡通短信平台说明书
哈尔滨新中新电子股份有限公司
2011-12-28
第1章系统概述
1.1 概述
金龙卡一卡通短信平台系统是金龙卡一卡通SP与短信通道（虚拟通信运营商）的集成，短信通道脱离一卡通SP完全可以独立运行，系统运行过程中可控制是否启用一卡通SP。

其他SP通过短信平台提供的第三方接口接入短信平台，实现相关短信业务。

系统支持三大运营商的短消息网关接口协议(SGIP、CMPP、SMGP)。

1.2 产品特点
l支持SGIP V1.2协议、CMPP V3.0协议、SMGP V3.1，具有广泛的适用性（在以后的版本中逐渐扩充所支持的短信接口协议）,短信平台
可设置多种接口协议共同工作,由协议所有段号自动决定短信业务
所用协议。

l支持接口协议扩充：电信ISAG、移动MAS、GSM Modem。

l提供可控的WEB功能，实现金龙卡一卡通SP的下行业务（即时、定时、定期短信群发）；最终用户的查询与业务定购。

l短信平台向其它SP提供接口，可使各第三方SP很快的实现短信功能，
且当短信平台使用的短信协议发生变化时，各第三方接入SP无需改动。

l提供出运营结算所需的汇总报表。

l金龙卡一卡通SP上下行业务的短信内容由短信平台灵活设置。

l开发环境使用Visual Studio 2008 C#，基于.NET Framework3.5，软件系统具有良好的可移植性。

l数据库使用SQL SERVER 2008 ,更加适应当前数据库管理系统的市场环境。

l提供数据库自动/手动备份、重要数据FTP备份，增强数据安全性。

1.3 名词术语
l SGIP：Short Message Gateway Interface Protocol中国联合通信公司短消息网关系统接口协议。

l CMPP：China Mobile Peer to Peer 中国移动通信互联网短信网关接口协议。

l SMGP：Short Message Gateway Protocol电信短消息网关协议。

l SP: Service Provider服务提供商。

l上行短信：由手机用户提交的短消息。

l下行短信：由手机用户接收的短消息。

l业务标识：上行业务短信内容的开始部分，用于系统区分上行短信所属SP。

第2章系统安装
2.1 系统环境
硬件要求：高主频CPU 2.0G以上；硬盘80G以上；内存2G以上；双网卡。

软件要求：Windows XP/2003（不建议使用Win7）；SQL Server 2008 (不建议使用 SQL Server 2000)。

2.2 短信平台安装
1、安装目录\Framework 3.5.0\dotnetfx.exe安装.NET 平台。

2、安装数据库管理系统SQL Server 2008, 数据库安装过程参见相关文档。

注意系统开发与测试均在SQL Server 2008下完成，SQL Server 2000
未经测试。

短信平台系统数据库操作频繁，断网影响较大, 要求短信平
台系统与数据库在同一台PC上运行。

3、安装目录\建库工具\CreateDB.exe建短信平台数据库。

4、安装目录\加密锁驱动\Sentinel System Driver Installer 7.5.1.exe
安装加密锁驱动。

5、如连接金龙卡一卡通平台，到综合管理系统中为短信平台建立节点，并
发布证书，在短信平台导入证书。

6、运行金龙卡一卡短信平台.exe，默认系统管理员登录密码
00000000。

系统运行需要进行较多的配置请参见下述。

2.3 WEB 服务安装
1、安装目录\WEB\jdk-.exe安装JDK。

2、设置系统环境变量
JAVA_HOME：“c:\jdk1.6.0_10”（JDK安装目录）
CLASSPATH:“.;%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar;”
path中最前增加：“%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;”。

3、重新打开命令行窗口, 执行以下命令
用“set”命令查看环境变量设置是否成功。

用“java –version”查看下 JDK 版本信息。

4、安装目录\WEB\ javaclass 文件夹拷贝到系统盘根目录下。

打开命令
窗口，到目录javaclass下，执行“javac HelloWorld.java”，“ java HelloWorld”。

结果如下图，输出“Hello JDK”，说明JDK 安装成功，
且环境变量设置正确。

5、安装目录\WEB\jakarta-tomcat-5.0.24.exe 安装TOMCAT 服务。

注意路径不要有空格。

指JDK安装目录，如下图：
不要修改端口，设置密码，如下图：
6、设置系统环境变量:
TOMCAT_HOME：“C:\Tomcat-5.0”（Tomcat安装目录）
在path中最前增加：” %TOMCAT_HOME%\bin;”
7、启动Tomcat服务，开始－程序－Apache Tomcat 5.0－Configure Tomcat
8、IE 测试TOMCAT 服务http://localhost:8080/
如上图，Tomcat服务安装成功。

9、修改服务端口
Tomcat 安装目录\conf\Server.xml 如下图,将8080修改成8081(或其它可用端口)。

10、将安装目录\WEB\note.war 拷贝到Tomcat安装目录\webapps 目录
下。

重新启动Tomcat 服务。

使用http://localhost:8081/note/地址
访问网站。

第３章短信平台界面功能说明
3.1 系统配置菜单
3.1.1 用户配置
用户配置界面如上图所示。

提供［增加］、［修改］、［删除］功能。

增加、修改界面如下图：
短信平台中系统管理员只有一个，其他只能是普通操作员，系统管理员具有全部权限，普通操作员不具有系统配置权限。

系统管理员可以给普通操作员进行授权，使其能在短信平台界面发送短信。

如上图，勾选相应的发送方式即可。

短信平台系统运行过程中，必需使用普通操作员登录，短信平台的配置直接影响短信平台的运行。

3.1.2 协议配置
协议配置界面如上图所示，提供［修改］、［配置］、［号段］三项功能。

［修改］对协议是否启用进行配置，短信平台对接的网关协议需在此启用。

［配置］对协议运行参数进行配置，各协议配置界面各不相同。

此处配置与修改系统管理员请与厂家联系，配置错误直接影响系统的运行。

［号段］号段即手机号码的前三位数字，此处对协议所支持的号段进行配置，系统运行时根据号段使用协议进行短信发送。

3.1.3 默认配置
[默认配置］对短信平台系统运行使用的参数进行配置。

此处参数需谨慎配置，对系统运行影响较大。

下面是各参数的含义：
任务时效(T)：任务默认有效小时数。

任务包括即时、定时、定期发送的的短信。

当任务未设置有效时间的情况下，使用此值。

即时任务在入库T小时后
失效；定时、定期任务在所设置的发送时间T小时后失效。

报告时效(T)：此参数是对协议工作设置的，协议发送短信时，网关会在一定时间内返回一个结果报告报文，用以通知短信的最终发送结果。

报告时效指的是报告报文必需在发送短信后T小时内收到报告报文，超过T小时系统抛弃报告报文。

这样处理以保证结算结果与报文相一致。

1-24小时。

服务端口：对第三方服务所监听的端口号进行设置，注意无特别情况，不要修改。

注意修改此端口号后，第三方接入的节点需重发证书。

定时时限(T)：对第三方接入发送定时任务的定时时间长度进行控制。

即第三方发送定时任务，定时时间应在当前时间后的T小时以内。

设置成0将不限制。

建议使用默认48小时。

定时任务设置时间长、数量大会影响系统服务。

结算时间(TM)：短信平台系统结算时间设置，系统会在TM到TM+30分钟时间范围内结算，此时间段以外不进行结算。

系统结算会锁表，必需把结算时间设置在系统不忙时间段。

开户默认：对金龙卡一卡通开户时，短信平台是否发送提醒短信进行设置。

“定购短信”会发送提醒；“取消定购”不发送。

导出路径：短信平台系统的大部分数据查询后都可导出EXCEL。

设置一个默认导出路径，操作上比较方便。

中心序号：平台同步金龙卡一卡通平台流水的最大流水号。

流水时效(T)：金龙卡一卡通平台流水发生时间后的T小时内，短信平台发送提醒短信；超过T小时将不发送提醒。

0不设时限，全部提醒。

3.1.4 自动备份
数据库自动备份参数设置界如上图所示，可设置是否启用自动备份。

在所设置的备份时间后30分钟内进行处理，如处理失败将在30分钟内尝试重新备份。

自动备份分完整备份与差异备份，完整备份产生整个数据库的备份文件，差异备份以前一次完整备份此为基准产生变更数据的备份文件。

当数据库损坏时可使用最后一次完整备份文件与其后的差异备份文件在数据库管理系统中进行恢复。

3.1.5 FTP备份
FTP备份界面如上图所示，可设置是否启用FTP备份。

备份操作是在所设置的时间后30分钟内执行，并每日执行一次。

FTP服务器的搭建请查阅相关资料。

FTP备份将数据库中重要表数据以Excel文件的方式上传到FTP服务器上。

重要数据包括短信平台运行的参数与日结记录等。

此备份文件有助于系统故障时恢复系统、取得日结记录，但无法完整恢复系统。

3.1.6 敏感字段
敏感字是对短信内容加以过滤，当所发送的短信内容中包含有所设置的敏感
字，短信将不能发送。

界面如上图所示，提供［增加］、［修改］、［删除］功能。

3.2 金龙卡菜单
3.2.1 帐户
短信平台帐户包括两类：金龙卡一卡通平台帐户、短信平台开户帐户。

帐户管理界面如上图所示，提供［查询］、［开户］、［变更］、［撤户］、［导入］、［导出］、［定购记录］、［批量定购］、[批量汇报]。

其中批量定购与批量汇报的操作对象是当前所有选择帐户。

选择帐户可使用[全选]、Ctrl、Shift。

［开户］与[变更]界面如上图所示。

金龙卡一卡通平台帐户在短信平台不可以变更帐户信息。

帐户级别分普通与高级，高级用户可以在WEB上发送短信。

必需对高级用户设置其管理部门，管理部门是高级用户发送短信时，发送目标的范围。

管理部门需设置在1-4级部门。

可以对高级用户设置发送授权，以控制高级用户在WEB上的发送权限。

如开始汇报业务，需为帐户设置新帐户的汇报组。

［导入］界面如上图所示。

选择导入帐户归入的部门与身份，从Excel读取帐户信息,帐户导入文件格式如下图所示，参见安装目录下“帐户导入格式.xls”。

［定购记录］如上图所示。

显示选择帐户的定购记录。

定购记录是提醒短信发送的依据，帐户对某一项提醒业务有定购记录，且定购状态为“定购”，流水中交易金额超过限值，才会发送提醒短信。

[批量定购]界面如上图所示。

是对定购记录的批量增加。

操作的是当前查询结果的所有帐户记录。

[批量汇报]界面如上图所示，其目的是批量设置当前选择帐户的汇报组。

3.2.2 部门
部门管理界面如上。

当金龙卡一卡通SP状态为正常，即短信平台接入金龙卡一卡通平台时，部门以金龙卡一卡通平台部门为准，部门管理中［增加子部门］、［修改］、［删除］不可用。

在接入一卡通平台以前配置的部门将会被删除。

3.2.3 身份
身份管理界面如上。

当金龙卡一卡通SP状态为正常，即短信平台接入金龙卡一卡通平台时，身份以金龙卡一卡通平台部门为准，身份管理中［增加］、［修改］、［删除］不可用。

在接入一卡通平台以前配置的身份将会被删除。

3.2.4 流水查询
短信平台同步金龙卡一卡通平台流水，同步流水有以下作用：维护短信平台帐户（由一卡通平台同步部分）与一卡通平台帐户一致；触发提醒短信；上行业务查询明细使用。

每条流水发生时，短信平台都会判断是否需要提醒，定购记录就是提醒是否触发的一项依据。

一条流水会触发相应类型的提醒业务，同时会触余额预警业务。

所以在流水查询时会有提醒错误码与预警错误码。

［报文］可以查询到当前选择流水对应的协议发送报文。

3.2.5 定购记录
定购记录是提醒短信发送的依据。

此处统一对定购记录进行修改，修改的是查询到的记录集。

［统一定购］是对查询记录集定购状态的的统一修改。

［统一限值］是对查询记录集限值的统一修改。

3.2.6 节点名称
节点名称是金龙卡一卡通平台的节点号与名称。

此表数据与综合管理系统中节点配置一致即可。

配置节点名称的目的是在发送提醒短信或应答上行查询时，用流水发生节点号查询流水发生节点的名称，以合成短信内容。

3.2.7 数据同步
数据同步提供对金龙卡一卡通部门、身份的手动同步功能。

3.2.8 同步帐户
同步帐户完成金龙卡一卡通平台与短信平台的一次全同步，而且只有在短信平台帐户中没有一卡通平台帐户存在时可用。

当进行完一次同步帐户后，菜单项不可见。

3.2.9 汇报分组
[汇报分组]界面如上图所示，完成汇报业务所需的汇报目标组，可为各部门建立各自的汇报组，各部门员工向所设置的汇报组帐户短信汇报工作。

3.3 业务管理菜单
3.3.1 企业开通
企业开通界面如上图所示。

提供［增加］、［修改］、［删除］、［上行业务］、［下行业务］、［发布证书］。

第三方接入SP 在此开通，并确定其上下行业务。

需要注意的是对金龙卡一卡通SP有正常、禁用、Web服务三种状态，正常状态下服务启动会连接金龙卡一卡通平台、实时同步流水并触发提醒短信、上行查询可用、Web发送短信可用；当禁用时不连接金龙卡一卡通平台、不同步流水、上行查询不可用、Web发送不可用；当Web服务状态时，启动服务后Web发送可用、不连接金龙卡一卡通平台、不同步流水、上行查询不可用。

[上行业务]界面如图所示。

上行业务是指由手机用户发送短信，系统根据业务标识确定其业务类型，进行相应的处理后发送下行短信给手机用户相关信息。

需要注意的是，每个企业开通后，系统自动为其增加一个上行业务与一下行业务。

上行业务是禁用的，下行业务是正常的。

第三方接入SP如果想查询获得上行短信必需开通其上行业务。

如果想发送下行短信，下行业务必需存在并正常状态。

系统管理员在此管理第三方接入的上下行业务是否可用。

业务标识，在上行业务记录中是唯一字段。

是上行短信的开始部分，用以区分上行短信的所属企业与业务。

内部编号,系统内部使用，根据相应的内部编号进行相应的处理。

短信平台对应的上行业务中包括一条短信平台上行通用业务，当收到上行短信不能根据业务标识确定其所属企业时，归入此业务。

金龙卡一卡通SP 的上行业务系统安装时自动加入，可修改其业务标识与状态。

要想使用某项上行业务，必需修改其状态为正常。

金龙卡一卡通SP上行业务如下表所示。

下行内部编号是指上行短信的应答短信的下行业务内部编号。

上行内部编号下行内部编号描述
1 101 手机号码注册
2 102 挂失
3 103 修改密码
4 104 帐户余额查询
5 105 卡片交易明细与累计按日查询
6 106 存款明细与累计按日查询
7 107 取款明细与累计按日查询
8 108 补助明细与累计按日查询
9 109 扣款明细与累计明细按日查询
10 110 银行转帐明细与累计按日查询
11 111 缴费明细与累计按日查询
12 112 内部转出明细与累计按日查询
13 113 内部转入与累计明细按日查询
14 114 分类累计按日查询
15 115 分类累计按月查询
16 116 短信汇报
[下行业务]界面如上图所示。

下行业务指短信平台发起，网关接收后，发送给手机用户的短信业务。

如通告、提醒、上行应答。

短信平台对应的下行业务包括短信平台下行通用与短信平台通告短信两种业务。

其中短信平台下行通用主要于上行业务处理过程中不成功的应答短信，就是说当上行业务处理不成功时，其资费金额是按下行通用收的，而不是安其相应下行业务资费金额收的。

短信平台通告短信业务是指短信平台界面发送的短信。

金龙卡一卡通SP下行业务系统安装时自动加入，只可修改其状态。

其下行业务主要包括：Web通告短信、Web通知短信、提醒短信、上行业务的应答短信。

具体如下表所示。

内部编号描述
短信平台下行
0 短信平台下行通用
1 短信平台通告短信
金龙卡一卡通SP下行
2 WEB通告短信
提醒短信
3 开立帐户提醒短信
4 撤销帐户提醒短信
5 建立对应提醒短信
6 撤消对应提醒短信
7 信息变更(基本帐户)提醒短信
8 信息变更(对应关系)提醒短信
9 余额变更(系统通用)提醒短信
10 余额变更(附带引发) 提醒短信
11 存款提醒短信
12 取款提醒短信
13 补助提醒短信
14 扣款提醒短信
15 卡片交易提醒短信
16 银行转帐提醒短信
17 通用缴费提醒短信
18 缴纳押金提醒短信
19 收管理费提醒短信
20 收手续费提醒短信
21 收工本费提醒短信
22 内部转出提醒短信
23 内部转入提醒短信
24 余额预警提醒短信
WEB 通知短信
25 WEB 登录通知短信
26 WEB 手机号码注册结果通知短信
27 WEB 挂失结果通知短信
28 WEB 修改密码结果通知短信
29 累计通知
30 短信汇报通知
3.3.2 金龙卡上行业务
金龙卡一卡通SP的上行业务界面如上图所示，提供对业务的[修改]功能。

对上行业务的短信格式进行修改，最终短信格式＝业务标识＋短信格式。

短信格式设置系统管理员配置时，双击必选元素或可选元素即可添加。

3.3.3 金龙卡下行业务
金龙卡一卡通SP下行业务界面如上图所示，此处对金龙卡一卡通SP的下行业务参数进行配置。

修改界面如上图所示。

对下行业务短信格式的配置，需注意短信不要超过网关协议所支持的最大长度。

短信平台处理时，如果上行应答短信的长度超过255的字符，会拆分成多条短信。

默认限值是对需要设置限值的业务给出一个默认的限值，在进行批量定购记录增加或用户在Web定购业务时将显示此值。

短信格式配置中，明细部分请使用”{}”包括在其中。

[余额]指业务处理时短信平台帐户中余额。

［当前余额］指流水发生时帐户的余额。

此两个值在流水未能即时处理时是不一致的。

3.4 服务管理菜单
3.4.1 服务控制
服务控制界面如上图所示。

用以启动或停止服务。

3.5 短信发送菜单
3.5.1 即时短信单发
即时短信单发界面如上图所示。

直接输入手机号码与内容即进立刻发送短信。

即时短信单发具有高优先级。

3.5.2 即时短信群发
即时短信群发界面如上。

［查询］、［增加］、［删除］、［清空］是对发送列表的操作。

输入任务名称、短信内容即可提交。

可以使用有效期限，当时间达到任务所设置的有效期限仍未发送，系统将放弃发送短信。

在短信平台界面的短信群发发送列表长度不受限制，但不建议一个任务发送列表过长。

提交后可以在任务查询中查询任务发送结果。

3.5.3 定时短信群发
定时短信群发界面如上图所示。

可以为任务设置定时时间，一般在48小时以内，定时过长对系统有影响。

提交后可以任务查询中查询任务发送结果。

3.5.4 定期短信群发
定期短信群发界面如下图所示。

选择定期方式、日期点、时间点、结束时间即可提交任务。

任务提交后可通过定期任务查询任务发送结果。

业务类型可选择通告短信、累计通知。

当选择累计通知业务时短信内容显示金龙卡一卡通下行业务29中所设置的短信格式，可以修改,定期方式决定累计值的时间长度(即日\周\月) 。

3.6 查询统计菜单
3.6.1 任务查询
任务查询界面如上图所示。

此处可以查询由短信平台界面、WEB服务、第三方接入SP提交的任务(定期短信群发在此查询的是批次任务)。

[明细]可以查看当前选择任务的明细记录。

只有等待处理状态的任务才可以作废。

3.6.2 明细查询
任务明细查询界面如上图所示。

需要说明的查询条件中处理状态与发送状态，处理指的是对WEB提交的修改密码、挂失、号码注册、登录通知等业务而言的，表示业务处理是否成功，是否成功都将进行短信发送。

只可手动作废等待处理状态的任务明细。

3.6.3 定期任务
定期任务查询界面如上图所示。

［批次任务］显示的是任务查询的界面，数据是选择定期任务的各批次，每一批次对应一个任务。

3.6.4 定期明细
定期明细查询界面如上图所示。

3.6.5 报文查询
对上下行报文的查询，其中列标题是汉字的是短信平台系统信息，列标题是英文的是具体的报文信息，想了解报文信息的含议请参考具体协议。

3.6.6 上行查询
上行查询界面如上图所示。

上行查询是对短信平台收到的所有短信的查询。

对金龙卡一卡通SP的上行短信，由于其内容可能含有密码信息，系统进行处理显示成星号。

3.6.7 下行查询
下行查询界面如上图所示。

提供出对所有下行短信的查询。

3.6.8 上行日结
上行日结记录查询界面如上图所示。

系统在所设置的结算时间，对系统上行短信数量进行结算。

上行日结格式{编号、日期、企业编号、业务编号、协议编号、短信总数}。

3.6.9 下行日结
下行日结格式如上图所示。

系统在所设置的结算时间，对系统上行短信数量进行结算。

下行日结格式{编号、日期、企业编号、业务编号、协议编号、支付类型、计费类别、报告状态、短信总数、资费总额}。

3.6.10 上行汇总
3.6.11 下行汇总
下行汇总根据下行日结记录汇总出企业各下行业务的短信数量与资费金额。

3.6.12 统计分析
3.6.12.1 帐户上行
帐户上行统计完成各帐户所提交的上行短信数量的汇总。

统计的短信是可以实别出短信提交帐户的上行短信。

不包括第三方上行短信、短信平台通用上行短信。

3.7 系统工具
3.7.1 数据备份
在异地机器中，以备系统故障或意外发生时可以恢复系统。

第４章 WEB功能说明
4.1 登录
4.1.1 登录
登录界面如上图所示。

可以使用帐号或手机号码登录，手机号码登录需保证手机号码在短信平台系统中是唯一的。

4.1.2 主界面菜单
主界面如上图所示，图中显示的是全部菜单项。

登录用户帐户类型与级别的
不同，菜单项不同，具体划分如下,其中帐户级别指短信平台帐户级别。

1、金龙卡一卡通帐户，帐户级别普通用户：显示［基本信息维护］－［帐
户信息］、［业务定购］、［修改密码］、［号码注册］、［卡片挂失］。

2、金龙卡一卡通帐户，帐户级别高级用户：显示全部菜单。

3、短信平台开户帐户，帐户级别普通用户：［基本信息维护］－［帐户信
息］、［修改密码］、［号码注册］。

4、短信平台开户帐户，帐户级别高级用户：除[业务定购]、［卡片挂失］
外的全部菜单。

4.2 基本信息维护
4.2.1 帐户信息
帐户信息界面显示当前登录帐户的姓名、性别、身份、部门、电话号码、用户级别、管理部门。

帐户的级别与管理部门在短信平台帐户变更中进行设置，只有高级用户可以进行短信发送，而发送的范围由管理部门的设置决定。

4.2.2 业务定购
业务定购界面如上图所示。

业务定购完成登录帐户对是否定购提醒短信与提醒短信的的限值进行设置。

可以在限值列对一项提醒业务设置限值后定购业务或修改限值。

只有定购一项提醒业务且超过其限值时，才会发送提醒短信。

4.2.3 修改密码
修改密码界面如上图所示，输入当前登录帐号、原密码、新密码、确认新密码，点击右上方［保存］按钮提交。

修改密码任务提交后，修改密码的执行结果将通过短信的方式发送给用户。

使用此功能需在短信平台设置金龙卡一卡通SP的下行业务28为正常状态，并设置其下行短信的具体格式。

4.2.4 号码注册
号码注册界面如上图所示，输入当前登录帐号、密码、手机号码，点击右上方［保存］按钮提交。

提交后手机号码注册结果将以短信方式发送到新手机号码。

号码注册后，重新登录WEB将会刷新帐户信息中的电话号码。