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

《最新中国联通客户网管系统接口规范v1.0》由会员分享，可在线阅读，更多相关《最新中国联通客户网管系统接口规范v1.0（210页珍藏版）》请在装配图网上搜索。

1、最新中国联通客户网管系统接口标准v1.0中国联通公司企业标准QB/CU 204-2022中国联通客户网络管理系统接口标准China Unicom Customer Network Management System Interface Specification(v1.0)2011-06-22发布 2011-06-22实施中国联通公司发布 目 录1范围22标准性引用文件23缩略语24接口概述45客户网管系统部省级接口65.1接口简要描述65.2网络连接方式65.3接口功能需求6过滤条件设置6数据信息接口6告警故障接口7性能信息接口85.4接口方式及协议85.5接口详细描述8连接测试8过滤条件设

2、置9数据信息接口10告警故障接口17性能信息接口206与资源管理系统间接口236.1接口简要描述236.2接口功能需求23资源数据同步23资源数据查询24资源数据变更通知246.3接口方式及协议246.4接口详细描述24采用Webservice+FTP方式24采用中间表方式337与电子运维系统间接口387.1接口简要描述387.2接口功能需求38故障派单38故障单管理38重保电路信息同步38电路割接信息同步397.3接口方式及协议397.4接口详细描述39接口数据39电子运维系统侧接口效劳定义42客户网管侧接口效劳定义448与传输网综合网管系统间接口488.1接口简要描述488.2接口功能需求

3、48过滤条件设置48告警同步48告警同步通知48告警实时上报48告警结束通知49性能任务定制49性能数据获取通知498.3接口方式及协议498.4接口交互数据49告警信息49性能数据508.5接口详细描述51传输网综合网管系统侧接口效劳定义51客户网管系统侧效劳定义559与IP网综合网管系统间接口609.1接口简要描述609.2接口功能需求60告警同步60告警实时上报60过滤条件设置60定制性能任务60性能数据获取通知61节点间IP网络层时延测试619.2.7MPLS VPN电路：获取各QoS等级带宽占用百分比619.3接口方式及协议619.4交互数据定义62电路相关性能参数定义表62告警信息

4、639.5接口详细描述64综合网管系统侧效劳定义64客户网管系统侧效劳定义7110与数据ATM网管理系统间接口7510.1接口简要描述7510.2接口功能需求75告警同步75告警实时上报75过滤条件设置75定制性能任务75性能数据文件获取7610.3接口方式及协议7610.4接口交互数据76告警信息76性能数据7710.5接口详细描述77数据ATM管理系统侧接口效劳定义77客户网管系统侧效劳定义81附录A接口效劳定义代码说明85A.1 错误代码表85A.2 系统代码表85A.3 同步请求标识和通知标识的编号规那么85A.4 Filter的BNF范式说明86A.5 资源数据文件命名规那么88附录

5、B 客户网管部省接口WSDL89前言中国联通客户网管系统，是以对客户租用电路和客户设备的实时监测为主要目标，从面向客户、面向业务的角度对网管数据进行分析和呈现，实现大客户网络的状态监视、故障定位以及性能分析等功能，同时为大客户提供统计报表和SLA报告，使其成为中国联通为大客户效劳的重要支撑平台。为适应中国联通客户网络管理系统建设的需要，规划编制了以下客户网络管理系统系列企业标准：1?中国联通客户网络管理系统技术标准?2?中国联通客户网络管理系统接口标准?3?中国联通客户网络管理系统测试标准?本标准是其中的?中国联通客户网络管理系统接口标准?。本标准结合企业OSS规划和客户网管系统的技术标准，统

6、一考虑客户网络管理系统与周边系统的集成关系和接口要求，为中国联合网络通信客户网络管理系统以及相关系统间集成接口的规划和建设提供根本的技术原那么和要求。本标准由中国联通网络公司运维部提出。本标准由中国联通公司技术部归口。本标准起草单位：中国联通网络公司运维部，中讯邮电咨询设计院本标准主要起草人：石乐、杨光、刘纯、季文翀本标准修改和解释权属中国联通公司。1 范围本标准适用于中国联合网络通信及下属省市公司，对OSS客户网络管理系统与相关外部系统间的集成关系的规划和建设，和其它标准配合，保障客户网络管理系统建设实施的顺利进行。2 标准性引用文件YDN024-1997中国联通资源管理系统接口标准YD/T

