云南电信：远程写卡与CRM接口子系统详细设计-20100725

1、云南电信远程写卡系统CRM接口子系统详细设计北京握奇数据系统有限公司文件状态： 草稿 修改稿 正式发布文档密级：机密当前版本：1.0部 门： 软件开发中心cc项目名称： RPS_CT作 者：完成日期：2010-06-23审 核：日 期：审 批：日 期： 中国电信远程写卡CRM接口子系统详细设计版本历史版本日期作者说明1.02010-06-22远写CRM接口子系统详细设计1.0.12010-7-25第16页 总16页目录1文档介绍41.1文档目的41.2文档范围41.3读者对象41.4参考文献42系统分析及设计42.1系统需求与分析42.2设计策略42.3跨省补换卡接口52.3.1本省作为归属省

2、52.3.2本省作为漫游省62.4本省写卡或补换卡接口112.4.1远程写卡客户端接口113接口可测性设计143.1接口测试环境搭建143.2接口测试流程图144附录144.1归属省RPS接口服务描述文件141 文档介绍1.1 文档目的在理解电信远写概要设计提出的接口子系统设计基础上进行详细的子系统设计，为相关开发人员的开发提供指导。1.2 文档范围文档描述了本省远程写卡系统接口子系统的详细设计概述，设计策略，具体流程，实现策略，以及接口协议等。1.3 读者对象项目组全体人员。1.4 参考文献1 中国电信远程写卡概要设计.doc2 中国电信远程写卡业务接口规范V1.1.4.doc3 中国电信远

3、程写卡数据库设计.doc4 中国电信远程写卡业务IT支撑方案V1.22.doc5 跨省补换卡接口协议实例-20100623.doc2 系统分析及设计2.1 系统需求与分析本省RPS系统需要完成本省的新开户以及补换卡业务，跨省的补换卡业务。在办理跨省的补换卡业务时，本省的RPS承担两种角色，一是作为归属省的RPS，接收漫游省提交的写卡数据请求，接收漫游省RPS的写卡结果；二是作为漫游省的RPS，向归属省RPS提交写卡数据请求，提交写卡结果。2.2 设计策略Ø RPS写卡服务流程中，省内业务建议采用模态窗口作为用户交互界面。RPS给CRM的写卡返回值采用js 对象的方式承载，接口协议返回

4、值中的各个字段均作为返回对象的一个属性。跨省业务采用URL链接的形式，由CRM传递写卡数据调用RPS的Servlet，打开RPS客户端页面进行写卡。Ø 可测性：通过CRM模拟器，完成省内、跨省业务的测试，方便测试人员的功能测试。Ø 接口子系统的界面风格采用风格与web管理系统一致，2.3 跨省补换卡接口2.3.1 本省作为归属省 远程写卡资源数据申请接口发起方：漫游省RPS提供方：归属省RPS调用方式：Web Service说明：该接口中归属省RPS作为一个Web Service服务端，由归属省RPS向漫游省的RPS系统提供个人化数据。该接口中，本省RPS系统

5、充当归属省的角色，RPS系统须按照集团的要求，定义自己的服务接口，并把访问地址通知本省的CRM系统，供其调用。系统整体调用流程请参考中国电信远程写卡业务IT支撑方案V1.22.doc的系统交互流程。报文字段以及类型定义请参考跨省补换卡接口协议实例-20100623.doc。流程图： 图2-3-1-1归属省CRM调用归属省RPS写卡资源数据申请接口流程图接口地址：:10000/RPSWSServer/services/RPSWSServer接口方法：getPersonalData服务描述见：附录归属省RPS接口服务描述文件 写卡结果上报接口发起方

