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

动力环境系统告警与综合网管
互联接口规范
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接口日志功能
综合告警平台系统与动力环境网管系统接口应提供日志功能，对接口中服务的调用方式（调
用其他接口服务或被其他接口所调用）、调用或被调用服务名称、接口服务的调用时间、调用执行的结果等信息进行详细的记录，并在必要时提供相应的查询等功能。

5.2动力环境网管故障告警上报
5.2.1接口服务定义
5.2.1.1告警信息传送服务（InterSwitchAlarm）
5.2.1.1.1测试服务接口（isAlive）
服务接口：InterSwitchAlarm
接口方法：isAlive
输入参数：Null（无）
输出参数：isAliveResult（String类型。

为空表示相应服务可用，非空表示该服务当前出现问题，错误返回信息用相应明文进行说明）
接口概述：动力环境网管系统在调用综合告警平台系统相应服务模块中其他接口方法之前，可利用此服务调用判断对方当前服务是否已经部署完毕，以确定所调用的方法当前是否可以正常服务。

WSDL定义：
</soap:Envelope>
5.2.1.1.2告警接收服务接口（newAlarm）服务接口：InterSwitchAlarm
接口方法：newAlarm
输入参数：如下表所示
输出参数：errList（String类型。

空表示调用成功；非空表示调用失败，其值为错误代码。

若返回多个错误代码，约定用逗号分隔）
前置约束：动力环境网管系统出现需自动上报的告警
接口概述：综合告警平台系统提供该接口服务用于接收告警动力环境网管的需要自动上报的故障告警信息。

后置结果：服务调用成功后，在综合告警平台系统中生成相应的故障告警
WSDL定义：
</soap:Envelope>
5.2.1.1.3告警清除服务接口（syncAlarm）
服务接口：InterSwitchAlarm
接口方法：syncAlarm
输入参数：如下表所示
输出参数：errList（String类型。

空表示调用成功；非空表示调用失败，其值为错误代码。

若返回多个错误代码，约定用逗号分隔）
前置约束：动力环境网管系统中已上报的告警的被清除。

接口概述：综合告警平台系统提供该接口服务用于接收动力环境网管的清除告警信息。

后置结果：服务调用成功后，综合告警平台系统中的相应故障告警自动清除。

WSDL定义：
</soap:Envelope>
附录A
（规范性附录）
各类代码规范
A.1 数据字段约定
1）限定说明
M表示Mandatory（必须的），O表示Optional（可选的），但需注意，可选参数必须出现，
其值为空。

2）时间字段格式
在本规范中，如无特殊说明，时间类字段的数据格式均为：“YYYY-MM-DD H24:MI:SS”。

3）系统简称命名约定
服务提供方、服务调用方均为动力环境网管系统或综合告警平台系统的系统简称。

系统简称命名形如“省市代码_专业类型_系统名称”。

其中省市代码参见表A.2，专业类型代码参见表A.3。

例如：，集团话务网网管的系统简称为“JT_JH_WNMS”。

A.2 省市代码表
表A.2 省市代码
A.3 专业类型代码表
表A.3专业类型代码表。