批量处理服务接入规范V1.0.6汇编.docxVIP

数据资源管理平台接入技术规范批量处理服务接入规范V1.0.6目次1批量接口技术规范31.1批量主数据同步接口规范31.1.1批量主数据同步请求接口31.1.2批量主数据同步响应接口81.2批量主数据变更广播规范112批量主数据文件格式规范152.1请求文件152.1.1报文结构152.1.2结构清单152.1.3报文示例172.2响应文件182.2.1报文结构182.2.2结构清单182.2.3报文示例192.3变更广播文件202.3.1报文结构202.3.2结构清单202.3.3报文示例223附录243.1.1接口定义243.1.2返回码清单24批量接口技术规范本规范对数据资源管理平台批量主数据处理服务接入方式进行规范和约定。批量主数据的变更采用文件的形式进行数据的交互，数据文件通过FTP服务器进行上传与下载。（FTP服务器的提供方待定，为了方便说明，以下的处理流程中将FTP节点暂放置于信息集成平台中）批量主数据同步接口规范批量主数据同步接口规范，主要是描述了数据提供方与数据资源管理平台之间的交互方式。批量主数据同步接口规范包括两部分内容，分别是请求部分与响应部分。批量主数据同步请求接口在一个批次的主数据同步（一张电子化移交单）的请求中包含一个或多个请求文件（每个请求文件最多包含500个主数据对象，以此作为文件分割的条件）。数据资源管理平台在接收到该批次所有的请求文件之后，才开始对该批次的主数据进行同步的处理，最终保证数据的完整性。处理流程此处描述的是批量主数据同步的请求阶段的处理流程，是业务系统对数据资源管理平台发起数据同步请求的处理过程。在同一批次的多个请求文件之间的请求过程是相互独立，单独走以下的流程。相当于每上传一个请求文件，就发起一次处理通知，多个文件则发起多次通知。请求文件的格式规范，详见2.1章节。数据资源管理平台将请求文件校验服务的JMS消息处理接口注册到信息集成平台中。业务系统将请求文件上传至FTP服务器；业务系统通过信息集成平台提供的接口发起对数据资源管理平台发起请求文件处理的通知；信息集成平台对业务系统的请求进行处理(如消息格式转换、报文过滤、拆分等)，并转换成符合数据资源管理平台要求的JMS消息，发送到数据资源管理平台提供的JMS消息队列中；数据资源管理平台监听来自信息集成平台的JMS消息，进行相应的业务处理，并把处理结果写入数据资源管理平台的返回消息队列；信息集成平台负责监听数据资源管理平台的返回消息队列并把消息返回给业务系统。业务系统接收校验结果信息，若校验通过本次处理流程结束；若检验失败，业务系统需要根据返回的错误信息，进行相关的处理后重新上传请求文件并发起通知（重新走处理流程）。技术要求数据资源管理平台对外提供的JMS服务必须满足如下的要求：1、JMS协议实现，符合JMS 1.1规范约束；2、消息类型只支持Text Message 或Bytes Message；3、字符集：utf-8。信息集成平台和业务系统调用服务时必须满足如下要求：1、字符集：utf-8。请求文件校验服务遵循《SOA应用技术规范第3部分：SOA信息集成技术规范》要求。请求消息报文规范请求文件校验服务的请求信息报文结构，如下图：消息头默认为空。消息属性默认为空。消息体消息体内容为文件校验服务的请求交互对象，具体内容如下：参数名称描述是否必须数据格式说明batchId批次编号是StringelectId电子化移交单号是StringlastUpdateSystem系统标识是StringfilePath数据文件地址是StringfileCode数据文件校验码是StringtotalFile本批次总文件个数是inttotalNumber本批次对象总个数是int本批次所有文件包含的对象个数总和。fileNo本文件序号是StringisFinal是否最终文件是String“Y”表示为“是”，“N”表示为“否”。dataSize本文件对象总个数是int本文件包含的对象个数总和。maxiMum本文件对象最大编号是int本文件的最大对象编号。此编号是批次唯一的顺序流水号。mainMird主位置MRID否String用于描述该电子化移交单的主题内容，如新投产的变电站或者线路的主编码。没有主题内容可不填。mainType主位置类型否String用于描述该电子化移交单的主题内容，如0表示变电站，1代表线路。没有主题内容可不填。消息体的数据结构示例reqFileRequestbatchId001/batchIdlastUpdateSystemGZDW_JJXT/lastUpdateSystemfilePath:21/01Test.xml/filePathfileCode11/fileCodetotalFile3/totalFiletotalNumber