DB12T 1233-2023 政务信息资源共享政务信息资源目录编码规范

发布发布天津市市场监督管理委员会2023090120230719ICS35.240.01CCSICS35.240.01CCSL67天 津 市 地 方 标 准DB12/T1232—2023政务信资源共享 数据交技术规范Governmentinfomationresourcessharing-DataexchangingtechniquespecificationDB12/T1232DB12/T1232—2023II前 言本文按照GB/T1.1—2020《标化作导则 第部分标准文的结和起规则的起草。本文件由天津市互联网信息办公室提出并归口。DB12/T1232DB12/T1232—2023DB12/T1232—DB12/T1232—2023d) json、xml政务信息资源共享 数据交换技术规范范围本文件规定了政务信息资源共享交换采用的数据格式、数据交换方式、数据交换流程和技术要求。本文件适用于市、区两级政务部门及公共服务机构开展政务信息资源共享工作。（DB12/T1230-2023 DB12/T1233-2023 DB12/T1230-2023、DB12/T1233-2023界定的以及下列术语和定义适用于本文件。3.1资源供方 resourceprovider通过共享交换平台提供政务信息资源的政务部门或公共服务机构。注：资源提供方负责编制信息资源目录，发布相应信息资源。3.2资源用方 resourceconsumer通过共享交换平台申请、获取政务信息资源的政务部门或公共服务机构。3.3数据换 dataexchanging政务部门或公共服务机构间通过共享交换平台进行政务信息资源传输的过程。3.4政务息源录统 governmentinformationresourcecatalogsystem对信息资源目录进行全生命周期管理的系统，具有信息资源编目、导航、检索以及发起数据共享申请等功能。3.5服务理线 servicemanagementbus用于接口的注册、发布及调用管理，支撑接口服务形式的数据交换。数据交换内容包括结构化文件、非结构化文件、库表数据、接口传输数据：csv、xlsx、rdf；pdf、docx；OracleMySQL、GBase1数据交换形式包括以下三种：数据交换的参与对象包括：资源使用方、资源提供方、共享交换平台。数据交换业务逻辑如图1：图1 数据换务辑基于共享交换平台的数据交换业务流程见图2。2图2 数据换务程资源提供方与资源使用方应遵循以下数据库表交换规则：“T_示例：（3070020000013/000017”31GUIDGUID3DB12/T1232DB12/T1232—2023DB12/T1232DB12/T1232—2023表1 交换则求段序号字段含义字段名数据类型数据格式是否可空说明1当前数据的物理创建时间TOPIC_ADD_TIME日期型DATETIME非空记录数据在部门前置节点数据库中第一次入库的物理时间2当前数据的最后修改时间TOPIC_UPDATE_TIME日期型DATETIME非空记录数据在部门前置节点数据库中最后一次修改入库的物理时间3数据状态标识位OPERATETYPE字符型VARCHAR(2)非空I：新增U：修改D：删除资源提供方在准备、组织数据交换时应遵循以下要求：（）GUIDGUID，TOPIC_ADD_TIMETOPIC_UPDATE_TIME）OPERATETYPETOPIC_UPDATE_TIME字OPERATETYPEU“D”；TOPIC_ADD_TIMETOPIC_UPDATE_TIMEOPERATETYPEOPERATETYPEIU”“D挂接数据字段为“DATEDATETIME”等日期型时，应写入实际时间值，不应写入“0000-00-00”、“0000-00-0000:00:00数据库表交换业务流程，包括但不限于：4根据前置节点服务器操作系统种类，应明确交换文件的存放路径，例如：Windows：d:/tjgxLinux：/home/user/others/tjgx在前置节点中创建存放推送或接收文件的文件夹，文件夹命名规则为“T_”+“信息类编码”，其中信息类编码中“/”应改为“_”，并对文件夹授予读写权限，文件夹命名规则示例如下：“政务信息资源目录（信息类）名称：统计年报”“信息类编码：3070020000016/000012”“文件夹名称：T_3070020000016_000012”文件交换业务流程，包括但不限于：GBK（IPHTTPOpenAPI、RESTfulAPI、WebServiceHTTPOpenAPIRESTfulAPI5669.3 接入规范/限制具体要求应符合表4。接口发布，即将接入服务管理总线的接口按照统一标准进行发布并按需提供服务，具体要求包括：HTTPOpenAPI、RESTfulAPIWebServiceUTF-8；3A.2。表3 接口布息明UTF-82A.1。表2 接口入息明参数参数说明接口名称接口名称功能说明接口功能描述URL样式写明调用接口的URL样式接入接口协议写明支持的协议，如：HTTPOpenAPI、RESTfulAPI、WebService等请求方式支持POST、GET、POST/GET等方式接口参数写明参数名称、参数说明、参数数据类型、参数传值要求等提交数据举例对于特定格式（json、xml格式等）参数应举例说明返回HTTP状态写明返回HTTP状态所对应的状态说明返回数据参数写明返回参数的名称、参数说明等返回数据格式字符串/json/xml或其他格式应举例说明返回数据举例对特定格式（json、xml、自定义格式等）的返回参数应提供示例说明错误代码对错误信息进行定义，并进行详细说明接口功能说明说明涉及接口的功能接口地址服务管理总线接口地址接口提供部门接口提供部门（即政务信息资源目录所属部门）适配参数说明提供适配参数说明接口协议说明支持的协议，如：HTTPOpenAPI、RESTfulAPI、WebService等接口认证参数说明涉及接口接入服务管理总线认证的相关参数77表4 协议换求明接入接口协议发布接口协议接入规范/限制HTTPHTTP应支持GET/PUT/POST/DELETE参数传递Query：Key-Value形式Body：Key-Value/JSON/byte[]形式3.应支持RESTful风格接入，如：http://localhost:8081/abc/{userId}/search4.应支持HTTP返回结果透传，不做任何变换加工WebServiceHTTP应使用AuthorizationWSSE格式的用户名密码接入SOAPHeader对于anytypews:anyType”接入后端WS支持的bindType是Document-LiteralWrapperorUnwrapper)返回结果是将SOAPXML转化为JSON格式HTTPWebService应以SOAP1.1格式发布WebService服务，并提供标准的WSDL应使用服务管理总线提供的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：}调用示例：根据接口实际情况填写。附录A（资料性）服务接口说明示例接口名称：婚姻信息核验接口功能说明：婚姻信息核验API实现根据业务请求编号、身份证号码、性别进行查询，所有查询参数为必填项。URL样式：http://localhost:8081/abc/{userId}/search请求方式：POSTURL参数：返回HTTPJSON{99调用