7、1089-2000中国联通传输综合管理系统接口标准YD/T1146-2001中国联通电子运维系统接口标准3 缩略语英文缩写英文全称中文全称SLAService Level Agreement业务等级协定VLANVirtual LAN虚拟局域网VPNVirtual Private Network虚拟个人网MPLSMulti-Protocol Label Switch多协议标签交换XMLeXtensible Markup Language可延伸标示语言ASONAutomatic Switch Optical Network智能光网络BOSSBusiness Operation and Suppor

8、t System业务运营支撑系统CORBACommon Object Request Broker Architecture公共对象请求代理结构DCNData Communication Network数据通信网DDFDigital Distribute Frame数字配线架NMSNetwork Management System网络管理系统EMSElement Management System网元管理系统GUIGraphic User Interface图形用户界面IDLInterface Definition Language接口定义语言JMSJava Message ServiceJA

9、VA消息效劳KPIKey Process Indication关键绩效指标MSTPMulti-Service Transport Platform多业务传输平台NENet Element网元PDHPlesiochronous Digital Hierarchy准同步数字体系PPPPoint to Point Protocol 点对点协议PTPPhysical Termination Point物理终端点SDHSynchronous Digital Hierarchy同步数字体系4 接口概述大客户网管系统在联通的整个信息系统中并不是孤立的，它需要与多个外部系统，比方相关专业综合网管系统和各类运营

10、支撑系统实现互连，才能表达系统建设的意义。同时，由于客户网管系统采用在集团和各省独立部署的两级部署架构，集团客户网管系统和各省客户网管系统之间还存在一个部省接口。客户网管系统与其它系统之间的接口关系如下列图所示其中故障单工单系统在最新的OSS规划中已经被纳入到电子运维系统。图11 系统集成接口示意图 针对各互联系统的简要分析如下：序号系统名称系统互连意义建议的互联接口数据流向1传输综合网管系统获取传输网承载的大客户电路的告警和性能信息Webservice+FTP1，性能等大数据量非实时性很高的数据可以通过FTP方式上传2，配置信息及告警信息采用Webservice方式上传单向，专业网管到客户网

11、管2ATM网管系统获取ATM数据网承载的大客户电路的告警、性能数据和性能事件Webservice +FTP1，性能等大数据量非实时性很高的数据可以通过FTP方式上传2，配置信息及告警信息采用Webservice方式上传单向，专业网管到客户网管3IP综合网管系统获取IP网承载的大客户电路的告警、性能数据和性能数据Webservice+FTP1，性能等大数据量非实时性很高的数据可以通过FTP方式上传2，配置信息及告警信息采用Webservice方式上传单向，专业网管到客户网管4资源管理系统获取大客户电路的业务信息、电路全程路由、客户资料数据以及网元端口的配置信息数据库中间表或Webservice单

12、向，资源管理系统到客户网管5电子运维系统手动或自动派单到故障单系统，并能从故障单系统得到流水信息；获取重保电路和电路割接信息Webservice双向6客户网管系统部省级接口省分客户网管向集团客户网管上报集团客户和跨省客户在本省区域内业务的路由、告警、性能数据及事件Webservice +FTP1，性能等大数据量非实时性很高的数据可以通过FTP方式上传2，配置信息及告警信息采用WebService/XML方式上传双向注：根据OSS总体规划，原那么上资源配置数据须统一从资源管理系统中获取，当省分不具备与资源系统联调的条件时，可以先从专业综合网管系统中获取资源配置数据，接口效劳参照客户网管与资源管理

13、系统间接口定义。5 客户网管系统部省级接口5.1 接口简要描述部省级接口是指集团总部客户网管系统与省分客户网管系统间的接口。接口间交换的信息主要包括：资源信息、路由信息、告警信息和性能信息。其中客户信息、客户电路信息以集团资源为准。集团总部客户网络管理系统会向省分系统下发任务列表或网管信息如朗讯传输数据；省分客户网络管理系统向集团系统上报集团客户和跨省客户业务的资源根本信息、路由、告警和性能信息，通过对这些信息的联合处理可以实现跨省大客户端到端的路由、告警、性能信息的呈现功能。5.2 网络连接方式建议省分客户网管系统部署在DCN网，至少省部接口机部署在DCN网。与集团总部客户网管平台间通过DC

