DB12T 1233-2023 政務(wù)信息資源共享政務(wù)信息資源目錄編碼規(guī)范

發(fā)布發(fā)布天津市市場監(jiān)督管理委員會2023090120230719ICS35.240.01CCSICS35.240.01CCSL67天 津 市 地 方 標(biāo) 準(zhǔn)DB12/T1232—2023政務(wù)信資源共享 數(shù)據(jù)交技術(shù)規(guī)范Governmentinfomationresourcessharing-DataexchangingtechniquespecificationDB12/T1232DB12/T1232—2023II前 言本文按照GB/T1.1—2020《標(biāo)化作導(dǎo)則 第部分標(biāo)準(zhǔn)文的結(jié)和起規(guī)則的起草。本文件由天津市互聯(lián)網(wǎng)信息辦公室提出并歸口。DB12/T1232DB12/T1232—2023DB12/T1232—DB12/T1232—2023d) json、xml政務(wù)信息資源共享 數(shù)據(jù)交換技術(shù)規(guī)范范圍本文件規(guī)定了政務(wù)信息資源共享交換采用的數(shù)據(jù)格式、數(shù)據(jù)交換方式、數(shù)據(jù)交換流程和技術(shù)要求。本文件適用于市、區(qū)兩級政務(wù)部門及公共服務(wù)機(jī)構(gòu)開展政務(wù)信息資源共享工作。（DB12/T1230-2023 DB12/T1233-2023 DB12/T1230-2023、DB12/T1233-2023界定的以及下列術(shù)語和定義適用于本文件。3.1資源供方 resourceprovider通過共享交換平臺提供政務(wù)信息資源的政務(wù)部門或公共服務(wù)機(jī)構(gòu)。注：資源提供方負(fù)責(zé)編制信息資源目錄，發(fā)布相應(yīng)信息資源。3.2資源用方 resourceconsumer通過共享交換平臺申請、獲取政務(wù)信息資源的政務(wù)部門或公共服務(wù)機(jī)構(gòu)。3.3數(shù)據(jù)換 dataexchanging政務(wù)部門或公共服務(wù)機(jī)構(gòu)間通過共享交換平臺進(jìn)行政務(wù)信息資源傳輸?shù)倪^程。3.4政務(wù)息源錄統(tǒng) governmentinformationresourcecatalogsystem對信息資源目錄進(jìn)行全生命周期管理的系統(tǒng)，具有信息資源編目、導(dǎo)航、檢索以及發(fā)起數(shù)據(jù)共享申請等功能。3.5服務(wù)理線 servicemanagementbus用于接口的注冊、發(fā)布及調(diào)用管理，支撐接口服務(wù)形式的數(shù)據(jù)交換。數(shù)據(jù)交換內(nèi)容包括結(jié)構(gòu)化文件、非結(jié)構(gòu)化文件、庫表數(shù)據(jù)、接口傳輸數(shù)據(jù)：csv、xlsx、rdf；pdf、docx；OracleMySQL、GBase1數(shù)據(jù)交換形式包括以下三種：數(shù)據(jù)交換的參與對象包括：資源使用方、資源提供方、共享交換平臺。數(shù)據(jù)交換業(yè)務(wù)邏輯如圖1：圖1 數(shù)據(jù)換務(wù)輯基于共享交換平臺的數(shù)據(jù)交換業(yè)務(wù)流程見圖2。2圖2 數(shù)據(jù)換務(wù)程資源提供方與資源使用方應(yīng)遵循以下數(shù)據(jù)庫表交換規(guī)則：“T_示例：（3070020000013/000017”31GUIDGUID3DB12/T1232DB12/T1232—2023DB12/T1232DB12/T1232—2023表1 交換則求段序號字段含義字段名數(shù)據(jù)類型數(shù)據(jù)格式是否可空說明1當(dāng)前數(shù)據(jù)的物理創(chuàng)建時間TOPIC_ADD_TIME日期型DATETIME非空記錄數(shù)據(jù)在部門前置節(jié)點數(shù)據(jù)庫中第一次入庫的物理時間2當(dāng)前數(shù)據(jù)的最后修改時間TOPIC_UPDATE_TIME日期型DATETIME非空記錄數(shù)據(jù)在部門前置節(jié)點數(shù)據(jù)庫中最后一次修改入庫的物理時間3數(shù)據(jù)狀態(tài)標(biāo)識位OPERATETYPE字符型VARCHAR(2)非空I：新增U：修改D：刪除資源提供方在準(zhǔn)備、組織數(shù)據(jù)交換時應(yīng)遵循以下要求：（）GUIDGUID，TOPIC_ADD_TIMETOPIC_UPDATE_TIME）OPERATETYPETOPIC_UPDATE_TIME字OPERATETYPEU“D”；TOPIC_ADD_TIMETOPIC_UPDATE_TIMEOPERATETYPEOPERATETYPEIU”“D掛接數(shù)據(jù)字段為“DATEDATETIME”等日期型時，應(yīng)寫入實際時間值，不應(yīng)寫入“0000-00-00”、“0000-00-0000:00:00數(shù)據(jù)庫表交換業(yè)務(wù)流程，包括但不限于：4根據(jù)前置節(jié)點服務(wù)器操作系統(tǒng)種類，應(yīng)明確交換文件的存放路徑，例如：Windows：d:/tjgxLinux：/home/user/others/tjgx在前置節(jié)點中創(chuàng)建存放推送或接收文件的文件夾，文件夾命名規(guī)則為“T_”+“信息類編碼”，其中信息類編碼中“/”應(yīng)改為“_”，并對文件夾授予讀寫權(quán)限，文件夾命名規(guī)則示例如下：“政務(wù)信息資源目錄（信息類）名稱：統(tǒng)計年報”“信息類編碼：3070020000016/000012”“文件夾名稱：T_3070020000016_000012”文件交換業(yè)務(wù)流程，包括但不限于：GBK（IPHTTPOpenAPI、RESTfulAPI、WebServiceHTTPOpenAPIRESTfulAPI5669.3 接入規(guī)范/限制具體要求應(yīng)符合表4。接口發(fā)布，即將接入服務(wù)管理總線的接口按照統(tǒng)一標(biāo)準(zhǔn)進(jìn)行發(fā)布并按需提供服務(wù)，具體要求包括：HTTPOpenAPI、RESTfulAPIWebServiceUTF-8；3A.2。表3 接口布息明UTF-82A.1。表2 接口入息明參數(shù)參數(shù)說明接口名稱接口名稱功能說明接口功能描述URL樣式寫明調(diào)用接口的URL樣式接入接口協(xié)議寫明支持的協(xié)議，如：HTTPOpenAPI、RESTfulAPI、WebService等請求方式支持POST、GET、POST/GET等方式接口參數(shù)寫明參數(shù)名稱、參數(shù)說明、參數(shù)數(shù)據(jù)類型、參數(shù)傳值要求等提交數(shù)據(jù)舉例對于特定格式（json、xml格式等）參數(shù)應(yīng)舉例說明返回HTTP狀態(tài)寫明返回HTTP狀態(tài)所對應(yīng)的狀態(tài)說明返回數(shù)據(jù)參數(shù)寫明返回參數(shù)的名稱、參數(shù)說明等返回數(shù)據(jù)格式字符串/json/xml或其他格式應(yīng)舉例說明返回數(shù)據(jù)舉例對特定格式（json、xml、自定義格式等）的返回參數(shù)應(yīng)提供示例說明錯誤代碼對錯誤信息進(jìn)行定義，并進(jìn)行詳細(xì)說明接口功能說明說明涉及接口的功能接口地址服務(wù)管理總線接口地址接口提供部門接口提供部門（即政務(wù)信息資源目錄所屬部門）適配參數(shù)說明提供適配參數(shù)說明接口協(xié)議說明支持的協(xié)議，如：HTTPOpenAPI、RESTfulAPI、WebService等接口認(rèn)證參數(shù)說明涉及接口接入服務(wù)管理總線認(rèn)證的相關(guān)參數(shù)77表4 協(xié)議換求明接入接口協(xié)議發(fā)布接口協(xié)議接入規(guī)范/限制HTTPHTTP應(yīng)支持GET/PUT/POST/DELETE參數(shù)傳遞Query：Key-Value形式Body：Key-Value/JSON/byte[]形式3.應(yīng)支持RESTful風(fēng)格接入，如：http://localhost:8081/abc/{userId}/search4.應(yīng)支持HTTP返回結(jié)果透傳，不做任何變換加工WebServiceHTTP應(yīng)使用AuthorizationWSSE格式的用戶名密碼接入SOAPHeader對于anytypews:anyType”接入后端WS支持的bindType是Document-LiteralWrapperorUnwrapper)返回結(jié)果是將SOAPXML轉(zhuǎn)化為JSON格式HTTPWebService應(yīng)以SOAP1.1格式發(fā)布WebService服務(wù)，并提供標(biāo)準(zhǔn)的WSDL應(yīng)使用服務(wù)管理總線提供的SDK傳遞AccessKeysignature等Header信息88code：0msg：datas：rownum：rows：C_NAME：C_GENDER：BIRTH_CERTIFICATION_NUMBER：FATHER_NAME：FATHER_ID_NUMBER：FATHER_ETHNIC_GROUP：MOTHER_NAME：MOTHER_ID_NUMBER：MOTHER_ETHNIC_GROUP：}調(diào)用示例：根據(jù)接口實際情況填寫。附錄A（資料性）服務(wù)接口說明示例接口名稱：婚姻信息核驗接口功能說明：婚姻信息核驗API實現(xiàn)根據(jù)業(yè)務(wù)請求編號、身份證號碼、性別進(jìn)行查詢，所有查詢參數(shù)為必填項。URL樣式：http://localhost:8081/abc/{userId}/search請求方式：POSTURL參數(shù)：返回HTTPJSON{99調(diào)用