DB61_T 1344.3-2020智慧统战综合服务平台技术规范+第3部分+数据共享与交换.pdf

目 次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 数据交换总体架构.1 5 用户统一管理认证授权.2 6 数据交换方式.2 7 基于库表的交换.3 8 基于文件的交换.4 9 基于接口的交换.4 附录 A（规范性附录）数据目录.6 附录 B（规范性附录）数据接口.7 附录 C（规范性附录）接口协议格式.12 前 言 DB61/T 1344智慧统战综合服务平台技术规范分为三个部分：第1部分：总体框架；第2部分：基础数据；第3部分：数据共享与交换。本部分为DB61/T 1344的第3部分。本部分按照GB/T 1.12009给出的规则起草。本部分由中共陕西省委统一战线工作部提出并归口。本部分起草单位：中共陕西省委统一战线工作部、中共咸阳市委网络安全和信息化委员会办公室、陕西未来数据信息科技有限公司。本部分主要起草人：虞浩桂、张鹏、田少娟、朱年奇、赵军、刘瑞娜、崔鹏飞。本部分由中共陕西省委统一战线工作部负责解释。本部分首次发布。联系信息如下：单位：中共陕西省委统一战线工作部 电话：[phone] 地址：陕西省西安市雁塔区雁塔路南段10号 邮编：710054 智慧统战综合服务平台技术规范 第 3 部分：数据共享与交换 1 范围 DB61/T 1344的本部分规定了省级智慧统战综合服务平台数据共享与交换的相关技术要求。本部分适用于全省各级统战部门和成员单位信息系统之间的数据共享与交换，各市（区）级智慧统战综合服务平台的数据共享与交换子系统可参照本规范进行设计和实施。2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。DB61/T 1344.22020 智慧统战综合服务平台技术规范 第2部分：基础数据 3 术语和定义 下列术语和定义适用于本文件。3.1 数据共享与交换参与方 participants in data share and exchange 是指全省各级统战部门和成员单位的信息系统 3.2 交换前置系统 exchange pre-system 是智慧统战数据共享与交换子系统的组成部分，它由交换前置计算机和部署在该计算机上的共享交换中间件软件组成。4 数据交换总体架构 智慧统战综合服务平台数据共享与交换总体架构包含数据共享与交换参与方、交换前置系统、智慧统战综合服务平台。说明：数据共享与交换参与方可通过智慧统战综合服务平台进行数据共享与交换。每个参与方既可以提供数据资源（此时称为数据提供方），又可以通过智慧统战综合服务平台共享其它参与方的数据资源（此时称为数据接收方）；数据共享与交换参与方一般通过交换前置系统实现数据共享与交换。数据共享与交换参与方可以利用浏览器登录智慧统战综合服务平台，利用其数据共享交换配置功能对所涉及共享与交换的资源进行配置，并对共享与交换过程进行监管。综合服务平台将配置结果分发给相应的交换前置系统，以实现交换前置系统与交换参与方业务应用系统的数据对接。交换前置系统可部署在参与方端或智慧统战综合服务平台端，优先部署在智慧统战综合服务平台端。图1 智慧统战综合服务平台数据共享与交换总体架构 5 用户统一管理认证授权 省委统战部对各市（区）统战部及成员单位的使用用户进行认证、授权，授权内容包含交换任务发起、可访问资源、数据过滤条件等。6 数据交换方式 6.1 基于数据库表的交换方式 6.1.1 使用场景 各级统战部门及成员单位信息系统之间实时、周期性、结构化的数据共享与交换。6.1.2 数据库类型 支持MySQL、Oracle、达梦、人大金仓等主流数据库之间的数据交换。6.2 基于文件的交换方式 6.2.1 使用场景 各级统战部门及成员单位信息系统之间实时、周期性、数据包、结构化、半结构化、非结构化的数据共享与交换。6.2.2 传输协议 标准的SFTP 服务，服务端口为22。6.2.3 目录命名规则 文件目录命名规则：根据DB61/T1344.2-2020中第3章数据编码规定，数据编码一段/数据编码二段/文件上传日期。6.2.4 文件交换要求 6.2.4.1 SFTP 文件服务部署在前置计算机上。6.2.4.2 文件可压缩为一个文件包进行传输，数据文件的压缩格式应支持 rar 或 zip 等文件类型。6.2.4.3 结构化的数据组织成以 JSON 为载体的数据文件，文件结构见附录 B。6.3 基于服务接口的交换方式 6.3.1 使用场景 各级统战部门及成员单位信息系统之间实时、周期性、数据包、结构化的数据交换。6.3.2 接口协议 采用基于HTTPS协议的RESTful接口形式。6.3.3 服务接口发布要求 服务接口的发布格式规范见附录C。7 基于库表的交换 7.1 数据发布 数据提供方通过浏览器登录智慧统战综合服务平台，在数据共享交换配置功能中配置数据源、数据目录、数据项。数据源配置内容：数据库IP地址、端口号、数据库类型、用户名和密码、表名、所属交换前置系统。数据目录：见附件A。数据项：应符合DB61/1344.2-2020中第4章数据结构规定的格式和内容。表名：数据库表名称，支持多个。7.2 数据订阅 数据接收方通过浏览器登录智慧统战综合服务平台，申请数据资源。经数据提供方审核通过后，在数据共享交换配置功能中配置存储接收数据的数据库（称为目标数据库）连接信息。目标数据库配置内容：数据库IP地址、端口号、数据库类型、用户名和密码、所属交换前置系统。7.3 数据上传与更新 7.3.1 智慧统战综合服务平台将数据提供方的数据源分发至相应的交换前置系统，交换前置系统连接数据提供方数据库，根据表名读取数据，并发送数据到智慧统战综合服务平台。7.3.2 智慧统战综合服务平台将数据接收方数据库配置及数据分发至相应的交换前置系统，交换前置系统根据数据接收方提供的数据订阅信息，自动连接并发送数据到接收方数据库。8 基于文件的交换 8.1 文件上传 8.1.1 数据提供方通过浏览器登录智慧统战综合服务平台，在数据共享交换配置功能中配置 SFTP 文件服务、数据目录、数据项。SFTP 文件服务配置内容：IP 地址、端口号、用户名和密码、文件根目录、所属交换前置系统。数据目录：见附件 A。数据项：应符合 DB61/T1344.2-2020 中第 4 章数据结构规定的格式和内容。8.1.2 文件根目录命名规则见 5.2.3。8.1.3 结构化文件上传时的交换要求见 5.2.4。8.2 文件下载 8.2.1 数据接收方通过浏览器登录智慧统战综合服务平台，申请数据资源，数据提供方审核通过后，在数据共享交换配置功能中配置接收方 SFTP 文件服务信息。SFTP 文件服务配置内容：IP 地址、端口号、用户名和密码、文件根目录、所属交换前置系统。8.2.2 交换前置系统自动连接并发送文件到数据接收方 SFTP 文件服务器。数据接收方自行选择工具从数据接收方 SFTP 文件服务器下载文件。8.3 文件更新 8.3.1 智慧统战综合服务平台将数据提供方 SFTP 文件服务配置分发至相应的交换前置系统，交换前置系 统连接数据提供方 SFTP 文件服务，读取并发送更新的文件到智慧统战综合服务平台。8.3.2 智慧统战综合服务平台将数据接收方 SFTP 文件服务配置信息及所要下载的文件分发至相应的交换前置系统，交换前置系统自动连接并发送更新文件到数据接收方文件服务器。9 基于接口的交换 9.1 接口发布 9.1.1 数据提供方自行发布接口，所发布接口应符合 4.3.3 的规定。9.1.2 数据提供方通过浏览器登录智慧统战综合服务平台，在数据共享交换配置功能中配置需发布的接口信息。接口信息配置内容：接口名称、接口地址、数据目录、请求参数、返回格式、所属交换前置系统。数据目录见附录 A，请求参数、返回格式见 4.3.3 的规定。9.1.3 智慧统战综合服务平台动态生成代理接口及对应授权码 AuthorizationCode。9.2 接口调用 9.2.1 数据接收方通过浏览器登录智慧统战综合服务平台，申请数据资源，经数据提供方审核通过后，获取申请身份认证码 SecretKey，在数据接口地址中获取代理接口地址及授权码 AuthorizationCode。9.2.2 智慧统战综合服务平台接口均为 RESTful 接口，响应信息为 JSON 格式，请求接口时将身份认证码 SecretKey 和服务授权码 AuthorizationCode 填写至 HTTP 请求头中，请求参数、请求方法、格式、返回参数以数据目录详情中的描述为准。异常请求返回状态见附录 C。A A 附 录 A（规范性附录）数据目录 数据目录表见表A.1。表A.1 数据目录表 编号 目录数据项 说明 1 数据目录编码 应符合 DB61/T1344.2-2020 中第 3 章数据编码规定 2 名称 数据的名称 3 数据提供部门 数据目录来源部门 4 发布时间 数据目录首次发布的具体时间 5 更新时间 数据目录更新的具体时间 6 共享方式 支持共享数据的方式，基于库表交换、基于文件交换、基于接口交换三种方式 7 更新周期 数据目录更新周期，如年、月、周、日等。共享方式为基于接口交换方式时，该内容不填写 7 支持格式 数据格式，基于库表交换为数据库类型，基于文件交换为文件后缀名，基于接口交换为JSON 格式 9 资源状态 数据目录所指数据资源的状态，如活跃、废弃等 10 来源系统 数据来源所属的信息系统名称 B B 附 录 B（规范性附录）数据接口 B.1 数据接口模型 B.1.1 数据接口模型组成 数据接口模型由数据结构、数据集、附件集，如图B.1所示，其中：图B.1 数据接口模型 a)数据结构：1)元素名称：EnvelopInfo；2)说明：描述交换信息内容的结构信息；3)约束/条件：必备。b)数据集：1)元素名称：PackageInfo；2)说明：封装结构化数据；3)约束/条件：必备。c)附件集：1)元素名称：Attachments；2)说明：表示非结构化数据；3)约束/条件：可选。B.1.2 数据接口模型结构 数据结构由报文编号、业务编码、报文发送时间、报文发送者、报文接受者、业务数据记录数六个元素组成，其结构如图B.2所示,其中：图B.2 数据结构 a)报文编号：1)元素名称：MessageId；2)说明：交换内容的报文编号，格式为日期(yyyyMMddHHmmss)+四位随机数；3)约束条件：必备。b)业务编码：1)元素名称：MessageType；2)说明：根据 DB61/T1344.2-2020 中第 3 章数据编码规定，数据编码一段/数据编码二段；3)约束条件：必备。c)报文发送时间：1)元素名称：MessageTime；2)说明：报文发送的实际时间，格式为：yyyy-MM-dd HH:mm:ss；3)约束条件：必备。d)报文发送单位：1)元素名称：MessageSender；2)说明：报文来源发送单位名称；3)约束条件：必备。e)报文接收单位：1)元素名称：MessageReceiver；2)说明：报文接受单位名称；3)约束条件：可选。f)业务数据记录数：1)元素名称：Count；2)说明：数据集数据条数，格式数值型；3)约束条件：可选。B.1.3 数据集 数据集用来封装结构化数据，是对数据结构的实例化。数据集由一条或多条数据记录组成，其结构如图B.3所示，其中：图B.3 数据集 a)数据记录：1)元素名称：DataNode；2)说明：组成数据集的基本单位，表示一条记录，例如关系型数据库中表的一行或电子表格的一行等。数据记录由一个或多个数据项实例组成；3)约束/条件：必备，至少出现一次。b)数据项示例：数据项应符合 DB61/T1344.2-2020 中第 4 章数据结构规定的格式和内容。B.1.4 附件集 附件集用来封装非结构化数据，如PDF文件、Word文档、图片等。附件集由一个或多个附件构成，其结构如图B.4所示，其中：图B.4 附件集 a)附件标识：1)元素名称：AttachmentID；2)说明：附件唯一标识，格式为日期(yyyyMMddHHmmss)+四位随机数+文件类型后缀名；3)约束/条件：必备。b)附件名称：1)元素名称：AttachmentName；2)说明：附件的名称；3)约束/条件：必备。c)附件描述：1)元素名称：AttachmentDescription；2)说明：对附件的解释性信息；3)约束/条件：可选。d)附件类型：1)元素名称：AttachmentType；2)说明：文件后缀名称；3)约束/条件：必备。e)附件内容：1)元素名称：AttachmentContent；2)说明：附件文件流转码为 Base64 形式编码进行传输；3)约束/条件：必备。B.2 数据接口JSON模型 EnvelopInfo:MessageId:报文编号,MessageType:报文业务编号,MessageTime:报文发送时间,MessageSender:报文发送者,MessageReceive:报文接受者,Count:业务记录数 ,PackageInfo:peopleType:统战对象类型,personName:姓名,sex:性别,nation:民族,idNumber:身份证号码,certificateType:有效证件类型,certificateNum:有效证件号码,birthday:出生日期,nationality:国籍,homeDomicile:常住地,political:政治面貌,nativePlace:户籍所在地,fullTimeDegree:全日制学历,academicDegree:全日制学位,onJobEducation:在职教育学历,onJobDegree:在职教育学位,email:电子邮件,telephone:移动电话 ,peopleType:统战对象类型,personName:姓名,sex:性别,nation:民族,idNumber:身份证号码 ,AttachmentsType:AttachmentID:附件标识,AttachmentName:附件名称,AttachmentDescription:附件描述,AttachmentType:附件类型,AttachmentContent:附件内容 C C 附 录 C（规范性附录）接口协议格式 C.1.1 发布服务接口协议格式 表C.1 发布服务接口协议格式表 接口名称 交换数据描述，按照数据分类编码-数据来源部门格式命名 请求路径 HTTPS:/XXX/API/请求方式 GET 请求参数 依据DB61/T1344.2-2020中第4章数据结构 成功 State 状态码见附录C.2 message 请求状态说明 dataset 服务接口返回对象见附录C.3 失败 State 状态码见附录C.2 Error 错误信息 C.1.2 服务接口请求状态码 表C.2 服务接口请求状态码表 状态码 含义 200 请求已成功 400 请求信息不完整或无法解析 401 访问令牌没有提供，或者无效 403 访问令牌有效，但没有权限 404 资源不存在 409 资源冲突 422 请求信息完整，但无效 500 服务器内部抛出错误 C.1.3 服务接口请求返回参数 表C.3 服务接口请求返回参数 参数名称 参数类型 参数说明 totalCount Integer 数据总数量 pageSize Integer 数据每页数量 totalPage Integer 数据总页数 currPage Integer 数据当前页 data dataType 数据集，依据DB61/T1344.2-2020中第4章数据结构。_