中国联通客户网管系统接口规范v1.0.doc

中国联通公司企业标准

QB/CU 204-2011

中国联通客户网络管理系统接口规范

China Unicom Customer Network Management System Interface Specification
(v1.0)

2011-06-22发布 2011-06-22实施
中国联通公司发布

I

目 录
1 范围 2
2 规范性引用文件 2
3 缩略语 2
4 接口概述 4
5 客户网管系统部省级接口 6
5.1 接口简要描述 6
5.2 网络连接方式 6
5.3 接口功能需求 6
5.3.1过滤条件设置 6
5.3.2数据信息接口 6
5.3.3告警故障接口 7
5.3.4性能信息接口 8
5.4 接口方式及协议 8
5.5 接口详细描述 8
5.5.1连接测试 8
5.5.2过滤条件设置 9
5.5.3数据信息接口 10
5.5.4告警故障接口 17
5.5.5性能信息接口 20
6 与资源管理系统间接口 23
6.1 接口简要描述 23
6.2 接口功能需求 23
6.2.1资源数据同步 23
6.2.2资源数据查询 24
6.2.3资源数据变更通知 24
6.3 接口方式及协议 24
6.4 接口详细描述 24
6.4.1采用Webservice+FTP方式 24
6.4.2采用中间表方式 33
7 与电子运维系统间接口 38
7.1 接口简要描述 38
7.2 接口功能需求 38
7.2.1故障派单 38
7.2.2故障单管理 38
7.2.3重保电路信息同步 38
7.2.4电路割接信息同步 39
7.3 接口方式及协议 39
7.4 接口详细描述 39
7.4.1接口数据 39
7.4.2电子运维系统侧接口服务定义 42
7.4.3客户网管侧接口服务定义 44
8 与传输网综合网管系统间接口 48
8.1 接口简要描述 48
8.2 接口功能需求 48
8.2.1过滤条件设置 48
8.2.2告警同步 48
8.2.3告警同步通知 48
8.2.4告警实时上报 48
8.2.5告警结束通知 49
8.2.6性能任务定制 49
8.2.7性能数据获取通知 49
8.3 接口方式及协议 49
8.4 接口交互数据 49
8.4.1告警信息 49
8.4.2性能数据 50
8.5 接口详细描述 51
8.5.1传输网综合网管系统侧接口服务定义 51
8.5.2客户网管系统侧服务定义 55
9 与IP网综合网管系统间接口 60
9.1 接口简要描述 60
9.2 接口功能需求 60
9.2.1告警同步 60
9.2.2告警实时上报 60
9.2.3过滤条件设置 60
9.2.4定制性能任务 60
9.2.5性能数据获取通知 61
9.2.6节点间IP网络层时延测试 61
9.2.7MPLS VPN电路：获取各QoS等级带宽占用百分比 61
9.3 接口方式及协议 61
9.4 交互数据定义 62
9.4.1IP电路相关性能参数定义表 62
9.4.2告警信息 63
9.5 接口详细描述 64
9.5.1IP综合网管系统侧服务定义 64
9.5.2客户网管系统侧服务定义 71
10 与数据ATM网管理系统间接口 75
10.1 接口简要描述 75
10.2 接口功能需求 75
10.2.1告警同步 75
10.2.2告警实时上报 75
10.2.3过滤条件设置 75
10.2.4定制性能任务 75
10.2.5性能数据文件获取 76
10.3 接口方式及协议 76
10.4 接口交互数据 76
10.4.1告警信息 76
10.4.2性能数据 77
10.5 接口详细描述 77
10.5.1数据ATM管理系统侧接口服务定义 77
10.5.2客户网管系统侧服务定义 81
附录A接口服务定义代码说明 85
A.1 错误代码表 85
A.2 系统代码表 85
A.3 同步请求标识和通知标识的编号规则 85
A.4 Filter的BNF范式说明 86
A.5 资源数据文件命名规则 88
附录B 客户网管部省接口WSDL 89

