ICS35.240.01 CCSL67 12 天津市地方标准 DB12/T1231—2023 政务信息资源共享数据交换技术规范 Governmentinfomationresourcessharing-Dataexchangingtechniquespecification 2023-07-19发布 2023-09-01实施 天津市市场监督管理委员会  发布 DB12/T1231—2023 I前言 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件由天津市互联网信息办公室提出并归口。 本文件起草单位：天津市互联网信息办公室、天津市大数据管理中心、天津市标准化研究院。 本文件主要起草人：边柯柯、张永跃、刘津、由方岚、袁琳、李丹阳、宋万洋、张楠、李晓明。 DB12/T1231—2023 1政务信息资源共享数据交换技术规范 1范围 本文件规定了政务信息资源共享交换采用的数据格式、数据交换方式、数据交换流程和技术要求。 本文件适用于市、区两级政务部门及公共服务机构开展政务信息资源共享工作。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 DB12/T1230-2023政务信息资源共享总体框架 DB12/T1233-2023政务信息资源共享政务信息资源目录编码规范 3术语和定义 DB12/T1230-2023、DB12/T1233-2023界定的以及下列术语和定义适用于本文件。 3.1 资源提供方resourceprovider 通过共享交换平台提供政务信息资源的政务部门或公共服务机构。 注：资源提供方负责编制信息资源目录，发布相应信息资源。 3.2 资源使用方resourceconsumer 通过共享交换平台申请、获取政务信息资源的政务部门或公共服务机构。 3.3 数据交换dataexchanging 政务部门或公共服务机构间通过共享交换平台进行政务信息资源传输的过程。 3.4 政务信息资源目录系统governmentinformationresourcecatalogsystem 对信息资源目录进行全生命周期管理的系统，具有信息资源编目、导航、检索以及发起数据共享申 请等功能。 3.5 服务管理总线servicemanagementbus 用于接口的注册、发布及调用管理，支撑接口服务形式的数据交换。 4交换内容 数据交换内容包括结构化文件、非结构化文件、库表数据、接口传输数据： a)结构化文件格式包括但不限于csv、xlsx、rdf； b)非结构化文件格式包括但不限于pdf、docx； c)库表数据包括但不限于Oracle、MySQL、GBase数据库数据； DB12/T1231—2023 2d)接口传输数据包括但不限于json、xml数据。 5交换形式 数据交换形式包括以下三种： a)数据库表交换:通过前置节点交换实现,适用于大体量、高时效性、周期性的结构化数据交换 场景，资源使用方通过共享批量获取数据，与自有数据融合后可进行综合业务处理、统计分 析、数据挖掘等应用； b)文件交换:通过前置节点交换实现,适用于无系统承载的结构化、非结构化文件交换场景； c)服务接口交换:通过服务管理总线注册并发布服务接口方式实现,适用于小数据包、高频次、 高时效性、周期性的数据交换场景，资源使用方通过调用服务接口进行查询、核验等应用。 数据交换的参与对象包括：资源使用方、资源提供方、共享交换平台。 数据交换业务逻辑如图1： 图1数据交换业务逻辑 6交换流程 基于共享交换平台的数据交换业务流程见图2。 a)资源使用方通过共享交换平台检索所需资源； b)资源使用方通过共享交换平台对资源发起共享申请，申请中应注明数据使用场景、联系方式 及其他要求信息； c)根据资源共享条件，无条件共享资源应在共享交换平台备案后获取；有条件共享的资源，在 申请提交并由资源提供方审核通过后获取。 DB12/T1231—2023 3 图2数据交换业务流程 7数据库表交换 7.1交换要求 7.1.1初始设置 资源提供方与资源使用方应遵循以下数据库表交换规则： a)数据库表命名：前置节点数据库中的库表命名规则应为“T_”+“信息类编码”，其中信息类 编码中“/”应改为“_”。信息类编码即信息资源目录类编码，是标识政务信息资源目录的 唯一编码，编码规则应符合《政务信息资源共享政务信息资源目录编码规范》。 示例： “政务信息资源目录（信息类）名称：婚姻登记信息” “信息类编码：3070020000013/000017” “库表名称：T_3070020000013_000017” b)交换规则要求字段：除完成业务字段创建外，数据库表结构中还应增加时间戳及数据状态标 记位，共3个字段，应符合表1规范要求； c)添加注释：资源提供方应对数据库表及业务字段添加注释信息，便于理解业务含义； d)设置主键应满足以下条件之一： 1)业务字段中存在作为此表主键的字段，应设置此字段为主键； 2)业务字段中不存在作为此表主键的字段，应使用GUID字段作为主键，使用时需要在GUID 字段中上传能代表数据唯一标识的主键值。 DB12/T1231—2023 4表1交换规则要求字段 序号字段含义 字段名数据 类型数据格式是否 可空说明 1当前数据的物理 创建时间TOPIC_ADD_TIME日期型DATETIME非空记录数据在部门前置节点 数据库中第一次入库的物 理时间 2当前数据的最后 修改时间TOPIC_UPDATE_TIME日期型DATETIME非空记录数据在部门前置节点 数据库中最后一次修改入 库的物理时间 3数据状态标识位 OPERATETYPE字符型VARCHAR(2)非空数据状态标识位 I：新增 U：修改 D：删除 7.1.2操作要求 资源提供方在准备、组织数据交换时应遵循以下要求： a)数据库中表结构应与政务信息资源目录系统中注册的信息类（信息项）相对应（如字段类型、 长度、是否为必填项、主键等），若有表结构改动应先在政务信息资源目录系统中变更目录， 并由变更后目录提供的库表创建脚本语句进行前置节点数据库表结构修改； b)挂接的数据库表应添加唯一标识的主键字段，作为数据更新的依据； c)GUID字段作为主键的情况下，部门应自行上传能作为数据唯一标识的数值，不能将GUID字段 设置为自动增长或其他不符合标准的数值； d)当部门第一次上传数据时，TOPIC_ADD_TIME及TOPIC_UPDATE_TIME值应保持一致（即赋予该 字段当前数据写入时间），且OPERATETYPE字段内容填“I”； e)当部门需修改或删除数据内容时，除更新业务字段值外，应同时修改TOPIC_UPDATE_TIME字 段值为当前数据写入时间，OPERATETYPE字段赋值为“U”或“D”； f)TOPIC_ADD_TIME、TOPIC_UPDATE_TIME、OPERATETYPE三个字段都不应为空，并且OPERATETYPE 字段中只应存在“I”、“U”、“D”三种值； g)挂接数据字段为“DATE”、“DATETIME”等日期型时，应写入实际时间值，不应写入“0000-00-00”、 “0000-00-0000:00:00”等无意义时间值。 7.2交换流程 数据库表交换业务流程，包括但不限于： a)资源注册：资源提供方通过共享交换平台注册政务信息资源，应注明资源描述、共享类型、 资源格式、更新频率、信息项等资源目录元数据信息，其中资源格式应选择“数据库表”； b)注册审核：共享交换平台对资源提供方发起的资源注册进行审核，审核通过后，资源目录状 态变为“已发布”； c)资源挂接审核：资源提供方将数据挂接到前置节点数据库，并将数据挂接状态设置为“挂接 待审核”。 1)满足数据质量检查要求的，共享交换平台审核通过，并将数据挂接状态调整为“已挂接”； 2)不满足数据质量检查要求的，共享交换平台将数据挂接状态调整为“挂接不通过”，并 将问题反馈给资源提供部门，部门调整完成后再次进行挂接操作。