6、：漫游省RPS提供方：归属省RPS调用方式：Web Service说明：该接口中归属省RPS作为一个Web Service服务端，接收漫游省的RPS系统回送的写卡结果。本省RPS系统充当归属省的角色，RPS系统须按照集团的要求，定义自己的服务接口，并把访问地址通知本省的CRM系统，供其调用。系统整体调用流程请参考中国电信远程写卡业务IT支撑方案V1.22.doc的系统交互流程。报文字段以及类型定义请参考跨省补换卡接口协议实例-20100623.doc。流程图：图2-3-1-2归属省CRM调用归属省RPS写卡结果上报接口流程图接口地址：:10000/RPSWS

7、Server/services/RPSWSServer接口方法：submitResultInfo服务描述见：附录归属省RPS接口服务描述文件2.3.2 本省作为漫游省 远程写卡客户端接口发起方：漫游省CRM提供方：漫游省RPS调用方式：HTTP 说明：漫游省CRM把办理补换卡业务的用户号码、卡产品类型，归属地地址等信息以HTTP请求参数（POST）方式传递给漫游省RPS，漫游省RPS通过漫游省CRM提供的服务通道发起向归属省RPS的写卡资源数据申请，获取写卡资源数据并写卡后再通过漫游省CRM提供的服务通道向归属省RPS提交写卡结果，并将写卡结果以HTTP方式返回给漫游省CRM。流

8、程图： 图2-3-2-1漫游省CRM调用漫游省RPS客户端接口流程图接口地址：远程写卡客户端接口调用地址：:10000/RPSService/login.action远程写卡客户端接口返回地址： 由CRM提供接口参数：远程写卡客户端接口调用参数：参数名为：personalData，其值是如下格式的XML的字符串，例如：<xml version="1.0" encoding="UTF-8"?><PersonalData><BUSINESS_TYPE>2</ BUSINESS_TY

9、PE ><MDN>lt;/MDN><CARDTYPE>00001</CARDTYPE><STAFF_CODE>03F42F4AE503BB81</STAFF_CODE><PASSWORD>03F42F4AE503BB81</PASSWORD><STAFF_ID>10001</STAFF_ID><STAFF_NAME>张三</STAFF_NAME><CHANNEL_ID>ABC10001</CHANNEL_ID&

10、gt;<CHANNEL_NAME>鼓楼营业厅</CHANNEL_NAME><FROMAREANUM>021</ FROMAREANUM ><TOAREANUM>025</ TOAREANUM ><PROVINCIAL>123</PROVINCIAL><CUST_NAME>李四</CUST_NAME></PersonalData>参数说明：输入序号父属性属性编码属性名称数据类型长度出现次数说明1PersonalData请求内容1.1XML格式1.1PersonalD

11、ataBUSINESS_TYPE操作类型String1.10:新开户写卡；1：本省补换卡开户写卡1.2PersonalDataMDN手机号码String1.11.3PersonalDataCARDTYPE卡产品编号String1.11.4PersonalDataSTAFF_CODECRM接入帐户String1.1远程写卡系统分配的系统帐号，用于认证鉴权,要求使用单DES进行加密1.5PersonalDataPASSWORDCRM接入密码String1.1远程写卡系统分配的系统帐号密码，用于认证鉴权,要求使用单DES进行加密1.6PersonalDataSTAFF_ID工号String1.11.

12、7PersonalDataSTAFF_NAME工号名称String1.11.8PersonalDataCHANNEL_ID营业厅标识String1.11.9PersonalDataCHANNEL_NAME营业厅名称String1.11.10PersonalDataFROMAREANUM漫游地区号String1.1漫游省或直辖市代码1.11PersonalDataTOAREANUM归属地区号String1.1归属省或直辖市代码1.12PersonalDataPROVINCIAL归属省省代码String1.11.13PersonalDataCUST_NAME归属省客户名称String1.1远程写卡

13、客户端接口返回参数：输出序号父属性属性编码属性名称数据类型长度出现次数说明1ResultData返回内容1.1XML格式1.1ResultDataBUSINESS_TYPEString1.10:新开户写卡；1：本省补换卡开户写卡1.2ResultDataRESULT_CODE结果String1.10：成功；1：失败1.3ResultDataRESULT_MESSAGE结果描述String1.11.4ResultDataMDN号码String1.11.5ResultDataIMSIIMSIString1.11.6ResultDataICCSERIAL空卡序列号String1.11.7Result