中国网通（集团）有限公司 - iii -
中国联通客户网管系统接口规范
前言
中国联通客户网管系统，是以对客户租用电路和客户设备的实时监测为主要目标，从面向客户、面向业务的角度对网管数据进行分析和呈现，实现大客户网络的状态监视、故障定位以及性能分析等功能，同时为大客户提供统计报表和SLA报告，使其成为中国联通为大客户服务的重要支撑平台。为适应中国联通客户网络管理系统建设的需要，规划编制了以下客户网络管理系统系列企业标准：
（1）《中国联通客户网络管理系统技术规范》
（2）《中国联通客户网络管理系统接口规范》
（3）《中国联通客户网络管理系统测试规范》
本标准是其中的《中国联通客户网络管理系统接口规范》。
本规范结合企业OSS规划和客户网管系统的技术规范，统一考虑客户网络管理系统与周边系统的集成关系和接口要求，为中国联合网络通信有限公司客户网络管理系统以及相关系统间集成接口的规划和建设提供基本的技术原则和要求。

本标准由中国联通网络公司运维部提出。
本标准由中国联通公司技术部归口。
本标准起草单位：中国联通网络公司运维部，中讯邮电咨询设计院有限公司
本标准主要起草人：石乐、杨光、刘纯、季文翀
本标准修改和解释权属中国联通公司。
1 范围
本规范适用于中国联合网络通信有限公司及下属省（市）公司，对OSS客户网络管理系统与相关外部系统间的集成关系的规划和建设，和其它规范配合，保障客户网络管理系统建设实施的顺利进行。

2 规范性引用文件
YDN024-1997
中国联通资源管理系统接口规范
YD/T1089-2000
中国联通传输综合管理系统接口规范
YD/T1146-2001
中国联通电子运维系统接口规范

3 缩略语
英文缩写
英文全称
中文全称
SLA
Service Level Agreement
业务等级协定
VLAN
Virtual LAN
虚拟局域网
VPN
Virtual Private Network
虚拟个人网
MPLS
Multi-Protocol Label Switch
多协议标签交换
XML
eXtensible Markup Language
可延伸标示语言
ASON
Automatic Switch Optical Network
智能光网络
BOSS
Business Operation and Support System
业务运营支撑系统
CORBA
Common Object Request Broker Architecture
公共对象请求代理结构
DCN
Data Communication Network
数据通信网
DDF
Digital Distribute Frame
数字配线架
NMS
Network Management System
网络管理系统

EMS
Element Management System
网元管理系统
GUI
Graphic User Interface
图形用户界面
IDL
Interface Definition Language
接口定义语言
JMS
Java Message Service
JAVA消息服务
KPI
Key Process Indication
关键绩效指标
MSTP
Multi-Service Transport Platform
多业务传输平台
NE
Net Element
网元
PDH
Plesiochronous Digital Hierarchy
准同步数字体系
PPP
Point to Point Protocol
点对点协议
PTP
Physical Termination Point
物理终端点
SDH
Synchronous Digital Hierarchy
同步数字体系
4 接口概述
大客户网管系统在联通的整个信息系统中并不是孤立的，它需要与多个外部系统，比如相关专业综合网管系统和各类运营支撑系统实现互连，才能体现系统建设的意义。同时，由于客户网管系统采用在集团和各省独立部署的两级部署架构，集团客户网管系统和各省客户网管系统之间还存在一个部省接口。
客户网管系统与其它系统之间的接口关系如下图所示（其中故障单工单系统在最新的OSS规划中已经被纳入到电子运维系统）。

图1－1 系统集成接口示意图
针对各互联系统的简要分析如下：
序号
系统名称
系统互连意义
建议的互联接口
数据流向
1
传输综合网管系统
获取传输网承载的大客户电路的告警和性能信息
Webservice+FTP
1，性能等大数据量非实时性很高的数据可以通过FTP方式上传
2，配置信息及告警信息采用Webservice方式上传
单向，专业网管到客户网管
2
ATM网管系统
获取ATM数据网承载的大客户电路的告警、性能数据和性能事件
Webservice +FTP
1，性能等大数据量非实时性很高的数据可以通过FTP方式上传
2，配置信息及告警信息采用Webservice方式上传
单向，专业网管到客户网管
3
IP综合网管系统
获取IP网承载的大客户电路的告警、性能数据和性能数据
Webservice+FTP
1，性能等大数据量非实时性很高的数据可以通过FTP方式上传
2，配置信息及告警信息采用Webservice方式上传
单向，专业网管到客户网管
4
资源管理系统
获取大客户电路的业务信息、电路全程路由、客户资料数据以及网元端口的配置信息
数据库中间表
或Webservice

