标准规范下载简介
DB31T 1240.2-2020 公共数据共享交换工作规范 第2部分：平台接入技术要求.pdf5.4. 1.2环境部署
市级分平台安装环境部署要求主要包括： a）软件安装： 1）交换管理中心软件：市级分平台需在交换中心部署交换管理中心软件，用于交换过程的监 控、管理。交换管理中心软件部署在交换管理中心服务器上。 2）中心交换节点软件：市级分平台需在交换中心部署交换节点软件，用于发送和接收数据。 中心交换节点软件部署在中心交换节点服务器上。 3） 服务管理软件：市级分平台需在交换中心部署服务管理软件，用于服务的发布、监控、管 理。服务管理软件部署在服务管理服务器上。 b） 服务器端口开放策略见表7。
DB31/T1240.2—2020表7各服务器需要开放的网络端口及开放策略服务器端口号协议备注22TCPSSH远程安装程序使用交换管理中心8080TCP交换管理中心软件程序运行使用22TCPSSH远程安装程序使用中心交换节点3316、40001、40002、TCP中心交换节点软件程序运行使用40003、1026222TCPSSH远程安装程序使用服务管理8080TCP服务管理软件程序运行使用8181TCP服务接口程序运行使用注：市级分平台交换管理中心软件、中心交换节点软件、服务管理软件由平台管理部门统一安装部署。5.4.1.3平台开通市级分平台联调测试通过后，交付区平台建设管理单位使用。5.4.2使用自建平台接入5.4.2.1级联组成结构市区级联对接应基于统一的系统组成结构和接口报文通道标准进行基础设施建设，各区平台的级联模块（区端)的系统开发人员应参考本章节内容进行市区级联对接。系统组成结构和接口报文通道要求主要包括：a)系统组成结构：市平台与区平台的交换系统级联功能DB1403／T 2-2020 国家卫生城市创建指南.pdf，由交换级联子系统提供实现。交换级联子系统的组成部分包括：交换软件、级联模块（市端）、级联共享区以及级联模块（区端），见图7：市平台交换级联市端前置机级联模块（中端）交换软级联其字数据库访间文件读写服务访间缓联投块（风确】区平台服务器图7系统组成结构15
1）交换软件：交换软件应部署在区前置机上，实现市平台内跨节点的数据交换、服务接口调 用功能。同时，交换软件与区平台之间应以服务接口方式进行互动。 2） 级联模块（市端）：应将市平台推送给区平台的数据写入级联共享区，并将区平台推送给市 平台的数据从级联共享区取出。 3） 级联共享区：应由数据库和文件存储构成，为级联模块（市端)与级联模块（区端)的交换缓 存区，用于存储平台交换级联的资源发布信息和数据。 4） 级联模块（区端）：应用于实现与级联模块（市端）对接。级联模块（区端）提供市、区平台交 换数据在级联共享区的读取和写人功能，提供区平台内部资源的加工处理和接口调用功 能。级联模块（区端）调用市平台交换软件提供的服务代理接口，实现对市平台服务接口 资源的调用。 b）接口报文通道：市平台与区平台的交换级联，应支持数据库表交换、文件交换和服务接口三种 交换方式。级联模块（区端）与市平台之间的级联接口报文通值方式见表8。
表8级联接口报文通信方式
5.4.2.2级联共享区及连接方式
5.4.2.2.1级联共享区描述
5.4.2.2.2级联共享区操作模式
市平台与区平台进行级联交换时，两端的级联模块对级联共享区的典型作模式见图8。
5.4.2.4级联数据库表格式
级联数据库表格式参见附录B。
5.4.2.5级联文件操作接口
级联文件操作接口参见附录C
5.4.2.6级联交换处理流程
级联交换处理流程应按照如下标准执行： 库表交换：应支持一次发布，多次供数。库表处理流程见图13： 1）发布资源时，公共数据提供者应将库表类型的资源发布信息完整、准确地写入管控上行 表。市平台进行处理后，资源信息即可在市平台上展现，并开始接受订阅； 2） 公共数据提供者每次提供数据时，应将数据文件放人级联共享区，同时提供与文件一一对 应的数据描述信息； 3） 库表交换方式下，若已有多个部门或区级单位订阅，应由市平台提供单次数据的组播 推送； 4) 区平台公共数据使用者应从管控数据下行表中获取资源发布信息，从数据描述下行表中 获取下行数据文件的相关信息。
DB31/T1240.2—2020区平台区平台（数据提供方）市平台（数据得求方）开始开始向管控上行表写入资源发布信息获取资源发布信资源发布信息息，进行例处理有息是否错误码返回错误码，在市平台网站检套是否有提示提供方进上展现资源信错铁返国行修正总更正信息获取管控下行表中将资源发布信息推送到资源信息的资源发布值息，指定范街内的区平台进行处理后，在区内平台发布按照区内部门笛求，登最市平台申请和订阅，指向级联共字区放入定数据诺求部门数据文件摘述信息数据文件获取描述信息和文件，进行预处向数据描述上行表入插选信息返回错误描述伯息将数据交换获取数据描述下行表检套是否有错误码提示提文件到福求部门中的播述信息，获取供方进行修文件，解析后过区所在风平台正内交换给留求部门准备下一批更正数据或交换数据摘述信息图13库表交换流程图b）文件夹交换：支持一次发布，多次供数。文件夹交换处理流程见图14：1）发布资源时，公共数据提供者将资源发布信息写人管控上行表，并提供包含文件夹路径的数据描述信息。市平台进行处理后，文件夹资源信息即可在市平台上展现，并开始接受订阅。2）公共数据提供者每次提供文件时，只需将文件放入指定的文件夹路径下即可。3）文件夹交换方式下，若已有多个部门或区级单位订阅，由市平台对每个文件进行组播推送。21
DB31/T1240.2—2020
DB31/T1240.2—2020
应根据实际请求部门，使用各自的授权信息（请求者身份标识和APPKey)。 各部门应妥善保管授权信息，如果APPKey不慎泄露，应撤销此申请，重新申请服务获得新的APPKey。 使用APPKey获得密钥后，默认密钥有效期为1d(返回值中提示了密钥过期时间)，在此过期时间之前，不能频 获取密钥。
应根据实际请求部门，使用各自的授权信息（请求者身份标识和APPKey)。 各部门应妥善保管授权信息，如果APPKey不慎泄露，应撤销此申请，重新申请服务获得新的APPK 使用APPKey获得密钥后，默认密钥有效期为1d(返回值中提示了密钥过期时间)，在此过期时间之 警获取密钥。
5.4.2.9级联交换日志信息归集
区首建平台，应将自建平台数据资源的便用情况以交换日志形式归集到市平合，交换日志信息项、 集方式和归集周期要求包括： a）交换日志信息应采用明文、结构化方式存储，须归集数据字典用来说明信息项业务含义。信息 项应至少包括： 1）库表交换：交换批次号、交换发送时间、交换接收时间、交换数据发送部门、交换数据接收 （使用）部门、交换数据使用人、交换数据表名（源表、目标表）、发送数据量（条）、接收数据 量（条）等； 2）文件交换：文件发送时间、文件接收时间、文件发送部门、文件接收（使用）部门、文件使用 人、文件名、文件大小等； 3）服务调用：服务调用时间、服务调用IP、服务提供部门、服务调用部门、服务名，服务响应 时间、服务调用结果（成功/失败）等。 b） 归集方式：交换日志信息可采用库表、文件或服务接口方式，通过前置机同步到市级数据潮。 恒焦照相，在交统任备或服调用发生时，同步将交换日志信良发送给市平台。
级联错误码对照表见表A.1
DB31/T1240.2—2020
附录A （资料性附录） 级联错误码对照表
附录A （资料性附录） 级联错误码对照表
表A.1级联错误码对用
DB31/T1240.2—2020
级联管控数据库表结构见表B.1。
控数据库表结构见表B
附录B （资料性附录） 级联数据库表格式
表B.1管控数据表结构
B.1.2.1管控数据操作描述
B.1.2.2管控数据表的读写
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市平台、区平台在新增、停用、变更、删除发布之后，均需要级联模块操作相应级联未 的数据。 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
DB31/T1240.2—2020
GY／T 246-2020标准下载D.2服务详情查询接口
务列表查询接口见表D.2
DB31/T1240.2—2020
D.3服务信息注册接口
列表查询接口见表D.3
D.4签名密钥获取接口
DB45／T 679-2017标准下载签名密钥获取接口见表D.4。
表D.4签名密钥获取接口