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

ICS35.240.01

CCSL67

12

天津市地方標(biāo)準(zhǔn)

DB12/T1231—2023

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

Governmentinfomationresourcessharing-Dataexchangingtechniquespecification

2023-07-19發(fā)布2023-09-01實(shí)施

天津市市場監(jiān)督管理委員會(huì)??發(fā)布

DB12/T1231—2023

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

1范圍

本文件規(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

通過共享交換平臺(tái)提供政務(wù)信息資源的政務(wù)部門或公共服務(wù)機(jī)構(gòu)。

注：資源提供方負(fù)責(zé)編制信息資源目錄，發(fā)布相應(yīng)信息資源。

3.2

資源使用方resourceconsumer

通過共享交換平臺(tái)申請、獲取政務(wù)信息資源的政務(wù)部門或公共服務(wù)機(jī)構(gòu)。

3.3

數(shù)據(jù)交換dataexchanging

政務(wù)部門或公共服務(wù)機(jī)構(gòu)間通過共享交換平臺(tái)進(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ù)；

1

DB12/T1231—2023

d)接口傳輸數(shù)據(jù)包括但不限于json、xml數(shù)據(jù)。

5交換形式

數(shù)據(jù)交換形式包括以下三種：

a)數(shù)據(jù)庫表交換:通過前置節(jié)點(diǎn)交換實(shí)現(xiàn),適用于大體量、高時(shí)效性、周期性的結(jié)構(gòu)化數(shù)據(jù)交換

場景，資源使用方通過共享批量獲取數(shù)據(jù)，與自有數(shù)據(jù)融合后可進(jìn)行綜合業(yè)務(wù)處理、統(tǒng)計(jì)分

析、數(shù)據(jù)挖掘等應(yīng)用；

b)文件交換:通過前置節(jié)點(diǎn)交換實(shí)現(xiàn),適用于無系統(tǒng)承載的結(jié)構(gòu)化、非結(jié)構(gòu)化文件交換場景；

c)服務(wù)接口交換:通過服務(wù)管理總線注冊并發(fā)布服務(wù)接口方式實(shí)現(xiàn),適用于小數(shù)據(jù)包、高頻次、

高時(shí)效性、周期性的數(shù)據(jù)交換場景，資源使用方通過調(diào)用服務(wù)接口進(jìn)行查詢、核驗(yàn)等應(yīng)用。

數(shù)據(jù)交換的參與對象包括：資源使用方、資源提供方、共享交換平臺(tái)。

數(shù)據(jù)交換業(yè)務(wù)邏輯如圖1：

圖1數(shù)據(jù)交換業(yè)務(wù)邏輯

6交換流程

基于共享交換平臺(tái)的數(shù)據(jù)交換業(yè)務(wù)流程見圖2。

a)資源使用方通過共享交換平臺(tái)檢索所需資源；

b)資源使用方通過共享交換平臺(tái)對資源發(fā)起共享申請，申請中應(yīng)注明數(shù)據(jù)使用場景、聯(lián)系方式

及其他要求信息；

c)根據(jù)資源共享?xiàng)l件，無條件共享資源應(yīng)在共享交換平臺(tái)備案后獲取；有條件共享的資源，在

申請?zhí)峤徊⒂少Y源提供方審核通過后獲取。

2

DB12/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é)點(diǎn)數(shù)據(jù)庫中的庫表命名規(guī)則應(yīng)為“T_”+“信息類編碼”，其中信息類

編碼中“/”應(yīng)改為“_”。信息類編碼即信息資源目錄類編碼，是標(biāo)識(shí)政務(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í)間戳及數(shù)據(jù)狀態(tài)標(biāo)

記位，共3個(gè)字段，應(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字段作為主鍵，使用時(shí)需要在GUID

字段中上傳能代表數(shù)據(jù)唯一標(biāo)識(shí)的主鍵值。

3

DB12/T1231—2023

表1交換規(guī)則要求字段

數(shù)據(jù)是否

序號字段含義字段名數(shù)據(jù)格式說明

類型可空

記錄數(shù)據(jù)在部門前置節(jié)點(diǎn)

當(dāng)前數(shù)據(jù)的物理

1TOPIC_ADD_TIME日期型DATETIME非空數(shù)據(jù)庫中第一次入庫的物

創(chuàng)建時(shí)間

理時(shí)間

記錄數(shù)據(jù)在部門前置節(jié)點(diǎn)

當(dāng)前數(shù)據(jù)的最后

2TOPIC_UPDATE_TIME日期型DATETIME非空數(shù)據(jù)庫中最后一次修改入

修改時(shí)間

庫的物理時(shí)間

數(shù)據(jù)狀態(tài)標(biāo)識(shí)位

I：新增

3數(shù)據(jù)狀態(tài)標(biāo)識(shí)位OPERATETYPE字符型VARCHAR(2)非空

U：修改

D：刪除

7.1.2操作要求

資源提供方在準(zhǔn)備、組織數(shù)據(jù)交換時(shí)應(yīng)遵循以下要求：

a)數(shù)據(jù)庫中表結(jié)構(gòu)應(yīng)與政務(wù)信息資源目錄系統(tǒng)中注冊的信息類（信息項(xiàng)）相對應(yīng)（如字段類型、