单向，资源管理系统到客户网管
5
电子运维系统
手动或自动派单到故障单系统，并能从故障单系统得到流水信息；获取重保电路和电路割接信息
Webservice
双向
6
客户网管系统部省级接口
省分客户网管向集团客户网管上报集团客户和跨省客户在本省区域内业务的路由、告警、性能数据及事件
Webservice +FTP
1，性能等大数据量非实时性很高的数据可以通过FTP方式上传
2，配置信息及告警信息采用WebService/XML方式上传
双向

注：根据OSS总体规划，原则上资源配置数据须统一从资源管理系统中获取，当省分不具备与资源系统联调的条件时，可以先从专业综合网管系统中获取资源配置数据，接口服务参照客户网管与资源管理系统间接口定义。
5 客户网管系统部省级接口
5.1 接口简要描述
部省级接口是指集团总部客户网管系统与省分客户网管系统间的接口。接口间交换的信息主要包括：资源信息、路由信息、告警信息和性能信息。其中客户信息、客户电路信息以集团资源为准。
集团总部客户网络管理系统会向省分系统下发任务列表或网管信息（如朗讯传输数据）；省分客户网络管理系统向集团系统上报集团客户和跨省客户业务的资源基本信息、路由、告警和性能信息，通过对这些信息的联合处理可以实现跨省大客户端到端的路由、告警、性能信息的呈现功能。
5.2 网络连接方式
建议省分客户网管系统部署在DCN网，至少省部接口机部署在DCN网。与集团总部客户网管平台间通过DCN网直接通信。
5.3 接口功能需求
5.3.1 过滤条件设置
集团总部客户网管通过定制接口过滤条件，控制省级网管上报的资源数据以及告警信息的范围。省分客户网管应只上报集团总部客户网管系统关心的与电路相关的路由、网元、端口以及告警和性能信息。
5.3.2 数据信息接口
5.3.2.1 资源数据查询
5.3.2.1.1 电路路由信息查询
当集团总部客户网管需要对大客户电路的省内段路由进行查看时，集团总部客户网管发起电路路由查询操作。

5.3.2.1.2 网元信息查询
集团总部客户网管需要同步省客户网管管理范围内的与集团大客户（或跨省）业务相关的网元信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。
5.3.2.1.3 端口信息查询
集团总部客户网管需要同步省客户网管管理范围内的与集团大客户业务相关的端口信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。
5.3.2.2 资源数据变化上报
5.3.2.2.1 电路路由信息变化上报
当集团总部网管系统管理的跨省客户电路的省内路由段路由发生变化时，省分客户网管系统需要及时通知集团总部客户网管更新该电路省内端路由信息。
省级客户网管通过接口主动上报电路路由发生变化的业务电路最新路由信息给集团总部客户网管。
5.3.2.2.2 网元信息变化上报
当省级客户网管管理的集团客户业务占用的网元信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应设备信息。
省级客户网管通过接口主动上报发生变化的网元最新信息给集团总部客户网管。

