1、ICS 35.240L 73備案號:54170-2017DB11北京市地方標(biāo)準(zhǔn)DB11/T 1391.32017網(wǎng)格化社會服務(wù)管理信息系統(tǒng)技術(shù)規(guī)范第 3 部分：通用數(shù)據(jù)接口Grid social services and management information system technical specificationPart 3:General data interface2017 - 03 - 22 發(fā)布2017 - 07 - 01 實施北京市質(zhì)量技術(shù)監(jiān)督局發(fā) 布DB11/T 1391.32017目次前言II范圍1縮略語1接口架構(gòu)1整體框架1調(diào)用流程1技術(shù)要求2接口調(diào)用信息結(jié)構(gòu)2請

2、求信息結(jié)構(gòu)2返回信息結(jié)構(gòu)4異常處理5重試機(jī)制5事務(wù)機(jī)制5安全要求5用戶認(rèn)證5信息加密5備份5附錄 A（資料性附錄）通用數(shù)據(jù)接口使用示例6IDB11/T 1391.32017前言DB11/T 1391網(wǎng)格化社會服務(wù)管理信息系統(tǒng)技術(shù)規(guī)范分為以下3個部分：第1部分：總則；第2部分：數(shù)據(jù)；第3部分：通用數(shù)據(jù)接口。 本部分為DB11/T 1391的第3部分。本部分按照GB/T 1.1-2009給出的規(guī)則起草。本部分由北京市社會建設(shè)工作辦公室提出并歸口。本部分由北京市社會建設(shè)工作辦公室組織實施。本部分的起草單位：北京市社會建設(shè)工作辦公室、北京市密云區(qū)社會建設(shè)工作辦公室、北京長風(fēng)信息技術(shù)產(chǎn)業(yè)聯(lián)盟、北京數(shù)字政

3、通科技股份有限公司、方正國際軟件有限公司、首都信息發(fā)展股份有限公司、北京有生博大軟件技術(shù)有限公司、北京國研數(shù)通軟件技術(shù)有限公司、北京中關(guān)村科技發(fā)展（控股） 股份有限公司。本部分的主要起草人：王麗竹、劉志杰、唐志華、楊國林、李浩、張同銀、紀(jì)海明、冷禎鵬、宗君、王曉娟、張婷、曹芹、李悅、龐奎、徐峰、趙斌、吳傳強(qiáng)、常利紅、吳花春、黃雷。IIDB11/T 1391.32017網(wǎng)格化社會服務(wù)管理信息系統(tǒng)技術(shù)規(guī)范 第 3 部分：通用數(shù)據(jù)接口范圍本部分規(guī)定了網(wǎng)格化社會服務(wù)管理信息系統(tǒng)中通用數(shù)據(jù)接口的接口架構(gòu)、接口調(diào)用信息結(jié)構(gòu)、異常處理及安全要求。本部分適用于各級網(wǎng)格化社會服務(wù)管理信息系統(tǒng)之間、各級網(wǎng)格化社會

4、服務(wù)管理信息系統(tǒng)與相關(guān)外圍信息系統(tǒng)之間的信息采集、處理與共享交換?？s略語SOAP 簡單對象訪問協(xié)議（Simple Object Access Protocol)WSDL Web Service描述語言（Web Services Description Language） XML可擴(kuò)展標(biāo)記語言(Extensible Markup Language)XSDXML結(jié)構(gòu)定義 (XML Schema Definition )接口架構(gòu)整體框架通用數(shù)據(jù)接口實現(xiàn)機(jī)制如圖1。圖1通用數(shù)據(jù)接口框架結(jié)構(gòu)圖網(wǎng)格化社會服務(wù)管理采用基于SOAP協(xié)議的Web Service技術(shù)來實現(xiàn)不同系統(tǒng)之間的信息傳輸；進(jìn)行信息傳輸?shù)母?/p>