14、N网直接通信。5.3 接口功能需求5.3.1 过滤条件设置集团总部客户网管通过定制接口过滤条件，控制省级网管上报的资源数据以及告警信息的范围。省分客户网管应只上报集团总部客户网管系统关心的与电路相关的路由、网元、端口以及告警和性能信息。5.3.2 数据信息接口5.3.2.1 资源数据查询5.3.2.1.1 电路路由信息查询当集团总部客户网管需要对大客户电路的省内段路由进行查看时，集团总部客户网管发起电路路由查询操作。5.3.2.1.2 网元信息查询集团总部客户网管需要同步省客户网管管理范围内的与集团大客户或跨省业务相关的网元信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。5

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

16、设备信息。省级客户网管通过接口主动上报发生变化的网元最新信息给集团总部客户网管。 5.3.2.2.3 端口信息变化上报当省级客户网管管理的集团客户业务占用的端口信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应端口信息。省级客户网管通过接口主动上报发生变化的端口最新信息给集团总部客户网管。 5.3.3 告警故障接口5.3.3.1 告警实时上报省客户网管系统接收到网络告警，并对告警进行根原因和相关性分析后，根据集团总部客户网管告警过滤上报条件，上报影响业务的告警信息给集团总部客户网管系统。省客户网管系统直接通过告警上报通道上报新增告警事件以及告警去除事件。告警信息直接上报，不需要确认。

17、5.3.3.2 告警查询同步集团总部客户网管系统在网络中断恢复以后或者其它任何需要的情况，可以发起告警查询同步。告警查询同步可以采用数据通道方式或消息通道方式来传输。如果返回信息太多，在一个消息体中无法传递，那么需要采用文件方式来传递。（1） 集团总部客户网管先通过消息通道传递查询同步条件。（2） 省客户网管系统在接到该消息以后，准备数据，在数据准备完成后通过消息通道中的消息体把相应的告警信息上报给客户网管系统。（3） 集团总部客户网管通过数据通道接收相关的告警数据文件。完成告警数据的查询同步。5.3.4 性能信息接口5.3.4.1 定制性能任务集团总部客户网管系统根据需要下发性能任务。省客户

18、网管保存该性能任务，并根据下发的性能任务采集性能数据。性能指标按照客户网管系统技术标准中定义，每次采集包括一类电路或设备的性能所有指标参数。5.3.4.2 性能数据文件通知在省客户网管系统采集的性能任务到达性能任务上报时间间隔的要求，那么自动生成性能数据文件，并通知集团总部客户网管系统。集团总部客户网管通过数据通道获取相关性能数据文件。在省客户网管系统采集的性能任务到达性能任务上报时间间隔的要求，那么自动生成性能数据文件，生成的文件按照规定的文件命名，存在相应的位置，并通知集团总部客户网管系统。客户网管系统那么根据URL，读取性能数据文件，解析即可得到相关性能数据。5.4 接口方式及协议采用W

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

20、正常调用。【前提条件】：【接口协议描述】：采用webservice协议-isAlive ()【输入】：【输出】：接口状态回馈。1：当省分系统确认接口功能正常时返回0：存在问题5.5.2 过滤条件设置【场景描述】：集团总部客户网管通过定制接口过滤条件，控制省级网管上报的资源数据以及告警信息的范围。省分客户网管应只上报集团总部客户网管系统关心的与电路相关的路由、网元、端口以及告警和性能信息。注：以下的各项资源、告警和性能调用方法的返回值或生成的FILE文件，省分系统都需要经过过滤后才能将数据返给集团总部客户网管。【功能描述】：集团总部客户网管可以根据实际需求定义集团同省级客户网管上报接口数据的过滤

21、条件，可以设置根据电路对省级上报的配置数据范围进行约束。【前提条件】：省分客户网管电路信息中必须有对应的集团总部客户网管的电路编码。【接口协议描述】：采用webservice协议-setProvinceDataFilter (String groupCircuitIDList,int actionType)【输入】：- groupCircuitIDList 集团电路编码ListID间以“|分隔 -actionType 过滤操作类型0 新增；1删除【输出】：过滤条件设置成功或错误代码。1：成功0：失败或通信失败5.5.3 数据信息接口5.5.3.1 资源数据查询5.5.3.1.1 电路路由信息查