5.3.2.2.3 端口信息变化上报
当省级客户网管管理的集团客户业务占用的端口信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应端口信息。
省级客户网管通过接口主动上报发生变化的端口最新信息给集团总部客户网管。
5.3.3 告警故障接口
5.3.3.1 告警实时上报
省客户网管系统接收到网络告警，并对告警进行根原因和相关性分析后，根据集团总部客户网管告警过滤上报条件，上报影响业务的告警信息给集团总部客户网管系统。
省客户网管系统直接通过告警上报通道上报新增告警事件以及告警清除事件。告警信息直接上报，不需要确认。
5.3.3.2 告警查询（同步）
集团总部客户网管系统在网络中断恢复以后或者其它任何需要的情况，可以发起告警查询（同步）。告警查询（同步）可以采用数据通道方式或消息通道方式来传输。如果返回信息太多，在一个消息体中无法传递，则需要采用文件方式来传递。
（1） 集团总部客户网管先通过消息通道传递查询（同步）条件。
（2） 省客户网管系统在接到该消息以后，准备数据，在数据准备完成后通过消息通道中的消息体把相应的告警信息上报给客户网管系统。
（3） 集团总部客户网管通过数据通道接收相关的告警数据文件。完成告警数据的查询（同步）。
5.3.4 性能信息接口
5.3.4.1 定制性能任务
集团总部客户网管系统根据需要下发性能任务。省客户网管保存该性能任务，并根据下发的性能任务采集性能数据。
性能指标按照客户网管系统技术规范中定义，每次采集包括一类电路或设备的性能所有指标参数。
5.3.4.2 性能数据文件通知
在省客户网管系统采集的性能任务达到性能任务上报时间间隔的要求，则自动生成性能数据文件，并通知集团总部客户网管系统。集团总部客户网管通过数据通道获取相关性能数据文件。
在省客户网管系统采集的性能任务达到性能任务上报时间间隔的要求，则自动生成性能数据文件，生成的文件按照规定的文件命名，存在相应的位置，并通知集团总部客户网管系统。客户网管系统则根据URL，读取性能数据文件，解析即可得到相关性能数据。

5.4 接口方式及协议
采用WebService+FTP文件方式，文档中的方式一和方式二都要实现。
采用HTTP+SOAP1.2协议，集团总部客户网管接口作为服务端，省分作为客户端。实现双工常连接。省分需要也总部网管建立2个常连接，一个用于资源的获取和下发任务，另一个用于告警的实时上报和资源数据变化的实时上报。
FTP的服务器端是省分。
5.5 接口详细描述
5.5.1 连接测试
【场景描述】：
集团总部客户网管通过此命令定期监测与省分接口之间的可连接性。
【功能描述】：
集团总部客户网管通过定期向各个省分接口发送探测命令，来确保每个接口的连通性。如果调用超时则说明接口通信失败；如果省分系统返回整数0，表示省分接口功能出现问题，不能实现正常调用。

【前提条件】：
【接口协议描述】：采用webservice协议
-isAlive ()
【输入】：
【输出】：
接口状态回馈。
1：当省分系统确认接口功能正常时返回
0：存在问题

5.5.2 过滤条件设置
【场景描述】：
集团总部客户网管通过定制接口过滤条件，控制省级网管上报的资源数据以及告警信息的范围。省分客户网管应只上报集团总部客户网管系统关心的与电路相关的路由、网元、端口以及告警和性能信息。
注：以下的各项资源、告警和性能调用方法的返回值或生成的FILE文件，省分系统都需要经过过滤后才能将数据返给集团总部客户网管。
【功能描述】：
集团总部客户网管可以根据实际需求定义集团同省级客户网管上报接口数据的过滤条件，可以设置根据电路对省级上报的配置数据范围进行约束。
【前提条件】：
省分客户网管电路信息中必须有对应的集团总部客户网管的电路编码。
【接口协议描述】：采用webservice协议
-setProvinceDataFilter (String groupCircuitIDList,int actionType)
【输入】：
- groupCircuitIDList 集团电路编码List（ID间以“||”分隔）
-actionType 过滤操作类型（0 新增；1删除）
【输出】：
过滤条件设置成功或错误代码。
1：成功
0：失败或通信失败

5.5.3 数据信息接口
5.5.3.1 资源数据查询
5.5.3.1.1 电路路由信息查询
【场景描述】：
当集团总部客户网管需要对大客户电路的省内段路由进行查看时，集团总部客户网管发起电路路由查询操作。
【功能描述】：
（1） 集团总部客户网管发起电路路由查询操作，通过WebService接口下发需要查询的电路编码给省级客户网管。
（2） 省客户网管通过唯一的电路编码查询该电路的路由，将电路的路由信息通过WebService接口返回给集团总部客户网管系统。
【前提条件】：
（1） 集团总部客户网管已经具备电路基本信息，需要对电路下层路由信息进行查询操作。
（2） 集团总部客户网管同省客户网管拥有统一的电路编码。
【接口协议描述】：
方式一：采用WebService协议获取数据
-getProvinceCircuitRouteInfo (String groupCircuitID,int isMain)
-getProvinceCircuitRouteList(String groupCircuitIDList,int isMain)
【输入】：
-groupCircuitID 集团电路编码
-groupCircuitIDList 集团电路编码List（ID间以“||”分隔）
-isMain 查询主用还是备用电路标识，1：主用；0：备用
【输出】：
电路路由信息（RouteInfo）结果集，其单条记录格式如下：
序号
字段名称
中文含义
1
circuit_id
电路编码
2
serial_no
路由序号（整数）
3
node1_id
入端网元id
4
port1_id
入端端口id
5
logicport1_id
入端逻辑端口id
6
node2_id
出端网元id
7
port2_id
出端端口id
8
logicport2_id
出端逻辑端口id

