物资主数据纵向集成接口规范v20.doc

物资主数据
纵向集成接口规范
***
主数据项目组
2011年8月9日
文档编号: 版本:
文档信息
编写者
石丽娇
编写日期
2011年8月9日
审核者
审核日期
批准人
批准日期
变更历史
版本号
日期
变更描述
批准

2011-8-9
新增
目录
1. 前言 1
. 导读 1
. 范围 1
. 术语 1
. 参考资料 2
2. 原则 1
3. 主数据管理集成规范 1
. 集成架构 1
. 接口集成描述 1
. SG-MDM分发主数据到业务应用 2
. SG-MDM发送主数据状态到业务应用 5
. 业务应用申请主数据 8
附录一主数据类型码对照表 12
附录二接收端编号对照表 12
前言
导读
目前,SG-MDM物资主数据范围包含物资分类(含水电)、物料(含水电),供应商等三类主数据。本文档也仅限于描述这三类主数据与其他外部应用的数据交互接口规范定义。
范围
SG-MDM管理的物资主数据范围包含物资分类(含水电)、物料(含水电),供应商主数据等三类主数据。本文档也仅限于描述这三类主数据与其他外部应用的数据交互接口规范定义。
术语
SG-MDM:SG-MDM指国家电网主数据管理系统。采用总部集中部署,总部/网省两级应用的方式进行主数据管理。
WebService:WebService是业务系统对外暴露的能够通过Web进行调用的API。
接收端:指各个单位要接入SG-MDM的业务系统。为了更好的描述和全局定义要接入的业务系统,我们采取“业务模块_业务系统拼音简称_流水号”方式命名接收端的ID,采用“单位名称+系统名称”命名接收端的中文名称。为了便于SG-MDM系统对接入系统的统一管理,在采用WebService方式进行数据交换时,请求方都需要在接入参数中提供根据本接口规范中预先分配的“接收端ID”来进行系统接入,详情可见
附录二“接收端编号对照表”。具体见附录二接收端编号对照表。
参考资料
本规范参考以下文件制定,并参考公司系统部分单位研究成果:
《》
《》
《_成熟套装软件纵向贯通技术实现v2》
《(打印版)》
《***成熟套装软件信息分类编码方案(使用版)》
《***数据中心典型设计》
《》
《***“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]
输入参数一