云南電信：遠程寫卡與CRM接口子系統(tǒng)詳細設計-20100725

1、云南電信遠程寫卡系統(tǒng)CRM接口子系統(tǒng)詳細設計北京握奇數(shù)據(jù)系統(tǒng)有限公司文件狀態(tài)： 草稿 修改稿 正式發(fā)布文檔密級：機密當前版本：1.0部 門： 軟件開發(fā)中心cc項目名稱： RPS_CT作 者：完成日期：2010-06-23審 核：日 期：審 批：日 期： 中國電信遠程寫卡CRM接口子系統(tǒng)詳細設計版本歷史版本日期作者說明1.02010-06-22遠寫CRM接口子系統(tǒng)詳細設計1.0.12010-7-25第16頁 總16頁目錄1文檔介紹41.1文檔目的41.2文檔范圍41.3讀者對象41.4參考文獻42系統(tǒng)分析及設計42.1系統(tǒng)需求與分析42.2設計策略42.3跨省補換卡接口52.3.1本省作為歸屬省

2、52.3.2本省作為漫游省62.4本省寫卡或補換卡接口112.4.1遠程寫卡客戶端接口113接口可測性設計143.1接口測試環(huán)境搭建143.2接口測試流程圖144附錄144.1歸屬省RPS接口服務描述文件141 文檔介紹1.1 文檔目的在理解電信遠寫概要設計提出的接口子系統(tǒng)設計基礎上進行詳細的子系統(tǒng)設計，為相關開發(fā)人員的開發(fā)提供指導。1.2 文檔范圍文檔描述了本省遠程寫卡系統(tǒng)接口子系統(tǒng)的詳細設計概述，設計策略，具體流程，實現(xiàn)策略，以及接口協(xié)議等。1.3 讀者對象項目組全體人員。1.4 參考文獻1 中國電信遠程寫卡概要設計.doc2 中國電信遠程寫卡業(yè)務接口規(guī)范V1.1.4.doc3 中國電信遠

3、程寫卡數(shù)據(jù)庫設計.doc4 中國電信遠程寫卡業(yè)務IT支撐方案V1.22.doc5 跨省補換卡接口協(xié)議實例-20100623.doc2 系統(tǒng)分析及設計2.1 系統(tǒng)需求與分析本省RPS系統(tǒng)需要完成本省的新開戶以及補換卡業(yè)務，跨省的補換卡業(yè)務。在辦理跨省的補換卡業(yè)務時，本省的RPS承擔兩種角色，一是作為歸屬省的RPS，接收漫游省提交的寫卡數(shù)據(jù)請求，接收漫游省RPS的寫卡結(jié)果；二是作為漫游省的RPS，向歸屬省RPS提交寫卡數(shù)據(jù)請求，提交寫卡結(jié)果。2.2 設計策略Ø RPS寫卡服務流程中，省內(nèi)業(yè)務建議采用模態(tài)窗口作為用戶交互界面。RPS給CRM的寫卡返回值采用js 對象的方式承載，接口協(xié)議返回

4、值中的各個字段均作為返回對象的一個屬性?？缡I(yè)務采用URL鏈接的形式，由CRM傳遞寫卡數(shù)據(jù)調(diào)用RPS的Servlet，打開RPS客戶端頁面進行寫卡。Ø 可測性：通過CRM模擬器，完成省內(nèi)、跨省業(yè)務的測試，方便測試人員的功能測試。Ø 接口子系統(tǒng)的界面風格采用風格與web管理系統(tǒng)一致，2.3 跨省補換卡接口2.3.1 本省作為歸屬省 遠程寫卡資源數(shù)據(jù)申請接口發(fā)起方：漫游省RPS提供方：歸屬省RPS調(diào)用方式：Web Service說明：該接口中歸屬省RPS作為一個Web Service服務端，由歸屬省RPS向漫游省的RPS系統(tǒng)提供個人化數(shù)據(jù)。該接口中，本省RPS系統(tǒng)