22、询【场景描述】：当集团总部客户网管需要对大客户电路的省内段路由进行查看时，集团总部客户网管发起电路路由查询操作。【功能描述】：（1） 集团总部客户网管发起电路路由查询操作，通过WebService接口下发需要查询的电路编码给省级客户网管。（2） 省客户网管通过唯一的电路编码查询该电路的路由，将电路的路由信息通过WebService接口返回给集团总部客户网管系统。【前提条件】：（1） 集团总部客户网管已经具备电路根本信息，需要对电路下层路由信息进行查询操作。（2） 集团总部客户网管同省客户网管拥有统一的电路编码。【接口协议描述】：方式一：采用WebService协议获取数据-getProvinc

23、eCircuitRouteInfo (String groupCircuitID,int isMain)-getProvinceCircuitRouteList(String groupCircuitIDList,int isMain)【输入】： -groupCircuitID 集团电路编码-groupCircuitIDList 集团电路编码ListID间以“|分隔 -isMain 查询主用还是备用电路标识，1：主用；0：备用【输出】： 电路路由信息RouteInfo结果集，其单条记录格式如下：序号字段名称中文含义1circuit_id电路编码2serial_no路由序号整数3node1_id

24、入端网元id4port1_id入端端口id5logicport1_id入端逻辑端口id6node2_id出端网元id7port2_id出端端口id8logicport2_id出端逻辑端口id方式二：采用WebService和FTP（1） 下发任务-getProvinceCircuitRouteFile(String taskID,String groupCircuitIDList,int isMain)【输入】： -taskID 任务号-groupCircuitIDList 集团电路编码ListID间以“|分隔 -isMain 查询主用还是备用电路标识【输出】：是否收到任务，int值，1：成功

25、收到；0：失败或通信失败（2） 任务完成通知-onProvinceCircuitRouteFileReady(String taskID,String strURL)【输入】： -taskID 任务号-strURL【输出】：是否收到通知信息，int值，1：成功收到；0：失败或通信失败strURL为文件路径和文件名组合而成。其文件路径一般定义为“/省分编号/routes/；文件名定义为“ROUTEINFO+时间戳“yyyymmddHHMM。文件内容格式：网元信息同方式一中RouteInfo结果集，属性以$分隔，每条记录按行保存。(3) FTP获取数据，客户网管系统调用FTP：getstrURL来

26、获取数据。5.5.3.1.2 网元信息查询【场景描述】：集团总部客户网管需要同步省客户网管管理范围内的与集团大客户或跨省业务相关的网元信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。如果查询返回的网元信息量过大，那么可以考虑采用文件方式进行传送。【功能描述】：（1） 集团总部客户网管发起网元查询请求，通过WebService接口下发客户编码或业务编码或网元编码到省级客户网管。（2） 省级客户网管根据集团总部客户网管指定的客户编号或电路编号或网元编号查询相应的网元，将网元信息或网元信息文件路径返回给集团总部客户网管。（3） 如果采用FTP方式，集团总部客户网管根据收到的文件路

27、径，通过数据通道获取该文件。【前提条件】：集团总部客户网管同省客户网管拥有统一的客户编码、电路编码、网元编码。【接口协议描述】：方式一：采用WebService协议获取数据-getProvinceNEListByCustomerID(String customerID)-getProvinceNEListByCircuitID(String groupCircuitID)-getProvinceNEInfoByNEID(String neID)【输入】：-customerID 客户编码-circuitID电路编码-neID网元编码【输出】：网元根本信息NEInfo结果集，其单条记录格式如下：序

28、号字段名称中文含义1ne_id省级客户网管网元id2ne_lable网元标签3name_in_res网元资源名称在资源系统中名称4name_in_ems网元网管名称在专业网管中名称5service所属专业6ne_type网元类型7vendor设备厂家8ne_model设备型号9hw_version硬件版本10sw_version软件版本11ems所属网管系统12area所属区域13position位置信息方式二：采用WebService和FTP(1)下发任务-getProvinceNEFileByCustomerID(String taskID ,String customerID)-getP

29、rovinceNEFileByCircuitIDString taskID,String groupCircuitID-getProvinceNEFileByNEIDListString taskID ,String neIDList)【输入】：- taskID 任务号-customerID 客户编码-circuitID电路编码-neIDList网元编码ListID间以“|分隔【输出】：是否收到任务，int值，1：成功收到；0：失败或通信失败2任务完成通知-onProvinceNEFileReady(String taskID,String strURL)【输入】： -taskID 任务号-s

