物资主数据纵向集成接口规范V2.0

国家电网公司主数据管理功能模块（SG-MDM）需求分析说明书福建亿力电力科技股份有限公司PAGE2 物资主数据纵向集成接口规范国家电网公司主数据项目组2011年8月9日文档编号： 版本：1.0文档信息编写者石丽娇编写日期2011年8月9日审核者审核日期批准人批准日期变更历史版本号日期变更描述批准V1.02011-8-9新增

目录1. 前言 11.1. 导读 11.2. 范围 11.3. 术语 11.4. 参考资料 22. 原则 13. 主数据管理集成规范 13.1. 集成架构 13.2. 接口集成描述 13.2.1. SG-MDM分发主数据到业务应用 23.2.2. SG-MDM发送主数据状态到业务应用 53.2.3. 业务应用申请主数据 8附录一主数据类型码对照表 12附录二接收端编号对照表 12国家电网公司物资主数据纵向集成接口规范第7页前言导读目前，SG-MDM物资主数据范围包含物资分类（含水电）、物料（含水电），供应商等三类主数据。本文档也仅限于描述这三类主数据与其他外部应用的数据交互接口规范定义。范围SG-MDM管理的物资主数据范围包含物资分类（含水电）、物料（含水电），供应商主数据等三类主数据。本文档也仅限于描述这三类主数据与其他外部应用的数据交互接口规范定义。术语SG-MDM：SG-MDM指国家电网主数据管理系统。采用总部集中部署，总部/网省两级应用的方式进行主数据管理。WebService：WebService是业务系统对外暴露的能够通过Web进行调用的API。接收端：指各个单位要接入SG-MDM的业务系统。为了更好的描述和全局定义要接入的业务系统，我们采取“业务模块_业务系统拼音简称_流水号”方式命名接收端的ID，采用“单位名称+系统名称”命名接收端的中文名称。为了便于SG-MDM系统对接入系统的统一管理，在采用WebService方式进行数据交换时，请求方都需要在接入参数中提供根据本接口规范中预先分配的“接收端ID”来进行系统接入，详情可见HYPERLINK附录二“接收端编号对照表”。具体HYPERLINK\l"_附录二_接收端编号对照表"见附录二接收端编号对照表。参考资料本规范参考以下文件制定，并参考公司系统部分单位研究成果：《主数据管理功能模块建设方案_v0.9》《应用集成平台典型设计手册v2.6》《SGCC_成熟套装软件纵向贯通技术实现v2》《数据交换接口规范V2.1（打印版）》《国家电网公司成熟套装软件信息分类编码方案（使用版）》《国家电网公司数据中心典型设计》《物资管控实施_集成技术架构_确认版.rar》《国家电网公司“SG186”工程一体化平台-应用集成典型设计（下发稿）》原则本文档仅定义WebService方式的接口定义，具体的实现由各系统参考本规范文档和其它技术文档自行开发实现。本方案中使用的编码值使用国网公司下发的编码。如果外部应用的编码值与本方案中使用的编码值定义不一致，应由各外部应用在其系统内部自行做编码映射工作。主数据管理集成规范集成架构接口集成描述根据国网公司统一要求，参照应用集成典型设计，集成架构采用通用集成平台的方式进行集成，这种应用模式中各业务应用通过通用的、基于SOA架构的集成平台实现集成，将套装软件看做一个普通的业务应用，可以按照接口规范将业务功能封装成WebService，注册到ESB，同时能够调用集成平台的服务。调用系统通过标准方式（SOAPoverHTTP或者SOAPoverJMS）调用服务总线上的服务，数据采用XML格式组织，当请求数据进入服务总线后，服务总线调用相应的业务服务。集成模式下图所示：SG-MDM分发主数据到业务应用功能描述：本接口用于SG-MDM主动分发主数据到业务应用。实现方式：接口发布方：业务应用接口调用方：SG-MDM数据流向：SG-MDMà业务应用实现说明：SG-MDM把要分发的数据打包成XML数据包。SG-MDM调用本接口，把XML数据包以参数的方式传递给业务应用。业务应用解析XML，进行内部操作，完成数据同步，并根据返回值协议返回主数据处理情况。SG-MDM根据返回值，记录主数据同步情况。接口方法定义：StringsyncMasterData(StringmasterDataType,StringxmlData)参数说明：物资主数据接口名称syncMasterData主数据类型物资分类主数据[10000]输入参数一masterDataType：10000输入参数二返回值水电物资主数据接口名称syncMasterData主数据类型水电物资分类主数据[10004]输入参数一masterDataType：10004输入参数二返回值物料主数据接口名称syncMasterData主数据类型物料主数据[10001]输入参数一masterDataType：10001输入参数二返回值水电物料主数据接口名称syncMasterData主数据类型水电物料主数据[10005]输入参数一masterDataType：10005输入参数二返回值供应商主数据接口名称syncMasterData主数据类型供应商主数据[10002]输入参数一masterDataType：10002输入参数二返回值SG-MDM发送主数据状态到业务应用功能描述：本接口用于SG-MDM主动同步主数据的状态到业务应用。实现方式：接口发布方：业务应用接口调用方：SG-MDM数据流向：SG-MDM外部应用实现说明：SG-MDM把要同步状态的主数据打包成XML数据包。SG-MDM调用本接口，把XML数据包以参数的方式传递给外部应用。外部应用解析XML，进行内部操作，完成数据状态同步，并根据返回值协议返回主数据处理情况。SG-MDM根据返回值，记录主数据状态同步情况。接口方法定义：StringsyncMasterDataStatus(StringmasterDataType,StringxmlData)参数说明：物资分类主数据接口名称syncMasterDataStatus主数据类型物资分类主数据[10000]输入参数一masterDataType：[10000]输入参数二返回值水电物资分类主数据接口名称syncMasterDataStatus主数据类型水电物资分类主数据[10004]输入参数一masterDataType：[10004]输入参数二返回值物料主数据接口名称syncMasterDataStatus主数据类型物料主数据[10001]输入参数一masterDataType：[10001]输入参数二返回值水电物料主数据接口名称syncMasterDataStatus主数据类型水电物料主数据[10005]输入参数一masterDataType：[10005]输入参数二返回值供应商主数据接口名称syncMasterDataStatus主数据类型供应商主数据[10002]输入参数一masterDataType：[10002]输入参数二返回值附录一主数据类型码对照表主数据类型编码描述10000物资分类数据10001物料主数据10002供应商主数据10004水电物资分类数据10005水电物料主数据注意:该规范中的主数据类型编码与之前横向和纵向集成规范中的类型码有所变化，MDM平台会同时支持早期的主数据类型码(01:物资分类02:物料主数据03:供应商主数据),但建议后续的接口开发统一采用该对照表中的5位主数据类型码。附录二接收端编号对照表接收端编号接收端名称mm_erp_0099国家电网公司总部ERP系统_物资模块mm_erp_0001华北电网有限公司ERP系统_物资模块mm_erp_0002北京电力公司ERP系统_物资模块mm_erp_0003天津市电力公司ERP系统_物资模块mm_erp_0004河北省电力公司ERP系统_物资模块mm_erp_0005山西省电力公司ERP系统_物资模块mm_erp_0006山东电力集团公司ERP系统_物资模块mm_erp_0007蒙东电力公司ERP系统_物资模块mm_erp_0008华东电网有限公司ERP系统_物资模块mm_erp_0009上海市电力公司ERP系统_物资模块mm_erp_0010江苏省电力公司ERP系统_物资模块mm_erp_0011浙江省电力公司ERP系统_物资模块mm_erp_0012安徽省电力公司ERP系统_物资模块mm_erp_0013福建省电力有限公司ERP系统_物资模块mm_erp_0014华中电网有限公司ERP系统_物资模块mm_erp_0015湖北省电力公司ERP系统_物资模块mm_erp_0016湖南省电力公司ERP系统_物资模块mm_erp_0017河南省电力公司ERP系统_物资模块mm_erp_0018江西省电力公司ERP系统_物资模块mm_erp_0019四川省电力公司ERP系统_物资模块mm_erp_0020重庆市电力公司ERP系统_物资模块mm_erp_0021东北电网有限公司ERP系统_物资模块mm_erp_0022辽宁省电力有限公司ERP系统_物资模块mm_erp_0023吉林省电力有限公司ERP系统_物资模块mm_erp_0024黑龙江省