5、子系統(tǒng)應(yīng)通過發(fā)布Web Service服務(wù)，提供數(shù)據(jù)交換接口，從而實現(xiàn)數(shù)據(jù)、業(yè)務(wù)的交互。網(wǎng)格化社會服務(wù)管理系統(tǒng)中的運(yùn)行管理子系統(tǒng)對訪問接口的對接系統(tǒng)進(jìn)行身份認(rèn)證和權(quán)限認(rèn)證。調(diào)用流程接口調(diào)用流程如圖2所示。1網(wǎng)格化社會服務(wù)管理系統(tǒng)Web Service服務(wù)DB11/T 1391.32017返回結(jié)果服務(wù)請求對接系統(tǒng)圖2接口調(diào)用流程具體流程如下：各對接系統(tǒng)向 Web Service 服務(wù)發(fā)送服務(wù)請求；Web Service 服務(wù)收到服務(wù)請求后，進(jìn)行相應(yīng)的操作并返回結(jié)果；Web Service 服務(wù)宜支持以下四種調(diào)用模式:簡單請求應(yīng)答模式，即一次請求對應(yīng)一次應(yīng)答或者沒有應(yīng)答；多次應(yīng)答模式，即一次請求對

6、應(yīng)多次應(yīng)答；混合應(yīng)答模式，即對請求后的應(yīng)答不能完成全部數(shù)據(jù)傳送，網(wǎng)格化社會服務(wù)管理信息系統(tǒng)還需要通過其他方式把完整數(shù)據(jù)提供給服務(wù)請求方；訂購?fù)ㄖＪ剑捶?wù)請求方訂購網(wǎng)格化社會服務(wù)管理信息系統(tǒng)發(fā)布的主題，當(dāng)與訂購主題相關(guān)的事件發(fā)生時，網(wǎng)格化社會服務(wù)管理信息系統(tǒng)通知服務(wù)請求方。技術(shù)要求接口技術(shù)要求包括：信息描述語言遵守 WSDL Version1.2。XML 數(shù)據(jù)的消息格式遵守 SOAP 規(guī)范。XML 數(shù)據(jù)使用 XSD 進(jìn)行描述。編碼格式采用 UTF-8。接口調(diào)用信息結(jié)構(gòu)請求信息結(jié)構(gòu)接口的請求信息采用XML格式，其XSD定義如圖3所示。請求信息分成兩個部分：第一部分是控制信息，包括協(xié)議版本、服務(wù)

7、請求系統(tǒng)ID、服務(wù)請求ID、加密方案、請求者身份等；第二部分是請求信息的具體內(nèi)容。請求信息的擴(kuò)展方法可參考附錄A。2DB11/T 1391.32017圖3請求信息 XSD請求信息XML格式見圖4，請求信息XML標(biāo)簽含義見表1。圖4請求信息 XML 格式3DB11/T 1391.32017表1請求信息 XML 標(biāo)簽含義序號XML 標(biāo)簽標(biāo)簽說明1DataCenterXML根標(biāo)簽2Request服務(wù)請求信息子標(biāo)簽3Version協(xié)議版本號4SystemID服務(wù)請求系統(tǒng) ID5SessionID服務(wù)請求 ID6EncryptionScheme加密方案，即對后續(xù)各 XML 元素內(nèi)容進(jìn)行加密時采用的加密方

8、式。0 表示不加密7Authentication請求者身份子標(biāo)簽8UserName用戶名稱9Password用戶密碼10Ext1預(yù)留標(biāo)簽，用于擴(kuò)展后續(xù)控制信息11Ext2預(yù)留標(biāo)簽，用于擴(kuò)展后續(xù)控制信息12RequestData請求數(shù)據(jù)子標(biāo)簽，可以根據(jù)需要進(jìn)一步擴(kuò)展返回信息結(jié)構(gòu)接口的返回信息采用XML格式，其XSD定義如圖5所示。請求信息包括兩個部分：第一部分是控制信息，包括服務(wù)請求ID和加密方案；第二部分是返回信息，包括返回狀態(tài)和返回數(shù)據(jù)。返回數(shù)據(jù)的擴(kuò)展方法可參考附錄A。圖5返回信息 XSD返回信息XML格式見圖6，返回信息XML標(biāo)簽含義見表2。4DB11/T 1391.32017圖6返回信息