長度、是否為必填項(xiàng)、主鍵等），若有表結(jié)構(gòu)改動(dòng)應(yīng)先在政務(wù)信息資源目錄系統(tǒng)中變更目錄，

并由變更后目錄提供的庫表創(chuàng)建腳本語句進(jìn)行前置節(jié)點(diǎn)數(shù)據(jù)庫表結(jié)構(gòu)修改；

b)掛接的數(shù)據(jù)庫表應(yīng)添加唯一標(biāo)識(shí)的主鍵字段，作為數(shù)據(jù)更新的依據(jù)；

c)GUID字段作為主鍵的情況下，部門應(yīng)自行上傳能作為數(shù)據(jù)唯一標(biāo)識(shí)的數(shù)值，不能將GUID字段

設(shè)置為自動(dò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”三種值；

g)掛接數(shù)據(jù)字段為“DATE”、“DATETIME”等日期型時(shí)，應(yīng)寫入實(shí)際時(shí)間值，不應(yīng)寫入“0000-00-00”、

“0000-00-0000:00:00”等無意義時(shí)間值。

7.2交換流程

數(shù)據(jù)庫表交換業(yè)務(wù)流程，包括但不限于：

a)資源注冊：資源提供方通過共享交換平臺(tái)注冊政務(wù)信息資源，應(yīng)注明資源描述、共享類型、

資源格式、更新頻率、信息項(xiàng)等資源目錄元數(shù)據(jù)信息，其中資源格式應(yīng)選擇“數(shù)據(jù)庫表”；

b)注冊審核：共享交換平臺(tái)對資源提供方發(fā)起的資源注冊進(jìn)行審核，審核通過后，資源目錄狀

態(tài)變?yōu)椤耙寻l(fā)布”；

c)資源掛接審核：資源提供方將數(shù)據(jù)掛接到前置節(jié)點(diǎn)數(shù)據(jù)庫，并將數(shù)據(jù)掛接狀態(tài)設(shè)置為“掛接

待審核”。

1)滿足數(shù)據(jù)質(zhì)量檢查要求的，共享交換平臺(tái)審核通過，并將數(shù)據(jù)掛接狀態(tài)調(diào)整為“已掛接”；

2)不滿足數(shù)據(jù)質(zhì)量檢查要求的，共享交換平臺(tái)將數(shù)據(jù)掛接狀態(tài)調(diào)整為“掛接不通過”，并

將問題反饋給資源提供部門，部門調(diào)整完成后再次進(jìn)行掛接操作。

4

DB12/T1231—2023

d)資源掛接審核通過后，共享交換平臺(tái)按資源提供方設(shè)定的更新頻率定期進(jìn)行數(shù)據(jù)抽?。?/p>

e)資源使用方在資源申請備案通過后，在本方前置節(jié)點(diǎn)數(shù)據(jù)庫中創(chuàng)建庫表結(jié)構(gòu)；

f)共享交換平臺(tái)根據(jù)共享申請約定，向資源使用方前置節(jié)點(diǎn)數(shù)據(jù)庫推送數(shù)據(jù)；

g)數(shù)據(jù)獲取后，資源使用方應(yīng)向資源提供方確認(rèn)獲取數(shù)據(jù)的入庫時(shí)間、入庫記錄數(shù)量等。

8文件交換

8.1交換要求

8.1.1文件存放路徑

根據(jù)前置節(jié)點(diǎn)服務(wù)器操作系統(tǒng)種類，應(yīng)明確交換文件的存放路徑，例如：

Windows：d:/tjgx

Linux：/home/user/others/tjgx

8.1.2文件夾命名規(guī)則

在前置節(jié)點(diǎn)中創(chuàng)建存放推送或接收文件的文件夾，文件夾命名規(guī)則為“T_”+“信息類編碼”，其

中信息類編碼中“/”應(yīng)改為“_”，并對文件夾授予讀寫權(quán)限，文件夾命名規(guī)則示例如下：

“政務(wù)信息資源目錄（信息類）名稱：統(tǒng)計(jì)年報(bào)”

“信息類編碼：3070020000016/000012”

“文件夾名稱：T_3070020000016_000012”

8.2交換流程

文件交換業(yè)務(wù)流程，包括但不限于：

a)資源注冊：資源提供方通過共享交換平臺(tái)注冊政務(wù)信息資源，應(yīng)注明資源描述、共享類型、

資源格式、更新頻率、信息項(xiàng)等資源目錄元數(shù)據(jù)信息，其中資源格式應(yīng)選擇“文件”；

b)注冊審核：共享交換平臺(tái)對資源提供方發(fā)起的資源注冊進(jìn)行審核，審核通過后，資源目錄狀

