中国南方电网电子运维系统
纵向接口规范
中国南方电网电力调度通信中心
二〇〇九年六月
目 录
1 2 3 4
目的........................................................................................................................................... 1 范围........................................................................................................................................... 1 术语........................................................................................................................................... 1 接口设计 . .................................................................................................................................. 1 4.1 描述语言 . ...................................................................................................................... 1 4.2 部署结构 . ...................................................................................................................... 2 4.3 通信流程 . ...................................................................................................................... 2 4.4 安全规定 . ...................................................................................................................... 3 接口描述 . .................................................................................................................................. 3 5.1 数据格式 . ...................................................................................................................... 3
5.1.1 XML 头 . ............................................................................................................ 4 5.1.2 数据头 . .............................................................................................................. 4 5.1.3 数据内容 . .......................................................................................................... 5 5.1.4 数据尾 . .............................................................................................................. 5 5.2 接口方法 . ...................................................................................................................... 5
5.2.1 发送数据方法(sendData ) ............................................................................ 5 5.2.2 查询数据方法(queryData ) .......................................................................... 6 5.3 通用应答 . ...................................................................................................................... 6 接口功能 . .................................................................................................................................. 7 6.1 中调汇报 . ...................................................................................................................... 7
6.1.1 中调汇报请求 . .................................................................................................. 7 6.1.2 中调汇报上报 . .................................................................................................. 8 6.2 数据上报 . .................................................................................................................... 10
6.2.1 财务业务统计上报 . ........................................................................................ 10 6.2.2 管理业务统计上报 . ........................................................................................ 12 6.2.3 人力资源业务统计上报 . ................................................................................ 14 6.2.4 生产管理业务统计上报 . ................................................................................ 16 6.2.5 业务中断情况统计上报 . ................................................................................ 18 6.3 运行计划 . .................................................................................................................... 21
6.3.1 月度运行计划上报 . ........................................................................................ 21 6.3.2 月度运行计划查询 . ........................................................................................ 23 6.4 值班表 . ........................................................................................................................ 25
6.4.1 值班表上报 . .................................................................................................... 25 6.5 电路开通 . .................................................................................................................... 27
6.5.1 月度运行计划上报 . ........................................................................................ 27 6.5.2 电路开通查询 . ................................................................................................ 28
5
6
1 目的
本规范的目的是为了规范南网总调与各省中调电子运维系统间纵向数据交互接口,保障南网总调与各省中调系统之间的纵向数据交互。
2 范围
本规范规定了南网总调与各省中调电子运维系统之间纵向数据交互的接口设计(包括接口方式、通信协议等)、接口描述、接口功能等。
本规范适用于南网总调与各省中调在安全III 区内电子运维系统间纵向接口的规划、设计和实施。
3 术语
XML WebService TCP/IP Server Client GUID HTTPS base64
Extensible Markup Language(可扩展标记语言) Web 服务
Transmission Control Protocol/Internet Protocol(传输控制/网络通讯协议) 服务端 客户端
Globally Unique Identifier(唯一标识)
Hypertext Transfer Protocol over Secure Socket(安全超文本传输协议) 用于传输字节代码的编码方式
4 接口设计
4.1 描述语言
WebService 是由企业发布的完成其特定商务需求的在线应用服务,其他公司或应用软件能够通过Internet 来访问并使用这项在线服务。
WebService 是一种构建应用程序的普遍模型, 可以在任何支持网络通信的操作系统中实施运行;WebService 是一种新的Web 服务应用程序分支,是自包含、自描述、模块 化的应用,可以发布、定位、通过Web 调用。WebService 是一个应用组件,它逻辑性的为其他应用程序提供数据与服务。各应用程序通过网络协议和规定的一些标准数据格式(Http 、XML 、Soap) 来访问WebService ,通过WebService 内部执行得到所需结果。WebService 可以执行从简单的请求到复杂商务处理的任何功能。一旦部署以后,其他WebService 应用程序可以发现并调用它部署的服务。
中国南方电网电子运维系统纵向接口规范采用WebService 通信方式,数据内容采用XML 标准格式。
4.2 部署结构
整个接口结构采用分布式方式进行部署,即在南网总调和各省中调均部署接口。接口部署示意图如下:
图4.2 接口部署示意图
南网总调和各省中调接口通过通信网络连接,并传输XML 数据。南网总调接口获取到各省中调接口的请求后,将请求分发到电子运维系统或其它应用系统进行处理,实现了电子运维的纵向数据交互。
4.3 通信流程
在纵向接口数据交互过程中,客户端(Client )发起数据交互请求,调用服务器(Client )提供WebService 接口方法,服务端处理请求并应答客户端请求。整个调用接口方法过程采用同步响应模式。各省中调和南网总调数据交互流程图如下:
图4.3 各省中调和南网总调数据交互流程图
各省中调和南网总调数据交互流程:
1、 各省中调客户端调用南网总调WebService 接口,发送或查询数据; 2、 南网总调WebService 服务端处理请求;
3、 南网总调WebService 服务端返回状态或数据给各省中调客户端。
4.4 安全规定
本规范中定义的纵向接口位于安全III 区,用于在南网总调和各省中调电子运维系统间的数据交互。
为了保证数据在传输过程中的安全性,双方的WebService 采用https 传输协议。为确保接口数据传输的效率,传输协议仅采用SSL 单向的认证模式,即在数据交换建立连接时,调用方获得对端服务器的数字证书,数据在传输时SSL 机制利用证书密钥自动将数据进行加密。数字证书只做数据加密使用,不作为身份验证的依据。
在接口系统中,要求对允许进行数据交换的对端服务器IP 地址进行限制,以此验证接口调用双方身份的合法性,增强系统的安全。同时接口系统应该具备针对不同数据所涉及单位进行隔离操作的能力。
5 接口描述
本章描述了电子运维系统纵向接口的功能需求、数据格式、接口方法和数据返回。
5.1 功能需求
图5.1 接口用例图
从接口用例图可以看出,主要有两个角色——南网总调电子运维系统和各省中调电子运维系统,四个用例——总调数据下发、总调数据查询、中调数据上报和中调数据查询。南网总调和各省中调电子运维系统可以通过这些用例向对方下发、上报或查询数据。
5.2 数据格式
数据格式是指电子运维系统纵向接口交互的数据对象所遵循的数据组织规则。数据格式是基于XML 标准的,基本内容如下:
数据值1
数据值2.1
数据值2.2.1 数据值2.2.2 ...
... ...
... 由上面的代码可以看出,电子运维系统纵向接口数据格式由XML 头、数据头、数据内容和数据尾组成。
5.2.1 XML 头
表示接口数据遵循是XML 1.0标准,支持是GB2312汉字编码。GB2312码是中华人民共和国国家汉字信息交换用编码,全称为《信息交换用汉字编码字符集——基本集》,由国家标准总局发布,1981年5月1日实施,通行于中国大陆。它是计算机可以识别的编码,适用于汉字处理、汉字通信等系统之间的信息交换。本接口规范采用该编码,完全满足文本包含汉字的数据交互需要。
5.2.2 数据头
数据头表示数据内容的开始,包含多个属性。具体属性取值和说明描述如下:
表5.1.2 接口数据头属性列表
5.2.3 数据内容
数据值1
数据值2.1
数据值2.2.1 数据值2.2.2 ...
... ...
... 数据内容由一个个数据项组成,可分为简单数据项和嵌套数据项。数据项1为简单数据项,后面直接跟数据值1。数据项2是嵌套数据项,可以嵌套简单数据项和复杂数据项。 数据项值为文本格式,可以通过程序转化为字节型、字符型、短整型、整型、长整型、浮点型、双精度浮点型、字符串、字节数组等常用的数据类型。
5.2.4 数据尾
数据尾表示数据内容的结束,也表示整个接口数据的结束。
5.3 接口方法
在WebService 接口服务中,只定义了2个接口方法:发送数据方法(sendData )和查询数据方法(queryData )。南网总调和各省中调纵向接口都要实现这2个方法,以供对方调用。下面,针对每一个方法进行详细描述。
5.3.1 发送数据方法(sendData )
发送数据方法(sendData )用于发送数据到接口服务器。为了避免数据重复发送,必须有发送端生成GUID 来唯一标识此次数据发送过程。同时,XML 格式的发送数据和返回结果都将被转换为字节数组,保证了较大数据量的发送。
发送数据方法(sendData )定义如下:
byte [] sendData( String sender, String guid, byte [] data );
输入参数说明如下:
5.3.2 查询数据方法(queryData )
查询数据方法(queryData )用于从接口服务器查询数据。为了避免重复查询数据,必须有发送端生成GUID 来唯一标识此次查询数据过程。同时,XML 格式的查询条件和查询结果都将被转换为字节数组,保证了较大数据量的传输。
查询数据方法(queryData )定义如下:
byte [] queryData( String sender, String guid, byte [] condition );
5.4 通用应答
调用电子运维系统纵向接口方法后,无论服务器端是否正常处理,都应该返回应答。当服务器端处理正确时,返回成功应答;当服务器处理错误时,返回失败应答。
成功应答用数据头的status 属性为“成功”表示,格式如下:
失败应答用数据头的status 属性为“失败”表示,格式如下:
1
数据查询超时
其中,type 表示失败类型,reason 标识失败原因。详细的失败类型定义如下:
6 接口功能
6.1 中调汇报
当告警发生后,南网总调需要相关中调上报告警处理过程。
6.1.1 中调汇报请求
南网总调请求各省中调进行中调汇报。
6.1.1.1 调用方法
南网总调纵向接口调用各省中调纵向接口的发送数据方法(sendData )。
6.1.1.2 请求数据
6.1.1.2.1 数据头
6.1.1.2.2 数据内容
6.1.1.2.3 应用示例
10281969
650=1=I1=1=2M-10 主要告警
信号丢失(LOS)
2009-12-09 09:51:29 ECI
云南ECI 传输网 丽江地调
6.1.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.1.2 中调汇报上报
各省中调向南网总调上报汇报信息。
6.1.2.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.1.2.2 请求数据 6.1.2.2.1 数据头
表6.1.2.2.1 中调汇报上报数据头取值
6.1.2.2.2 数据内容
6.1.2.2.3 应用示例
10281969 罗海林 2010-06-12 14:56:55 检修 检修导致,跟踪之中
6.1.2.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2 数据上报
6.2.1 财务业务统计上报
6.2.1.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.1.2 请求数据 6.2.1.2.1 数据头
表6.2.1.2.1财务业务统计上报数据头取值
6.2.1.2.2 数据内容
表6.2.1.2.2财务业务统计上报数据内容
6.2.1.2.3 应用示例
云南2010年5月财务业务统计报表 财务人员
2010-06-12 14:56:55
营业部门用户点 宽带业务
Hub 路由器 纤芯直连 10M SDH 10M 8 未知 8 120
营业部门用户点 专网业务
二层数据设备 路由器 纤芯直连 10M
SDH 10M 16 未知 16 200
6.2.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2.2 管理业务统计上报
6.2.2.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.2.2 请求数据 6.2.2.2.1 数据头
6.2.2.2.2 数据内容
表6.2.2.2.2管理业务统计上报数据内容
6.2.2.2.3 应用示例
云南2010年5月管理业务统计报表 管理人员
2010-06-12 14:56:55
营业部门用户点 宽带业务
Hub 路由器 纤芯直连 10M SDH 10M 8 未知 8 120
营业部门用户点 专网业务
二层数据设备 路由器 纤芯直连 10M SDH 10M 16 未知 16 200
6.2.2.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2.3 人力资源业务统计上报
6.2.3.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.3.2 请求数据 6.2.3.2.1 数据头
表6.2.3.2.1人力资源业务统计上报数据头取值
6.2.3.2.2 数据内容
6.2.3.2.3 应用示例
云南2010年5月人力资源业务统计报表 人力资源人员
2010-06-12 14:56:55
营业部门用户点 宽带业务
Hub 路由器 纤芯直连 10M SDH 10M 8
未知 8 120
营业部门用户点 专网业务
二层数据设备 路由器 纤芯直连 10M SDH 10M 16 未知 16 200
6.2.3.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2.4 生产管理业务统计上报
6.2.4.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.4.2 请求数据 6.2.4.2.1 数据头
6.2.4.2.2 数据内容
表6.2.4.2.2生产管理业务统计上报数据内容
6.2.4.2.3 应用示例
云南2010年5月生产管理业务统计报表 生产管理人员
2010-06-12 14:56:55
营业部门用户点 宽带业务
Hub
路由器 纤芯直连 10M SDH 10M 8 未知 8 120
营业部门用户点 专网业务
二层数据设备 路由器 纤芯直连 10M SDH 10M 16 未知 16 200
6.2.4.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2.5 业务中断情况统计上报
6.2.5.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.5.2 请求数据 6.2.5.2.1 数据头
表6.2.5.2.1业务中断情况统计上报数据头取值
6.2.5.2.2 数据内容
6.2.5.2.3 应用示例
云南2010年5月业务中断情况统计报表 财务人员
2010-06-12 14:56:55
光设备故障 SDH 昭通变 华为
OptiX OSN 3500 严重 检修
一级
继电保护
单专用纤芯
昭通变 20 50 25 50
业务开通 1 20
10
是
是
2010-06-12 11:56:55 2010-06-12 12:47:50
6.2.5.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.3 运行计划
6.3.1 月度运行计划上报
6.3.1.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.3.1.2 请求数据 6.3.1.2.1 数据头
6.3.1.2.2 数据内容
6.3.1.2.3 应用示例
2010-3-1 超高压
填写人姓名
2010-06-12 14:56:55
500kV 盘换乙线2M 保护信号传输通道测试
1、2M 电路误码测试、传输延时测试。 2010年03月13日至03月16日
1、退出500kV 盘换乙线主一保护通道一、主二保护通道一及辅助保护通道一;2、退出对侧相应保护通道。
否 天生桥局
是
6.3.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.3.2 月度运行计划查询
6.3.2.1 调用方法
各省中调纵向接口调用南网总调纵向接口的查询数据方法(queryData )。
6.3.2.2 请求数据 6.3.2.2.1 数据头
6.3.2.2.2 数据内容
表6.2.1.2.2月度运行计划查询数据内容
6.3.2.2.3 应用示例
2010-3-1
超高压
填写人姓名
超高压输电公司信通中心
6.3.2.3 应答数据
返回通用应答数据:成功应答数据体如下,失败应答包含失败类型和失败原因。
6.3.2.3.1 数据头
表6.2.1.2.1月度运行计划查询数据头取值
6.3.2.3.2 数据内容
表6.2.1.2.2月度运行计划查询数据内容
6.3.2.3.3 应用示例
2010-3-1 超高压
填写人姓名
2010-06-12 14:56:55
500kV 盘换乙线2M 保护信号传输通道测试
1、2M 电路误码测试、传输延时测试。 2010年03月13日至03月16日
1、退出500kV 盘换乙线主一保护通道一、主二保护通道一及辅助保护通道一;2、退出对侧相应保护通道。
否 天生桥局
是
6.4 值班表 6.4.1 值班表上报
6.4.1.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.4.1.2 请求数据 6.4.1.2.1 数据头
表6.2.1.2.1值班表上报数据头取值
6.4.1.2.2 数据内容
6.4.1.2.3 应用示例
广东中调 通信部
填写人姓名
2010-06-12 14:56:55
2010-3-3 值班人姓名 85122410
[1**********]
6.4.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.5 电路开通 6.5.1 电路开通上报
6.5.1.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.5.1.2 请求数据 6.5.1.2.1 数据头
表6.2.1.2.1电路开通上报数据头取值
6.5.1.2.2 数据内容
表6.2.1.2.2电路开通上报数据内容
6.5.1.2.3 应用示例
取消
广州换至马窝换极2直流控制通道2 南网总调
广州换至马窝换极2直流控制通道2
2M
广州换至马窝换 E1
2010-2-22
天广直流通道改造,已对应开通新的通道,此通道可以取消。(对应开通单号20070003)
申请人姓名
2010-2-22 11:36 [email protected] [1**********]
6.5.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.5.2 电路开通查询
6.5.2.1 调用方法
各省中调纵向接口调用南网总调纵向接口的查询数据方法(queryData )。
6.5.2.2 请求数据 6.5.2.2.1 数据头
表6.2.1.2.1电路开通查询数据头取值
6.5.2.2.2 数据内容
6.5.2.2.3 应用示例
取消
广州换至马窝换极2直流控制通道2 南网总调
广州换至马窝换极2直流控制通道2
2M 申请人姓名
6.5.2.3 应答数据
返回通用应答数据:成功应答数据体如下,失败应答包含失败类型和失败原因。
6.5.2.3.1 数据头
6.5.2.3.2 数据内容
6.5.2.3.3 应用示例
取消
广州换至马窝换极2直流控制通道2
南网总调
广州换至马窝换极2直流控制通道2
2M
广州换至马窝换 E1
2010-2-22
天广直流通道改造,已对应开通新的通道,此通道可以取消。(对应开通单号20070003)
申请人姓名
2010-2-22 11:36 [email protected]
[1**********]
中国南方电网电子运维系统
纵向接口规范
中国南方电网电力调度通信中心
二〇〇九年六月
目 录
1 2 3 4
目的........................................................................................................................................... 1 范围........................................................................................................................................... 1 术语........................................................................................................................................... 1 接口设计 . .................................................................................................................................. 1 4.1 描述语言 . ...................................................................................................................... 1 4.2 部署结构 . ...................................................................................................................... 2 4.3 通信流程 . ...................................................................................................................... 2 4.4 安全规定 . ...................................................................................................................... 3 接口描述 . .................................................................................................................................. 3 5.1 数据格式 . ...................................................................................................................... 3
5.1.1 XML 头 . ............................................................................................................ 4 5.1.2 数据头 . .............................................................................................................. 4 5.1.3 数据内容 . .......................................................................................................... 5 5.1.4 数据尾 . .............................................................................................................. 5 5.2 接口方法 . ...................................................................................................................... 5
5.2.1 发送数据方法(sendData ) ............................................................................ 5 5.2.2 查询数据方法(queryData ) .......................................................................... 6 5.3 通用应答 . ...................................................................................................................... 6 接口功能 . .................................................................................................................................. 7 6.1 中调汇报 . ...................................................................................................................... 7
6.1.1 中调汇报请求 . .................................................................................................. 7 6.1.2 中调汇报上报 . .................................................................................................. 8 6.2 数据上报 . .................................................................................................................... 10
6.2.1 财务业务统计上报 . ........................................................................................ 10 6.2.2 管理业务统计上报 . ........................................................................................ 12 6.2.3 人力资源业务统计上报 . ................................................................................ 14 6.2.4 生产管理业务统计上报 . ................................................................................ 16 6.2.5 业务中断情况统计上报 . ................................................................................ 18 6.3 运行计划 . .................................................................................................................... 21
6.3.1 月度运行计划上报 . ........................................................................................ 21 6.3.2 月度运行计划查询 . ........................................................................................ 23 6.4 值班表 . ........................................................................................................................ 25
6.4.1 值班表上报 . .................................................................................................... 25 6.5 电路开通 . .................................................................................................................... 27
6.5.1 月度运行计划上报 . ........................................................................................ 27 6.5.2 电路开通查询 . ................................................................................................ 28
5
6
1 目的
本规范的目的是为了规范南网总调与各省中调电子运维系统间纵向数据交互接口,保障南网总调与各省中调系统之间的纵向数据交互。
2 范围
本规范规定了南网总调与各省中调电子运维系统之间纵向数据交互的接口设计(包括接口方式、通信协议等)、接口描述、接口功能等。
本规范适用于南网总调与各省中调在安全III 区内电子运维系统间纵向接口的规划、设计和实施。
3 术语
XML WebService TCP/IP Server Client GUID HTTPS base64
Extensible Markup Language(可扩展标记语言) Web 服务
Transmission Control Protocol/Internet Protocol(传输控制/网络通讯协议) 服务端 客户端
Globally Unique Identifier(唯一标识)
Hypertext Transfer Protocol over Secure Socket(安全超文本传输协议) 用于传输字节代码的编码方式
4 接口设计
4.1 描述语言
WebService 是由企业发布的完成其特定商务需求的在线应用服务,其他公司或应用软件能够通过Internet 来访问并使用这项在线服务。
WebService 是一种构建应用程序的普遍模型, 可以在任何支持网络通信的操作系统中实施运行;WebService 是一种新的Web 服务应用程序分支,是自包含、自描述、模块 化的应用,可以发布、定位、通过Web 调用。WebService 是一个应用组件,它逻辑性的为其他应用程序提供数据与服务。各应用程序通过网络协议和规定的一些标准数据格式(Http 、XML 、Soap) 来访问WebService ,通过WebService 内部执行得到所需结果。WebService 可以执行从简单的请求到复杂商务处理的任何功能。一旦部署以后,其他WebService 应用程序可以发现并调用它部署的服务。
中国南方电网电子运维系统纵向接口规范采用WebService 通信方式,数据内容采用XML 标准格式。
4.2 部署结构
整个接口结构采用分布式方式进行部署,即在南网总调和各省中调均部署接口。接口部署示意图如下:
图4.2 接口部署示意图
南网总调和各省中调接口通过通信网络连接,并传输XML 数据。南网总调接口获取到各省中调接口的请求后,将请求分发到电子运维系统或其它应用系统进行处理,实现了电子运维的纵向数据交互。
4.3 通信流程
在纵向接口数据交互过程中,客户端(Client )发起数据交互请求,调用服务器(Client )提供WebService 接口方法,服务端处理请求并应答客户端请求。整个调用接口方法过程采用同步响应模式。各省中调和南网总调数据交互流程图如下:
图4.3 各省中调和南网总调数据交互流程图
各省中调和南网总调数据交互流程:
1、 各省中调客户端调用南网总调WebService 接口,发送或查询数据; 2、 南网总调WebService 服务端处理请求;
3、 南网总调WebService 服务端返回状态或数据给各省中调客户端。
4.4 安全规定
本规范中定义的纵向接口位于安全III 区,用于在南网总调和各省中调电子运维系统间的数据交互。
为了保证数据在传输过程中的安全性,双方的WebService 采用https 传输协议。为确保接口数据传输的效率,传输协议仅采用SSL 单向的认证模式,即在数据交换建立连接时,调用方获得对端服务器的数字证书,数据在传输时SSL 机制利用证书密钥自动将数据进行加密。数字证书只做数据加密使用,不作为身份验证的依据。
在接口系统中,要求对允许进行数据交换的对端服务器IP 地址进行限制,以此验证接口调用双方身份的合法性,增强系统的安全。同时接口系统应该具备针对不同数据所涉及单位进行隔离操作的能力。
5 接口描述
本章描述了电子运维系统纵向接口的功能需求、数据格式、接口方法和数据返回。
5.1 功能需求
图5.1 接口用例图
从接口用例图可以看出,主要有两个角色——南网总调电子运维系统和各省中调电子运维系统,四个用例——总调数据下发、总调数据查询、中调数据上报和中调数据查询。南网总调和各省中调电子运维系统可以通过这些用例向对方下发、上报或查询数据。
5.2 数据格式
数据格式是指电子运维系统纵向接口交互的数据对象所遵循的数据组织规则。数据格式是基于XML 标准的,基本内容如下:
数据值1
数据值2.1
数据值2.2.1 数据值2.2.2 ...
... ...
... 由上面的代码可以看出,电子运维系统纵向接口数据格式由XML 头、数据头、数据内容和数据尾组成。
5.2.1 XML 头
表示接口数据遵循是XML 1.0标准,支持是GB2312汉字编码。GB2312码是中华人民共和国国家汉字信息交换用编码,全称为《信息交换用汉字编码字符集——基本集》,由国家标准总局发布,1981年5月1日实施,通行于中国大陆。它是计算机可以识别的编码,适用于汉字处理、汉字通信等系统之间的信息交换。本接口规范采用该编码,完全满足文本包含汉字的数据交互需要。
5.2.2 数据头
数据头表示数据内容的开始,包含多个属性。具体属性取值和说明描述如下:
表5.1.2 接口数据头属性列表
5.2.3 数据内容
数据值1
数据值2.1
数据值2.2.1 数据值2.2.2 ...
... ...
... 数据内容由一个个数据项组成,可分为简单数据项和嵌套数据项。数据项1为简单数据项,后面直接跟数据值1。数据项2是嵌套数据项,可以嵌套简单数据项和复杂数据项。 数据项值为文本格式,可以通过程序转化为字节型、字符型、短整型、整型、长整型、浮点型、双精度浮点型、字符串、字节数组等常用的数据类型。
5.2.4 数据尾
数据尾表示数据内容的结束,也表示整个接口数据的结束。
5.3 接口方法
在WebService 接口服务中,只定义了2个接口方法:发送数据方法(sendData )和查询数据方法(queryData )。南网总调和各省中调纵向接口都要实现这2个方法,以供对方调用。下面,针对每一个方法进行详细描述。
5.3.1 发送数据方法(sendData )
发送数据方法(sendData )用于发送数据到接口服务器。为了避免数据重复发送,必须有发送端生成GUID 来唯一标识此次数据发送过程。同时,XML 格式的发送数据和返回结果都将被转换为字节数组,保证了较大数据量的发送。
发送数据方法(sendData )定义如下:
byte [] sendData( String sender, String guid, byte [] data );
输入参数说明如下:
5.3.2 查询数据方法(queryData )
查询数据方法(queryData )用于从接口服务器查询数据。为了避免重复查询数据,必须有发送端生成GUID 来唯一标识此次查询数据过程。同时,XML 格式的查询条件和查询结果都将被转换为字节数组,保证了较大数据量的传输。
查询数据方法(queryData )定义如下:
byte [] queryData( String sender, String guid, byte [] condition );
5.4 通用应答
调用电子运维系统纵向接口方法后,无论服务器端是否正常处理,都应该返回应答。当服务器端处理正确时,返回成功应答;当服务器处理错误时,返回失败应答。
成功应答用数据头的status 属性为“成功”表示,格式如下:
失败应答用数据头的status 属性为“失败”表示,格式如下:
1
数据查询超时
其中,type 表示失败类型,reason 标识失败原因。详细的失败类型定义如下:
6 接口功能
6.1 中调汇报
当告警发生后,南网总调需要相关中调上报告警处理过程。
6.1.1 中调汇报请求
南网总调请求各省中调进行中调汇报。
6.1.1.1 调用方法
南网总调纵向接口调用各省中调纵向接口的发送数据方法(sendData )。
6.1.1.2 请求数据
6.1.1.2.1 数据头
6.1.1.2.2 数据内容
6.1.1.2.3 应用示例
10281969
650=1=I1=1=2M-10 主要告警
信号丢失(LOS)
2009-12-09 09:51:29 ECI
云南ECI 传输网 丽江地调
6.1.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.1.2 中调汇报上报
各省中调向南网总调上报汇报信息。
6.1.2.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.1.2.2 请求数据 6.1.2.2.1 数据头
表6.1.2.2.1 中调汇报上报数据头取值
6.1.2.2.2 数据内容
6.1.2.2.3 应用示例
10281969 罗海林 2010-06-12 14:56:55 检修 检修导致,跟踪之中
6.1.2.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2 数据上报
6.2.1 财务业务统计上报
6.2.1.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.1.2 请求数据 6.2.1.2.1 数据头
表6.2.1.2.1财务业务统计上报数据头取值
6.2.1.2.2 数据内容
表6.2.1.2.2财务业务统计上报数据内容
6.2.1.2.3 应用示例
云南2010年5月财务业务统计报表 财务人员
2010-06-12 14:56:55
营业部门用户点 宽带业务
Hub 路由器 纤芯直连 10M SDH 10M 8 未知 8 120
营业部门用户点 专网业务
二层数据设备 路由器 纤芯直连 10M
SDH 10M 16 未知 16 200
6.2.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2.2 管理业务统计上报
6.2.2.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.2.2 请求数据 6.2.2.2.1 数据头
6.2.2.2.2 数据内容
表6.2.2.2.2管理业务统计上报数据内容
6.2.2.2.3 应用示例
云南2010年5月管理业务统计报表 管理人员
2010-06-12 14:56:55
营业部门用户点 宽带业务
Hub 路由器 纤芯直连 10M SDH 10M 8 未知 8 120
营业部门用户点 专网业务
二层数据设备 路由器 纤芯直连 10M SDH 10M 16 未知 16 200
6.2.2.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2.3 人力资源业务统计上报
6.2.3.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.3.2 请求数据 6.2.3.2.1 数据头
表6.2.3.2.1人力资源业务统计上报数据头取值
6.2.3.2.2 数据内容
6.2.3.2.3 应用示例
云南2010年5月人力资源业务统计报表 人力资源人员
2010-06-12 14:56:55
营业部门用户点 宽带业务
Hub 路由器 纤芯直连 10M SDH 10M 8
未知 8 120
营业部门用户点 专网业务
二层数据设备 路由器 纤芯直连 10M SDH 10M 16 未知 16 200
6.2.3.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2.4 生产管理业务统计上报
6.2.4.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.4.2 请求数据 6.2.4.2.1 数据头
6.2.4.2.2 数据内容
表6.2.4.2.2生产管理业务统计上报数据内容
6.2.4.2.3 应用示例
云南2010年5月生产管理业务统计报表 生产管理人员
2010-06-12 14:56:55
营业部门用户点 宽带业务
Hub
路由器 纤芯直连 10M SDH 10M 8 未知 8 120
营业部门用户点 专网业务
二层数据设备 路由器 纤芯直连 10M SDH 10M 16 未知 16 200
6.2.4.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.2.5 业务中断情况统计上报
6.2.5.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.2.5.2 请求数据 6.2.5.2.1 数据头
表6.2.5.2.1业务中断情况统计上报数据头取值
6.2.5.2.2 数据内容
6.2.5.2.3 应用示例
云南2010年5月业务中断情况统计报表 财务人员
2010-06-12 14:56:55
光设备故障 SDH 昭通变 华为
OptiX OSN 3500 严重 检修
一级
继电保护
单专用纤芯
昭通变 20 50 25 50
业务开通 1 20
10
是
是
2010-06-12 11:56:55 2010-06-12 12:47:50
6.2.5.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.3 运行计划
6.3.1 月度运行计划上报
6.3.1.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.3.1.2 请求数据 6.3.1.2.1 数据头
6.3.1.2.2 数据内容
6.3.1.2.3 应用示例
2010-3-1 超高压
填写人姓名
2010-06-12 14:56:55
500kV 盘换乙线2M 保护信号传输通道测试
1、2M 电路误码测试、传输延时测试。 2010年03月13日至03月16日
1、退出500kV 盘换乙线主一保护通道一、主二保护通道一及辅助保护通道一;2、退出对侧相应保护通道。
否 天生桥局
是
6.3.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.3.2 月度运行计划查询
6.3.2.1 调用方法
各省中调纵向接口调用南网总调纵向接口的查询数据方法(queryData )。
6.3.2.2 请求数据 6.3.2.2.1 数据头
6.3.2.2.2 数据内容
表6.2.1.2.2月度运行计划查询数据内容
6.3.2.2.3 应用示例
2010-3-1
超高压
填写人姓名
超高压输电公司信通中心
6.3.2.3 应答数据
返回通用应答数据:成功应答数据体如下,失败应答包含失败类型和失败原因。
6.3.2.3.1 数据头
表6.2.1.2.1月度运行计划查询数据头取值
6.3.2.3.2 数据内容
表6.2.1.2.2月度运行计划查询数据内容
6.3.2.3.3 应用示例
2010-3-1 超高压
填写人姓名
2010-06-12 14:56:55
500kV 盘换乙线2M 保护信号传输通道测试
1、2M 电路误码测试、传输延时测试。 2010年03月13日至03月16日
1、退出500kV 盘换乙线主一保护通道一、主二保护通道一及辅助保护通道一;2、退出对侧相应保护通道。
否 天生桥局
是
6.4 值班表 6.4.1 值班表上报
6.4.1.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.4.1.2 请求数据 6.4.1.2.1 数据头
表6.2.1.2.1值班表上报数据头取值
6.4.1.2.2 数据内容
6.4.1.2.3 应用示例
广东中调 通信部
填写人姓名
2010-06-12 14:56:55
2010-3-3 值班人姓名 85122410
[1**********]
6.4.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.5 电路开通 6.5.1 电路开通上报
6.5.1.1 调用方法
各省中调纵向接口调用南网总调纵向接口的发送数据方法(sendData )。
6.5.1.2 请求数据 6.5.1.2.1 数据头
表6.2.1.2.1电路开通上报数据头取值
6.5.1.2.2 数据内容
表6.2.1.2.2电路开通上报数据内容
6.5.1.2.3 应用示例
取消
广州换至马窝换极2直流控制通道2 南网总调
广州换至马窝换极2直流控制通道2
2M
广州换至马窝换 E1
2010-2-22
天广直流通道改造,已对应开通新的通道,此通道可以取消。(对应开通单号20070003)
申请人姓名
2010-2-22 11:36 [email protected] [1**********]
6.5.1.3 应答数据
返回通用应答数据:成功应答无数据体,失败应答包含失败类型和失败原因。
6.5.2 电路开通查询
6.5.2.1 调用方法
各省中调纵向接口调用南网总调纵向接口的查询数据方法(queryData )。
6.5.2.2 请求数据 6.5.2.2.1 数据头
表6.2.1.2.1电路开通查询数据头取值
6.5.2.2.2 数据内容
6.5.2.2.3 应用示例
取消
广州换至马窝换极2直流控制通道2 南网总调
广州换至马窝换极2直流控制通道2
2M 申请人姓名
6.5.2.3 应答数据
返回通用应答数据:成功应答数据体如下,失败应答包含失败类型和失败原因。
6.5.2.3.1 数据头
6.5.2.3.2 数据内容
6.5.2.3.3 应用示例
取消
广州换至马窝换极2直流控制通道2
南网总调
广州换至马窝换极2直流控制通道2
2M
广州换至马窝换 E1
2010-2-22
天广直流通道改造,已对应开通新的通道,此通道可以取消。(对应开通单号20070003)
申请人姓名
2010-2-22 11:36 [email protected]
[1**********]