标准规范下载简介

DB31T 1240.2-2020 公共数据共享交换工作规范　第2部分：平台接入技术要求.pdf简介：

"DB31T 1240.2-2020 公共数据共享交换工作规范 第2部分：平台接入技术要求.pdf" 是一份技术标准文件，由中国上海市质量技术监督局发布。这份规范详细规定了公共数据共享交换平台的接入技术要求，旨在指导和规范公共数据在不同系统之间的有效、安全和高效共享。它可能包括平台的接口设计、数据格式、安全控制、互操作性、性能指标等方面的技术细节，以确保数据共享交换过程中数据的准确性、完整性和隐私保护。对于负责公共数据管理、信息技术开发或数据交换的机构来说，这份规范是一个重要的参考依据。

DB31T 1240.2-2020 公共数据共享交换工作规范　第2部分：平台接入技术要求.pdf部分内容预览：

B.1.2.3管控数据关键数据项定义与操作描述

3.1.2.3.1发布ID：本次发布资源的编号，要求保持表内唯性。 3.1.2.3.2发布资源的名称：本次发布资源的名称，用于市平台或区平台对资源信息进行展现。为了具 备可读性，建议在名称中含有资源提供部门、业务信息、资源类型等信息。 B.1.2.3.3资源来源机构编码：标识资源来源机构，即数据提供部门。 B.1.2.3.4资源发布范围机构编码：控制资源的发布范围，只有范围内的机构才可订阅资源。范围可以 是一个或多个机构，对应地，机构编码可以是一个或多个，中间用逗号分隔。若发布范围为全国范围且 不限机构，直接填写字符串“all”。 B.1.2.3.5数据源类型：待发布数据资源类型，包括数据库表(0）、文件（1）、文件夹（4）。 B.1.2.3.6数据schema：若发布的数据来源于库表，则描述表名、主键、列名、数据类型等必要信息，用 于进行资源展现，并作为公共数据使用者准备数据接收库表的参考。 B.1.2.3.7业务编码：用于标识资源相关的业务种类。本阶段赋值“0”，后期扩展编码由市平台管理部 门统一制定并通知。 B.1.2.3.8关联的目录ID：用于标识本次发布数据资源所关联的市平台政务信息资源目录，即：区平台 上报资源目录到市平台后，由市平台生成的目录系统ID值。区平台应通过市平台目录系统提供的“目 录查询”接口，获取ID并进行赋值。 B.1.2.3.9资源状态：设置本次发布资源的状态，如：1（启用）、2（停用）、3（删除）。默认发布为1（启 用）.表示资源当前可用状态为2（停用）时，系统将不再进行数据推送：3（删除）是对已发布资源进行清

理和删除，即取消发布。具体状态转换，详见“变更已发布资源”内容。 B.1.2.3.10操作状态：用以提示对端级联模块进行信息处理的标志位，写入方赋值0（未读），读取方读 取完成后更新该字段为1（已读）。 B.1.2.3.11 创建时间：标记本条记录的生成时间。 B.1.2.3.12 修改时间：标记本条记录最近一次处理的时间，任何一方在对记录中其他字段更新时同步 更新。 B.1.2.3.134 错误码：标识本条记录在读取时发生的错误，由读取方进行赋值，提示写入方进行更正 处理。

B.1.2.4规则和约

B.1.2.4.1市平台、区平台在新增、停用、变更、删除发布之后铁路隧道超前地质预报技术指南 铁建设[2008]105号，均需要级联模块操作相应级联未 的数据。 B.1.2.4.2级联模块（区端）应能够及时地发现级联共享区中发生的变化，并据此进行相应的 据写人方要保证“数据schema”能够真实有效地体现即将提供的数据格式。

B.1.2.4.1市平台、区平台在新增、停用、变更、删除发布之后，均需要级联模块操作相应级联共享区中 的数据。 B.1.2.4.2级联模块（区端）应能够及时地发现级联共享区中发生的变化，并据此进行相应的操作。数 据写人方要保证“数据schema”能够直实有效地体现即将提供的数据格式

B.1.3.1 写入要求

B.1.3.2错误处理

B.1.3.3记录检查

B.1.4schema描述

数据描述表结构见表B.2。 30

放据描述表结构见表B.2

数据描述表结构见表B.2。

表B.2微据描述表结构

B.2.2.1数据操作描述

2.1.1当进行实际的数据级联交换时，级联模块（市端）、级联模块（区端）将各自的交换数据写入 联共享区，数据描述信息描述这些数据的相关信息：

DB31/T1240.2—2020

B.2.2.1.2当级联模块（市端）、级联模块（区端）从共享级联共享区中读取数据时，需要获取匹配的数据 描述信息，并根据描述信息执行相关的动作（如获取文件，解析数据等）

B.2.2.2数据描述表的读写

B.2.2.3.1管控数据表的外键：与管控数据关联，描述本次级联交换的数据所关联的资源信息。数据描 述信息必须与管控数据关联，一条管控数据可以被一条（数据源为文件、文件夹）或者多条（数据源为库 表）数据描述信息所关联。 B.2.2.3.2数据源类型：交换的数据源类型，取值为0（数据库表）、1（文件）或4（文件夹）。该字段的值， 必须与关联管控数据TYPE字段的值一致。 B.2.2.3.3数据文件大小：记录数据文件的大小（单位：字节）。TYPE为0或1时必填，且为文件真实 大小。TYPE为4时无需填写。 B.2.2.3.4数据记录条数：记录数据文件中的数据条数。TYPE为0（数据库表）时必填，且为文件中实 际数据条数。 B.2.2.3.5数据文件路径：记录数据文件的存放路径。TYPE为0或1时，为文件全路径；TYPE为4 （文件夹）时，为文件夹路径。 B.2.2.3.6文件签名：对文件的数字签名。双方的级联模块通过文件签名与验签，检查文件一致性。 TYPE为0或1时，若写人方提供签名，读取方应进行验签。TYPE为4时，为空，为确保一致性，文件 签名和验签使用统一提供的API接口进行调用处理。 B.2.2.3.7压缩标识：表示数据文件是否经过zip压缩。通过统一提供的API生成数据文件后，级联模 块可自行将数据文件压缩成zip格式文件，以减少存储占用，若提交的是压缩文件，则赋值1（是），否则 赋值0（否）。 注：为确保压缩解压的跨平台及一致性，仅可压缩为zip格式，不支持gz、Z、rar等其他格式。 B.2.2.3.8操作状态：用以提示对端级联模块进行信息处理的标志位，写入方赋值0（未读），读取方读 取完成后更新该字段为1（已读）。 B.2.2.3.9目标机构、送达状态、送达时间：数据交换目标可以是多个部门，使用JSON串来描述每个部 门以及各自的数据到达状况和到达时间，到达状态包括未到达、已到达；当状态为0（未到达）时，到达时 间的值为空，读取方完成数据交换后，对该记录进行回写，设置送达状态为1（已到达）、写入实际送达时 间，级联模块（市端）写上行表时，本学段为空。 B.2.2.3.10创建时间：标记本条记录的创建时间。 B.2.2.3.11数据清理期限：数据到期清理的期限，单位为d。以创建时间为基础，加上期限的天数后， 即为数据自动清理的时间。 注：期限到期后，针对不同的TYPE，清理机制有所区别： TYPE为O（数据库表），数据描述信息和数据文件会被自动清理和删除。 TYPE为1（文件），数据描述信息和文件均不会被自动清理和删除。这些信息和文件只有对发布资源进行删除

TYPE为4(文件夹），数据措述信息不会被清理，完成交换并被备份后的文件会被清理。 B.2.2.3.12修改时间：标记本条记录最近一次处理的时间，由读取方进行更新。 B.2.2.3.13错误码：标识本条记录在读取时发生的错误，由读取方进行赋值，提示写入方进行更正 处理。 B223.14其仙

B.2.2.4规则和约束

B.2.2.4.1写人方需要确保数据描述信

2.4.1写人方需要确保数据描述信息中 生和有效性， .2.4.2读取方在消费完数据之后，需要及时

C2.1.4ColumnData

ColumnData描述了某个具体的字段及其值，包括： a）name：字段名称，字符型； b）dbType：数据库类型，int类型，枚举值为：java.sql.Types中定义的类型； c）value：该列的值，Object类型； d）pkColumn：boolean类型，如果该列是表中的主键，或者是联合主键的组成部分，均将该字段 设置为true

C.2.2.1数据文件操作描述

发送方将待交换的数据写入文件，并将文件放入共享区；接收方从共享区中获取并解析该 交换数据。

C.2.2.2数据文件的读取

C.2.2.3数据文件的写入

通过访间文件系统的方式写入数据。

通过访间文件系统的方式写入数据！

C.2.2.4数据内容的解析

使用市平台提供的API解析数据。

市平台提供的API解析

在级联接口交互过程中，为了避免文件 文件读取方进行验签，以确认数据一致性

C.3.2文件签名接口

文件签名接口API说明如下： 类名：PlatformSecurityUtil; b) 方法：public staticStringsign（StringfilePath）； c）参数：待加签的文件； d）返回值：加签后的字符串。

C.3.3文件验签接口

文件验签接口API说明包括：

DB31/T1240.22020

a 类名：PlatformSecurityUtil 方法：publicstaticbooleancheck（Stringsignature，StringfilePath)； c） 参数：待验签的签名以及文件； d）返回值，验证通过返回true.否则返回false

GB∕T 28059.3-2011 公路网图像信息管理系统 平台互联技术规范 第3部分：接口与通信控制协议DB31/T1240.2—2020

D.2服务详情查询接口

务列表查询接口见表D.2

DB31/T1240.2—2020

D.3服务信息注册接口

列表查询接口见表D.3

D.4签名密钥获取接口

签名密钥获取接口见表D.4。

《高压直流系统的性能 第1部分：稳态 GB/Z 20996.1-2007》表D.4签名密钥获取接口