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