数据交换接口规范V2.1（打印版）.docVIP

数据交换平台接口规范

PAGE

PAGE3

数据交换平台

数据交换平台

接口规范

版本：V2.0

国网“SG186”工程一体化平台数据交换项目组

二○○七年十二月

1

前言

根据国家电网公司“十一五”信息发展规划、信息化建设工程（“SG186”工程）的建设策略，数据交换作为一体化集成平台重要组成部分，主要实现网省与公司总部的纵向数据交换，满足两级数据中心级联的需要。现编制数据交换平台接口规范和交换标准，为数据中心、业务应用建设过程中利用数据交换平台实现纵向数据交换提供统一的参考规范。

本文档具体描述了数据交换平台的定位、主要功能，典型应用场景的使用，以及数据接入规范。

本文档为数据交换平台V2.1.2版本的接口规范，后续随着软件版本升级，将进行相应修订。

信息工作办公室

2007年12月

目录TOC\o1-3\h\z\u

1 数据交换平台定位 1

2 数据交换平台功能框架 1

2.1 功能介绍 1

2.2 数据交换方式说明 2

2.2.1 自动方式 2

2.2.2 手工方式 3

2.3 数据交换安全管理 3

2.3.1 数据传输安全 3

2.3.2 管理控制层安全 3

2.3.3 访问安全 3

3 数据交换平台典型应用场景 3

3.1 典型应用场景—两级数据中心级联 3

3.1.1 两级数据中心级联—发送 3

3.1.2 两级数据中心级联—抽取 4

3.2 典型应用场景—交换业务应用数据 5

3.2.1 发送格式化数据 5

3.2.2 通过ESB发送格式化数据 6

3.2.3 发送非格式化数据 8

3.2.4 通过ESB发送非格式化数据 9

3.3 配置步骤 11

3.3.1 交换标准制定 11

3.3.2 接收方（公司总部） 11

3.3.3 发送方（网省公司） 11

3.3.4 自动交换 11

3.3.5 应用触发交换 12

3.4 示例一、自动发送 12

3.4.1 步骤一：定义交换标准 12

3.4.2 步骤二：接收方（公司总部） 15

3.4.3 步骤三：发送方（网省公司） 16

3.4.4 步骤四：自动发送 17

3.5 示例二、自动抽取 18

3.6 示例三、应用触发交换 19

4 数据交换接口规范 19

4.1 接入服务规范 21

4.2 数据到达通知接口 29

4.3 交换日志规范 30

4.4 接入服务调用示例 32

4.4.1 发送数据示例 32

4.4.2 发送文件示例 33

4.4.3 获取数据示例 35

4.4.4 获取文件示例 37

附录A接入服务接口规范 38

附录B接入服务输入参数规范 50

附录C接入服务返回值规范 60

附录D接入服务接口规范 62

附录E发送文件接入服务输入参数规范 66

附录F发送文件接入服务返回值规范 70

附录G获取文件接入服务输入参数规范 72

附录H数据到达通知数据格式 74

附录I交换日志规范 78

附录J发送数据客户端代码清单 82

附录K发送文件客户端代码清单 83

附录L获取数据客户端代码清单 84

附录M获取文件客户端代码清单 85

附录N错误码列表 86

1

数据交换平台定位

根据国网公司十一五信息化、“SG186”建设方案、一体化平台建设策略，数据交换平台是企业一体化平台的重要组成部分，是数据中心数据采集工具之一，实现总部与网省公司两级数据中心之间的数据交换，是总部与各网省公司之间的统一的数据交换渠道，实现纵向数据交换。

数据交换平台功能框架

功能介绍

数据交换平台（ePDXP-2100）提供多种传输通道、多种数据交换方式和交换标准，满足不同应用场景的需要。

数据交换平台适用于多级管理的企业集团，利用该平台可以建立自下而上的数据交换体系，统一数据交换标准、统一交换渠道，实现数据中心级联和数据采集。

数据交换平台由管理控制层与传输层组成，管理控制层提供平台管理、接收管理、发送管理等管理功能和数据接收服务、数据发送服务、数据抽取服务等一系列服务功能；传输层提供基于消息、WebService、HTTP等