《广东移动企信通云服务二次接口使用手册V1.0》由会员分享，可在线阅读，更多相关《广东移动企信通云服务二次接口使用手册V1.0（28页珍藏版）》请在金锄头文库上搜索。
1、 广东移动企信通云服务平台二次接口使用手册广东移动企信通云服务平台二次接口使用手册当前版本：Version 1.0修改日期：2013/08文档更新记录版本号更新日期更新内容更新人V1.02012/07创建初始版本目 录广东移动企信通云服务平台1二次接口使用手册11二次接口简介52二次接口接入流程53系统配置74JAVA环境75客户端安装96启动运行107短信收发流程简述118短信接口配置128.1 数据库接入方式121)发送接口122)接收接口148.2 文本文件接入方式151)发送接口152)接收接口169接收发送失败短信1710已发送短信列表1811状态报告获取1912数据源设置2012.
2、1 配置参数2012.2 ODBC配置2112.3各数据库数据源设置231)ACCESS数据库232)SQLSERVER数据库233)ORACLE 数据库244)DB2 数据库245)MYSQL数据库246)INFORMIX数据库2513代理设置25二次接口的常见问题及解答261 二次接口简介“企信通二次接口”是一种高效便携的短信发送工具。企业可以通过二次接口客户端自动、快速、稳定地发送短信，并且可以把发送和接收短信的功能接入到企业内部应用系统中，扩展企业内办公及其他应用系统的移动信息化功能。2 二次接口接入流程1）登录企信通云平台：在IE浏览器中输入企信通地址，输入企信通帐号，点击登录，成功
3、登录企信通平台；2）下载二次接口客户端：选择下载菜单，点击客户端下载，选择二次接口，点击下载，成功下载二次接口客户端；3）检查本机系统环境：检查操作系统（Windows 7/XP/NT/2000/2003）、基本配置（内存128M以上，硬盘空间430M以上）、java环境（JDK1.5版本以上），如果环境不符合要求，请先设置好环境；4）安装二次接口客户端：按照提示安装好二次接口客户端；（参考二次接口客户端安装文档）5）二次接口客户端测试联调（ACCESS数据库）：客户端安装完成后，配置您的微软自带的ACCESS数据库，先发送短信以测试二次接口客户端是否可用，如果不可用，则属于二次接口自身问题；
4、如果可用，表示二次接口可正常使用；6）选择更改数据库类型：在二次接口可用的情况下，如果要更改数据库，选择好需要更改的数据库类型；（建议：由于无法定位用户的使用环境，二次接口程序默认是使用ACCESS数据库，但ACCESS功能不是很健全，所以不建议使用，在条件许可情况下建议sql_server或更好的数据库。）7）创建二次接口相关表结构：根据ACCESS数据库的表结构相应的在新的数据库上建立二次接入服务所需的表结构；8）更改数据库参数配置信息：需要更改核心数据库配置信息的几项参数值；DBTypeJDBC_DRIVER/数据库的驱动程序类名JDBC_URL/数据库访问的URLJDBC_USERNA
5、ME/访问数据库的用户名JDBC_PASSWORD/访问数据库的口令LOCALDB_CHARACTER_ENCODE/是否需要对数据库的中文信息进行编码处理9）更改接口客户端测试联调（新数据库）：在您的目标数据库上创建相应的表（创建表的语句在安装目录的help文件夹下：二次接口客户端SQL脚本 FOR oracle(ver_4.1).sql 文档中），数据库创建完成，先发送短信以测试二次接口客户端是否可用，如果不可用，则表示数据库连接有误，请检查数据库的连接或配置信息是否有误；如果可用，则表示二次接口已经成功安装，可正常使用。10）二次接口安装完成11）现在可以介入您的系统了。祝您好运！3 系
6、统配置操作系统：Windows 7/XP/NT/2000/2003基本配置：内存128M以上，硬盘空间430M以上4 JAVA环境本程序需要JDK 1.5版本以上运行环境。JDK版本查看方法：在电脑桌面点击“开始”，在“运行”文本框中输入“cmd”按回车键，在DOS命令行下输入“java -version”按回车键，查看是否已经安装java及其版本。窗口内容类似如下：如果没有达到要求，需要先安装java运行环境。可以从Oracle公司站点下载并安装JDK，下载地址：http:/ （变量值为JAVA安装路径下的bin目录）5 客户端安装使用企信通帐号登录企信通网站，进入“下载”-“客户端下载”页
7、面，下载二次接口的安装程序“meip_gw.zip”到待安装的机器。使用解压工具解压“meip_gw.zip”，在解压后的文件夹中双击“Meip2_Client_4.2.1.exe”进行安装，按向导提示默认安装，安装目录默认为c:/program files/meip/Meip2_Client_4.2.1，您可以更改为其他目录，如C:toolsMeip2_Client_4.2.1。输入有关登录信息，提示输入用户注册信息，窗口显示如下：在以上窗口中输入企业ID、用户ID及口令信息，企业ID是企业注册企信通后的帐号ID，可以在登录后的企信通网站右上角查到（见下图），用户ID分别是企信通帐号“”分隔
8、符前面的部分（如adminmp的admin），口令则是登录企信通网站的密码。填写以上信息后，继续点击下一步，按向导提示操作，直到安装完成。本文档后面部分将用表示二次接口程序的安装目录另外，可用文本编辑工具打开文件confservice.conf，在最末端修改用户ID及密码，配置如下参数项：client.1.EnterpriseID=#企业ID或 集团编码client.1.UserID=#用户IDclient.1.Password=#用户密码注意：如果修改后的登录方式为集团编码登录，重启服务时，需要选择登录的企业，界面如下：6 启动运行默认安装时会自动启动二次接口程序。通过双击桌面上企信通二次接
9、口的快捷方式“”，也能手工启动该程序。正常启动后弹出窗口如下：7 短信收发流程简述短信发送：在客户端中可以采用文本或数据库的方式发送短信，首先将短信保存在已发送列表中并提交至服务端，再把短信提交至短信服务，最后通过网关发送短信，可在短信状态报表中查看短信真实的发送状态。短信接收：客户上行短信后，上行短信被推送至短信服务，再被推送至二次接口服务端，最后保存到数据库中，可在数据库jsdl、jsdl2中查看接收到的上行短信。以下是二次接口短信收发流程图：8 短信接口配置二次接口当前提供两种短信收发接口：文本接口和数据库接口，建议使用数据库方式。8.1 数据库接入方式1) 发送接口二次接口默认把所有待
10、发送的短信息写到二次接入服务指定的核心数据库(数据源为meipapp)的dfsdl表中，该表的结构如下表所示。用户可以直接将要发送的短信写到dfsdl表中即可进行短信发送，二次接口每隔一定时间自动将已发送的短信息(status字段不为0的信息)从dfsdl表迁移到yfsdl表中。列名类型描述备注Id整数短信标识该字段在dfsdl表中不允许重复，在yfsdl中允许重复Mobile字符串目标手机号码长度至多为15Content字符串短信内容长度至多为255Deadtime日期时间信息有效时间截至到Status整数信息状态0:未处理，1:已处理，其他表示处理失败Eid字符串发送信息所属企业ID号长度
11、至多50Userid字符串发送信息的用户ID号长度至多50Password字符串发送信息的用户密码长度至多50Userport字符串端口扩展号不能超过4位数字msgid整数发送组ID，白名单校验用，不能为空值，每次发送的内容不相同时不能重复数据库方式发送短信时，注意必须确保以上字段中Eid，Userid，Password不为空，如果这些字段为空，则短信将不会发送。说明：通过二次接入服务发送的短信的端口号(即用户收到短信后所见到的号码)为：服务代码（106570200002）+二次接口应用号（03）+扩展号（自定义），如106570200002032) 接收接口为了启动二次接入的短信接收功能，需
12、要修改配置文件/conf/service.conf（修改配置后需重启二次接口）。打开该配置文件，找到RECEIVE_SMS_ENABLE=true这样所有接收到的短信息存储在系统数据源meipapp对应的ACCESS数据库中的表jsdl中。短信接收表(jsdl，jsdl2)格式说明如下：列名类型描述备注Id整数短信标识该字段在jsdl表中不允许重复，在jsd2中允许重复Mobile字符串上行手机号码长度至少为15Content字符串上行短信内容长度至少为140Recetime日期时间信息发送时间Status整数信息状态0:未处理，1:已处理，其他表示处理失败Eid字符串上行信息所属企业编号长度
13、至少20Userid字符串发送信息的用户ID号长度至多50Password字符串发送信息的用户密码长度至多50userport整数扩展号用户通过查询jsdl和jsdl2可以得到所有的上行的短信息。二次接入服务每隔一定时间自动将jsdl表中的status不为0信息搬移到jsdl2中。注意：通过二次接入服务接收的短信的端口号(即用户发送短信到哪个号码)为：服务代码（106570200002）+二次接口应用号（03）+扩展号（自定义）8.2 文本文件接入方式1) 发送接口用户需要把发送的短信组合成一个文本文件，文件名任意，如send.txt，然后将该文件拷贝到目录messages企业id_用户id下。例如：安装时输入的企业ID为mp，用户ID为admin，则把短信文件拷贝到messagesmp_admin下。文件内容格式为13900000000|你好11390000000113911111111|你好213911111112接收者13900000000和13900000001接收的短信内容是：你好 1接收者13911111111和13911111112接收的短信内容是：你好 2发送完的短信在目录下messages_bak有保留,可作为发送记录查询。此功能仅限文件方式发送，数据库方式发送短信并不没有此保留功能。