30、trURL【输出】：是否收到通知信息，int值，1：成功收到；0：失败或通信失败strURL为文件路径和文件名组合而成。其文件路径一般定义为“/省分编号/nes/；文件名定义为“NEINFO+时间戳“yyyymmddHHMM。文件内容格式：网元信息同方式一中NEInfo结果集，属性以$分隔，每条记录按行保存。3FTP获取数据，客户网管系统调用FTP：getstrURL来获取数据。5.5.3.1.3 端口信息查询【场景描述】：集团总部客户网管需要同步省客户网管管理范围内的与集团大客户业务相关的端口信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。如果查询返回的端口信息量过大，那

31、么可以考虑采用文件方式进行传送。【功能描述】：（1） 集团总部客户网管发起端口查询请求，通过WebService接口下发网元编号或端口编号到省级客户网管。（2） 省级客户网管根据集团总部客户网管指定的网元编号或端口编号，查询相应的端口，将端口信息或端口信息文件路径，返回给集团总部客户网管。（3） 如果采用FTP方式，集团总部客户网管根据收到的文件路径，通过数据通道获取该文件。【前提条件】：集团总部客户网管同省客户网管能够统一识别网元、端口编码。【接口协议描述】：方式一：采用WebService获取数据-getProvincePortListByNEID(String neID)-getProv

32、incePortInfoByPortID (String portID)【输入】：-neID网元编码 -portID 端口编码【输出】：端口信息PortInfo结果集，其单条记录格式如下：序号字段名称中文含义1port_id端口标识端口在板卡上的唯一标识2port_type端口类型以太、串口等3port_rate端口速率4port_lable端口标签5ne_id所属网元id6slot_info所属槽道7card_info所属板卡方法二：采用WebService和FTP1下发任务-getProvincePortFileByNEID(String taskID,String neID)-getPr

33、ovincePortFileByPortIDList(String taskID,String portIDList)【输入】：-taskID 任务号-neID网元编码 -portIDList 端口编码ID间以“|分隔【输出】：是否收到任务，int值，1：成功收到；0：失败或通信失败2任务完成通知-onProvincePortFileReady(String taskID,String strURL)【输入】： -taskID 任务号-strURL【输出】：是否收到通知信息，int值，1：成功收到；0：失败或通信失败strURL为文件路径和文件名组合而成。其文件路径一般定义为“/省分编号/po

34、rts/；文件名定义为“PORTINFO+时间戳“yyyymmddHHMM。文件内容格式：端口信息同方式一中PortInfo结果集，属性以$分隔，每条记录按行保存。3FTP获取数据，客户网管系统调用FTP：getstrURL来获取数据。5.5.3.2 资源数据变化上报5.5.3.2.1 电路路由信息变化上报【场景描述】：当集团总部网管系统管理的跨省客户电路的省内路由段路由发生变化时，省分客户网管系统需要及时通知集团总部客户网管更新该电路省内端路由信息。【功能描述】：省级客户网管通过接口主动上报电路路由发生变化的业务电路最新路由信息给集团总部客户网管。【前提条件】：集团总部客户网管同省客户网管具

35、备统一的电路编码、路由编码标准。【接口协议描述】：采用webservice协议-onProvinceCircuitRouteChange(String circuitID,RouteInfo newRoute)【输入】： -circuitID 电路编码-newRoute电路最新路由【输出】：1：成功0：失败5.5.3.2.2 网元信息变化上报【场景描述】：当省级客户网管管理的集团客户业务占用的网元信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应设备信息。【功能描述】：省级客户网管通过接口主动上报发生变化的网元最新信息给集团总部客户网管。 【前提条件】：集团总部客户网管同省客户网管具

36、备统一的网元编码标准。【接口协议描述】：采用webservice协议-onProvinceNEChange(String neID，NEInfo neInfo)【输入】： -neID 网元编码-neInfo 最新网元信息【输出】：1：成功0：失败5.5.3.2.3 端口信息变化上报【场景描述】：当省级客户网管管理的集团客户业务占用的端口信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应端口信息。【功能描述】：省级客户网管通过接口主动上报发生变化的端口最新信息给集团总部客户网管。 【前提条件】：集团总部客户网管同省客户网管具备统一的端口编码标准。【接口协议描述】：采用webservic

