动力环境系统告警与综合网管互联接口规范

动力环境系统告警与综合网管

互联接口规范

1.0版本

前言

XX综合告警管理平台系统实现运营商全专业（交换，无线，传输、数据、动环等）故障告警信息的集中显示和关联分析，实现“集中监控、一点故障处理，一点派单”，提高跨专业业务申告工单的处理效率，促进运维模式的优化。同时提供面向业务和面向客户的服务，并向综合运维平台等系统提供数据支撑。平台系统的使用对象主要是各专业监控人员、客服人员以及运维管理人员。

XX综合告警平台系统要实现动力环境监控系统的告警接入以及数据处理呈现。动力环境监控系统一般根据各省不同的建设进度以及建设思路，有很多移动省份建设了省集中的动力环境监控动力环境网管系统（CSC），也有很多省份还只建设到本地的动力监控系统(LSC)，本规范针对XX综合告警平台系统与集中的动力环境监控动力环境网管系统（CSC）互联做接口定义，完成动力监控系统告警的实时上报和清除告警的实时上报。本规范规定了综合告警平台系统和动力环境监控动力环境网管系统互联的接口业务需求、接口数据规范、接口参考技术方案（Web Service/SOAP）等内容。本规范适用于综合告警平台系统与各厂家动力监控系统的互联接口的实施。

本规范的附录A为规范性附录，附录B为资料性附录。

本规范由XX有限公司公司提出并归口。

本规范由XX有限公司公司负责解释。

目录

第一章适用范围 (3)

第二章术语与缩略语 (3)

第三章接口业务需求 (3)

3.1 动力环境网管告警实时上报 (3)

第四章接口数据规范 (4)

4.1 动力环境网管告警上报 (4)

4.1.1 告警数据 (4)

4.1.2 告警清除数据 (5)

4.2 动力环境重要告警需求列表 (5)

4.2.1 中兴动力环境监控系统 (5)

4.2.2 艾默生动力环境监控 (6)

第五章接口技术参考方案 (7)

5.1 技术约定 (7)

5.1.1 接口技术约定 (7)

5.1.2 接口日志功能 (7)

5.2 动力环境网管告警上报 (8)

5.2.1 接口服务定义 (8)

附录A （规范性附录）各类代码规范 (12)

A.1 数据字段约定 (12)

A.2 省市代码表 (13)

A.3 专业类型代码表 (14)

第一章适用范围

《动力环境系统与综合网管互联接口规范》适用于指导各省公司综合告警平台系统与动力环境集中动力环境网管系统互联接口的开发和测试，是综合告警平台系统与动力环境集中动力环境网管系统互联建设的主要依据。本规范规定了综合告警平台系统和动力环境集中动力环境网管系统互联的接口业务需求、接口数据规范、接口技术参考方案（Web Service/SOAP）等内容。综合告警平台系统与动力环境集中动力环境网管系统互联接口的承建方需满足本规范中的业务需求，严格遵循本规范中的接口数据规范，并在无特殊情况下采用本规范所提供的参考技术方案。

第二章术语与缩略语

下列缩略语适用于本规范：

综合告警平台综合告警平台系统（Intergration Alarm Platform System）

SOAP 简单对象访问协议（Simple Object Access Protocol）

WSDL Web服务定义语言（Web Service Definition Language）

第三章接口业务需求

3.1动力环境网管告警实时上报

系统互联接口应能够支持由动力环境网管告警上报综合告警平台实时故障告警的功能。即通过互联接口，动力环境网管告警的信息将被动力环境网管系统传给综合告警平台系统，并由综合告警平台系统自动接收。

动力环境网管告警实时上报又可细分为由动力环境网管告警自动上报活动故障告警和清除告警两类。自动上报是指在动力环境系统中制定自动上报活动告警规则，由动力环境网管系统根据规则自动判定是否是需要自动上报的告警，并由综合告警平台系统自动接收。当已上报的故障告警被清除后，应能够通过动力环境网管与综合告警平台互联接口，将告警清除信息上报到综合告警平台系统中，并由综合告警平台系统自动接收并作清除操作。

对于动力环境网管告警上报，需满足以下几点要求：

1）动力环境网管系统要对已上报的告警进行标识，避免重复上报。

2）当相关动力环境网管告警的状态为“清除”之后，综合告警平台系统中的相应故障告警也可清除。

3）双方都在log功能中都会各自记录上报和接收的实时故障告警信息。

对于告警自动上报，由告警自动上报规则确定是否上报以及如何上报：

动力环境网管系统应能够根据动力环境网管告警信息项“设备类型”、“局站”、“告警类型”、“告警级别”、“告警标题”、“告警描述”中某几项或全部项进行“自动上报告警”（重要告警）的规则定义。动力环境网管系统将自动把“自动上报告警”传给综合告警平台系统，并由综合告警平台系统自动接收并呈现。

第四章接口数据规范

4.1动力环境网管告警上报

4.1.1告警数据

4.1.2告警清除数据

4.2动力环境重要告警需求列表

一般情况下局方工作基本上只关心“市电停电”“环境温度高”这两类。所以目前只要求动力环境系统上报综合告警平台系统这两类告警，实现故障告警集中。

4.2.1中达动力环境监控系统

1、告警详细列表

4.2.2艾默生动力环境监控

1、告警详细列表

第五章接口技术参考方案

本接口技术参考方案基于Web Service/SOAP技术。

5.1技术约定

5.1.1接口技术约定

接口实现过程中对技术约定如下：

1）支持SOAP v1.1协议；

2）基于HTTP协议传输；

3）为确保接口的兼容性，要求遵循WS-I Basic Profile 1.0。具体要求包括采用文档(document)通信方式和文字(literal)编码方式、没有安全性要求等(参见)；

4）在应用层采用GB2312编码方式；

5）为了保证不同厂家接口操作调用的互通性，综合告警平台系统的SOAP服务命名空间均约定为：“/服务名称”的形式；

6）XX信通必须提供接口定义文件(WSDL)

5.1.2接口日志功能

综合告警平台系统与动力环境网管系统接口应提供日志功能，对接口中服务的调用方式（调