5、充當歸屬省的角色，RPS系統(tǒng)須按照集團的要求，定義自己的服務接口，并把訪問地址通知本省的CRM系統(tǒng)，供其調(diào)用。系統(tǒng)整體調(diào)用流程請參考中國電信遠程寫卡業(yè)務IT支撐方案V1.22.doc的系統(tǒng)交互流程。報文字段以及類型定義請參考跨省補換卡接口協(xié)議實例-20100623.doc。流程圖： 圖2-3-1-1歸屬省CRM調(diào)用歸屬省RPS寫卡資源數(shù)據(jù)申請接口流程圖接口地址：:10000/RPSWSServer/services/RPSWSServer接口方法：getPersonalData服務描述見：附錄歸屬省RPS接口服務描述文件 寫卡結(jié)果上報接口發(fā)起方

6、：漫游省RPS提供方：歸屬省RPS調(diào)用方式：Web Service說明：該接口中歸屬省RPS作為一個Web Service服務端，接收漫游省的RPS系統(tǒng)回送的寫卡結(jié)果。本省RPS系統(tǒng)充當歸屬省的角色，RPS系統(tǒng)須按照集團的要求，定義自己的服務接口，并把訪問地址通知本省的CRM系統(tǒng)，供其調(diào)用。系統(tǒng)整體調(diào)用流程請參考中國電信遠程寫卡業(yè)務IT支撐方案V1.22.doc的系統(tǒng)交互流程。報文字段以及類型定義請參考跨省補換卡接口協(xié)議實例-20100623.doc。流程圖：圖2-3-1-2歸屬省CRM調(diào)用歸屬省RPS寫卡結(jié)果上報接口流程圖接口地址：:10000/RPSWS

7、Server/services/RPSWSServer接口方法：submitResultInfo服務描述見：附錄歸屬省RPS接口服務描述文件2.3.2 本省作為漫游省 遠程寫卡客戶端接口發(fā)起方：漫游省CRM提供方：漫游省RPS調(diào)用方式：HTTP 說明：漫游省CRM把辦理補換卡業(yè)務的用戶號碼、卡產(chǎn)品類型，歸屬地地址等信息以HTTP請求參數(shù)（POST）方式傳遞給漫游省RPS，漫游省RPS通過漫游省CRM提供的服務通道發(fā)起向歸屬省RPS的寫卡資源數(shù)據(jù)申請，獲取寫卡資源數(shù)據(jù)并寫卡后再通過漫游省CRM提供的服務通道向歸屬省RPS提交寫卡結(jié)果，并將寫卡結(jié)果以HTTP方式返回給漫游省CRM。流

8、程圖： 圖2-3-2-1漫游省CRM調(diào)用漫游省RPS客戶端接口流程圖接口地址：遠程寫卡客戶端接口調(diào)用地址：:10000/RPSService/login.action遠程寫卡客戶端接口返回地址： 由CRM提供接口參數(shù)：遠程寫卡客戶端接口調(diào)用參數(shù)：參數(shù)名為：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>鼓樓營業(yè)廳</CHANNEL_NAME><FROMAREANUM>021</ FROMAREANUM ><TOAREANUM>025</ TOAREANUM ><PROVINCIAL>123</PROVINCIAL><CUST_NAME>李四</CUST_NAME></PersonalData>參數(shù)說明：輸入序號父屬性屬性編碼屬性名稱數(shù)據(jù)類型長度出現(xiàn)次數(shù)說明1PersonalData請求內(nèi)容1.1XML格式1.1PersonalD

