物资主数据纵向集成接口细则V2-0.doc

物资主数据 纵向集成接口规范 国家电网公司 主数据项目组 2011年8月9日 文档编号： 版本：1.0文 档 信 息 编写者 石丽娇 编写日期 2011年8月9日 审核者 审核日期 批准人 批准日期 变更历史 版本号 日期 变更描述 批准 V1.0 2011-8-9 新增 目录 1. 前言 1 1.1. 导读 1 1.2. 范围 1 1.3. 术语 1 1.4. 参考资料 2 2. 原则 1 3. 主数据管理集成规范 1 3.1. 集成架构 1 3.2. 接口集成描述 1 3.2.1. SG-MDM分发主数据到业务应用 2 3.2.2. SG-MDM发送主数据状态到业务应用 5 3.2.3. 业务应用申请主数据 8 附录一 主数据类型码对照表 12 附录二 接收端编号对照表 12 前言 导读 目前，SG-MDM物资主数据范围包含物资分类（含水电）、物料（含水电），供应商等三类主数据。本文档也仅限于描述这三类主数据与其他外部应用的数据交互接口规范定义。 范围 SG-MDM管理的物资主数据范围包含物资分类（含水电）、物料（含水电），供应商主数据等三类主数据。本文档也仅限于描述这三类主数据与其他外部应用的数据交互接口规范定义。 术语 SG-MDM：SG-MDM指国家电网主数据管理系统。采用总部集中部署，总部/网省两级应用的方式进行主数据管理。 WebService：WebService是业务系统对外暴露能够通过Web进行调用的API。附录二“接收端编号对照表”。具体见附录二 接收端编号对照表。 参考资料 本规范参考以下文件制定，并参考公司系统部分单位研究成果： 《主数据管理功能模块建设方案_v0.9》 《应用集成平台典型设计手册v2.6》 《SGCC_成熟套装软件纵向贯通技术实现v2》 《数据交换接口规范V2.1（打印版）》 《国家电网公司成熟套装软件信息分类编码方案（使用版）》 《国家电网公司数据中心典型设计》 《物资管控实施_集成技术架构_确认版.rar》 《国家电网公司“SG186”工程一体化平台-应用集成典型设计（下发稿）》原则 本文档仅定义WebService方式的接口定义，具体的实现由各系统参考本规范文档和其它技术文档自行开发实现。 本方案中使用的编码值使用国网公司下发的编码。如果外部应用的编码值与本方案中使用的编码值定义不一致，应由各外部应用在其系统内部自行做编码映射工作。 接口集成描述 根据国网公司统一要求，参照应用集成典型设计，集成架构采用通用集成平台的方式进行集成，这种应用模式中各业务应用通过通用的、基于SOA架构的集成平台实现集成，将套装软件看做一个普通的业务应用，可以按照接口规范将业务功能封装成WebService，注册到ESB，同时能够调用集成平台的服务。调用系统通过标准方式（SOAP over HTTP 或者 SOAP over JMS）调用服务总线上的服务，数据采用XML格式组织，当请求数据进入服务总线后，服务总线调用相应的业务服务。集成模式下图所示： SG-MDM分发主数据到业务应用 功能描述：本接口用于SG-MDM主动分发主数据到业务应用。 实现方式： 接口发布方：业务应用 接口调用方：SG-MDM 数据流向：SG-MDM à业务应用 实现说明： SG-MDM把要分发的数据打包成XML数据包。 SG-MDM调用本接口，把XML数据包以参数的方式传递给业务应用。 业务应用解析XML，进行内部操作，完成数据同步，并根据返回值协议返回主数据处理情况。 SG-MDM根据返回值，记录主数据同步情况。 接口方法定义： String syncMasterData(String masterDataType,String xmlData) 参数说明： 物资主数据 接口名称 syncMasterData 主数据类型 物资分类主数据[10000] 输入参数一 masterDataType：10000 输入参数二 返回值 水电物资主数据 接口名称 syncMasterData 主数据类型 水电物资分类主数据[10004] 输入参数一 masterDataType：10004 输入参数二 返回值 物料主数据 接口名称 syncMasterData 主数据类型 物料主数据[10001] 输入参数一 masterDataType：10001 输入参数二 返回值 水电物料主数据 接口名称 syncMasterData 主数据类型 水电物料主数据[1000