DB12-T 1231-2023 政務(wù)信息資源共享數(shù)據(jù)交換技術(shù)規(guī)范

ICS35.240.01CCSL6712Governmentinfomationresourcessharing-DataexchangingtechniquespecIDB12/T1231—2023本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件由天津市互聯(lián)網(wǎng)信息辦公室提出并歸口。本文件起草單位：天津市互聯(lián)網(wǎng)信息辦公室、天津市大數(shù)據(jù)管理中心、天津市標(biāo)準(zhǔn)化研究院。本文件主要起草人：邊柯柯、張永躍、劉津、由方嵐、袁琳、李丹陽(yáng)、宋萬(wàn)洋、張楠、李曉明。1DB12/T1231—2023政務(wù)信息資源共享數(shù)據(jù)交換技術(shù)規(guī)范本文件規(guī)定了政務(wù)信息資源共享交換采用的數(shù)據(jù)格式、數(shù)據(jù)交換方式、數(shù)據(jù)交換流程和技術(shù)要求。本文件適用于市、區(qū)兩級(jí)政務(wù)部門及公共服務(wù)機(jī)構(gòu)開展政務(wù)信息資源共享工作。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。DB12/T1230-2023政務(wù)信息資源共享總體框架DB12/T1233-2023政務(wù)信息資源共享政務(wù)信息資源目錄編碼規(guī)范3術(shù)語(yǔ)和定義DB12/T1230-2023、DB12/T1233-2023界定的以及下列術(shù)語(yǔ)和定義適用于本文件。3.1資源提供方resourceprovider通過(guò)共享交換平臺(tái)提供政務(wù)信息資源的政務(wù)部門或公共服務(wù)機(jī)構(gòu)。3.2資源使用方resourceconsumer通過(guò)共享交換平臺(tái)申請(qǐng)、獲取政務(wù)信息資源的政務(wù)部門或公共服務(wù)機(jī)構(gòu)。3.3數(shù)據(jù)交換dataexchanging政務(wù)部門或公共服務(wù)機(jī)構(gòu)間通過(guò)共享交換平臺(tái)進(jìn)行政務(wù)信息資源傳輸?shù)倪^(guò)程。3.4政務(wù)信息資源目錄系統(tǒng)governmentinformationresourcecatalogsystem對(duì)信息資源目錄進(jìn)行全生命周期管理的系統(tǒng)，具有信息資源編目、導(dǎo)航、檢索以及發(fā)起數(shù)據(jù)共享申請(qǐng)等功能。3.5服務(wù)管理總線servicemanagementbus用于接口的注冊(cè)、發(fā)布及調(diào)用管理，支撐接口服務(wù)形式的數(shù)據(jù)交換。4交換內(nèi)容數(shù)據(jù)交換內(nèi)容包括結(jié)構(gòu)化文件、非結(jié)構(gòu)化文件、庫(kù)表數(shù)據(jù)、接口傳輸數(shù)據(jù)：a)結(jié)構(gòu)化文件格式包括但不限于csv、xlsx、rdf；b)非結(jié)構(gòu)化文件格式包括但不限于pdf、docx；c)庫(kù)表數(shù)據(jù)包括但不限于Oracle、MySQL、GBase數(shù)據(jù)庫(kù)數(shù)據(jù)；2DB12/T1231—2023d)接口傳輸數(shù)據(jù)包括但不限于json、xml數(shù)據(jù)。5交換形式數(shù)據(jù)交換形式包括以下三種：a)數(shù)據(jù)庫(kù)表交換:通過(guò)前置節(jié)點(diǎn)交換實(shí)現(xiàn),適用于大體量、高時(shí)效性、周期性的結(jié)構(gòu)化數(shù)據(jù)交換場(chǎng)景，資源使用方通過(guò)共享批量獲取數(shù)據(jù)，與自有數(shù)據(jù)融合后可進(jìn)行綜合業(yè)務(wù)處理、統(tǒng)計(jì)分析、數(shù)據(jù)挖掘等應(yīng)用；b)文件交換:通過(guò)前置節(jié)點(diǎn)交換實(shí)現(xiàn),適用于無(wú)系統(tǒng)承載的結(jié)構(gòu)化、非結(jié)構(gòu)化文件交換場(chǎng)景；c)服務(wù)接口交換:通過(guò)服務(wù)管理總線注冊(cè)并發(fā)布服務(wù)接口方式實(shí)現(xiàn),適用于小數(shù)據(jù)包、高頻次、高時(shí)效性、周期性的數(shù)據(jù)交換場(chǎng)景，資源使用方通過(guò)調(diào)用服務(wù)接口進(jìn)行查詢、核驗(yàn)等應(yīng)用。數(shù)據(jù)交換的參與對(duì)象包括：資源使用方、資源提供方、共享交換平臺(tái)。數(shù)據(jù)交換業(yè)務(wù)邏輯如圖1：圖1數(shù)據(jù)交換業(yè)務(wù)邏輯6交換流程基于共享交換平臺(tái)的數(shù)據(jù)交換業(yè)務(wù)流程見圖2。a)資源使用方通過(guò)共享交換平臺(tái)檢索所需資源；b)資源使用方通過(guò)共享交換平臺(tái)對(duì)資源發(fā)起共享申請(qǐng)，申請(qǐng)中應(yīng)注明數(shù)據(jù)使用場(chǎng)景、聯(lián)系方式及其他要求信息；c)根據(jù)資源共享?xiàng)l件，無(wú)條件共享資源應(yīng)在共享交換平臺(tái)備案后獲??；有條件共享的資源，在申請(qǐng)?zhí)峤徊⒂少Y源提供方審核通過(guò)后獲取。3DB12/T1231—2023圖2數(shù)據(jù)交換業(yè)務(wù)流程7數(shù)據(jù)庫(kù)表交換7.1交換要求7.1.1初始設(shè)置資源提供方與資源使用方應(yīng)遵循以下數(shù)據(jù)庫(kù)表交換規(guī)則：a)數(shù)據(jù)庫(kù)表命名：前置節(jié)點(diǎn)數(shù)據(jù)庫(kù)中的庫(kù)表命名規(guī)則應(yīng)為“T_”+“信息類編碼”，其中信息類編碼中“/”應(yīng)改為“_”。信息類編碼即信息資源目錄類編碼，是標(biāo)識(shí)政務(wù)信息資源目錄的唯一編碼，編碼規(guī)則應(yīng)符合《政務(wù)信息資源共享政務(wù)信息資源目錄編碼規(guī)范》?！罢?wù)信息資源目錄（信息類）名稱：婚姻登記信息”“信息類編碼：3070020000013/000017”“庫(kù)表名稱：T_3070020000013_000017”b)交換規(guī)則要求字段：除完成業(yè)務(wù)字段創(chuàng)建外，數(shù)據(jù)庫(kù)表結(jié)構(gòu)中還應(yīng)增加時(shí)間戳及數(shù)據(jù)狀態(tài)標(biāo)記位，共3個(gè)字段，應(yīng)符合表1規(guī)范要求；c)添加注釋：資源提供方應(yīng)對(duì)數(shù)據(jù)庫(kù)表及業(yè)務(wù)字段添加注釋信息，便于理解業(yè)務(wù)含義；d)設(shè)置主鍵應(yīng)滿足以下條件之一：1)業(yè)務(wù)字段中存在作為此表主鍵的字段，應(yīng)設(shè)置此字段為主鍵；2)業(yè)務(wù)字段中不存在作為此表主鍵的字段，應(yīng)使用GUID字段作為主鍵，使用時(shí)需要在GUID字段中上傳能代表數(shù)據(jù)唯一標(biāo)識(shí)的主鍵值。4DB12/T1231—2023表1交換規(guī)則要求字段1237.1.2操作要求資源提供方在準(zhǔn)備、組織數(shù)據(jù)交換時(shí)應(yīng)遵循以下要求：a)數(shù)據(jù)庫(kù)中表結(jié)構(gòu)應(yīng)與政務(wù)信息資源目錄系統(tǒng)中注冊(cè)的信息類（信息項(xiàng)）相對(duì)應(yīng)（如字段類型、長(zhǎng)度、是否為必填項(xiàng)、主鍵等），若有表結(jié)構(gòu)改動(dòng)應(yīng)先在政務(wù)信息資源目錄系統(tǒng)中變更目錄，并由變更后目錄提供的庫(kù)表創(chuàng)建腳本語(yǔ)句進(jìn)行前置節(jié)點(diǎn)數(shù)據(jù)庫(kù)表結(jié)構(gòu)修改；b)掛接的數(shù)據(jù)庫(kù)表應(yīng)添加唯一標(biāo)識(shí)的主鍵字段，作為數(shù)據(jù)更新的依據(jù)；c)GUID字段作為主鍵的情況下，部門應(yīng)自行上傳能作為數(shù)據(jù)唯一標(biāo)識(shí)的數(shù)值，不能將GUID字段設(shè)置為自動(dòng)增長(zhǎng)或其他不符合標(biāo)準(zhǔn)的數(shù)值；d)當(dāng)部門第一次上傳數(shù)據(jù)時(shí)，TOPIC_ADD_TIME及TOPIC_UPDATE_TIME值應(yīng)保持一致（即賦予該字段當(dāng)前數(shù)據(jù)寫入時(shí)間），且OPERATETYPE字段內(nèi)容填“I”；e)當(dāng)部門需修改或刪除數(shù)據(jù)內(nèi)容時(shí)，除更新業(yè)務(wù)字段值外，應(yīng)同時(shí)修改TOPIC_UPDATE_TIME字段值為當(dāng)前數(shù)據(jù)寫入時(shí)間，OPERATETYPE字段賦值為“U”或“D”；f)TOPIC_ADD_TIME、TOPIC_UPDATE_TIME、OPERATETYPE三個(gè)字段都不應(yīng)為空，并且OPERATETYPE字段中只應(yīng)存在“I”、“U”、“D”三種值；“0000-00-0000:00:00”等無(wú)意義時(shí)間值。7.2交換流程數(shù)據(jù)庫(kù)表交換業(yè)務(wù)流程，包括但不限于：a)資源注冊(cè)：資源提供方通過(guò)共享交換平臺(tái)注冊(cè)政務(wù)信息資源，應(yīng)注明資源描述、共享類型、資源格式、更新頻率、信息項(xiàng)等資源目錄元數(shù)據(jù)信息，其中資源格式應(yīng)選擇“數(shù)據(jù)庫(kù)表”；b)注冊(cè)審核：共享交換平臺(tái)對(duì)資源提供方發(fā)起的資源注冊(cè)進(jìn)行審核，審核通過(guò)后，資源目錄狀態(tài)變?yōu)椤耙寻l(fā)布”；c)資源掛接審核：資源提供方將數(shù)據(jù)掛接到前置節(jié)點(diǎn)數(shù)據(jù)庫(kù)，并將數(shù)據(jù)掛接狀態(tài)設(shè)置為“掛接待審核”。1)滿足數(shù)據(jù)質(zhì)量檢查要求的，共享交換平臺(tái)審核通過(guò)，并將數(shù)據(jù)掛接狀態(tài)調(diào)整為“已掛接”；2)不滿足數(shù)據(jù)質(zhì)量檢查要求的，共享交換平臺(tái)將數(shù)據(jù)掛接狀態(tài)調(diào)整為“掛接不通過(guò)”，并將問(wèn)題反饋給資源提供部門，部門調(diào)整完成后再次進(jìn)行掛接操作。5DB12/T1231—2023d)資源掛接審核通過(guò)后，共享交換平臺(tái)按資源提供方設(shè)定的更新頻率定期進(jìn)行數(shù)據(jù)抽??；e)資源使用方在資源申請(qǐng)備案通過(guò)后，在本方前置節(jié)點(diǎn)數(shù)據(jù)庫(kù)中創(chuàng)建庫(kù)表結(jié)構(gòu)；f)共享交換平臺(tái)根據(jù)共享申請(qǐng)約定，向資源使用方前置節(jié)點(diǎn)數(shù)據(jù)庫(kù)推送數(shù)據(jù)；g)數(shù)據(jù)獲取后，資源使用方應(yīng)向資源提供方確認(rèn)獲取數(shù)據(jù)的入庫(kù)時(shí)間、入庫(kù)記錄數(shù)量等。8文件交換8.1交換要求8.1.1文件存放路徑根據(jù)前置節(jié)點(diǎn)服務(wù)器操作系統(tǒng)種類，應(yīng)明確交換文件的存放路徑，例如：Windows：d:/tjgxLinux：/home/user/others/tjgx8.1.2文件夾命名規(guī)則在前置節(jié)點(diǎn)中創(chuàng)建存放推送或接收文件的文件夾，文件夾命名規(guī)則為“T_”+“信息類編碼”，其中信息類編碼中“/”應(yīng)改為“_”，并對(duì)文件夾授予讀寫權(quán)限，文件夾命名規(guī)則示例如下：“政務(wù)信息資源目錄（信息類）名稱：統(tǒng)計(jì)年報(bào)”“信息類編碼：3070020000016/000012”“文件夾名稱：T_3070020000016_000012”8.2交換流程文件交換業(yè)務(wù)流程，包括但不限于：a)資源注冊(cè)：資源提供方通過(guò)共享交換平臺(tái)注冊(cè)政務(wù)信息資源，應(yīng)注明資源描述、共享類型、資源格式、更新頻率、信息項(xiàng)等資源目錄元數(shù)據(jù)信息，其中資源格式應(yīng)選擇“文件”；b)注冊(cè)審核：共享交換平臺(tái)對(duì)資源提供方發(fā)起的資源注冊(cè)進(jìn)行審核，審核通過(guò)后，資源目錄狀態(tài)變?yōu)椤耙寻l(fā)布”；c)資源掛接審核：資源提供方將資源文件上傳至前置節(jié)點(diǎn)文件存放路徑中，文件上傳工具或程序需將編碼格式設(shè)置為“GBK”，并將資源掛接狀態(tài)設(shè)置為“掛接待審核”；d)資源掛接審核通過(guò)后，共享交換平臺(tái)按照資源提供方設(shè)定的更新頻率定期進(jìn)行文件抽??；e)資源使用方在資源申請(qǐng)備案通過(guò)后，按照文件夾命名規(guī)則在本方前置節(jié)點(diǎn)指定路徑中創(chuàng)建資源接收文件夾；f)共享交換平臺(tái)根據(jù)共享申請(qǐng)約定，向資源使用方前置節(jié)點(diǎn)指定文件存放路徑推送資源文件；g)文件獲取后，資源使用方應(yīng)向資源提供方確認(rèn)獲取文件的提供時(shí)間及數(shù)量等。9接口服務(wù)9.1接口接入要求共享交換平臺(tái)與資源提供方（包括各級(jí)政務(wù)部門、基礎(chǔ)庫(kù)建設(shè)方、主題庫(kù)建設(shè)方在發(fā)布服務(wù)接口時(shí)應(yīng)遵循如下要求：a)共享交換平臺(tái)應(yīng)將發(fā)布接口的服務(wù)器IP和端口加入白名單；b)接口協(xié)議：應(yīng)至少支持HTTPOpenAPI、RESTfulAPI、WebService三種接口協(xié)議種的一種，需要級(jí)聯(lián)發(fā)布的部門接口應(yīng)遵循HTTPOpenAPI或RESTfulAPI協(xié)議；6DB12/T1231—2023c)字符編碼：應(yīng)遵循UTF-8編碼規(guī)則；d)接口接入應(yīng)至少提供表2所列信息；e)接口接入的定義及描述示例見附錄A.1。表2接口接入信息說(shuō)明寫明支持的協(xié)議，如：HTTPOpenAPI、RESTfulAPI、對(duì)于特定格式（json、xml格式等）9.2接口發(fā)布要求接口發(fā)布，即將接入服務(wù)管理總線的接口按照統(tǒng)一標(biāo)準(zhǔn)進(jìn)行發(fā)布并按需提供服務(wù)，具體要求包括：a)網(wǎng)絡(luò)要求：調(diào)用接口的各級(jí)政務(wù)部門信息系統(tǒng)應(yīng)與服務(wù)管理總線聯(lián)通；b)接口協(xié)議：接入的接口服務(wù)協(xié)議應(yīng)至少支持HTTPOpenAPI、RESTfulAPI、WebService中的一種；c)字符編碼：UTF-8；d)接口發(fā)布應(yīng)同時(shí)發(fā)布表3所列信息；e)接口發(fā)布示例見附錄A.2。表3接口發(fā)布信息說(shuō)明說(shuō)明支持的協(xié)議，如：HTTPOpenAPI、RESTfulAPI、W9.3協(xié)議轉(zhuǎn)換要求接入規(guī)范/限制具體要求應(yīng)符合表4。7DB12/T1231—2023表4協(xié)議轉(zhuǎn)換要求說(shuō)明Body：Key-Value/JSON/byte[http://localhost:8081/abc/{userId}/se2.對(duì)于anytype參數(shù)類型，參數(shù)定義時(shí)要經(jīng)過(guò)特殊定義為“ws:anyType”1.應(yīng)以SOAP1.1格式發(fā)布WebS2.應(yīng)使用服務(wù)管理總線提供的SDK傳遞AccessKey和signa息8DB12/T1231—2023（資料性）服務(wù)接口說(shuō)明示例A.1接口接入說(shuō)明接口名稱：婚姻信息核驗(yàn)接口功能說(shuō)明：婚姻信息核驗(yàn)API實(shí)現(xiàn)根據(jù)業(yè)務(wù)請(qǐng)求編號(hào)、身份證號(hào)碼、性別進(jìn)行查詢，所有查詢參數(shù)為必填項(xiàng)。URL樣式：http://localhost:8081/abc/{userId}/search請(qǐng)求方式：POSTURL參數(shù)：名稱：ywqqbh是否必須：是描述：婚姻信息核驗(yàn)提交數(shù)據(jù)舉例：返回HTTP狀態(tài)：200返回格式：JSON返回參數(shù)：{code：0msg：datas：rows：C_NAME：C_GENDER：C_BIRTHDAY：BIRTH_CERTIFICATION_NUMBER：FATHER_NAME：FATHER_ID_NUMBER：FATHER_ETHNIC_GROUP：MOTHER_NAME：MOTHER_ID_