SZSD01 0017—2024数字政务业务协同交换规范.docx

ICS35.240.99CCS1.67SZSD数字山东工程标准SZSD0100172024数字政务业务协同交换规范Specificationtbrcollaborativeexchangeofdigitalgovernmentservices2024-06-01实施2024-04-15发布济南市大数据局发布数字政务业务协同交换规范1葩围本文件规定了数字政务业务协同交帙的服务场景、应用接入要求、元数据定义及相关API接口要求。本文件适用于各层级的“单位、个人、应用”之间端到端的电子公文、工作信息、业务信息、应用数据等各种电子文件交换共享.2规葩性引用文件卜列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款.其中，注日期的引用文件，仅该11期对应的版本适用于本文件：不注口期的引用文件，其破新版本（包括所有的修改单）适用于木文件.GB/T19488.2-2008电子政务数掘元第2部分：公共数据元目录SZSD0029-2023”山东通协同办公平台统一用户接入规范3术语和定义下列术语和定义适用于本文件。3.1元数盘metadata定义和描述其他数据的数据.32中文名称Chinesename指元数据的中文名称.用第7.2章中各条的标卷来表达.3.3定义definition描述无数据实体或元数据元素的荔本内容,给出交换过程某个特性的概念和说明，3.4英文名称CngliShname元数据实体或元数据元素的英文名称.一般用英文全称.所Yf组成词汇应无缝连写.元数据实体和元数据元素首词汇全部采用小写字母，其余好个词汇的首字母采用大写.3.5数据类型datatype说明元数据实体或元数据元素的数据类型。元数据实体类型为复合型，元数据元素类型为单,类型，例如：字符串、日期型、日期时间型、布尔型、整鞭、浮点型、实体盘等。3.6值域datarange说明元数据元素可取他的范也.3.7注解consent对元数据实体或元数据元素的补充说明，包括该元数据实体或元数据元素的约Jlt可选、必选和其他信息等.可选元数据实体可以包含必选元数据元素.但只当可选实体被选用时才成为必选.如果一个可选元数据实体未被使用,则该实体所包含的元素(包括必选元素也不选用.38取值示例examplevalue给出元数据元素取值的示例4缩略语以下缩略语适用于本文件。GUIDi全局唯一标识符(GloballyUniqueIdentifier)QRY1D：全同查询标识符(QueryIdentifier)UUID:通刖唯一识别码(UniVerSaIlyUniqUeIdentifier)5服务场景5. 1於务对象数字政务业务协同交换现葩的眼务对象包括单位、个人、应用系统，上述三种服务对象都可以发送或者接收交换件.6. 2交换内容数字政务业务协同交换观池的交换内容如N：a)电子公文交换：经过电F公文传输系统处理后形成的具有现范格式的公文的电子数据交换.多Fll于单位与单位之间数据交换；W工作估息交换：包括但不同限于本文、图片、视频、录音等类型的文件交换，多用于个人与个人之间数据交换：c)业务信息交换：具有业务处理要求，服务于跨层级、跨单位的业务互操作的交换，业务交换可能涉及一个事务的多次交换过程，多用于单位、个人与应用系统之间数据交换：d)应用数据交换：羟过应用系统间规范化定义及格式预处理后形成的应用数据交换，用于应用系统与应用系统之间数据交换.，6应用系统接入7. «概述应用系统接入数字政务业务协同交换系统流程包括接入串谙、接入审核、应用系统改造、对接联调测试、上线生产运行.应用系统接入流程见图1.图1应用系统接入流程6.2接入申清应用系统接入单位应按照表D1要求填写接入申请表.提交到主管部门进行审核.6-3接入审核63.1接入申请审核通过后，数字政务业务协同交换系统运营总位根据接入巾请表中提供的应用系统名称、应用系统类型、应用系统建设方式、应用系统所在网络域、应用系统服务地址等应用系统相关信息在平台中进行应用注册.6.3.2数字政务业务协同交换系统运营单位在平台中注册相关应用信息后.物注册信息反馈给接入应用系统接入应用系统根据系统改造要求进行开发改造.如接入申请审核未通过,接入应用系统应理新提交接入申请。6.4应用系统改造641统一交换资源接入6.4.1. 1确认交换场景接入应用系统应明确接入数字政务业务协同交换系统的交换场景，包括交换类型及交换内容.交换场景中涉及到的单位、个人及应用系统范用应按照错谈!未找到引用海要求填写应用交换范附登记表。数字政务业务协同交换系统根据交换范围登记表注册所涉及单位、个人及应用系统信息,并向接入应用系统进行交换体系资源目录知悉范阳的授权管理.641.2统一交换资源获取（规范性）统一交换资源接口的接口要求迸行开发改造。接入应用系统应按胪储误!未找到引用海统一交换资源抉取流程见图2.6.4.2. 4.1.3统一奥源映射接入应用系统获取统一交换资源后，应将交换范围登记去中应用系统内部单位、个人信息与统一交换资源中对应单位、个人信息进行关联映射，确保在交换数据发送接入和交换数据接收接入过程中交换资源统一互认。6.4.3. 换数据发送接入接入应用系统应按照债谀!未找到引用海（规范性）交换数据发送接口的接Il要求iS行开发改造，交换数据发送接入流程见图3.附录B（规范性）交换数据发送接口Bl交换文件分片传给接口fiIeDataSendB-1.1接【1说明该接口由交换系统发布，接入应用系统调用，接入应用系统通过该接口将被交换文件分片数据发送到交换系统.B1.2接口定义接口名募StringfiIcDatnSend(StringnppJd.StringftppX11e,Stringgid.intfiIeType,StringfiIeNane,StringfiIeCcmtent,inttoulBlocks.intb】OCkVUnber,Stringoperld,Stringoprrur):»*««*ft定义*?河为空VM说明取值示制aPpId发文应用系统标识srin>:S1.tlD-e33lbtja-a4*13-4c3c-916d-ca3f9d4d3120appiine发文应用系统名称string否自由文本测试系线guid交换件唯标以string否IUID同,交换件雷与农单接口中guid保持,致d7eb3750-b462-4756-8b32-20tfa2n<Mda2fiIeTypc文件类型int否0,11：正文0：附件1fi文件名徐xtring否自由文本文件名称中不健/仃路径利试文件.dxfiIcContent文件片段bnse6l明码后数如tring否自由文本-IotnIBIockN当前文件分块总数intSint类型-1blDckNunbcr当的块序号int否int类型从0开始*号，依为0时去示一个新的文件传输开始0Operld操作白标识stringftIlIID-one除作竹名称stringft自由文本按口版同值格<rcsullXsxe93）处理成功失败标志：0表示调用成功.其他表示调用失败.<sUMe”><m稣）错ifS<nsg><resut>B-2交换表单信息传输接口/formlnfoSendB2.1接口说明该接口由交换系统提供.接入应用系统调用.接入应用系统通过该接I将被交换文件的表单信息数据发送到交换系统.B2.2接口定义<success>:追回成功其他代表失败<,UMRB3><映理）齐goes”的假为0.表示追回成功.则此处的内容为“追网成功”：WsuccessfiH他表示网用失收，则此处的内容为失败庭因说明“解。<result>附录C（规范性）交换数据接收接口C.1交换数娓接收接口recvDataTransferC.1.1接口说明该接口出应用系统发布，交换系统调用。交换系统按照定撷序调用应用系统该接口发送文件片段、表单信息.追回信息及状态回执信息，洋见接I定义中说明.C.1.2接口定义接口名需Stringrecv11at11mnsfer(Stringguid,Stringtype,Stringfilcne,StringfileContent.intdatalndex)«名暮*定义*s珂为主值*说明取值示制gid交换件唯一标识StringSUUlD-type数据类不String否0M1;正文0:附件2:登记表单3：田回表单4:状春回执-filename正文或并附件的名衿String正攵和附件时.拿空自由文本-fiIeContmit文件内容/我不内容StringS自由文本1）发送正文和附件时,埴写文件片段内存的hxCfrIiW?，数据；2）发送住记表通、iH表小款据时>«XNi4编外就数据格式见B.2.3IwIsCStr畚散ha“6l输码前数据结构：3）发送状灯回执故据时base646日前数据格式见B.3.3返回的l,11xg谷数位占码的数据结构；-dataIndex文件片段位置intS-发送正文和附件时.填写当前片戌索引故：Mfttt认填写0：-接口遮闻值说明<resuli><sccR3s>处理成功失败标志：0表示两用成功，凡他表示西用失败.<UMggXfl稣>错误信息<"g><rru11>善注1>交换件正常发送按照以下题序推送此粼：正文、阳件、登记很不：2）欲粼接收接口中文件正文和附件）内容是按分片的方式推送，3MtllindCX为0时衣示当匍文件开始推送.正文只行一个.附件多个：3）如果数到类型为2时衣示推送的是比记次的，不按分片推送Il在正文和附件推送完成之后推送：1）只有在接牧先登记会以后才我示核文次件接收完华，应用系统才可进行自身的业务处理；C.2交换件签收/拒收接口dcalRecvStatusC.2.1接口说明该接口由交换系统发布,接入应用系统调用，接入应用系统在接收交换件后可以进行交换件的签收和拒收，通过该接11格签收和拒收后状态反馈给交换系统.C.2.2接口定义»«»StringdealRecvStatus(StringappldeStringlabs.StringrecvTjrpe,StringrecvInfo,Stringopeid,StringDPeTMe)»*««是否可为空说明取值示制appld发起i求的应用系统标illStringSUUID-25e59a3-cca3-43M-84e9-lddfbac2cce2Iabsguid和qryld的XreI格式的字符申basel编码后数据String否自由文本格式见C2.3Inbx警蚊basc64位a码前数卷结构IXIog