B31-T 999.2-2016 網(wǎng)上政務(wù)大廳接入技術(shù)規(guī)范 第2部分：平臺數(shù)據(jù)交換接口及數(shù)據(jù)信封

網(wǎng)上政務(wù)大廳接入技術(shù)規(guī)范2016-08-12發(fā)布2016-09-01實(shí)施 I 1 1 1 1 2 附錄A(規(guī)范性附錄)發(fā)送數(shù)據(jù)文件格式XMLSCHEMA 附錄B(規(guī)范性附錄)接收數(shù)據(jù)文件格式XMLSCHEMA 附錄C(規(guī)范性附錄)接入部門平臺地址 IDB31/T999《網(wǎng)上政務(wù)大廳接入技術(shù)規(guī)范》分為5個部分：——第1部分：總則；——第2部分：平臺數(shù)據(jù)交換接口及數(shù)據(jù)信封；——第3部分：業(yè)務(wù)協(xié)同數(shù)據(jù)交換格式；——第4部分：單部門事項(xiàng)信息共享數(shù)據(jù)交換格式；——第5部分：統(tǒng)一編碼規(guī)則及獲取。本部分為DB31/T999的第2部分。本部分按照GB/T1.1—2009給出的規(guī)則起草。本部分由上海市政府辦公廳提出。本部分由上海市社會管理和公共服務(wù)標(biāo)準(zhǔn)化技術(shù)委員會歸口。本部分起草單位：上海市政府公眾信息網(wǎng)管理中心、萬達(dá)信息股份有限公司、上海市質(zhì)量和標(biāo)準(zhǔn)化研究院。1DB31/T999的本部分規(guī)定了網(wǎng)上政務(wù)大廳接入中的基礎(chǔ)數(shù)據(jù)交換接入的專項(xiàng)技術(shù)規(guī)范。下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文GB/T2260中華人民共和國行政區(qū)劃代碼GB/T19488.1-2004電子政務(wù)數(shù)據(jù)元第1部分：設(shè)計和管理規(guī)范4縮略語IP:網(wǎng)絡(luò)互連協(xié)議(InternetProtocol)UTF-8:一種針對1到4個字節(jié)編碼UNICODE字符的可變長度字符編碼(8-bitUnicodeTrans-ODBC:開放數(shù)據(jù)庫互連(OpenDatabaseJDBC:java數(shù)據(jù)庫連接(JavaDataBaseConnectivity)2FTP:文件傳輸協(xié)議(FileTransferProtocol)5數(shù)據(jù)交換接口5.1接口說明數(shù)據(jù)交換提供WebService、前置數(shù)據(jù)庫和XML文件三種接口，數(shù)據(jù)交換將依托接入前置設(shè)備完成。5.1.2數(shù)據(jù)交換地址數(shù)據(jù)交換地址的格式中包含路由信息，格式要求如下：a)市級平臺是主數(shù)據(jù)交換核心，地址為Center;b)接入適配器的地址是一個純英文字母、純數(shù)字或由英文字母和數(shù)字組合的字符串，不能包含其他符號，該字符串必須唯一，且長度不超過20位。如A115或SHSLSH都為合法的地址格式；c)接人系統(tǒng)的地址為結(jié)點(diǎn)的地址加上分隔符半角句號“.”,再加上接入系統(tǒng)代號。接入系統(tǒng)代號是由英文字母和數(shù)字組成的字符串，不能包含任何其他符號，該字符串必須唯一，且長度不超過20位。如A115.S025或SHSLSH.OA都為合法的地址格式。數(shù)據(jù)交換地址取值參見附錄C,區(qū)級接入地址參考GB/T2260。5.1.3數(shù)據(jù)發(fā)送和接收數(shù)據(jù)交換中最重要的兩個環(huán)節(jié)就是發(fā)送數(shù)據(jù)和接收數(shù)據(jù)，針對WebService、前置數(shù)據(jù)庫和XML文件三種接口有不同的發(fā)送及接收結(jié)構(gòu)，具體的發(fā)送數(shù)據(jù)文件格式參見附錄A,接收數(shù)據(jù)文件格式參見附錄B。5.1.4二進(jìn)制文件處理業(yè)務(wù)中若文件較大或者文件較多，會提供單獨(dú)的文件交換接口，以單個文件的方式進(jìn)行交換，若單個文件仍舊過于龐大，要使用壓縮工具將文件分卷成多個5MB以下的RAR格式文件，分開交換，接收系統(tǒng)以此格式合并成原始文件，文件在傳輸過程中將采用base64進(jìn)行編碼。數(shù)據(jù)交換的回復(fù)分為兩種，一種由接收方應(yīng)用給出的應(yīng)用回復(fù)，一種由數(shù)據(jù)交換系統(tǒng)給出的系統(tǒng)回復(fù)。在發(fā)送數(shù)據(jù)時，可以通過設(shè)置“需要送達(dá)回復(fù)”標(biāo)志(CallbackFlag),要求接收方在接收后給出回復(fù)，回復(fù)的格式由雙方系統(tǒng)約定，或由具體的數(shù)據(jù)交換應(yīng)用標(biāo)準(zhǔn)規(guī)范，一般情況下會參照表1所描述的方式進(jìn)行回復(fù)。3表1應(yīng)用回復(fù)情況表唯一編號系統(tǒng)指定改為原來的目標(biāo)地址關(guān)鍵標(biāo)識版本信息第一行為數(shù)據(jù)的原始唯一編號，第二行為“原始源地址-原始目標(biāo)地址”,行之間以“\r\n”分隔對具體內(nèi)容的摘要簽名回復(fù)請求或回復(fù)標(biāo)志“正確送達(dá)”、“業(yè)務(wù)相關(guān)信息有誤”、“業(yè)務(wù)不明異?！蹦繕?biāo)地址改為原來的源地址如果在數(shù)據(jù)交換過程中產(chǎn)生基本信息錯誤、數(shù)據(jù)結(jié)構(gòu)錯誤、權(quán)限問題以及其他一些不明原因問題，交換系統(tǒng)會產(chǎn)生異常，從而導(dǎo)致數(shù)據(jù)交換中止，這些異常會由系統(tǒng)發(fā)給發(fā)送方。數(shù)據(jù)的格式與發(fā)送的數(shù)據(jù)結(jié)構(gòu)基本相同，表2列出系統(tǒng)回復(fù)的處理方式。表2系統(tǒng)回復(fù)情況表唯一編號系統(tǒng)指定關(guān)鍵標(biāo)識版本信息第一行為數(shù)據(jù)的原始唯一編號，第二行為“原始源地址-原始目出錯原因(代碼),行之間以"\r\n"分隔對具體內(nèi)容的摘要簽名回復(fù)請求或回復(fù)標(biāo)志目標(biāo)地址改為原來的源地址回復(fù)的內(nèi)容將在20min內(nèi)送達(dá)，實(shí)際的回復(fù)送達(dá)時間視網(wǎng)絡(luò)環(huán)境和實(shí)時的系統(tǒng)處理數(shù)據(jù)量而定。4接入系統(tǒng)的數(shù)據(jù)交換處理接口方法見表3。方法說明登出發(fā)送信息向目標(biāo)方發(fā)送信息數(shù)據(jù)，信息的長度不要超過5MByte確認(rèn)已經(jīng)成功接收信息，并處理完畢。這樣該信息將不會被重發(fā)，否則注1:接入系統(tǒng)的數(shù)據(jù)交換處理接口的WSDL描述文件可從適配器上獲得，假設(shè)適配器IP地址為,端口為8080,則WSDL訪問地址為：http://:8080/EXDATA/services/baseHandleService?wsdl。注2:方法調(diào)用需要先進(jìn)行登錄，未登錄或登錄異常的情況下將拋出AuthenticationException。用戶名口令登錄接口的方法參數(shù)見表4。xmlns:tns="/shen3/HandleS輸出用戶名口令登錄接口的輸入見表5。5中文名稱1字符串是2字符串是用戶名口令登錄接口的輸出見表6。中文名稱1字符串是證書登錄接口的方法參數(shù)見表7。xmlns:tns="/shen3/HandleS輸出中文名稱1用戶證書一是2隨機(jī)數(shù)是3隨機(jī)數(shù)簽名字符串是證書登錄接口的輸出見表9。6中文名稱1字符串是登出接口的方法參數(shù)見表10。表10登出接口方法參數(shù)xmlns:tns="/shen3/HandleS輸出無登出接口的輸入見表11。中文名稱1字符串是發(fā)送信息接口的方法參數(shù)見表12。表12發(fā)送信息接口方法參數(shù)xmlns:tns="/shen3/Handle輸出無發(fā)送信息接口的輸入見表13。7表13發(fā)送信息接口輸入中文名稱1字符串是2回復(fù)請求或回復(fù)標(biāo)志字符串否3一否4目標(biāo)地址字符串是5唯一編號(暫不使用)是6關(guān)鍵標(biāo)識字符串是7字符串否8字符串是9對具體內(nèi)容的摘要簽名否字符串是版本信息字符串是接收信息接口的方法參數(shù)見表14。表14接收信息接口方法參數(shù)xmlns:tns="/shen3/HandleS輸出接收信息接口的輸入見表15。表15接收信息接口輸入中文名稱1字符串是2是接收信息接口的輸出見表16。8表16接收信息接口輸出中文名稱1回復(fù)請求或回復(fù)標(biāo)志字符串否2一否3目標(biāo)地址字符串是4唯一編號是5關(guān)鍵標(biāo)識字符串是6字符串否7字符串是8對具體內(nèi)容的摘要簽名字符串否9字符串是字符串是版本信息字符串是接收確認(rèn)接口的方法參數(shù)見表17。表17接收確認(rèn)接口方法參數(shù)xmlns:tns="/shen3/HandleS輸出無接收確認(rèn)接口的輸入見表18。表18接收確認(rèn)接口輸入中文名稱1字符串是2否前置數(shù)據(jù)庫支持多種數(shù)據(jù)庫類型。按不同的接入系統(tǒng)創(chuàng)建獨(dú)立的數(shù)據(jù)庫用戶，該用戶能且僅能操9a)接入系統(tǒng)可根據(jù)實(shí)際情況選擇通過ODBC或JDBC的方式訪問前置數(shù)據(jù)庫；b)接入系統(tǒng)把需要發(fā)送的數(shù)據(jù)按一定格式插入發(fā)送表中，系統(tǒng)將定時取走數(shù)據(jù)并按指定目標(biāo)交默認(rèn)的發(fā)送數(shù)據(jù)表名為EXDATA_SENDING,可以配置成指定名稱。發(fā)送數(shù)據(jù)表結(jié)構(gòu)說明見表19。表19發(fā)送數(shù)據(jù)表結(jié)構(gòu)中文名稱類型最大長度是否必須1數(shù)據(jù)編號整型是2字符串是3關(guān)鍵標(biāo)識字符串是4版本信息字符串是5字符串是6操作類型字符串是7備注字符串否8具體內(nèi)容一否9對具體內(nèi)容的摘要簽名否回復(fù)請求或回復(fù)標(biāo)志字符串否目標(biāo)地址字符串是默認(rèn)的接收數(shù)據(jù)表名為EXDATA_RECEIVING,可以配置成指定名稱。接收數(shù)據(jù)表結(jié)構(gòu)說明見表20。表20接收數(shù)據(jù)表結(jié)構(gòu)中文名稱類型最大長度是否必須1數(shù)據(jù)編號整型是2字符串是3關(guān)鍵標(biāo)識字符串是4版本信息字符串是5字符串是表20(續(xù))中文名稱類型最大長度是否必須6操作類型字符串是7備注字符串否8具體內(nèi)容一否9對具體內(nèi)容的摘要簽名字符串否回復(fù)請求或回復(fù)標(biāo)志字符串否目標(biāo)地址字符串是默認(rèn)的接收數(shù)據(jù)表名為EXDATA_BACKU接入單位需根據(jù)接入系統(tǒng)不同創(chuàng)建不同的文件目錄。每個接入系統(tǒng)對應(yīng)三個a)接入系統(tǒng)可根據(jù)實(shí)際情況選擇通過SMB或FTP的方式傳輸XML文件；b)接入系統(tǒng)把需要發(fā)送的數(shù)據(jù)構(gòu)造成XML文件置入對應(yīng)發(fā)送目錄中，系統(tǒng)定時取走XML文發(fā)送數(shù)據(jù)文件的XML結(jié)構(gòu)示例為：示例：<key)某某某</key><value)002000109000<op)簽收</op>(signature)g/U7dDheQXr0m4VGcQ5LzOp5C7U=<<callback_flag)需要送達(dá)回復(fù)</callback_flag)發(fā)送數(shù)據(jù)文件結(jié)構(gòu)描述見表21。中文名稱1字符串是2關(guān)鍵標(biāo)識字符串是3版本信息字符串是4字符串是5字符串是6字符串否7內(nèi)容一否8內(nèi)容的摘要簽名字符串否9回復(fù)請求或回復(fù)標(biāo)志字符串否目標(biāo)地址字符串是接收數(shù)據(jù)文件的XML結(jié)構(gòu)示例為：示例：<?xmlversion="1.0"encoding="UTF-<key>某某某</key)<value>002000109000001</<signature)g/U7dDheQXr0m4VGcQ5LzOp5C7U=</sig<callback_flag>需要送達(dá)回復(fù)</callback_flag>接收數(shù)據(jù)文件結(jié)構(gòu)描述見表22。中文名稱1字符串是2字符串是3字符串是4字符串是5字符串是表22(續(xù))中文名稱6字符串否7一否8對具體內(nèi)容的摘要簽名字符串否9回復(fù)請求或回復(fù)標(biāo)志字符串否目標(biāo)地址字符串是表23數(shù)據(jù)類型及格式數(shù)據(jù)類型說明示例字符串每個漢字或全角字符(雙字節(jié)字符)的長度為2,串中只能包含50個漢字日期時間XML中格式：yyyy-MM-ddTHHUUID的標(biāo)準(zhǔn)類型包含32個16進(jìn)位數(shù)字，以連字號分為五各接口數(shù)據(jù)名對照見表24。表24各接口數(shù)據(jù)名對照數(shù)據(jù)項(xiàng)名前置數(shù)據(jù)庫數(shù)據(jù)項(xiàng)名數(shù)據(jù)項(xiàng)名唯一編號整型文件名(不包含后綴)字符串關(guān)鍵標(biāo)識字符串表24(續(xù))類型數(shù)據(jù)項(xiàng)名前置數(shù)據(jù)庫數(shù)據(jù)項(xiàng)名數(shù)據(jù)項(xiàng)名版本信息字符串字符串字符串字符串具體內(nèi)容對具體內(nèi)容的摘要簽名回復(fù)請求或回復(fù)標(biāo)志字符串目標(biāo)地址字符串通用數(shù)據(jù)說明見表25。表25通用數(shù)據(jù)說明說明唯一編號是是關(guān)鍵標(biāo)識是版本信息版本信息指具體內(nèi)容部分?jǐn)?shù)據(jù)結(jié)構(gòu)的版本，不同版本的同的是是是否否對具體內(nèi)容的摘要簽名這是對具體內(nèi)容原文進(jìn)行摘要處理后，再通過數(shù)字證書簽名后生成的字節(jié)其中摘要的SHA-1算法接口和數(shù)字證書簽名和校驗(yàn)算法否回復(fù)請求或回復(fù)標(biāo)志回復(fù)”,默認(rèn)取值為“無需送達(dá)回復(fù)”接收方根據(jù)判斷該值的取值來確定該信息是否為回復(fù)內(nèi)容。否目標(biāo)地址目標(biāo)地址指接收方結(jié)點(diǎn)的數(shù)據(jù)交換地址是具體的發(fā)送數(shù)據(jù)文件格式參見如下XMLSCHEMA定義：<?xmlversion="1.0"encoding="UTF-8"stand<xs:schemaxmlns:xs="/2001/XMLSchema"elementFormDefault= <xs:element<xs:elementref="memo"minOccurs="ref="data"minOccurs="ref="signature"minOccurs=ref="dest"max0ccurs="unbound<xs:maxLengthvalue="50"/><xs:maxLengthvalue="50"/><xs:restrictionbase="xs:string<xs:maxLengthvalue="50"/><xs:restrictionbase="x<xs:restrictionbase="x<xs:restrictionbase="x<xs:maxLengthvalue="200"/><xs:elementname="data"type="xs:base64Binary"/><xs:elementname="si<xs:restrictionbase="x<xs:maxLengthvalue="2000"/><xs:elementname="callback_flag"><xs:enumeration(xs:elementname="dest">value="無需送達(dá)回復(fù)"/>《xs:restrictionbase="xs:string"><?xmlversion="1.0"encoding="UTE-8"standal<xs:schemaxmlns:xs="/2001/XMLSchema"elem<xs:elementname="rece<xs:elementref="<xs:elementref="memo"minOc<xs:elementref="data"minOccurs="0"/><xs:elementref="signature"minOccurs="0"/><xs:elementref="callback_flag"minOccurs=<xs:elementname="source"><xs:restrictionbase="xs:string"><xs:maxLengthvalue="50"/><xs:restrictionbase="xs:string"><xs:maxLengthvalue="50"/><xs:elementname="ver<xs:restrictionbase="xs:string"><xs:maxLengthvalue="50"/><xs:restrictionbase="xs<xs:restrictionbase="xs<xs:restrictionbase="xs<xs:elementname="data"type="xs:base64Binary"/><xs:restrictionbase="xs<xs:elementname="callb<xs:restrictionbase="xsvalue="數(shù)據(jù)結(jié)構(gòu)有誤"/>value="