態(tài)變?yōu)椤耙寻l(fā)布”；

c)資源掛接審核：資源提供方將資源文件上傳至前置節(jié)點(diǎn)文件存放路徑中，文件上傳工具或程

序需將編碼格式設(shè)置為“GBK”，并將資源掛接狀態(tài)設(shè)置為“掛接待審核”；

d)資源掛接審核通過后，共享交換平臺(tái)按照資源提供方設(shè)定的更新頻率定期進(jìn)行文件抽??；

e)資源使用方在資源申請備案通過后，按照文件夾命名規(guī)則在本方前置節(jié)點(diǎn)指定路徑中創(chuàng)建資

源接收文件夾；

f)共享交換平臺(tái)根據(jù)共享申請約定，向資源使用方前置節(jié)點(diǎn)指定文件存放路徑推送資源文件；

g)文件獲取后，資源使用方應(yīng)向資源提供方確認(rèn)獲取文件的提供時(shí)間及數(shù)量等。

9接口服務(wù)

9.1接口接入要求

共享交換平臺(tái)與資源提供方（包括各級政務(wù)部門、基礎(chǔ)庫建設(shè)方、主題庫建設(shè)方），在發(fā)布服務(wù)接

口時(shí)應(yīng)遵循如下要求：

a)共享交換平臺(tái)應(yīng)將發(fā)布接口的服務(wù)器IP和端口加入白名單；

b)接口協(xié)議：應(yīng)至少支持HTTPOpenAPI、RESTfulAPI、WebService三種接口協(xié)議種的一種，

需要級聯(lián)發(fā)布的部門接口應(yīng)遵循HTTPOpenAPI或RESTfulAPI協(xié)議；

5

DB12/T1231—2023

c)字符編碼：應(yīng)遵循UTF-8編碼規(guī)則；

d)接口接入應(yīng)至少提供表2所列信息；

e)接口接入的定義及描述示例見附錄A.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)說明

返回?cái)?shù)據(jù)參數(shù)寫明返回參數(shù)的名稱、參數(shù)說明等

返回?cái)?shù)據(jù)格式字符串/json/xml或其他格式應(yīng)舉例說明

返回?cái)?shù)據(jù)舉例對特定格式（json、xml、自定義格式等）的返回參數(shù)應(yīng)提供示例說明

錯(cuò)誤代碼對錯(cuò)誤信息進(jìn)行定義，并進(jìn)行詳細(xì)說明

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)同時(shí)發(fā)布表3所列信息；

e)接口發(fā)布示例見附錄A.2。

表3接口發(fā)布信息說明

接口功能說明說明涉及接口的功能

接口地址服務(wù)管理總線接口地址

接口提供部門接口提供部門（即政務(wù)信息資源目錄所屬部門）

適配參數(shù)說明提供適配參數(shù)說明

接口協(xié)議說明支持的協(xié)議，如：HTTPOpenAPI、RESTfulAPI、WebService等

接口認(rèn)證參數(shù)說明涉及接口接入服務(wù)管理總線認(rèn)證的相關(guān)參數(shù)

9.3協(xié)議轉(zhuǎn)換要求

接入規(guī)范/限制具體要求應(yīng)符合表4。

6

DB12/T1231—2023

表4協(xié)議轉(zhuǎn)換要求說明

接入接口協(xié)議發(fā)布接口協(xié)議接入規(guī)范/限制

1.應(yīng)支持GET/PUT/POST/DELETE

2.參數(shù)傳遞

Query：Key-Value形式

HTTPHTTPBody：Key-Value/JSON/byte[]形式

3.應(yīng)支持RESTful風(fēng)格接入，如：

http://localhost:8081/abc/{userId}/search

4.應(yīng)支持HTTP返回結(jié)果透傳，不做任何變換加工

1.應(yīng)使用Authorization與或WSSE格式的用戶名密碼接入SOAPHeader

2.對于anytype參數(shù)類型，參數(shù)定義時(shí)要經(jīng)過特殊定義為“ws:anyType”

WebServiceHTTP3.接入后端WS服務(wù)方法必須是同步的

4.支持的bindType是Document-Literal(WrapperorUnwrapper)

5.返回結(jié)果是將SOAPXML轉(zhuǎn)化為JSON格式

1.應(yīng)以SOAP1.1格式發(fā)布WebService服務(wù)，并提供標(biāo)準(zhǔn)的WSDL

HTTPWebService2.應(yīng)使用服務(wù)管理總線提供的SDK傳遞AccessKey和signature等Header信

息

7

DB12/T1231—2023

A

A

附錄A

（資料性）

服務(wù)接口說明示例

A.1接口接入說明

接口名稱：婚姻信息核驗(yàn)接口

功能說明：婚姻信息核驗(yàn)API實(shí)現(xiàn)根據(jù)業(yè)務(wù)請求編號、身份證號碼、性別進(jìn)行查詢，所有查詢參數(shù)

為必填項(xiàng)。

URL樣式：http://localhost:8081/abc/{userId}/search