11、ataBUSINESS_TYPE操作類型String1.10:新開戶寫卡；1：本省補換卡開戶寫卡1.2PersonalDataMDN手機號碼String1.11.3PersonalDataCARDTYPE卡產(chǎn)品編號String1.11.4PersonalDataSTAFF_CODECRM接入帳戶String1.1遠程寫卡系統(tǒng)分配的系統(tǒng)帳號，用于認證鑒權(quán),要求使用單DES進行加密1.5PersonalDataPASSWORDCRM接入密碼String1.1遠程寫卡系統(tǒng)分配的系統(tǒng)帳號密碼，用于認證鑒權(quán),要求使用單DES進行加密1.6PersonalDataSTAFF_ID工號String1.11.

12、7PersonalDataSTAFF_NAME工號名稱String1.11.8PersonalDataCHANNEL_ID營業(yè)廳標識String1.11.9PersonalDataCHANNEL_NAME營業(yè)廳名稱String1.11.10PersonalDataFROMAREANUM漫游地區(qū)號String1.1漫游省或直轄市代碼1.11PersonalDataTOAREANUM歸屬地區(qū)號String1.1歸屬省或直轄市代碼1.12PersonalDataPROVINCIAL歸屬省省代碼String1.11.13PersonalDataCUST_NAME歸屬省客戶名稱String1.1遠程寫卡

13、客戶端接口返回參數(shù)：輸出序號父屬性屬性編碼屬性名稱數(shù)據(jù)類型長度出現(xiàn)次數(shù)說明1ResultData返回內(nèi)容1.1XML格式1.1ResultDataBUSINESS_TYPEString1.10:新開戶寫卡；1：本省補換卡開戶寫卡1.2ResultDataRESULT_CODE結(jié)果String1.10：成功；1：失敗1.3ResultDataRESULT_MESSAGE結(jié)果描述String1.11.4ResultDataMDN號碼String1.11.5ResultDataIMSIIMSIString1.11.6ResultDataICCSERIAL空卡序列號String1.11.7Result

14、DataICCIDICCIDString1.11.8ResultDataUIMIDUIMIDString1.11.9ResultDataCARD_TYPE卡產(chǎn)品編號String.2 遠程寫卡資源數(shù)據(jù)申請接口發(fā)起方：漫游省RPS提供方：歸屬省RPS調(diào)用方式：Web Service說明：該接口中滿游省RPS作為一個Web Service客戶端，由漫游省RPS向歸屬省的RPS系統(tǒng)申請個人化數(shù)據(jù)。該接口中，本省RPS系統(tǒng)充當滿游省的角色，RPS系統(tǒng)須按照集團的要求，調(diào)用本省的CRM系統(tǒng)提供的遠程寫卡資源數(shù)據(jù)申請接口。系統(tǒng)整體調(diào)用流程請參考中國電信遠程寫卡業(yè)務IT支撐方案V1.22.do

15、c的系統(tǒng)交互流程。報文字段以及類型定義請參考跨省補換卡接口協(xié)議實例-20100623.doc。流程圖： 圖2-3-2-2滿游省RPS調(diào)用滿游省CRM寫卡資源數(shù)據(jù)申請接口流程圖接口地址：CRM系統(tǒng)提供接口方法：CRM系統(tǒng)提供服務描述見：CRM系統(tǒng)提供 寫卡結(jié)果上報接口發(fā)起方：滿游省RPS提供方：歸屬省RPS調(diào)用方式：Web Service說明：該接口中滿游省RPS作為一個Web Service客戶端，由漫游省RPS向歸屬省的RPS系統(tǒng)上報寫卡結(jié)果。該接口中，本省RPS系統(tǒng)充當滿游省的角色，RPS系統(tǒng)須按照集團的要求，調(diào)用本省的CRM系統(tǒng)提供的寫卡結(jié)果上報接口。系統(tǒng)整體調(diào)用流程請參考