14、DataICCIDICCIDString1.11.8ResultDataUIMIDUIMIDString1.11.9ResultDataCARD_TYPE卡产品编号String.2 远程写卡资源数据申请接口发起方：漫游省RPS提供方：归属省RPS调用方式：Web Service说明：该接口中满游省RPS作为一个Web Service客户端，由漫游省RPS向归属省的RPS系统申请个人化数据。该接口中，本省RPS系统充当满游省的角色，RPS系统须按照集团的要求，调用本省的CRM系统提供的远程写卡资源数据申请接口。系统整体调用流程请参考中国电信远程写卡业务IT支撑方案V1.22.do

15、c的系统交互流程。报文字段以及类型定义请参考跨省补换卡接口协议实例-20100623.doc。流程图： 图2-3-2-2满游省RPS调用满游省CRM写卡资源数据申请接口流程图接口地址：CRM系统提供接口方法：CRM系统提供服务描述见：CRM系统提供 写卡结果上报接口发起方：满游省RPS提供方：归属省RPS调用方式：Web Service说明：该接口中满游省RPS作为一个Web Service客户端，由漫游省RPS向归属省的RPS系统上报写卡结果。该接口中，本省RPS系统充当满游省的角色，RPS系统须按照集团的要求，调用本省的CRM系统提供的写卡结果上报接口。系统整体调用流程请参考

16、中国电信远程写卡业务IT支撑方案V1.22.doc的系统交互流程。报文字段以及类型定义请参考跨省补换卡接口协议实例-20100623.doc。流程图： 图2-3-2-2满游省RPS调用满游省CRM写卡结果上报接口流程图接口地址：CRM系统提供接口方法：CRM系统提供服务描述见：CRM系统提供2.4 本省写卡或补换卡接口2.4.1 远程写卡客户端接口发起方：本省CRM提供方：本省RPS调用方式：HTTP 说明：本省CRM把办理写卡或补换卡业务的用户号码、卡产品类型，归属地地址等信息以HTTP请求参数（POST）方式传递给本省RPS，本省RPS由本省卡管系统提供的卡资源数据中匹配对应的写卡资源数据

17、，写卡后资再将写卡结果返回给本省CRM。流程图： 图2-4-1本省CRM调用本省RPS客户端接口流程图接口地址：远程写卡客户端接口调用地址：:10000/RPSService/login.action远程写卡客户端接口返回地址： 由CRM提供接口参数：远程写卡客户端接口调用参数：参数名为：personalData，其值是如下格式的XML的字符串，例如：<xml version="1.0" encoding="UTF-8"?><PersonalData><BUSINESS_TYPE>0

18、</ BUSINESS_TYPE ><MDN>lt;/MDN><CARDTYPE>00001</CARDTYPE><STAFF_CODE>03F42F4AE503BB81</STAFF_CODE><PASSWORD>03F42F4AE503BB81</PASSWORD><STAFF_ID>10001</STAFF_ID><STAFF_NAME>张三</STAFF_NAME><CHANNEL_ID>ABC1000

19、1</CHANNEL_ID><CHANNEL_NAME>鼓楼营业厅</CHANNEL_NAME><PROVINCIAL>123</PROVINCIAL><CUST_NAME>李四</CUST_NAME></PersonalData>参数说明：输入序号父属性属性编码属性名称数据类型长度出现次数说明1PersonalData请求内容1.1XML格式1.1PersonalDataBUSINESS_TYPE操作类型String1.10:新开户写卡；1：本省补换卡开户写卡1.2PersonalDataMDN手