37、e协议-onProvincePortChange(int changeFlag,String portID,PortInfo portInfo)【输入】：-changeFlag 变更类型0新增，1修改，2删除 -portID 端口编码-portInfo 最新port信息【输出】：1：成功0：失败5.5.4 告警故障接口5.5.4.1 告警实时上报【场景描述】：省客户网管系统接收到网络告警，并对告警进行根原因和相关性分析后，根据集团总部客户网管告警过滤上报条件，上报影响业务的告警信息给集团总部客户网管系统。【功能描述】：省客户网管系统直接通过告警上报通道上报新增告警事件以及告警去除事件。告警信息

38、直接上报，不需要确认。【前提条件】： 双方消息通道畅通，并满足告警上报过滤条件。【接口协议描述】：采用webservice协议-onProvinceAlarmArrived(AlarmInfo alarminfo)【输入】：告警信息AlarmInfo集，其单条记录格式如下：序号字段名称中文含义1alarm_id告警id2alarm_title告警标题2alarm_desc告警描述3alarm_src告警源4alarm_ne所属网元ID5alarm_service所属专业6alarm_ems所属网管7alarm_type告警类型8alarm_level告警等级int，1:严重；2:重要；3:次要

39、；4:警告；5:信息9alarm_affectedCircuit影响的电路ID10alarm_affectedCustomer影响的客户ID11alarm_starttime告警发生时间12alarm_times告警发生次数int13alarm_updatetime告警最后更新时间yyyymmddHHMMss14alarm_elimatetime告警去除时间yyyymmddHHMMss15alarm_status告警状态int，1活动告警，0历史告警【输出】：5.5.4.2 告警查询同步【场景描述】： 集团总部客户网管系统在网络中断恢复以后或者其它任何需要的情况，可以发起告警查询同步。告警查询

40、同步可以采用数据通道方式或消息通道方式来传输。如果返回信息太多，在一个消息体中无法传递，那么需要采用文件方式来传递。【功能描述】：（4） 集团总部客户网管先通过消息通道传递查询同步条件。（5） 省客户网管系统在接到该消息以后，准备数据，在数据准备完成后通过消息通道中的消息体把相应的告警信息上报给客户网管系统。（6） 集团总部客户网管通过数据通道接收相关的告警数据文件。完成告警数据的查询同步。【前提条件】： 双方消息通道畅通。【接口协议描述】：【方式1】：采用webservice协议，用来同步活动告警-syncProvinceActiveAlarmString neID,String circu