方式二：采用WebService和FTP
（1） 下发任务
-getProvinceCircuitRouteFile(String taskID,
String groupCircuitIDList,
int isMain)
【输入】：
-taskID 任务号
-groupCircuitIDList 集团电路编码List（ID间以“||”分隔）
-isMain 查询主用还是备用电路标识
【输出】：
是否收到任务，int值，1：成功收到；0：失败或通信失败

（2） 任务完成通知
-onProvinceCircuitRouteFileReady(String taskID,String strURL)
【输入】：
-taskID 任务号
-strURL
【输出】：
是否收到通知信息，int值，1：成功收到；0：失败或通信失败

strURL为文件路径和文件名组合而成。其文件路径一般定义为“…/省分编号/routes/”；文件名定义为“ROUTEINFO”+时间戳“yyyymmddHHMM”。
文件内容格式：网元信息同方式一中（RouteInfo）结果集，属性以$分隔，每条记录按行保存。

(3) FTP获取数据，客户网管系统调用FTP：get（strURL）来获取数据。

5.5.3.1.2 网元信息查询
【场景描述】：
集团总部客户网管需要同步省客户网管管理范围内的与集团大客户（或跨省）业务相关的网元信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。
如果查询返回的网元信息量过大，则可以考虑采用文件方式进行传送。
【功能描述】：
（1） 集团总部客户网管发起网元查询请求，通过WebService接口下发客户编码或业务编码或网元编码到省级客户网管。
（2） 省级客户网管根据集团总部客户网管指定的客户编号或电路编号或网元编号查询相应的网元，将网元信息或网元信息文件路径返回给集团总部客户网管。
（3） 如果采用FTP方式，集团总部客户网管根据收到的文件路径，通过数据通道获取该文件。
【前提条件】：
集团总部客户网管同省客户网管拥有统一的客户编码、电路编码、网元编码。
【接口协议描述】：
方式一：采用WebService协议获取数据
-getProvinceNEListByCustomerID(String customerID)
-getProvinceNEListByCircuitID(String groupCircuitID)
-getProvinceNEInfoByNEID(String neID)
【输入】：
-customerID 客户编码
-circuitID电路编码
-neID网元编码
【输出】：
网元基本信息（NEInfo）结果集，其单条记录格式如下：
序号
字段名称
中文含义
1
ne_id
省级客户网管网元id
2
ne_lable
网元标签
3
name_in_res
网元资源名称（在资源系统中名称）
4
name_in_ems
网元网管名称（在专业网管中名称）
5
service
所属专业
6
ne_type
网元类型
7
vendor
设备厂家
8
ne_model
设备型号
9
hw_version
硬件版本
10
sw_version
软件版本
11
ems
所属网管系统
12
area
所属区域
13
position
位置信息

方式二：采用WebService和FTP
(1)下发任务
-getProvinceNEFileByCustomerID(String taskID ,String customerID)
-getProvinceNEFileByCircuitID（String taskID,String groupCircuitID）
-getProvinceNEFileByNEIDList（String taskID ,String neIDList)
【输入】：
- taskID 任务号
-customerID 客户编码
-circuitID电路编码
-neIDList网元编码List（ID间以“||”分隔）
【输出】：
是否收到任务，int值，1：成功收到；0：失败或通信失败

（2）任务完成通知
-onProvinceNEFileReady(String taskID,String strURL)
【输入】：
-taskID 任务号
-strURL
【输出】：
是否收到通知信息，int值，1：成功收到；0：失败或通信失败

