DB52∕T 1260-2018 政务云 贵州省电子政务网 应用平台公文数据交换规范 28页

ICS01.040.03A12DB52贵州省地方标准DB52/T1260—2018政务云贵州省电子政务网应用平台公文数据交换规范2018-04-16发布2018-10-16实施贵州省质量技术监督局发布\n\nDB52/T1260—2018目次前言................................................................................II1范围..............................................................................12规范性引用文件....................................................................13术语和定义........................................................................14系统结构..........................................................................15全局通讯地址......................................................................26公文交换业务......................................................................37数据格式..........................................................................58接口.............................................................................12附录A（规范性附录）电子公文交换相关报文信封格式定义...............................16I\n\nDB52/T1260—2018前言本标准按照GB/T1.1-2009《标准化工作导则第1部分：标准的结构和编写》给出的规则起草。请注意：本文件的某些内容可能涉及专利，本文件的发布机构不承担识别这些专利的责任。本标准由贵州省人民政府办公厅提出。本标准起草单位：贵州省人民政府办公厅、贵州省信息中心、贵州省标准化院、北京致远互联软件股份有限公司。本标准主要起草人：王红、彭玉新、王翔、万鹏、刘俊凯、侯庆、罗华洋、黎智坤、罗国远、叶彧、周浩、杨佰元、任欣、杨帆、曾芳、折小荣、马静、王晓。II\n\nDB52/T1260—2018政务云贵州省电子政务网应用平台公文数据交换规范1范围本标准规定了贵州省电子政务网应用平台内公文数据交换的全局通讯地址、系统结构、公文交换业务、数据格式、接口。本标准适用于贵州省政务云内省公文处理和事务办理系统非涉密电子公文数据的数据交换。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T1988信息技术信息交换用七位编码字符集GB/T33476党政机关电子公文格式规范GB/T33477党政机关电子公文标识规范GB/T33479党政机关电子公文交换接口规范GM/T0006密码应用标识规范3术语和定义下列术语和定义适用于本文件。3.1贵州省电子政务网贵州省电子政务网是由贵州省人民政府办公厅牵头统一建设的，面向全省各级政府及其部门，集协同工作、学习，加强内部管理、交流等功能为一体的全省政府系统行政办公总平台及总入口，是贵州省电子政务云的一个重要应用平台，其基于国家电子政务外网环境建设，功能定位主要是为全省政府系统公务人员提供信息资源共享、数据互联互通和联动办公服务。3.2通讯实体参与交换过程的电子公文处理系统、组织机构、人员，统称通讯实体。4系统结构4.1系统结构主要由处理系统和交换系统两大类构成，其交换接口和数据格式关系见图1。1\nDB52/T1260—2018公文传输信封公文传输信封交换平台处理系统A交换系统1交换系统2处理系统D处理系统B报文传输信封图示：交换系统3交换系统交换系统处理系统C处理系统处理系统公文传输信封交换系统间接口交换系统和处处理系统E处理系统F处理系统G理系统间接口图1电子公文交换接口与数据格式示例：处理系统A发送一份公文至处理系统D。4.2处理系统A按第7章数据格式规范封装公文传输信封，按照第5章全局通讯地址规范发送到交换平台中，交换平台根据第5章全局通讯地址中处理系统A地址发送，处理系统D接收。5全局通讯地址5.1通讯实体通讯实体间及与交换平台关系如图2所示。图2通讯实体间及与平台关系5.2通讯地址5.2.1交换平台是基于组织机构人员库进行数据通信的。依据组织机构人员库，通讯实体都能够以独特信息来构造一个地址，通过该地址就能将交换信息送达至对方。5.2.2地址实体可分为平台地址、接入系统地址两大类。平台地址为服务平台中通讯实体的唯一地址；接入系统地址为接入系统（如：省公文处理和事务办理系统）或接入系统中通讯实体的唯一地址。一个平台地址可能对应多个接入系统地址，且不同种类地址间可以相互转换。2\nDB52/T1260—20185.3表述格式5.3.1通讯地址可以通过字符串进行表示，由名称、所属系统、类型和编码组成，通讯地址类型要素说明见表1。表1通讯地址类型要素说明名称类型默认值描述namexs:string“”地址名称（实体名称），不能包含“|”“,”和“^”resourcexs:string0系统编码。当为0时表示平台标准对象（平台实体）地址类型：（系统）system,（单位）account,（部门）department,typexs:string“system”（人员）member地址ID（实体ID）。默认为-1，表示未设值。idxs:string-1只有当type为system时，该属性可为默认值；否则，该属性都应该指对应的id注：格式为：resource|type|id|name，多个地址时以“^”（GB/T1988规定的编码为5E）分割。5.3.2图1中内容的通讯地址可以表示成如表2。表2通讯地址示例名称平台地址接入系统地址交换平台0|system|-1|交换平台-系统A0|system|001|系统A001|system|-1|系统A系统B0|system|002|系统B002|system|-1|系统B001|account|123|组织1组织10|account|003|组织1002|account|456|组织1组织20|account|004|组织2001|account|456|组织2组织30|account|005|组织3002|account|789|组织36公文交换业务6.1概述6.1.1交换系统通过报文内容的交换完成任意电子文件数据的传输或者相关消息的传递。按照不同用途，报文内容分为系统报文和业务报文。系统报文用于各种计算机状态消息的传递，业务报文则用于文件数据的传输和业务状态消息的传递。6.1.2当用于传输公文时，业务报文内容既可以是公文文件，也可能仅是简短的业务状态消息，这两种报文内容节点分别使用“公文类型”或“公文短报文类型”进行限定。6.2公文类型6.2.1当业务报文中“类型”取值为“OFC”时，7.1.5中“内容”节点按照公文类型进行解析，公文类型的结构见图3。3\nDB52/T1260—2018图3公文类型结构6.2.2公文类型的要素说明见表3。表3公文类型要素说明名称类型说明备注密级xs:string待交换公文的元数据，文件的秘密等级可选紧急程度xs:string待交换公文的元数据，送达和办理的时限要求可选发文机关xs:string待交换公文的元数据，文件的发文机关可选收文机关xs:string待交换公文的元数据，文件的收文机关可选公文标题xs:string待交换公文的元数据，标题必选公文内容xs:base64Binary电子公文二进制内容的base64编码必选扩展属性xs:anyType为自主扩展预留可选注：公文内容格式需符合《党政机关电子公文格式规范》，参见GB/T33476-2016。6.3公文短报文类型6.3.1当业务报文中“类型”取值为“RET”时，7.1.5节中“内容”节点按照公文短报文类型进行解析，公文短报文类型的结构见图4。4\nDB52/T1260—2018图4公文短报文类型结构6.3.2公文短报文类型的要素说明见表4。表4公文短报文类型要素说明名称类型说明备注原报文标识xs:string本报文针对的报文的标识必选业务类型xs:string本报文的业务报文类型，可取值见表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业务报文5\nDB52/T1260—20187.1.2报文内容类型的取值及其说明见表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机构或者地址的其他补充描述可选注：身份标识，需要满足统一组织机构管理平台规范，格式参见5.3字符串表述格式部分。7.1.4密码算法类型7.1.4.1密码算法类型结构见图6。图6密码算法结构7.1.4.2密码算法类型属性说明见表9。6\nDB52/T1260—2018表9密码算法类型说明名称类型说明备注签名所采用的签名算法，当需要对信封进行签名时出现签名算法xs:string可选该节点加密所采用的加密算法，当需要对报文内容加密时出现加密算法xs:string可选该节点，仅适用于业务报文注：商密的摘要和签名算法遵照GM/T0006标准，其他密级的算法遵照相应规范。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。7\nDB52/T1260—2018图8业务报文类型结构7.1.6.2业务报文类型的要素说明见表11。表11业务报文类型要素说明名称类型说明备注报文内容的类型，确定其后出现的内容节点按何类型报文内容类型必选种类型进行扩展解释，见表7报文内容，依据类型声明按照不同结构进行分内容xs:string必选析，见6.2和6.3附件与内容相关的附件可选--附件名称xs:string附件的名称必选--扩展名xs:string附件的扩展名可选--附件标识xs:string附件的标识，由具体的应用确定可选--附件大小xs:unsignedInt附件的文件大小，单位字节可选--附件内容xs:base64Binary附件文件二进制流的base64编码必选注：附件标识必须保证唯一性，例如报文标识加编号。附件大小以字节为单位。7.2报文传输信封7.2.1报文传输信封组成7.2.1.1交换系统之间传输的数据文件称为报文传输信封，该文件为XML，报文信封模型见附录A.其根节点“报文传输信封”的结构见图9。8\nDB52/T1260—2018图9报文传输信封结构7.2.1.2报文传输信封说明见表12。表12报文传输信封说明名称类型说明备注Versionxs:string用于协议互通的版本号，固定为1.0必选报文头报文传输的头部结构必选报文体报文传输的主体部分结构，用于封装报文内容和附件必选需要对报文内容作签名保护时，记录针对整个报文信签名可选封的签名值和相关信息7.2.2报文头7.2.2.1报文头结构见图10。9\nDB52/T1260—2018图10报文头结构7.2.2.2报文头说明见表13。表13报文头说明名称类型说明备注报文标识xs:string报文传输中的唯一标识信息必选报文属性报文属性类型报文的属性，区分报文体中是系统报文还是业务报文，见表7必选报文发送方收发机构类型报文发送方相关信息，见表8必选报文接收方收发机构类型报文接收方相关信息，见表8必选发出时间xs:dateTime报文发出的时间必选保护报文内容使用的算法等信息，此节点不存在时不做任何密码算法密码算法类型保护；出现时应用密码保护，可以是加密和签名的组合应用，可选见表9报文备注xs:string报文的备注信息可选传输票据xs:string表示后续公文传输关系的信任凭证可选7.2.3报文体7.2.3.1报文体结构见图11。10\nDB52/T1260—2018图11报文体结构7.2.3.2报文体说明见表14。表14报文体说明名称类型说明备注系统报文系统报文类型系统短报文内容，报文头中报文属性取值为SYS时应出现此节点必选待传输的报文内容，见7.1.5；报文头中报文属性取值为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的数字签名值；签名和验证签名时，应将本节点内容置空必选后再进行相关运算11\nDB52/T1260—20187.3公文传输信封7.3.1公文传输信封组成7.3.1.1交换系统与处理系统之间传输的数据文件称为报文传输信封，该文件以XML形式描述，其根节点“公文传输信封”的结构见图13。图13公文传输信封结构7.3.1.2公文传输信封要素说明见表16。表16公文传输信封要素说明名称类型说明备注Versionxs:string用于协议互通的版本号，固定为1.0必选封装实体被传输实体，可以为多个必选--报文标识xs:string报文传输中的唯一标识信息必选--发文机关收发机构类型报文发送方相关信息，见表8必选--收文机关收发机构类型报文接收方相关信息，见表8必选--明文报文业务报文类型传递的报文内容，见7.1.5必选8接口8.1总体要求电子公文交换系统与处理系统以及不同的交换系统之间以报文形式进行数据交换，交换系统和处理系统以WebService方式提供对外接口。12\nDB52/T1260—20188.2交换系统间的接口8.2.1受信代码要求交换系统之间进行报文传输之前应先建立受信代码。受信代码由系统随机产生、双方认可且不重复的字符串组成，用于确认双方身份。受信代码要求如下：a)受信代码为32位的UUID；b)交换系统之间进行报文传输应带有受信代码信息，否则被请求方应拒绝接收；c)受信代码建立后在有效期内可多次使用；有效时间由双方协商确定，双方均可强行终止；d)受信代码建立后在有效期内不再重复请求受信代码；e)交换系统应维护受信代码、及时销毁已经超时的受信代码。注：双方受信代码不一致的情况有可能发生，如一方系统故障或一方主动销毁。8.2.2建立受信代码8.2.2.1功能说明请求受信代码。8.2.2.2接口原型stringreqWebService(stringunitId,stringlinkCode,stringseconds,stringreqType)。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为被请求方的单位标识，linkCode为请求方生成的握手信号，transCode为受信代码。注2：若该接口返回值为refuse（拒绝连接），则请求方应终止后继操作。8.2.3传输报文8.2.3.1功能说明请求传输报文。8.2.3.2接口原型stringsendBaseXMLEsbWebService(stringtransCode,stringmessage)8.2.3.3参数说明（2个参数）：a)参数1：transCode受信代码；b)参数2：message报文，其格式应遵照7.2的要求。8.2.3.4返回值说明0表示报文接收成功；1表示被请求方不认可作为参数的受信代码。则请求方应按照8.2.2请求得到新的受信代码后再传输报文。注1：其他非0值表示错误代码。13\nDB52/T1260—20188.3处理系统与交换系统间接口8.3.1交换系统接收报文8.3.1.1功能说明交换系统接收处理系统发送的报文，与交换系统之间的传输报文的接口名称一致。8.3.1.2接口原型stringsendBaseXMLEsbWebService(stringtransCode，stringmessage)8.3.1.3参数说明（2个参数）：a)参数1：transCode受信代码；b)参数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接口原型stringreceiveBaseXMLEsbWebService(stringtransCode，stringmessage)8.3.2.3参数说明（1个参数）：a)参数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接口原型stringgetAddressWebService(stringtransCode，stringunitId)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表示未查询到机构对应的处理系统地址。14\nDB52/T1260—2018注：其他非0值表示错误代码。8.4.2处理系统处理穿透查看请求8.4.2.1功能说明处理系统接收处理穿透查看请求，展示可查看的页面，使用HTTP1.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/T33477要求。8.4.2.4返回值说明正常情况返回html页面数据；异常情况返回错误提示信息。15\nDB52/T1260—2018AA附录A（规范性附录）电子公文交换相关报文信封格式定义系统报文业务报文公文公文短报文16\nDB52/T1260—201817\nDB52/T1260—201818\nDB52/T1260—2018送达签收拒收撤销催办19\nDB52/T1260—2018_________________________________20\n\nDB52/T1260-2018