41、itID,String startTime，String endTime；【输入】： 输入条件是“与的关系，如果某一个条件不需要，必须填入NULL，如果所有条件都为NULL，那么同步当前过滤条件下的所有活动告警。 -neID 所属网元ID-circuitID 影响的电路ID-startTime 告警同步开始时间时间格式：yyyymmddHHMMss-endTime 告警同步结束时间【输出】：告警信息AlarmInfo集。【方式2】：采用FTP同步数据，一般多用来同步历史告警数据1下发任务-syncProvinceAlarmFile(String taskID,String neID,Strin

42、g circuitID,String startTime，String endTime；【输入】： 输入条件是“与的关系，如果某一个条件不需要，必须填入NULL，如果所有条件都为NULL，那么同步过滤条件下的所有告警。 -taskID 任务号-neID 所属网元ID-circuitID 影响的电路ID-startTime 告警同步开始时间时间格式：yyyymmddHHMMss-endTime 告警同步结束时间 【输出】：是否收到任务，int值，1：成功收到；0：失败或通信失败2任务完成通知-onProvinceAlarmFileReady(String taskID,String strURL

43、)【输入】： -taskID 任务号-strURL【输出】：是否收到通知信息，int值，1：成功收到；0：失败或通信失败strURL为文件路径和文件名组合而成。其文件路径一般定义为“/省分编号/alarms/；文件名定义为“ALARMINFO+时间戳“yyyymmddHHMMss。文件内容格式：告警信息与方式一中AlarmInfo结果集相同，属性以$分隔，每条记录按行保存。3FTP获取数据，客户网管系统调用FTP：getstrURL来获取数据。5.5.5 性能信息接口5.5.5.1 定制性能任务【场景描述】：集团总部客户网管系统根据需要下发性能任务。省客户网管保存该性能任务，并根据下发的性能任

44、务采集性能数据。性能指标按照客户网管系统技术标准中定义，每次采集包括一类电路或设备的性能所有指标参数。【功能描述】（1） 集团总部客户网管系统通过消息下发性能任务定义，性能定制任务在消息体中描述。（2） 省客户网管系统在接收到任务以后，解析并保存性能任务。【前提条件】 双方消息通道畅通。【接口协议描述】：任务下发采用webservice，批量性能数据获取通过FTP-setProvincePerfTask (String perf_id,String perf_name,int perf_obj_type,String perf_obj_id_list，String perf_begin_tim

45、e,int perf_task_interval,int perf_task_status【输入】perf_id 性能任务ID唯一标识性能任务perf_name 性能任务名称perf_obj_type 性能对象类型int类型，电路0、网元1、端口2perf_obj_id_list 同一类性能对象标识List，(ID以“|来进行分隔)perf_begin_time 性能任务开始时间，时间格式：yyyymmddHHMMssperf_task_interval 采集间隔任务周期，int类型，5分，15分，60分，1440分即24小时perf_task_status性能任务状态int类型，创立0、修改

46、1、删除2、挂起3、恢复4【输出】：String strURLstrURL为FTP文件路径。其文件路径一般定义为“/省分编号/perftask/15minute(5分钟或5分钟或60分钟 或24hour)。定期生成的文件名定义：任务ID+“yyyymmddHHMMss。5.5.5.2 性能数据文件通知【场景描述】：在省客户网管系统采集的性能任务到达性能任务上报时间间隔的要求，那么自动生成性能数据文件，并通知集团总部客户网管系统。集团总部客户网管通过数据通道获取相关性能数据文件。【功能描述】：在省客户网管系统采集的性能任务到达性能任务上报时间间隔的要求，那么自动生成性能数据文件，生成的文件按照规

47、定的文件命名，存在相应的位置，并通知集团总部客户网管系统。客户网管系统那么根据URL，读取性能数据文件，解析即可得到相关性能数据。【前提条件】： 性能任务已经被定制，且双方通信正常。【接口协议描述】：Webservice+FTP【方法】：-OnProvincePerfReady(String perfid,String ftpurl)由省分系统定期上报。【输入】-perfid 性能任务ID唯一标识性能任务-ftpurl 性能文件完整FTP地址，包括具体文件名【输出】：是否收到通知信息，int值，1：成功收到；0：失败或通信失败文件内容格式：性能参数依照客户网管系统技术标准中定义如下表，属性以$

48、分隔，每条记录按行保存。如果某一个属性没有值，必须填入NULL。如一条传输电路的性能格式为：集团电路编码$误码秒$严重误码秒$连续严重误码秒$不可用秒$背景误码块$光功率。编号分类业务指标1传输误码秒、严重误码秒、连续严重误码秒、不可用秒、背景误码块、光功率2数字电路误码秒ES、严重误码秒SES、不可用秒UAS、背景误块码BBE3数据ATM电路信元丧失率CLR、信元误差率CMR、接收字节数、发送字节数、接收错误字节数4MPLS VPN发送速率、接收丢包率、接收速率、发送丢包率、时延、Qos5IP发送速率、接收丢包率、接收速率、发送丢包率、Qos6xDSL上行实际速率(kbps)、下行实际速率(

49、kbps)、上行可达速率(kbps)、下行可达速率(kbps)7LAN发送速率、接收丢包率、接收速率、发送丢包率6 与资源管理系统间接口6.1 接口简要描述客户网管系统通过该接口从资源管理系统获取客户信息、客户的电路信息、电路路由信息和端口信息，形成客户视图、业务视图、电路视图及全程路由拓扑展示。客户网管系统从资源系统中还应该能够获取客户的业务信息，如SLA信息和Qos信息，以便客户网管能够实时监测这些指标。资源管理系统与客户网管系统之间的交互流程包括资源信息查询、资源信息变更通知和资源同步。6.2 接口功能需求6.2.1 资源数据同步资源管理系统通过数据同步功能向客户网管系统提供客户网管所需

50、要的资源数据信息。当客户网管系统需要向资源系统进行资源数据同步时，首先向资源系统发送资源数据同步请求，资源系统收到请求后给出响应，表示系统已收到该请求。与此同时，资源系统开始准备数据，客户网管系统可通过FTP协议从资源系统处获取资源数据文件，当数据传输完毕或传输中断需要向资源系统发送同步完毕通知，表示同步完成，假设同步失败，在同步完毕通知中需列出失败的原因。接口上的资源数据同步一般适用于以下情况：-当双方系统建立管理连接时；-当双方系统出现通信失败并且恢复后；-当一方系统出现系统故障并且恢复后；-当一方系统发生大粒度资源更新变更后；资源数据同步操作的触发点有两种情况：一是由客户网管系统主动发起

51、数据同步操作；另一种是资源管理系统主动发送通知消息，以触发客户网管系统的自动同步操作，由于资源管理系统发现了自身内部的问题等情况例如：资源信息变更，发送“资源数据变更通知给客户网管系统，并发送“同步数据请求通知。接口上还应支持灵活的数据同步方式，如资源系统可根据客户网管系统要求的同步过滤条件上报其相关的资源信息，有利于提高工作效率，减轻系统接口以及网络负荷。一次数据同步可以只选择有限的地域范围、子网范围等；一次数据同步也可以只选择有限的几种类型。6.2.2 资源数据查询资源管理系统应支持接收客户网管系统发起的资源信息的查询请求，并返回查询结果。除了支持大数据量的资源数据查询同步外，接口还应支持

52、直接查询较小范围内的资源数据，如指定范围的资源实例标识，指定范围和指定属性的资源属性信息等：接口应支持根据资源的关系对指定范围的资源实例标识进行查询；接口还应支持对一个或多个资源对象的指定属性值进行查询。6.2.3 资源数据变更通知当资源管理系统中纳入客户网管系统监控的资源数据发生变更时，应向客户网管系统发送相应的资源数据变更通知，如资源创立通知、资源删除通知、资源属性值改变通知等。通知中包含具体的资源变更信息，如资源实例、资源变更类型、资源属性取值等。当资源数据改动较大，需要通过大数据量方式传送时，该系统应发送“资源数据同步通知，客户网管系统收到该通知后可进行资源数据同步。6.3 接口方式及

53、协议建议采用Webservice+FTP或数据库中间表方式。6.4 接口详细描述6.4.1 采用Webservice+FTP方式考虑到Webservice在传输大量的数据时，网络速度可能会成为系统的瓶颈，而且会影响到其他的效劳，因此在传输大量数据的情况下，建议配合FTP效劳的方式传送数据包。6.4.1.1 接口交互数据6.4.1.1.1 客户根本信息序号字段名称数据类型中文含义1customer_idString客户编码2customer_nameString客户名称3customer_typeint客户类型集团客户、省分客户等4customer_levelint客户级别钻石、金牌、银牌、铜牌

54、5owner_customerString父客户编码6contactorString联系人7contact_telString联系 8contact_mobileString 号码9contact_emailString电子邮件10contact_faxString 11contact_addressString通信地址12officeint所属行业金融、政府等13manager_nameString客户经理名称14manager_telString客户经理 15manager_emailString客户经理电子邮件6.4.1.1.2 电路根本信息序号字段名称数据类型中文含义1circuit_

55、idString电路编码2circuit_nameString电路名称3serviceint所属专业4service_typeint业务类型5circuit_levelint电路级别：一干、二干、本地6circuit_rateint电路速率7owner_customerString所属客户ID8aend_nodeStringA端网元ID9aend_portStringA端端口ID10aend_logicportStringA端逻辑端口11aend_customerStringA端客户12zend_nodeStringZ端网元ID13zend_portStringZ端端口ID14zend_log

56、icportStringZ端逻辑端口15zend_customerStringZ端客户16target_useString电路用途17open_timeString开通时间2022-05-08 13:34:3418qos_classint白金、黄金、银等等级19sla_classint钻石，金，银，标准，其他6.4.1.1.3 电路路由信息序号字段名称数据类型中文含义1circuit_idString电路编码2serial_noint路由序号3node1String入端网元id4port1String入端端口id5logicport1String入端逻辑端口id6node2String出端网元

57、id7port2String出端端口id8logicport2String出端逻辑端口id6.4.1.1.4 网元信息序号字段名称数据类型中文含义1neIDString省级客户网管网元id2ne_lableString网元标签3name_in_resString网元资源名称在资源系统4name_in_emsString网元网管名称在专业网管5serviceint所属专业6typeint网元类型7vendorString设备厂家8ne_typeString设备型号9hw_versionString硬件版本10sw_versionString软件版本11emsString所属网管系统12areaString所属区域13positionString 位置信息6.4.1.1.5 端口信息序号字段名称数据类型中文含义1port_idString端口标识端口在板卡上的唯一标识2port_typeint端口物理介质3port_rateint