中国联通客户网管系统接口规范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范围22规范性引用文件23缩略语24接口概述45客户网管系统部省级接口65.1接口简要描述65.2网络连接方式65.3接口功能需求65.3.1过滤条件设置65.3.2数据信息接口65.3.3告警故障接口75.3.4性能信息接口85.4接口方式及协议85.5接口详细描述85.5.1连接测试85.5.2过滤条件设置95.5.3数据信息接口105.5.4告警故障接口175.5.5性能信息接口206与资源管理系统间接口236.1接口简要描述236.2接口功能需求236.2.1资源数据同步236.2.2资源数据查询246.2.3资源数据变更通知246.3接口方式及协议246.4接口详细描述246.4.1采用Webservice+FTP方式246.4.2采用中间表方式337与电子运维系统间接口387.1接口简要描述387.2接口功能需求387.2.1故障派单387.2.2故障单管理387.2.3重保电路信息同步387.2.4电路割接信息同步397.3接口方式及协议397.4接口详细描述397.4.1接口数据397.4.2电子运维系统侧接口服务定义427.4.3客户网管侧接口服务定义448与传输网综合网管系统间接口488.1接口简要描述488.2接口功能需求488.2.1过滤条件设置488.2.2告警同步488.2.3告警同步通知488.2.4告警实时上报488.2.5告警结束通知498.2.6性能任务定制498.2.7性能数据获取通知498.3接口方式及协议498.4接口交互数据498.4.1告警信息498.4.2性能数据508.5接口详细描述518.5.1传输网综合网管系统侧接口服务定义518.5.2客户网管系统侧服务定义559与IP网综合网管系统间接口609.1接口简要描述609.2接口功能需求609.2.1告警同步609.2.2告警实时上报609.2.3过滤条件设置609.2.4定制性能任务609.2.5性能数据获取通知619.2.6节点间IP网络层时延测试619.2.7MPLS VPN电路：获取各QoS等级带宽占用百分比619.3接口方式及协议619.4交互数据定义629.4.1IP电路相关性能参数定义表629.4.2告警信息639.5接口详细描述649.5.1IP综合网管系统侧服务定义649.5.2客户网管系统侧服务定义7110与数据ATM网管理系统间接口7510.1接口简要描述7510.2接口功能需求7510.2.1告警同步7510.2.2告警实时上报7510.2.3过滤条件设置7510.2.4定制性能任务7510.2.5性能数据文件获取7610.3接口方式及协议7610.4接口交互数据7610.4.1告警信息7610.4.2性能数据7710.5接口详细描述7710.5.1数据ATM管理系统侧接口服务定义7710.5.2客户网管系统侧服务定义81附录A接口服务定义代码说明85A.1 错误代码表85A.2 系统代码表85A.3 同步请求标识和通知标识的编号规则85A.4 Filter的BNF范式说明86A.5 资源数据文件命名规则88附录B 客户网管部省接口WSDL89中国网通（集团）有限公司 - iii -中国联通客户网管系统接口规范前言中国联通客户网管系统，是以对客户租用电路和客户设备的实时监测为主要目标，从面向客户、面向业务的角度对网管数据进行分析和呈现，实现大客户网络的状态监视、故障定位以及性能分析等功能，同时为大客户提供统计报表和SLA报告，使其成为中国联通为大客户服务的重要支撑平台。为适应中国联通客户网络管理系统建设的需要，规划编制了以下客户网络管理系统系列企业标准：（1）中国联通客户网络管理系统技术规范（2）中国联通客户网络管理系统接口规范（3）中国联通客户网络管理系统测试规范本标准是其中的中国联通客户网络管理系统接口规范。本规范结合企业OSS规划和客户网管系统的技术规范，统一考虑客户网络管理系统与周边系统的集成关系和接口要求，为中国联合网络通信有限公司客户网络管理系统以及相关系统间集成接口的规划和建设提供基本的技术原则和要求。本标准由中国联通网络公司运维部提出。本标准由中国联通公司技术部归口。本标准起草单位：中国联通网络公司运维部，中讯邮电咨询设计院有限公司本标准主要起草人：石乐、杨光、刘纯、季文翀本标准修改和解释权属中国联通公司。1 范围本规范适用于中国联合网络通信有限公司及下属省（市）公司，对OSS客户网络管理系统与相关外部系统间的集成关系的规划和建设，和其它规范配合，保障客户网络管理系统建设实施的顺利进行。2 规范性引用文件YDN024-1997中国联通资源管理系统接口规范YD/T1089-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 Support 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 ServiceJAVA消息服务KPIKey Process Indication关键绩效指标MSTPMulti-Service Transport Platform多业务传输平台NENet Element网元PDHPlesiochronous Digital Hierarchy准同步数字体系PPPPoint to Point Protocol 点对点协议PTPPhysical Termination Point物理终端点SDHSynchronous Digital Hierarchy同步数字体系4 接口概述大客户网管系统在联通的整个信息系统中并不是孤立的，它需要与多个外部系统，比如相关专业综合网管系统和各类运营支撑系统实现互连，才能体现系统建设的意义。同时，由于客户网管系统采用在集团和各省独立部署的两级部署架构，集团客户网管系统和各省客户网管系统之间还存在一个部省接口。客户网管系统与其它系统之间的接口关系如下图所示（其中故障单工单系统在最新的OSS规划中已经被纳入到电子运维系统）。图11 系统集成接口示意图 针对各互联系统的简要分析如下：序号系统名称系统互连意义建议的互联接口数据流向1传输综合网管系统获取传输网承载的大客户电路的告警和性能信息Webservice+FTP1，性能等大数据量非实时性很高的数据可以通过FTP方式上传2，配置信息及告警信息采用Webservice方式上传单向，专业网管到客户网管2ATM网管系统获取ATM数据网承载的大客户电路的告警、性能数据和性能事件Webservice +FTP1，性能等大数据量非实时性很高的数据可以通过FTP方式上传2，配置信息及告警信息采用Webservice方式上传单向，专业网管到客户网管3IP综合网管系统获取IP网承载的大客户电路的告警、性能数据和性能数据Webservice+FTP1，性能等大数据量非实时性很高的数据可以通过FTP方式上传2，配置信息及告警信息采用Webservice方式上传单向，专业网管到客户网管4资源管理系统获取大客户电路的业务信息、电路全程路由、客户资料数据以及网元端口的配置信息数据库中间表或Webservice单向，资源管理系统到客户网管5电子运维系统手动或自动派单到故障单系统，并能从故障单系统得到流水信息；获取重保电路和电路割接信息Webservice双向6客户网管系统部省级接口省分客户网管向集团客户网管上报集团客户和跨省客户在本省区域内业务的路由、告警、性能数据及事件Webservice +FTP1，性能等大数据量非实时性很高的数据可以通过FTP方式上传2，配置信息及告警信息采用WebService/XML方式上传双向注：根据OSS总体规划，原则上资源配置数据须统一从资源管理系统中获取，当省分不具备与资源系统联调的条件时，可以先从专业综合网管系统中获取资源配置数据，接口服务参照客户网管与资源管理系统间接口定义。5 客户网管系统部省级接口5.1 接口简要描述部省级接口是指集团总部客户网管系统与省分客户网管系统间的接口。接口间交换的信息主要包括：资源信息、路由信息、告警信息和性能信息。其中客户信息、客户电路信息以集团资源为准。集团总部客户网络管理系统会向省分系统下发任务列表或网管信息（如朗讯传输数据）；省分客户网络管理系统向集团系统上报集团客户和跨省客户业务的资源基本信息、路由、告警和性能信息，通过对这些信息的联合处理可以实现跨省大客户端到端的路由、告警、性能信息的呈现功能。5.2 网络连接方式建议省分客户网管系统部署在DCN网，至少省部接口机部署在DCN网。与集团总部客户网管平台间通过DCN网直接通信。5.3 接口功能需求5.3.1 过滤条件设置集团总部客户网管通过定制接口过滤条件，控制省级网管上报的资源数据以及告警信息的范围。省分客户网管应只上报集团总部客户网管系统关心的与电路相关的路由、网元、端口以及告警和性能信息。5.3.2 数据信息接口 资源数据查询.1 电路路由信息查询当集团总部客户网管需要对大客户电路的省内段路由进行查看时，集团总部客户网管发起电路路由查询操作。.2 网元信息查询集团总部客户网管需要同步省客户网管管理范围内的与集团大客户（或跨省）业务相关的网元信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。.3 端口信息查询集团总部客户网管需要同步省客户网管管理范围内的与集团大客户业务相关的端口信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。 资源数据变化上报.1 电路路由信息变化上报当集团总部网管系统管理的跨省客户电路的省内路由段路由发生变化时，省分客户网管系统需要及时通知集团总部客户网管更新该电路省内端路由信息。省级客户网管通过接口主动上报电路路由发生变化的业务电路最新路由信息给集团总部客户网管。.2 网元信息变化上报当省级客户网管管理的集团客户业务占用的网元信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应设备信息。省级客户网管通过接口主动上报发生变化的网元最新信息给集团总部客户网管。 .3 端口信息变化上报当省级客户网管管理的集团客户业务占用的端口信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应端口信息。省级客户网管通过接口主动上报发生变化的端口最新信息给集团总部客户网管。 5.3.3 告警故障接口 告警实时上报省客户网管系统接收到网络告警，并对告警进行根原因和相关性分析后，根据集团总部客户网管告警过滤上报条件，上报影响业务的告警信息给集团总部客户网管系统。省客户网管系统直接通过告警上报通道上报新增告警事件以及告警清除事件。告警信息直接上报，不需要确认。 告警查询（同步）集团总部客户网管系统在网络中断恢复以后或者其它任何需要的情况，可以发起告警查询（同步）。告警查询（同步）可以采用数据通道方式或消息通道方式来传输。如果返回信息太多，在一个消息体中无法传递，则需要采用文件方式来传递。（1） 集团总部客户网管先通过消息通道传递查询（同步）条件。（2） 省客户网管系统在接到该消息以后，准备数据，在数据准备完成后通过消息通道中的消息体把相应的告警信息上报给客户网管系统。（3） 集团总部客户网管通过数据通道接收相关的告警数据文件。完成告警数据的查询（同步）。5.3.4 性能信息接口 定制性能任务集团总部客户网管系统根据需要下发性能任务。省客户网管保存该性能任务，并根据下发的性能任务采集性能数据。性能指标按照客户网管系统技术规范中定义，每次采集包括一类电路或设备的性能所有指标参数。 性能数据文件通知在省客户网管系统采集的性能任务达到性能任务上报时间间隔的要求，则自动生成性能数据文件，并通知集团总部客户网管系统。集团总部客户网管通过数据通道获取相关性能数据文件。在省客户网管系统采集的性能任务达到性能任务上报时间间隔的要求，则自动生成性能数据文件，生成的文件按照规定的文件命名，存在相应的位置，并通知集团总部客户网管系统。客户网管系统则根据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 数据信息接口 资源数据查询.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）结果集，其单条记录格式如下：序号字段名称中文含义1circuit_id电路编码2serial_no路由序号（整数）3node1_id入端网元id4port1_id入端端口id5logicport1_id入端逻辑端口id6node2_id出端网元id7port2_id出端端口id8logicport2_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）来获取数据。.2 网元信息查询【场景描述】：集团总部客户网管需要同步省客户网管管理范围内的与集团大客户（或跨省）业务相关的网元信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。如果查询返回的网元信息量过大，则可以考虑采用文件方式进行传送。【功能描述】：（1） 集团总部客户网管发起网元查询请求，通过WebService接口下发客户编码或业务编码或网元编码到省级客户网管。（2） 省级客户网管根据集团总部客户网管指定的客户编号或电路编号或网元编号查询相应的网元，将网元信息或网元信息文件路径返回给集团总部客户网管。（3） 如果采用FTP方式，集团总部客户网管根据收到的文件路径，通过数据通道获取该文件。【前提条件】：集团总部客户网管同省客户网管拥有统一的客户编码、电路编码、网元编码。【接口协议描述】：方式一：采用WebService协议获取数据-getProvinceNEListByCustomerID(String customerID)-getProvinceNEListByCircuitID(String groupCircuitID)-getProvinceNEInfoByNEID(String neID)【输入】：-customerID 客户编码-circuitID电路编码-neID网元编码【输出】：网元基本信息（NEInfo）结果集，其单条记录格式如下：序号字段名称中文含义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)-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）来获取数据。.3 端口信息查询【场景描述】：集团总部客户网管需要同步省客户网管管理范围内的与集团大客户业务相关的端口信息，以便集团总部客户网管进行业务路由信息的呈现以及业务故障的定位。如果查询返回的端口信息量过大，则可以考虑采用文件方式进行传送。【功能描述】：（1） 集团总部客户网管发起端口查询请求，通过WebService接口下发网元编号或端口编号到省级客户网管。（2） 省级客户网管根据集团总部客户网管指定的网元编号或端口编号，查询相应的端口，将端口信息或端口信息文件路径，返回给集团总部客户网管。（3） 如果采用FTP方式，集团总部客户网管根据收到的文件路径，通过数据通道获取该文件。【前提条件】：集团总部客户网管同省客户网管能够统一识别网元、端口编码。【接口协议描述】：方式一：采用WebService获取数据-getProvincePortListByNEID(String neID)-getProvincePortInfoByPortID (String portID)【输入】：-neID网元编码 -portID 端口编码【输出】：端口信息（PortInfo）结果集，其单条记录格式如下：序号字段名称中文含义1port_id端口标识（端口在板卡上的唯一标识）2port_type端口类型（以太、串口等）3port_rate端口速率4port_lable端口标签5ne_id所属网元id6slot_info所属槽道7card_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）来获取数据。 资源数据变化上报.1 电路路由信息变化上报【场景描述】：当集团总部网管系统管理的跨省客户电路的省内路由段路由发生变化时，省分客户网管系统需要及时通知集团总部客户网管更新该电路省内端路由信息。【功能描述】：省级客户网管通过接口主动上报电路路由发生变化的业务电路最新路由信息给集团总部客户网管。【前提条件】：集团总部客户网管同省客户网管具备统一的电路编码、路由编码规范。【接口协议描述】：采用webservice协议-onProvinceCircuitRouteChange(String circuitID,RouteInfo newRoute)【输入】： -circuitID 电路编码-newRoute电路最新路由【输出】：1：成功0：失败.2 网元信息变化上报【场景描述】：当省级客户网管管理的集团客户业务占用的网元信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应设备信息。【功能描述】：省级客户网管通过接口主动上报发生变化的网元最新信息给集团总部客户网管。 【前提条件】：集团总部客户网管同省客户网管具备统一的网元编码规范。【接口协议描述】：采用webservice协议-onProvinceNEChange(String neID，NEInfo neInfo)【输入】： -neID 网元编码-neInfo 最新网元信息【输出】：1：成功0：失败.3 端口信息变化上报【场景描述】：当省级客户网管管理的集团客户业务占用的端口信息发生变化时，需要及时通知集团总部客户网管更新该客户的相应端口信息。【功能描述】：省级客户网管通过接口主动上报发生变化的端口最新信息给集团总部客户网管。 【前提条件】：集团总部客户网管同省客户网管具备统一的端口编码规范。【接口协议描述】：采用webservice协议-onProvincePortChange(int changeFlag,String portID,PortInfo portInfo)【输入】：-changeFlag 变更类型（0新增，1修改，2删除） -portID 端口编码-portInfo 最新port信息【输出】：1：成功0：失败5.5.4 告警故障接口 告警实时上报【场景描述】：省客户网管系统接收到网络告警，并对告警进行根原因和相关性分析后，根据集团总部客户网管告警过滤上报条件，上报影响业务的告警信息给集团总部客户网管系统。【功能描述】：省客户网管系统直接通过告警上报通道上报新增告警事件以及告警清除事件。告警信息直接上报，不需要确认。【前提条件】： 双方消息通道畅通，并满足告警上报过滤条件。【接口协议描述】：采用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:次要；4:警告；5:信息）9alarm_affectedCircuit影响的电路ID10alarm_affectedCustomer影响的客户ID11alarm_starttime告警发生时间12alarm_times告警发生次数（int）13alarm_updatetime告警最后更新时间（yyyymmddHHMMss）14alarm_elimatetime告警清除时间（yyyymmddHHMMss）15alarm_status告警状态（int），1活动告警，0历史告警【输出】： 告警查询（同步）【场景描述】： 集团总部客户网管系统在网络中断恢复以后或者其它任何需要的情况，可以发起告警查询（同步）。告警查询（同步）可以采用数据通道方式或消息通道方式来传输。如果返回信息太多，在一个消息体中无法传递，则需要采用文件方式来传递。【功能描述】：（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为文件路径和文件名组合而成。其文件路径一般定义为“/省分编号/alarms/”；文件名定义为“ALARMINFO”+时间戳“yyyymmddHHMMss”。文件内容格式：告警信息与方式一中（AlarmInfo）结果集相同，属性以$分隔，每条记录按行保存。（3）FTP获取数据，客户网管系统调用FTP：get（strURL）来获取数据。5.5.5 性能信息接口 定制性能任务【场景描述】：集团总部客户网管系统根据需要下发性能任务。省客户网管保存该性能任务，并根据下发的性能任务采集性能数据。性能指标按照客户网管系统技术规范中定义，每次采集包括一类电路或设备的性能所有指标参数。【功能描述】（1） 集团总部客户网管系统通过消息下发性能任务定义，性能定制任务在消息体中描述。（2） 省客户网管系统在接收到任务以后，解析并保存性能任务。【前提条件】 双方消息通道畅通。【接口协议描述】：任务下发采用webservice，批量性能数据获取通过FTP-setProvincePerfTask (String perf_id,String perf_name,int perf_obj_type,String perf_obj_id_list，String perf_begin_time,int perf_task_interval,int perf_task_status）【输入】perf_id 性能任务ID（唯一标识性能任务）perf_name 性能任务名称perf_obj_type 性能对象类型（int类型，电路0、网元1、端口2）perf_obj_id_list 同一类性能对象标识List，(ID以“|”来进行分隔)perf_begin_time 性能任务开始时间，（时间格式：yyyymmddHHMMss）perf_task_interval 采集间隔（任务周期，int类型，5分，15分，60分，1440分即24小时）perf_task_status性能任务状态（int类型，创建0、修改1、删除2、挂起3、恢复4）【输出】：String strURLstrURL为FTP文件路径。其文件路径一般定义为“/省分编号/perftask/15minute(5分钟或5分钟或60分钟 或24hour)”。定期生成的文件名定义：任务ID+“yyyymmddHHMMss”。 性能数据文件通知【场景描述】：在省客户网管系统采集的性能任务达到性能任务上报时间间隔的要求，则自动生成性能数据文件，并通知集团总部客户网管系统。集团总部客户网管通过数据通道获取相关性能数据文件。【功能描述】：在省客户网管系统采集的性能任务达到性能任务上报时间间隔的要求，则自动生成性能数据文件，生成的文件按照规定的文件命名，存在相应的位置，并通知集团总部客户网管系统。客户网管系统则根据URL，读取性能数据文件，解析即可得到相关性能数据。【前提条件】： 性能任务已经被定制，且双方通信正常。【接口协议描述】：Webservice+FTP【方法】：-OnProvincePerfReady(String perfid,String ftpurl)由省分系统定期上报。【输入】-perfid 性能任务ID（唯一标识性能任务）-ftpurl 性能文件完整FTP地址，包括具体文件名【输出】：是否收到通知信息，int值，1：成功收到；0：失败或通信失败文件内容格式：性能参数依照客户网管系统技术规范中定义（如下表），属性以$分隔，每条记录按行保存。如果某一个属性没有值，必须填入NULL。如一条传输电路的性能格式为：集团电路编码$误码秒$严重误码秒$连续严重误码秒$不可用秒$背景误码块$光功率。编号分类业务指标1传输误码秒、严重误码秒、连续严重误码秒、不可用秒、背景误码块、光功率2数字电路误码秒（ES）、严重误码秒（SES）、不可用秒（UAS）、背景误块码（BBE）3数据（ATM）电路信元丢失率（CLR）、信元误差率（CMR）、接收字节数、发送字节数、接收错误字节数4MPLS VPN发送速率、接收丢包率、接收速率、发送丢包率、时延、Qos5IP发送速率、接收丢包率、接收速率、发送丢包率、Qos6xDSL上行实际速率(kbps)、下行实际速率(kbps)、上行可达速率(kbps)、下行可达速率(kbps)7LAN发送速率、接收丢包率、接收速率、发送丢包率6 与资源管理系统间接口6.1 接口简要描述客户网管系统通过该接口从资源管理系统获取客户信息、客户的电路信息、电路路由信息和端口信息，形成客户视图、业务视图、电路视图及全程路由拓扑展示。客户网管系统从资源系统中还应该能够获取客户的业务信息，如SLA信息和Qos信息，以便客户网管能够实时监测这些指标。资源管理系统与客户网管系统之间的交互流程包括资源信息查询、资源信息变更通知和资源同步。6.2 接口功能需求6.2.1 资源数据同步资源管理系统通过数据同步功能向客户网管系统提供客户网管所需要的资源数据信息。当客户网管系统需要向资源系统进行资源数据同步时，首先向资源系统发送资源数据同步请求，资源系统收到请求后给出响应，表示系统已收到该请求。与此同时，资源系统开始准备数据，客户网管系统可通过FTP协议从资源系统处获取资源数据文件，当数据传输完毕或传输中断需要向资源系统发送同步完毕通知，表示同步完成，若同步失败，在同步完毕通知中需列出失败的原因。接口上的资源数据同步一般适用于以下情况：-当双方系统建立管理连接时；-当双方系统出现通信失败并且恢复后；-当一方系统出现系统故障并且恢复后；-当一方系统发生大粒度资源更新变更后；资源数据同步操作的触发点有两种情况：一是由客户网管系统主动发起数据同步操作；另一种是资源管理系统主动发送通知消息，以触发客户网管系统的自动同步操作，由于资源管理系统发现了自身内部的问题等情况（例如：资源信息变更），发送“资源数据变更通知”给客户网管系统，并发送“同步数据请求通知”。接口上还应支持灵活的数据同步方式，如资源系统可根据客户网管系统要求的同步过滤条件上报其相关的资源信息，有利于提高工作效率，减轻系统接口以及网络负荷。一次数据同步可以只选择有限的地域范围、子网范围等；一次数据同步也可以只选择有限的几种