strURL为文件路径和文件名组合而成。其文件路径一般定义为“…/省分编号/nes/”；文件名定义为“NEINFO”+时间戳“yyyymmddHHMM”。
文件内容格式：网元信息同方式一中（NEInfo）结果集，属性以$分隔，每条记录按行保存。

（3）FTP获取数据，客户网管系统调用FTP：get（strURL）来获取数据。

5.5.3.1.3 端口信息查询
【场景描述】：
集团总部客户网管需要同步省客户网管管理范围内的与集团大客户业务相关的端口信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。
如果查询返回的端口信息量过大，则可以考虑采用文件方式进行传送。
【功能描述】：
（1） 集团总部客户网管发起端口查询请求，通过WebService接口下发网元编号或端口编号到省级客户网管。
（2） 省级客户网管根据集团总部客户网管指定的网元编号或端口编号，查询相应的端口，将端口信息或端口信息文件路径，返回给集团总部客户网管。
（3） 如果采用FTP方式，集团总部客户网管根据收到的文件路径，通过数据通道获取该文件。
【前提条件】：
集团总部客户网管同省客户网管能够统一识别网元、端口编码。
【接口协议描述】：
方式一：采用WebService获取数据
-getProvincePortListByNEID(String neID)
-getProvincePortInfoByPortID (String portID)
【输入】：
-neID网元编码
-portID 端口编码
【输出】：
端口信息（PortInfo）结果集，其单条记录格式如下：
序号
字段名称
中文含义
1
port_id
端口标识（端口在板卡上的唯一标识）
2
port_type
端口类型（以太、串口等）
3
port_rate
端口速率
4
port_lable
端口标签
5
ne_id
所属网元id
6
slot_info
所属槽道
7
card_info
所属板卡

方法二：采用WebService和FTP
（1）下发任务
-getProvincePortFileByNEID(String taskID,String neID)
-getProvincePortFileByPortIDList(String taskID,String portIDList)
【输入】：
-taskID 任务号
-neID网元编码
-portIDList 端口编码（ID间以“||”分隔）
【输出】：
是否收到任务，int值，1：成功收到；0：失败或通信失败

（2）任务完成通知
-onProvincePortFileReady(String taskID,String strURL)
【输入】：
-taskID 任务号
-strURL
【输出】：
是否收到通知信息，int值，1：成功收到；0：失败或通信失败

strURL为文件路径和文件名组合而成。其文件路径一般定义为“…/省分编号/ports/”；文件名定义为“PORTINFO”+时间戳“yyyymmddHHMM”。
文件内容格式：端口信息同方式一中（PortInfo）结果集，属性以$分隔，每条记录按行保存。
（3）FTP获取数据，客户网管系统调用FTP：get（strURL）来获取数据。

5.5.3.2 资源数据变化上报
5.5.3.2.1 电路路由信息变化上报
【场景描述】：
当集团总部网管系统管理的跨省客户电路的省内路由段路由发生变化时，省分客户网管系统需要及时通知集团总部客户网管更新该电路省内端路由信息。
【功能描述】：
省级客户网管通过接口主动上报电路路由发生变化的业务电路最新路由信息给集团总部客户网管。
【前提条件】：
集团总部客户网管同省客户网管具备统一的电路编码、路由编码规范。
【接口协议描述】：采用webservice协议
-onProvinceCircuitRouteChange(String circuitID,RouteInfo[] newRoute)
【输入】：
-circuitID 电路编码
-newRoute电路最新路由
【输出】：
1：成功
0：失败

5.5.3.2.2 网元信息变化上报
【场景描述】：
当省级客户网管管理的集团客户业务占用的网元信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应设备信息。

【功能描述】：
省级客户网管通过接口主动上报发生变化的网元最新信息给集团总部客户网管。
【前提条件】：
集团总部客户网管同省客户网管具备统一的网元编码规范。
【接口协议描述】：采用webservice协议
-onProvinceNEChange(String neID，NEInfo neInfo)
【输入】：
-neID 网元编码
-neInfo 最新网元信息
【输出】：
1：成功
0：失败