16、中國電信遠程寫卡業(yè)務IT支撐方案V1.22.doc的系統(tǒng)交互流程。報文字段以及類型定義請參考跨省補換卡接口協(xié)議實例-20100623.doc。流程圖： 圖2-3-2-2滿游省RPS調(diào)用滿游省CRM寫卡結(jié)果上報接口流程圖接口地址：CRM系統(tǒng)提供接口方法：CRM系統(tǒng)提供服務描述見：CRM系統(tǒng)提供2.4 本省寫卡或補換卡接口2.4.1 遠程寫卡客戶端接口發(fā)起方：本省CRM提供方：本省RPS調(diào)用方式：HTTP 說明：本省CRM把辦理寫卡或補換卡業(yè)務的用戶號碼、卡產(chǎn)品類型，歸屬地地址等信息以HTTP請求參數(shù)（POST）方式傳遞給本省RPS，本省RPS由本省卡管系統(tǒng)提供的卡資源數(shù)據(jù)中匹配對應的寫卡資源數(shù)據(jù)

17、，寫卡后資再將寫卡結(jié)果返回給本省CRM。流程圖： 圖2-4-1本省CRM調(diào)用本省RPS客戶端接口流程圖接口地址：遠程寫卡客戶端接口調(diào)用地址：:10000/RPSService/login.action遠程寫卡客戶端接口返回地址： 由CRM提供接口參數(shù)：遠程寫卡客戶端接口調(diào)用參數(shù)：參數(shù)名為：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>鼓樓營業(yè)廳</CHANNEL_NAME><PROVINCIAL>123</PROVINCIAL><CUST_NAME>李四</CUST_NAME></PersonalData>參數(shù)說明：輸入序號父屬性屬性編碼屬性名稱數(shù)據(jù)類型長度出現(xiàn)次數(shù)說明1PersonalData請求內(nèi)容1.1XML格式1.1PersonalDataBUSINESS_TYPE操作類型String1.10:新開戶寫卡；1：本省補換卡開戶寫卡1.2PersonalDataMDN手

20、機號碼String1.11.3PersonalDataCARDTYPE卡產(chǎn)品編號String1.11.4PersonalDataSTAFF_CODECRM接入帳戶String1.1遠程寫卡系統(tǒng)分配的系統(tǒng)帳號，用于認證鑒權(quán),要求使用單DES進行加密1.5PersonalDataPASSWORDCRM接入密碼String1.1遠程寫卡系統(tǒng)分配的系統(tǒng)帳號密碼，用于認證鑒權(quán),要求使用單DES進行加密1.6PersonalDataSTAFF_ID工號String1.11.7PersonalDataSTAFF_NAME工號名稱String1.11.8PersonalDataCHANNEL_ID營業(yè)廳標識S

21、tring1.11.9PersonalDataCHANNEL_NAME營業(yè)廳名稱String1.11.10PersonalDataPROVINCIAL歸屬省省代碼String1.11.11PersonalDataCUST_NAME歸屬省客戶名稱String1.1遠程寫卡客戶端接口返回參數(shù)：輸出序號父屬性屬性編碼屬性名稱數(shù)據(jù)類型長度出現(xiàn)次數(shù)說明1ResultData返回內(nèi)容1.1XML格式1.1ResultDataBUSINESS_TYPEString1.10:新開戶寫卡；1：本省補換卡開戶寫卡1.2ResultDataRESULT_CODE結(jié)果String1.10：成功；1：失敗1.3Resu

22、ltDataRESULT_MESSAGE結(jié)果描述String1.11.4ResultDataMDN號碼String1.11.5ResultDataIMSIIMSIString1.11.6ResultDataICCSERIAL空卡序列號String1.11.7ResultDataICCIDICCIDString1.11.8ResultDataUIMIDUIMIDString1.11.9ResultDataCARD_TYPE卡產(chǎn)品編號String1.13 接口可測性設計3.1 接口測試環(huán)境搭建搭建兩套RPS系統(tǒng)，一套假定為上海RPS，一套為本省RPS，另外搭建一套CRM模擬系統(tǒng)環(huán)境，建議CRM模擬

23、系統(tǒng)與RPS系統(tǒng)部署在兩個獨立的機器上，可以網(wǎng)絡互聯(lián)。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