9、 XML 格式序號XML 標(biāo)簽標(biāo)簽說明1DataCenterXML根標(biāo)簽2Response返回信息子標(biāo)簽3SessionID服務(wù)請求 ID4EncryptionScheme加密方案，即對后續(xù)各 XML 元素內(nèi)容進(jìn)行加密時采用的加密方式。0 表示不加密5ReturnMessage返回狀態(tài)子標(biāo)簽6Code返回代碼7Message返回狀態(tài)信息8ResponseData返回數(shù)據(jù)子標(biāo)簽，可以根據(jù)需要進(jìn)一步擴(kuò)展表2返回信息 XML 標(biāo)簽含義異常處理重試機(jī)制調(diào)用方調(diào)用數(shù)據(jù)接口服務(wù)，最多嘗試3次，即： 第1次調(diào)用失敗、出現(xiàn)異常，重新調(diào)用該接口； 第2次調(diào)用失敗、出現(xiàn)異常，再次調(diào)用該接口； 第3次調(diào)用失敗，出現(xiàn)

10、異常，則不再重試。事務(wù)機(jī)制在調(diào)用數(shù)據(jù)接口進(jìn)行提交、修改、刪除等數(shù)據(jù)操作時，應(yīng)提供事務(wù)處理機(jī)制。安全要求用戶認(rèn)證5DB11/T 1391.32017應(yīng)提供對數(shù)據(jù)接口服務(wù)調(diào)用者的認(rèn)證機(jī)制。a）服務(wù)調(diào)用者在調(diào)用接口服務(wù)時應(yīng)對調(diào)用者進(jìn)行身份驗證；應(yīng)定期對身份驗證信息進(jìn)行更新； b）宜為不同的服務(wù)調(diào)用者分配不同權(quán)限；c）宜為不同的操作限定不同的交互方式。在進(jìn)行提交、修改、刪除等數(shù)據(jù)操作時，宜針對每次操作分別進(jìn)行身份認(rèn)證；在進(jìn)行查詢操作時，可以采取一次身份認(rèn)證多次查詢的方式。信息加密宜對請求參數(shù)中的身份元素和返回參數(shù)中的敏感數(shù)據(jù)進(jìn)行加密處理；對 XML 加密可參照 W3C 組織的 XML 加密標(biāo)準(zhǔn)；加密方

11、法宜采用對稱加密和非對稱加密相結(jié)合的方法。備份數(shù)據(jù)接口服務(wù)的服務(wù)器宜提供雙機(jī)熱備。6DB11/T 1391.32017附錄A（資料性附錄） 通用數(shù)據(jù)接口使用示例本示例適用于各級網(wǎng)格化社會服務(wù)管理信息系統(tǒng)之間、各級網(wǎng)格化社會服務(wù)管理信息系統(tǒng)與相關(guān)外圍信息系統(tǒng)之間的數(shù)據(jù)接口服務(wù)調(diào)用設(shè)計和應(yīng)用。本示例以某信息系統(tǒng)向某區(qū)級網(wǎng)格化社會服務(wù)管理信息系統(tǒng)調(diào)用“查詢街道信息”接口服務(wù)為例，說明通用數(shù)據(jù)接口的設(shè)計和使用方法。功能本示例實現(xiàn)的功能是通過街道編碼查詢街道信息。接口擴(kuò)展設(shè)計在實現(xiàn)某些具體業(yè)務(wù)需求時，應(yīng)對通用數(shù)據(jù)接口進(jìn)行進(jìn)一步擴(kuò)展設(shè)計。對通用數(shù)據(jù)接口的擴(kuò)展設(shè)計包括交互模式定義、請求信息的RequestD

12、ata標(biāo)簽擴(kuò)展定義和返回信息的ResponseData標(biāo)簽擴(kuò)展定義。本示例交互模式選擇簡單請求應(yīng)答模式，RequestData標(biāo)簽和ResponseData標(biāo)簽的擴(kuò)展定義見表A.1。表A.1接口擴(kuò)展信息 XML 標(biāo)簽含義序號XML 標(biāo)簽標(biāo)簽說明1ReqestType請求服務(wù)類型。在 RequestData 標(biāo)簽下。應(yīng)為所有數(shù)據(jù)接口服務(wù)定義請求服務(wù)類型代碼。如：getStreeInfo：查詢街道信息getCommunityInfo：查詢社區(qū)信息2StreetID街道 ID 號。在 RequestData 標(biāo)簽下3StreetName街道名稱。在 ResponseData 標(biāo)簽下4StreetAddress街道地址。在 ResponseData 標(biāo)簽下5Code0：成功-1：調(diào)用的服務(wù)不存在-2：沒有查到符合條件的信息請求信息請求信息的XML格式見圖A.1。7DB11/T 1391.320171.0100 98563465324 0user100 psd100 getStreetInfo 123456