20、机号码String1.11.3PersonalDataCARDTYPE卡产品编号String1.11.4PersonalDataSTAFF_CODECRM接入帐户String1.1远程写卡系统分配的系统帐号，用于认证鉴权,要求使用单DES进行加密1.5PersonalDataPASSWORDCRM接入密码String1.1远程写卡系统分配的系统帐号密码，用于认证鉴权,要求使用单DES进行加密1.6PersonalDataSTAFF_ID工号String1.11.7PersonalDataSTAFF_NAME工号名称String1.11.8PersonalDataCHANNEL_ID营业厅标识S

21、tring1.11.9PersonalDataCHANNEL_NAME营业厅名称String1.11.10PersonalDataPROVINCIAL归属省省代码String1.11.11PersonalDataCUST_NAME归属省客户名称String1.1远程写卡客户端接口返回参数：输出序号父属性属性编码属性名称数据类型长度出现次数说明1ResultData返回内容1.1XML格式1.1ResultDataBUSINESS_TYPEString1.10:新开户写卡；1：本省补换卡开户写卡1.2ResultDataRESULT_CODE结果String1.10：成功；1：失败1.3Resu

22、ltDataRESULT_MESSAGE结果描述String1.11.4ResultDataMDN号码String1.11.5ResultDataIMSIIMSIString1.11.6ResultDataICCSERIAL空卡序列号String1.11.7ResultDataICCIDICCIDString1.11.8ResultDataUIMIDUIMIDString1.11.9ResultDataCARD_TYPE卡产品编号String1.13 接口可测性设计3.1 接口测试环境搭建搭建两套RPS系统，一套假定为上海RPS，一套为本省RPS，另外搭建一套CRM模拟系统环境，建议CRM模拟

23、系统与RPS系统部署在两个独立的机器上，可以网络互联。3.2 接口测试流程图图3-1 测试时序图4 附录4.1 归属省RPS接口服务描述文件<?xml version="1.0" encoding="UTF-8"?><wsdl:definitions targetNamespace=""xmlns:apachesoap="/xml-soap"xmlns:impl=""xmlns:intf=""xmlns:soapenc

24、="/soap/encoding/"xmlns:wsdl="/wsdl/"xmlns:wsdlsoap="/wsdl/soap/"xmlns:xsd="/2001/XMLSchema"><!-WSDL created by Apache Axis version: 1.4Built on Apr 22, 2006 (06:5

25、5:48 PDT)-><wsdl:message name="submitResultInfoRequest"><wsdl:part name="request" type="xsd:string" /></wsdl:message><wsdl:message name="getPersonalDataRequest"><wsdl:part name="request" type="xsd:string" />

26、</wsdl:message><wsdl:message name="submitResultInfoResponse"><wsdl:part name="submitResultInfoReturn" type="xsd:string" /></wsdl:message><wsdl:message name="getPersonalDataResponse"><wsdl:part name="getPersonalDataReturn&q

27、uot; type="xsd:string" /></wsdl:message><wsdl:portType name="RPSWSServer"><wsdl:operation name="getPersonalData"parameterOrder="request"><wsdl:input message="impl:getPersonalDataRequest"name="getPersonalDataRequest"

28、/><wsdl:output message="impl:getPersonalDataResponse"name="getPersonalDataResponse" /></wsdl:operation><wsdl:operation name="submitResultInfo"parameterOrder="request"><wsdl:input message="impl:submitResultInfoRequest"name=&quo

29、t;submitResultInfoRequest" /><wsdl:output message="impl:submitResultInfoResponse"name="submitResultInfoResponse" /></wsdl:operation></wsdl:portType><wsdl:binding name="RPSWSServerSoapBinding"type="impl:RPSWSServer"><wsdlsoap:

30、binding style="rpc"transport="/soap/http" /><wsdl:operation name="getPersonalData"><wsdlsoap:operation soapAction="" /><wsdl:input name="getPersonalDataRequest"><wsdlsoap:bodyencodingStyle="/soap/encoding/"namespace="" use="encoded" /></wsdl:input><wsdl:output name="getPersonalDataResponse"><wsdlsoap:bodyencodingStyle="http:/schemas.xm