1、 ICS 01.040.03 A 12 DB52 贵州省地方标准 DB52/T 12602018 政务云 贵州省电子政务网 应用平台公文数据交换规范 2018 - 04 - 16 发布 2018 - 10 - 16 实施贵州省质量技术监督局 发 布 DB52/T 12602018 I 目 次 前言 . II 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 系统结构 . 1 5 全局通讯地址 . 2 6 公文交换业务 . 3 7 数据格式 . 5 8 接口 . 12 附录 A（规范性附录） 电子公文交换相关报文信封格式定义. 16 DB52/T 12602018 II
2、前 言 本标准按照GB/T 1.1-2009标准化工作导则 第1部分：标准的结构和编写给出的规则起草。 请注意：本文件的某些内容可能涉及专利，本文件的发布机构不承担识别这些专利的责任。 本标准由贵州省人民政府办公厅提出。 本标准起草单位：贵州省人民政府办公厅、贵州省信息中心、贵州省标准化院、北京致远互联软件股份有限公司。 本标准主要起草人：王红、彭玉新、王翔、万鹏、刘俊凯、侯庆、罗华洋、黎智坤、罗国远、叶彧、周浩、杨佰元、任欣、杨帆、曾芳、折小荣、马静、王晓。 DB52/T 12602018 1 政务云 贵州省电子政务网应用平台公文数据交换规范 1 范围 本标准规定了贵州省电子政务网应用平台内
3、公文数据交换的全局通讯地址、 系统结构、 公文交换业务、数据格式、接口。 本标准适用于贵州省政务云内省公文处理和事务办理系统非涉密电子公文数据的数据交换。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 1988 信息技术 信息交换用七位编码字符集 GB/T 33476 党政机关电子公文格式规范 GB/T 33477 党政机关电子公文标识规范 GB/T 33479 党政机关电子公文交换接口规范 GM/T 0006 密码应用标识规范 3 术语和定义 下列术
4、语和定义适用于本文件。 3.1 贵州省电子政务网 贵州省电子政务网是由贵州省人民政府办公厅牵头统一建设的， 面向全省各级政府及其部门， 集协同工作、学习，加强内部管理、交流等功能为一体的全省政府系统行政办公总平台及总入口，是贵州省电子政务云的一个重要应用平台， 其基于国家电子政务外网环境建设， 功能定位主要是为全省政府系统公务人员提供信息资源共享、数据互联互通和联动办公服务。 3.2 通讯实体 参与交换过程的电子公文处理系统、组织机构、人员，统称通讯实体。 4 系统结构 4.1 系统结构主要由处理系统和交换系统两大类构成，其交换接口和数据格式关系见图 1。 DB52/T 12602018 2
5、交换系统1交换系统2交换系统3处理系统E处理系统F处理系统G处理系统D处理系统C处理系统B处理系统A公文传输信封公文传输信封公文传输信封报文传输信封图示：交换系统交换系统处理系统处理系统交换系统间接口交换系统和处理系统间接口交换平台 图1 电子公文交换接口与数据格式 示例：处理系统 A 发送一份公文至处理系统 D。 4.2 处理系统 A 按第 7 章数据格式规范封装公文传输信封，按照第 5 章全局通讯地址规范发送到交换平台中，交换平台根据第 5 章全局通讯地址中处理系统 A 地址发送，处理系统 D 接收。 5 全局通讯地址 5.1 通讯实体 通讯实体间及与交换平台关系如图2所示。 图2 通讯实
6、体间及与平台关系 5.2 通讯地址 5.2.1 交换平台是基于组织机构人员库进行数据通信的。依据组织机构人员库，通讯实体都能够以独特信息来构造一个地址，通过该地址就能将交换信息送达至对方。 5.2.2 地址实体可分为平台地址、 接入系统地址两大类。 平台地址为服务平台中通讯实体的唯一地址；接入系统地址为接入系统（如：省公文处理和事务办理系统）或接入系统中通讯实体的唯一地址。一个平台地址可能对应多个接入系统地址，且不同种类地址间可以相互转换。 DB52/T 12602018 3 5.3 表述格式 5.3.1 通讯地址可以通过字符串进行表示，由名称、所属系统、类型和编码组成，通讯地址类型要素说明见
7、表 1。 表1 通讯地址类型要素说明 名称 类型 默认值 描述 name xs:string “” 地址名称（实体名称），不能包含“|” “,”和“” resource xs:string 0 系统编码。当为0时表示平台标准对象（平台实体） type xs:string “system”地址类型： （系统） system, （单位） account, （部门） department,（人员）member id xs:string -1 地址ID（实体ID）。默认为-1，表示未设值。 只有当type为system时，该属性可为默认值；否则，该属性都应该指对应的id 注：格式为：resource|
8、type|id|name，多个地址时以“”（GB/T 1988 规定的编码为5E）分割。 5.3.2 图 1 中内容的通讯地址可以表示成如表 2。 表2 通讯地址示例 名称 平台地址 接入系统地址 交换平台 0|system|-1|交换平台 - 系统A 0|system|001|系统A 001|system|-1|系统A 系统B 0|system|002|系统B 002|system|-1|系统B 组织1 0|account|003|组织1 001|account|123|组织1 002|account|456|组织1 组织2 0|account|004|组织2 001|account|456
9、|组织2 组织3 0|account|005|组织3 002|account|789|组织3 6 公文交换业务 6.1 概述 6.1.1 交换系统通过报文内容的交换完成任意电子文件数据的传输或者相关消息的传递。按照不同用途，报文内容分为系统报文和业务报文。系统报文用于各种计算机状态消息的传递，业务报文则用于文件数据的传输和业务状态消息的传递。 6.1.2 当用于传输公文时，业务报文内容既可以是公文文件，也可能仅是简短的业务状态消息，这两种报文内容节点分别使用“公文类型”或“公文短报文类型”进行限定。 6.2 公文类型 6.2.1 当业务报文中“类型”取值为“OFC”时，7.1.5 中“内容”节
10、点按照公文类型进行解析，公文类型的结构见图 3。 DB52/T 12602018 4 图3 公文类型结构 6.2.2 公文类型的要素说明见表 3。 表3 公文类型要素说明 名称 类型 说明 备注 密级 xs:string 待交换公文的元数据，文件的秘密等级 可选 紧急程度 xs:string 待交换公文的元数据，送达和办理的时限要求 可选 发文机关 xs:string 待交换公文的元数据，文件的发文机关 可选 收文机关 xs:string 待交换公文的元数据，文件的收文机关 可选 公文标题 xs:string 待交换公文的元数据，标题 必选 公文内容 xs:base64Binary 电子公文二
11、进制内容的base64编码 必选 扩展属性 xs:anyType 为自主扩展预留 可选 注：公文内容格式需符合党政机关电子公文格式规范，参见GB/T 33476-2016。 6.3 公文短报文类型 6.3.1 当业务报文中“类型”取值为“RET”时，7.1.5 节中“内容”节点按照公文短报文类型进行解析，公文短报文类型的结构见图 4。 DB52/T 12602018 5 图4 公文短报文类型结构 6.3.2 公文短报文类型的要素说明见表 4。 表4 公文短报文类型要素说明 名称 类型 说明 备注 原报文标识 xs:string 本报文针对的报文的标识 必选 业务类型 xs:string 本报文
12、的业务报文类型，可取值见表5 必选 时间 xs:string 本报文的组装时间 必选 意见 xs:string 本报文的意见内容 可选 6.3.3 公文短报文业务类型的取值及其说明见表 5。 表5 公文短报文类型的取值说明 取值 说明 Received 送达 Accepted 签收 Rejected 拒收 Revoked 撤销 Hasten 催办 7 数据格式 7.1 公共数据类型 7.1.1 简单类型说明 报文属性类型的取值及其说明见表6。 表6 报文属性类型的取值说明 取值 说明 SYS 系统报文 BIZ 业务报文 DB52/T 12602018 6 7.1.2 报文内容类型的取值及其说明
13、见表 7。 表7 报文内容类型的取值说明 名称 说明 OFC 表明出现的内容节点按照“公文类型”进行解析 RET 表明出现的内容节点按照“公文短报文类型”进行解析 注：报文内容类型是一个可扩展项，在本标准中仅针对公文进行了扩展。 7.1.3 收发机构类型 7.1.3.1 收发机构类型结构见图 5。 图5 收发机构类型结构 7.1.3.2 收发机构类型的要素说明见表8。 表8 收发机构类型要素说明 名称 类型 说明 备注 身份标识 xs:string 机构或者地址在平台中的唯一标识 必选 身份名称 xs:string 机构或者地址在平台中的名称 必选 身份描述 xs:string 机构或者地址的
14、其他补充描述 可选 注：身份标识，需要满足统一组织机构管理平台规范，格式参见5.3字符串表述格式部分。 7.1.4 密码算法类型 7.1.4.1 密码算法类型结构见图6。 图6 密码算法结构 7.1.4.2 密码算法类型属性说明见表9。 DB52/T 12602018 7 表9 密码算法类型说明 名称 类型 说明 备注 签名算法 xs:string 签名所采用的签名算法，当需要对信封进行签名时出现该节点 可选 加密算法 xs:string 加密所采用的加密算法，当需要对报文内容加密时出现该节点，仅适用于业务报文 可选 注：商密的摘要和签名算法遵照GM/T 0006标准，其他密级的算法遵照相应规
15、范。 7.1.5 系统报文类型 7.1.5.1 系统报文类型结构见图7。 图7 系统报文类型结构 7.1.5.2 系统报文类型的要素说明见表10。 表10 系统报文类型要素说明 名称 类型 说明 备注 原报文标识 xs:string 该报文针对的报文的标识 必选 类型 xs:string 报文消息类型 必选 时间 xs:string 报文消息的时间 必选 备注 xs:string 报文消息的内容 可选 7.1.6 业务报文类型 7.1.6.1 业务报文类型的结构见图 8。 DB52/T 12602018 8 图8 业务报文类型结构 7.1.6.2 业务报文类型的要素说明见表11。 表11 业务
16、报文类型要素说明 名称 类型 说明 备注 类型 报文内容类型 报文内容的类型， 确定其后出现的内容节点按何种类型进行扩展解释，见表7 必选 内容 xs:string 报文内容，依据类型声明按照不同结构进行分析，见6.2和6.3 必选 附件 与内容相关的附件 可选 -附件名称 xs:string 附件的名称 必选 -扩展名 xs:string 附件的扩展名 可选 -附件标识 xs:string 附件的标识，由具体的应用确定 可选 -附件大小 xs: unsignedInt 附件的文件大小，单位字节 可选 -附件内容 xs:base64Binary 附件文件二进制流的 base64 编码 必选 注
17、：附件标识必须保证唯一性，例如报文标识加编号。附件大小以字节为单位。 7.2 报文传输信封 7.2.1 报文传输信封组成 7.2.1.1 交换系统之间传输的数据文件称为报文传输信封，该文件为XML，报文信封模型见附录A.其根节点“报文传输信封”的结构见图9。 DB52/T 12602018 9 图9 报文传输信封结构 7.2.1.2 报文传输信封说明见表12。 表12 报文传输信封说明 名称 类型 说明 备注 Version xs:string 用于协议互通的版本号，固定为1.0 必选 报文头 报文传输的头部结构 必选 报文体 报文传输的主体部分结构，用于封装报文内容和附件 必选 签名 需要对
18、报文内容作签名保护时，记录针对整个报文信封的签名值和相关信息 可选 7.2.2 报文头 7.2.2.1 报文头结构见图10。 DB52/T 12602018 10 图10 报文头结构 7.2.2.2 报文头说明见表13。 表13 报文头说明 名称 类型 说明 备注 报文标识 xs:string 报文传输中的唯一标识信息 必选 报文属性 报文属性类型 报文的属性，区分报文体中是系统报文还是业务报文，见表7 必选 报文发送方 收发机构类型 报文发送方相关信息，见表8 必选 报文接收方 收发机构类型 报文接收方相关信息，见表8 必选 发出时间 xs:dateTime 报文发出的时间 必选 密码算法
19、密码算法类型 保护报文内容使用的算法等信息，此节点不存在时不做任何保护；出现时应用密码保护，可以是加密和签名的组合应用，见表 9 可选 报文备注 xs:string 报文的备注信息 可选 传输票据 xs:string 表示后续公文传输关系的信任凭证 可选 7.2.3 报文体 7.2.3.1 报文体结构见图11。 DB52/T 12602018 11 图11 报文体结构 7.2.3.2 报文体说明见表14。 表14 报文体说明 名称 类型 说明 备注 系统报文 系统报文类型 系统短报文内容，报文头中报文属性取值为SYS时应出现此节点 必选 明文报文 业务报文类型 待传输的报文内容，见 7.1.5
20、；报文头中报文属性取值为 BIZ 且密码算法中不出现加密选项时出现 必选密文报文 xs:base64Binary 待传输的经加密的报文内容，是“明文报文”节点内容的密码运算结果；报文头中报文属性取值为 BIZ 且密码算法中出现加密选项时出现 必选7.2.4 签名 7.2.4.1 签名的结构见图12。 图12 签名类型结构 7.2.4.2 签名的说明见表15。 表15 签名类型说明 名称 类型 说明 备注签名者 xs:string 执行签名的机构或服务 可选签名时间 xs:dateTime 签名的时间 可选签名值 xs:base64Binary 针对报文传输信封整个文件的二进制内容摘要和签名所得
21、的数字签名值；签名和验证签名时，应将本节点内容置空后再进行相关运算 必选DB52/T 12602018 12 7.3 公文传输信封 7.3.1 公文传输信封组成 7.3.1.1 交换系统与处理系统之间传输的数据文件称为报文传输信封， 该文件以 XML 形式描述， 其根节点“公文传输信封”的结构见图 13。 图13 公文传输信封结构 7.3.1.2 公文传输信封要素说明见表16。 表16 公文传输信封要素说明 名称 类型 说明 备注 Version xs:string 用于协议互通的版本号，固定为1.0 必选 封装实体 被传输实体，可以为多个 必选 -报文标识 xs:string 报文传输中的唯
22、一标识信息 必选 -发文机关 收发机构类型 报文发送方相关信息，见表8 必选 -收文机关 收发机构类型 报文接收方相关信息，见表8 必选 -明文报文 业务报文类型 传递的报文内容，见7.1.5 必选 8 接口 8.1 总体要求 电子公文交换系统与处理系统以及不同的交换系统之间以报文形式进行数据交换， 交换系统和处理系统以WebService方式提供对外接口。 DB52/T 12602018 13 8.2 交换系统间的接口 8.2.1 受信代码要求 交换系统之间进行报文传输之前应先建立受信代码。 受信代码由系统随机产生、 双方认可且不重复的字符串组成，用于确认双方身份。受信代码要求如下： a)
23、受信代码为 32 位的 UUID； b) 交换系统之间进行报文传输应带有受信代码信息，否则被请求方应拒绝接收； c) 受信代码建立后在有效期内可多次使用；有效时间由双方协商确定，双方均可强行终止； d) 受信代码建立后在有效期内不再重复请求受信代码； e) 交换系统应维护受信代码、及时销毁已经超时的受信代码。 注：双方受信代码不一致的情况有可能发生，如一方系统故障或一方主动销毁。 8.2.2 建立受信代码 8.2.2.1 功能说明 请求受信代码。 8.2.2.2 接口原型 string reqWebService(string unitId, string linkCode, string s
24、econds, string reqType)。 8.2.2.3 参数说明（4 个参数） ： a) 参数 1：unitId 请求建立受信代码的单位标识，该值为收发机构类型的身份标识，见 7.1.2； b) 参数 2：linkCode 预设握手字符串，由发送方生成的一串随机字符组成。此字符串用于确认被请求方返回的信息是否是针对本次请求； c) 参数 3：seconds 表示超时时间，即受信代码的有效时间，单位秒； d) 参数 4：reqType 代表请求类型，枚举值，可取值为：BGN 请求建立受信代码；END 请求强制终止受信代码。 8.2.2.4 返回值说明 . 注1：其中，unitId 为被
25、请求方的单位标识，linkCode 为请求方生成的握手信号，transCode 为受信代码。 注2：若该接口返回值为 refuse（拒绝连接），则请求方应终止后继操作。 8.2.3 传输报文 8.2.3.1 功能说明 请求传输报文。 8.2.3.2 接口原型 string sendBaseXMLEsbWebService(string transCode, string message) 8.2.3.3 参数说明（2 个参数） ： a) 参数 1：transCode 受信代码； b) 参数 2：message 报文，其格式应遵照 7.2 的要求。 8.2.3.4 返回值说明 0 表示报文接收成
26、功；1 表示被请求方不认可作为参数的受信代码。则请求方应按照 8.2.2 请求得到新的受信代码后再传输报文。 注1：其他非 0 值表示错误代码。 DB52/T 12602018 14 8.3 处理系统与交换系统间接口 8.3.1 交换系统接收报文 8.3.1.1 功能说明 交换系统接收处理系统发送的报文，与交换系统之间的传输报文的接口名称一致。 8.3.1.2 接口原型 string sendBaseXMLEsbWebService(string transCode，string message) 8.3.1.3 参数说明（2 个参数） ： a) 参数 1：transCode 受信代码； b)
27、 参数 2：message 传输报文，格式应遵照 7.3 的要求。 8.3.1.4 返回值说明 0 表示报文接收成功；1 表示被请求方不认可作为参数的受信代码。则请求方应按照 8.2.2 请求得到新的受信代码后再传输报文。2 表示传输报文不符合格式要求。 注1：其他非 0 值表示错误代码。 8.3.2 处理系统接收报文 8.3.2.1 功能说明 处理系统接收交换系统发送的报文。 8.3.2.2 接口原型 string receiveBaseXMLEsbWebService(string transCode，string message) 8.3.2.3 参数说明（1 个参数） ： a) 参数
28、1：transCode 受信代码； b) 参数 2：message 传输报文，格式应遵照 7.3 的要求。 8.3.2.4 返回值说明 0 表示报文接收成功；1 表示被请求方不认可作为参数的受信代码。则请求方应按照 8.2.2 请求得到新的受信代码后再传输报文。2 表示传输报文不符合格式要求。 注1：其他非 0 值表示错误代码。 8.4 穿透查看公文 8.4.1 交换系统处理穿透查看请求 8.4.1.1 功能说明 交换系统处理处理系统穿透查看请求，返回公文处理系统的地址。 8.4.1.2 接口原型 string getAddressWebService(string transCode，str
29、ing unitId) 8.4.1.3 参数说明（1 个参数） ： a) 参数 1：transCode 受信代码； b) 参数 2：收发文机构标识，格式应遵照 7.1.2 的要求。 8.4.1.4 返回值说明 .其中 flag 为请求结果代码； 0 表示处理成功，地址为 address 的值，表示处理系统的网络访问地址；1 表示被请求方不认可作为参数的受信代码。则请求方应按照 8.2.2 请求得到新的受信代码后再传输报文；2 表示传 unitId 不符合格式要求；3 表示未查询到机构对应的处理系统地址。 DB52/T 12602018 15 注：其他非0值表示错误代码。 8.4.2 处理系统处
30、理穿透查看请求 8.4.2.1 功能说明 处理系统接收处理穿透查看请求，展示可查看的页面，使用 HTTP 1.0 协议。 8.4.2.2 接口原型 http(s):/address/viewEdoc.do?token=token&edocId=edocId 8.4.2.3 参数说明（1 个参数） ： a) 参数 1：token 单点登录凭证，该规范不做详细说明； b) 参数 2：edocId 电子公文标识，base64 密文，明文格式宜遵 GB/T 33477 要求。 8.4.2.4 返回值说明 正常情况返回 html 页面数据；异常情况返回错误提示信息。 DB52/T 12602018 16 A A 附 录 A （规范性附录） 电子公文交换相关报文信封格式定义 系统报文 业务报文 公文 公文短报文 DB52/T 12602018 17 DB52/T 12602018 18 DB52/T 12602018 19 送达 签收 拒收 撤销 催办 DB52/T 12602018 20 _ DB52/T 1260-2018