5.5.3.2.3 端口信息变化上报
【场景描述】：
当省级客户网管管理的集团客户业务占用的端口信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应端口信息。
【功能描述】：
省级客户网管通过接口主动上报发生变化的端口最新信息给集团总部客户网管。
【前提条件】：
集团总部客户网管同省客户网管具备统一的端口编码规范。
【接口协议描述】：采用webservice协议
-onProvincePortChange(int changeFlag,String portID,PortInfo portInfo)
【输入】：
-changeFlag 变更类型（0新增，1修改，2删除）
-portID 端口编码
-portInfo 最新port信息
【输出】：
1：成功
0：失败
5.5.4 告警故障接口
5.5.4.1 告警实时上报
【场景描述】：
省客户网管系统接收到网络告警，并对告警进行根原因和相关性分析后，根据集团总部客户网管告警过滤上报条件，上报影响业务的告警信息给集团总部客户网管系统。
【功能描述】：
省客户网管系统直接通过告警上报通道上报新增告警事件以及告警清除事件。告警信息直接上报，不需要确认。
【前提条件】：
双方消息通道畅通，并满足告警上报过滤条件。
【接口协议描述】：采用webservice协议
-onProvinceAlarmArrived(AlarmInfo alarminfo)
【输入】：
告警信息（AlarmInfo）集，其单条记录格式如下：
序号
字段名称
中文含义
1
alarm_id
告警id
2
alarm_title
告警标题
2
alarm_desc
告警描述
3
alarm_src
告警源
4
alarm_ne
所属网元ID
5
alarm_service
所属专业
6
alarm_ems
所属网管
7
alarm_type
告警类型
8
alarm_level
告警等级（int），（1:严重；2:重要；3:次要；4:警告；5:信息）
9
alarm_affectedCircuit
影响的电路ID
10
alarm_affectedCustomer
影响的客户ID
11
alarm_starttime
告警发生时间
12
alarm_times
告警发生次数（int）
13
alarm_updatetime
告警最后更新时间（yyyymmddHHMMss）
14
alarm_elimatetime
告警清除时间（yyyymmddHHMMss）
15
alarm_status
告警状态（int），1活动告警，0历史告警

【输出】：

5.5.4.2 告警查询（同步）
【场景描述】：
集团总部客户网管系统在网络中断恢复以后或者其它任何需要的情况，可以发起告警查询（同步）。告警查询（同步）可以采用数据通道方式或消息通道方式来传输。如果返回信息太多，在一个消息体中无法传递，则需要采用文件方式来传递。
【功能描述】：
（4） 集团总部客户网管先通过消息通道传递查询（同步）条件。
（5） 省客户网管系统在接到该消息以后，准备数据，在数据准备完成后通过消息通道中的消息体把相应的告警信息上报给客户网管系统。
（6） 集团总部客户网管通过数据通道接收相关的告警数据文件。完成告警数据的查询（同步）。
【前提条件】：
双方消息通道畅通。
【接口协议描述】：
【方式1】：采用webservice协议，用来同步活动告警
-syncProvinceActiveAlarm（String neID,String circuitID,
String startTime，String endTime）；
【输入】： 输入条件是“与”的关系，如果某一个条件不需要，必须填入NULL，如果所有条件都为NULL，则同步当前过滤条件下的所有活动告警。
-neID 所属网元ID
-circuitID 影响的电路ID
-startTime 告警同步开始时间（时间格式：yyyymmddHHMMss）
-endTime 告警同步结束时间
【输出】：
告警信息（AlarmInfo）集。

【方式2】：采用FTP同步数据，一般多用来同步历史告警数据
（1）下发任务
-syncProvinceAlarmFile(String taskID,String neID,String circuitID,
String startTime，String endTime）；
【输入】： 输入条件是“与”的关系，如果某一个条件不需要，必须填入NULL，如果所有条件都为NULL，则同步过滤条件下的所有告警。
-taskID 任务号
-neID 所属网元ID
-circuitID 影响的电路ID
-startTime 告警同步开始时间（时间格式：yyyymmddHHMMss）
-endTime 告警同步结束时间
【输出】：
是否收到任务，int值，1：成功收到；0：失败或通信失败

（2）任务完成通知
-onProvinceAlarmFileReady(String taskID,String strURL)
【输入】：
-taskID 任务号
-strURL
【输出】：
是否收到通知信息，int值，1：成功收到；0：失败或通信失败

strURL为文件路径和文件名组合而成。其文件路