中国联通OSS-专业综合网管系统与电子运维系统间接口技术规范

运维系统间接口技术规范

China Unicom OSS / Technocal Specification for the Interface between Professional Integrated Network Management System and E-OMS

(V1.0)

2007-××-××发布 2007-××-××实施 中国联通公司 发布 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

目 次

目 次......................................................................... I 前 言....................................................................... III 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范 ........................ 1 1 适用范围....................................................................... 1 2 规范性引用文件 ................................................................. 1 3 术语与缩略语 ................................................................... 1 3.1 术语定义 ................................................................... 1 3.2 缩略语 ..................................................................... 1 4 接口位置....................................................................... 1 5 接口功能需求 ................................................................... 1 5.1 E-OMS作业计划子系统与专业综合网管系统接口 ................................... 1 5.2 E-OMS运行调度子系统与专业综合网管系统接口 ................................... 5 6 接口技术约定 ................................................................... 7 6.1 互联协议 ..................................................................... 7 6.2 技术约定 ..................................................................... 7 6.3 服务映射 ..................................................................... 8 6.4 服务概述 ..................................................................... 9 6.5 服务定义 ..................................................................... 9 6.6 服务调用 .................................................................... 10 7 接口服务定义 ................................................................... 1 7.1 E-OMS作业计划子系统接口服务定义 ............................................. 1 7.2 E-OMS运行调度子系统接口服务定义 ............................................. 3 7.3 专业综合网管系统接口服务定义 ................................................. 8 附 录 A (规范性附录) 各类代码表 ............................................... 14 A.1 错误代码表 .................................................................. 14 A.2 总部/省份/城市代码表 ......................................................... 14 A.3 系统代码表 .................................................................. 22 A.4 时间格式约定 ................................................................ 22 附 录 B (资料性附录) Filter的约束建议 ........................................... 23 B.1 改进的filter的BNF范式 ...................................................... 23 B.2 优先关系 .................................................................... 24 附 录 C （资料性附录） 专业综合网管系统与E-OMS接口服务WSDL映射 ........... 26 C.1 E-OMS作业计划子系统侧服务定义 .............................................. 26 C.1.1 巡检作业接口服务 .......................................................... 26 C.1.2 配置数据接口服务 .......................................................... 26 C.2 E-OMS运行调度子系统侧服务定义 .............................................. 26 C.2.1 故障工单接口服务 .......................................................... 26 C.2.2 配置数据接口服务 .......................................................... 26 C.3 专业综合网管系统侧服务定义 .................................................. 26

I

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

C.3.1 巡检作业接口服务 .......................................................... 26 C.3.2 配置数据接口服务 .......................................................... 26

II

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

前 言

《中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范》是为了进一步将E-OMS系统与其他系统互联，实现跨系统的数据共享和满足自动信息交互的需求的前提下制定的互联接口规范。

本规范中的专业综合网管系统包括：GSM综合网管系统、CDMA综合网管系统、传输综合网管系统以及其他各类专业网管系统和监测系统等；本规范定义接口技术要求属于通用内容，适用于各专业综合网管与电子运行维护系统(后文均简称为E-OMS系统)互联。

E-OMS与其他系统互联接口包括以下内容：

1） 中国联通OSS/电子运维与综合资源管理系统间接口技术规范 2） 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范 附录A为规范性附录，附录B、附录C为资料性附录。

本规范由中国联通运行维护部提出 本规范由中国联通技术部归口

本规范起草单位：中国联通运行维护部、北京邮电大学 本规范的修改和解释权属中国联合通信有限公司

III

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

中国联通OSS/专业综合网管系统与电子运维系统间接口技

术规范

1 适用范围

本规范适用于中国联通专业综合网管系统与电子运行维护系统(E-OMS)之间的互联。本部分规范规定了中国联通专业综合网管系统与电子运行维护系统(E-OMS)互联采用接口业务流程、接口功能需求、接口功能映射、接口服务定义和接口数据内容，并规范了部分接口数据命名格式和编码方式。

本接口规范适用于指导专业综合网管系统与E-OMS系统横向互联接口的开发和测试，是专业综合网管系统与E-OMS系统互联建设的主要依据。

本接口规范不涉及专业综合网管系统和E-OMS系统内部自身的相关业务和技术实现。 此外，为满足安全和接口稳定的需求以及后期统计和审核的需要，部端和省端系统均需提供详细的接口日志功能，以实时记录接口上的所有操作情况。 2 规范性引用文件

下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注日期的引用文件，其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本规范，然而，鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本规范。

[1] QB/CU 124-2007中国联通OSS/综合资源管理系统与传输综合网管系统间接口技术

规范 3 术语与缩略语 3.1 术语定义

无。

3.2 缩略语

以下缩略语适用于本规范： 缩略语 E-OMS HTTP NS SOAP WSDL XML 缩略语全称 Electric Operation Maintenance System Hyper Text Transport Protocol Naming Space Simple Object Access Protocol Web Service Definition Language eXtensible Markup Language 含义 电子运行维护系统 超文本传输协议 命名空间 简单对象访问协议 Web服务定义语言 可扩展标记语言 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

4 接口位置

本规范所定义的中国联通专业综合网管系统与E-OMS系统管理接口互联结构如图1 所示：

图1 专业综合网管与E-OMS系统互联结构图

5 接口功能需求

5.1 E-OMS作业计划子系统与专业综合网管系统接口 5.1.1 接口流程图

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

图2 E-OMS作业计划子系统与专业综合网管系统接口流程图

5.1.2 接口功能需求

5.1.2.1 巡检作业

巡检作业接口是通过关联智能巡检中的巡检作业，实现作业计划完成情况的自动填写。作业计划中作业大纲要求的作业内容、作业对象（对应作业计划中的网元）、作业周期可以与巡检任务内容相对应。

接口的前提要求：智能巡检侧的作业对象、作业内容、执行周期、结果文件需兼容作业计划侧作业内容，可由人工或其他方式设置对应，接口不支持巡检任务的直接设置。

巡检作业接口支持E-OMS作业计划子系统通过两种方式获得巡检结果，并实现作业计划执行结果的自动填写，如下：

1） 定时轮询请求查询方式

2） 结果订购，周期性返回方式 5.1.2.1.1 查询巡检任务信息

E-OMS作业计划子系统通过与专业综合网管系统接口查询已开启的巡检任务的信息，包括巡检内容、巡检对象、巡检周期、每次巡检开始执行时间等巡检信息，从而明确作业大纲的执行时间计划和作业结果。

输入

2

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

指定查询条件

——巡检项目、巡检对象、巡检周期 指定返回信息

——返回符合条件的巡检任务唯一标识、开始执行时间、巡检周期、巡检对象、巡检内容 输出

返回任务信息

——符合条件、指定返回的巡检任务信息或失败原因 失败原因：

——巡检项目不存在； ——巡检对象不存在；

——巡检周期不合法，在合法周期范围外； ——指定返回的信息不合法

5.1.2.1.2 查询巡检结果信息

E-OMS作业计划子系统通过与专业综合网管系统接口查询已开启的巡检任务的执行结果信息，包括巡检任务标识、巡检结果产生时间段、子项目结果列表等信息，从而明确作业大纲的作业执行结果。

输入

指定查询条件

——巡检任务标识、巡检结果产生时间段、子项目列表 指定返回信息

——巡检任务标识、巡检结果产生时间段、子项目列表 输出

返回任务结果信息

——符合条件、指定返回的巡检任务结果信息或失败原因 失败原因：

——指定标识不存在 ——指定时间段无结果

——指定的结果项目不存在 5.1.2.1.3 定购巡检任务结果

E-OMS作业计划子系统通过与专业综合网管系统接口订购已开启的巡检任务的执行结果信息，包括巡检任务标识、巡检结果产生时间、子项目结果列表等信息。

输入

指定订购条件 ——巡检任务标识 指定周期性返回信息

——巡检任务标识、巡检结果产生时间、子项目列表 输出

返回信息

——订购唯一标识或失败原因 失败原因：

——指定标识不存在

3

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

5.1.2.1.4 返回巡检结果文件

针对E-OMS作业计划子系统通过与专业综合网管系统接口对巡检结果的订购，专业综合网管系统通过接口周期性返回巡检结果信息，包括巡检任务标识、巡检结果产生时间、子项目结果列表等信息。

输入 无 输出

返回信息

——巡检任务标识、巡检结果产生时间、子项目结果列表 5.1.2.1.5 撤消巡检结果订购

针对E-OMS作业计划子系统通过与专业综合网管系统接口对巡检结果的订购，E-OMS作业计划子系统通过接口撤消指定订购。订购撤消后，不再返回结果。

输入

指定信息

——订购唯一标识 ——订购系统标识 输出

返回信息

——撤消成功或失败原因 失败原因：

——指定订购标识不存在

——指定订购标识与订购系统不匹配 5.1.2.1.6 订购任务撤消通知（O）

针对E-OMS作业计划子系统通过与专业综合网管系统接口对巡检结果的订购，如果巡检系统撤消订购结果对应的巡检任务，则任务结果订购自动撤消；撤消成功后，通过接口向E-OMS作业计划子系统发送撤消通知。

输入

通知信息

——订购唯一标识

——订购结果对应巡检任务唯一标识 ——撤消原因 输出 无 5.1.2.2 配置数据（O）

根据OSS总体规划，E-OMS所需求的数据统一通过与综合资源管理系统接口获得。但在前期综合资源管理系统未建设的情况下，为保证E-OMS的正常运行，在过渡阶段，将配置数据需求纳入专业综合网管系统与E-OMS的接口功能需求，并作为可选要求。

5.1.2.2.1 同步配置数据

E-OMS可通过与专业综合网管系统接口请求同步大数据量的配置数据；专业综合网管系统也可以通过接口向E-OMS主动同步配置数据。E-OMS通过数据同步功能使系统内的动态配置

4

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

数据与专业综合网管系统保持同步一致，以满足各个专业的调度需求。接口上的配置数据同步一般适用于以下情况：

1） 当双方系统建立管理连接时；

2） 当双方系统出现通信失败并且恢复后；

3） 当专业综合网管系统出现系统故障并且恢复后； 4） 当专业综合网管系统发生大粒度资源更新后； 5.1.2.2.2 查询配置数据

除了支持大数据量的数据同步外，E-OMS可通过与专业综合网管系统接口直接查询较小范围内的配置数据，如指定范围的资源实例标识，指定范围和指定属性的资源属性信息等：

——接口应支持根据资源的关系对指定范围的资源实例标识进行查询； ——接口应支持对一个或多个资源对象的指定属性值进行查询。 5.1.2.2.3 数据变更通知

当专业综合网管系统维护的配置数据发生变更时，应通过与E-OMS的接口向E-OMS发送相应的配置数据变更通知，如配置创建通知、配置删除通知、配置属性值改变通知等。通知中包含具体的资源变更信息，如对象实例、配置变更类型、配置属性取值等。

当配置数据改动范围较大，需要通过大数据量方式传送时，该专业综合网管系统应通过接口发起配置数据同步。

5.2 E-OMS运行调度子系统与专业综合网管系统接口 5.2.1 接口流程图

图3 E-OMS运行调度子系统与专业综合网管系统接口流程图

5

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

5.2.2 接口功能需求 5.2.2.1 故障工单

5.2.2.1.1 接收告警信息

专业综合网管系统生成重大告警，通过与E-OMS运行调度子系统接口向E-OMS运行调度子系统自动派发，在E-OMS侧生成故障工单。自动生成的故障工单处于草稿状态，待电子运维人员人工确认后调度处理。

输入

告警信息 输出 无

5.2.2.1.2 告警清除通知

对已派发给E-OMS运行调度子系统的重大告警，如果该告警在网管侧被清除（自动或手动），综合网管系统需向E-OMS调度子系统发送告警清除通知，进行状态同步。

输入

告警清除信息 输出 无 5.2.2.1.3 接收故障信息

E-OMS运行调度子系统接收专业综合网管系统派发的故障信息，以生成故障工单进行调度。自动生成的故障工单处于草稿状态，待电子运维人员人工确认调度处理。

输入

故障信息 输出 无 5.2.2.2 配置数据（O）

根据OSS总体规划，E-OMS所需求的数据统一通过与综合资源管理系统接口获得。但在前期综合资源管理系统未建设的情况下，为保证E-OMS的正常运行，在过渡阶段，将配置数据需求纳入专业综合网管系统与E-OMS的接口功能需求，并作为可选要求。

5.2.2.2.1 同步配置数据

E-OMS可通过与专业综合网管系统接口请求同步大数据量的配置数据；专业综合网管系统也可以通过接口向E-OMS主动同步配置数据。E-OMS通过数据同步功能使系统内的动态配置数据与专业综合网管系统保持同步一致，以满足各个专业的调度需求。接口上的配置数据同步一般适用于以下情况：

5） 当双方系统建立管理连接时；

6） 当双方系统出现通信失败并且恢复后；

7） 当专业综合网管系统出现系统故障并且恢复后； 8） 当专业综合网管系统发生大粒度资源更新后； 5.2.2.2.2 查询配置数据

6

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

除了支持大数据量的数据同步外，E-OMS可通过与专业综合网管系统接口直接查询较小范围内的配置数据，如指定范围的资源实例标识，指定范围和指定属性的资源属性信息等：

——接口应支持根据资源的关系对指定范围的资源实例标识进行查询； ——接口应支持对一个或多个资源对象的指定属性值进行查询。 5.2.2.2.3 数据变更通知

当专业综合网管系统维护的配置数据发生变更时，应通过与E-OMS的接口向E-OMS发送相应的配置数据变更通知，如配置创建通知、配置删除通知、配置属性值改变通知等。通知中包含具体的资源变更信息，如对象实例、配置变更类型、配置属性取值等。

当配置数据改动范围较大，需要通过大数据量方式传送时，该专业综合网管系统应通过接口发起配置数据同步。 6 接口技术约定

6.1 互联协议

专业综合网管系统与E-OMS系统互联采用基于SOAP协议的Web服务调用方式实现。 6.2 技术约定

为保证不同厂家不同实现方式的接口间调用的互联互通，本节将对具体接口实现过程作出如下约定。

1. 规范及版本约定

1) 整个接口消息基于XML语言，必须符合XML V1.0(2nd Edition or Higher)规范和

XML Schema (1st Edition or Higher)规范。

2) 接口实现必须使用SOAP协议，接口描述必须使用WSDL语言； 3) 接口实现方必须向接口调用方提供本端服务的WSDL文件，建议使用Web URL方

式实时提供；

4) 接口实现必须符合SOAP协议V1.1版本规范，高版本SOAP协议必须保证与1.1

版本的兼容性；

5) 接口实现必须至少支持SOAP 在HTTP V1.0协议上的传输；

6) 接口实现必须符合WSDL语言V1.1版本规范，高版本WSDL语言必须保证与1.1

版本的兼容性；

7) 接口描述必须至少支持WSDL在SOAP V1.1协议上的绑定。

8) 接口实现必须支持WS-I Basic Profile V1.0(or Higher)互联互通协议。 2. Web语义约定

1) E-OMS NS约定形式：

E-OMS作业计划子系统NS约定：

\"http://eoms.chinaunicom.com.cn/[总部/省份代码]/worktaskschedule/[服务名称]\" E-OMS运行调度子系统NS约定：

\"http://eoms.chinaunicom.com.cn/[总部/省份代码]/formdispatch/[服务名称]\"。 其中[ ]内的内容将被实际调用中被具体名称替换。 2) 专业综合网管系统的NS约定为以下形式：

a) CDMA综合网管系统的NS约定：

\"http://cnms.chinaunicom.com.cn/[总部/省份代码]/ [服务名称]\" b) GSM综合网管系统的NS约定：

\"http://gnms.chinaunicom.com.cn/[总部/省份代码]/ [服务名称]\"。

7

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

c) 传输综合网管系统的NS约定：

\"http://tnms.chinaunicom.com.cn/[总部/省份代码]/ [服务名称]\"。 d) [总部/省份代码]见A.2

3) 针对SOAP在HTTP协议上的传输，WSDL基于SOAP的绑定中SOAP

Operation的soapAction字段约定为以下形式：“ [当前NS]” ＋ “/” ＋ “[接口方法名]”。 其中[ ]内的内容将被实际调用中被具体名称替换。 例：北京E-OMS作业计划子系统调用北京传输网综合网管系统的“巡检作业服务(InspectionService)”的“查询巡检任务信息操作(InqrInspTask)”，服务调用的soapAction字段内容应指定为： \"http://tnms.chinaunicom.com.cn/bj/InspectionService/InqrInspTask\"。

4) 针对WSDL基于SOAP的绑定方式，必须满足以下约定：

a) 绑定(binding)和操作(operation)的风格(style)必须满足：style=”document”； b) 消息体的呈现方式必须满足：use=”literal”。

3. 编码约定

1) 接口实现的SOAP消息的消息头和消息体的编码方式，必须使用符合SOAP V1.1

规范中规定的编码方式，即

encodingStyle=”http://schemas.xmlsoap.org/soap/encoding/”

2) 接口实现的HTTP层编码方式以及对附件信息封装必须使用GB2312编码方式； 6.3 服务映射

6.3.1 专业综合网管系统与E-OMS作业计划子系统接口服务映射

A端系统：E-OMS作业计划子系统 Z端系统：专业综合网管系统

接口功能需求与接口服务的映射关系如下表所示： 接口功能需求 查询巡检任务信息 查询巡检结果信息 订购巡检任务结果 返回巡检任务结果 撤消巡检结果订购 巡检任务撤消通知 配置数据 同步配置数据 查询配置数据 方向 接口服务 接口操作 接口服务 巡检作业接口 巡检作业接口 巡检作业接口 巡检作业接口 巡检作业接口 巡检作业接口 服务提供方 专业综合网管系统 专业综合网管系统 专业综合网管系统 E-OMS作业计划子系统 专业综合网管系统 E-OMS作业计划子系统 A->Z 查询巡检任务信息 A->Z 查询巡检结果信息 A->Z 订购巡检任务结果 Z->A 返回巡检任务结果 A->Z 撤消巡检结果订购 Z->A 巡检任务撤消通知 巡检作业 A->Z 见规范性引用文件[1]资源数据接口服务定义 Z->A A->Z 8

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

数据更新通知 Z->A 6.3.2 专业综合网管系统与E-OMS运行调度子系统接口服务映射

A端系统：E-OMS运行调度子系统 Z端系统：专业综合网管系统

接口功能需求与接口服务的映射关系如下表所示： 接口功能需求 故障工单 接收告警信息 告警清除通知 接收故障信息 配置数据

方向 接口操作 Z->A 接收告警信息 告警清除通知 接收故障信息 接口服务 接口服务 故障工单接口 服务提供方 E-OMS运行调度子系统 同步配置数据 查询配置数据 数据更新通知 A->Z Z->A 见规范性引用文件[1]资源数据接口服务定义 A->Z Z->A 6.4 服务概述

现阶段总部及各省E-OMS作业计划子系统互联接口中所定义的服务，按服务提供方和服务功能的不同划分为6个。接口服务的基本信息如下表所示： 服务提供方 服务名称 巡检作业接口服务 InspectService 服务描述 该服务用于专业综合网管向E-OMS作业计划子系统返回订购的巡检结果、巡检任务撤消通知 见规范性引用文件[1]资源数据接口服务定义 该服务用于专业综合网管系统向E-OMS运行调度子系统自动派发故障工单 见规范性引用文件[1]资源数据接口服务定义 该服务用于其他系统向专业综合网管系统查询巡检任务信息、巡检结果信息、订购/撤消订购巡检任务结果 见规范性引用文件[1]资源数据接口服务定义 接口功能 返回巡检任务结果 巡检任务撤消通知 所在章节 7.1.1.2 7.1.1.3 E-OMS作业计划子系统 配置数据接口服务 -- 接收告警信息 告警清除通知 接收故障信息 -- 查询巡检任务信息 查询巡检结果信息 订购巡检任务结果 撤消巡检结果订购 7.2.1.2 7.2.1.3 7.2.1.4 -- 7.3.1.2 7.3.1.3 7.3.1.4 7.3.1.5 E-OMS运行调度子系统 故障工单接口服务FaultFormSercive 配置数据接口服务 专业综合网管系统 巡检作业接口服务InspectionService 配置数据接口服务 -- -- 6.5 服务定义

本节描述的接口服务定义只涉及抽象服务定义，即只涉及抽象的数据类型(type)、接口

9

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

操作(operation)和接口类型(portType)，而不涉及具体的服务位置(port)、服务绑定信息(binding)。

在以下服务定义和参数说明中，如无特殊说明，均遵循以下原则：

1) 本节中，string表示字符串类型(xsd:string)，int表示整数类型(xsd:int)，date表示日

期类型(xsd:date)；出现的其它类型为用户自定义类型，需在WSDL文档定义中给出相应的模式约束；

2) 本节中，M表示Mandatory (必须的)，O表示Optional (可选的)，MC表示

Mandatory,Conditional(如果出现则必须存在)。可选参数的值(Value)可以为空(Nil)，但相应的XML Tag必须出现。

3) 本节中所规定的SOAP Fault中错误代码(Fault Code)的取值均参见附录A.1 。 6.6 服务调用

对于接口服务调用，建议调用双方遵守以下业务准则：

1) 建议系统在调用对方系统相关服务前，先调用对方接口提供的IsAlive方法确定所

需服务是否正常。 6.6.1 E-OMS作业计划子系统与专业综合网管系统接口 6.6.1.1 巡检作业接口服务流程

图4 巡检作业接口服务流程

6.6.1.2 配置数据接口服务流程

见规范性引用文件[1]资源数据接口服务定义

6.6.2 E-OMS运行调度子系统与专业综合网管系统接口 6.6.2.1 故障工单接口服务流程

10

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

图5 故障工单接口服务流程

6.6.2.2 配置数据接口服务流程

见规范性引用文件[1]资源数据接口服务定义。

11

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

7 接口服务定义

7.1 E-OMS作业计划子系统接口服务定义 7.1.1 巡检作业接口服务

7.1.1.1 调用测试操作（IsAlive）

 所属接口服务(service)：InspectionService

 所属接口类型(portType)：InspectionServicePortType  接口操作名称(operation)：IsAlive

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于服务调用方判断服务提供方服务是否

可用。

 输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier serCaller 参数类型 string string 参数含义 服务提供方，为E-OMS作业计划子系统。取值参见A.3 。 服务调用方，为专业综合网管系统。取值参见附录A.3 。 参数含义 取值为字符串“success”表示该服务可用；否则表示该服务不可用，触发SOAPFault元素。 参数含义 具体错误描述。取值参见附录A.1 。 限定 M M  输出参数(outputmessagepart)：如下表所示 参数名称 参数类型 限定 resultIsAlive string M  错误信息(faultmessagepart)：如下表所示 参数名称 faultIsAlive 7.1.1.2 返回巡检任务结果（InspResult）

 所属接口服务(service)：InspectionService

 所属接口类型(portType)：InspectionServicePortType  接口操作名称(operation)：InspResult

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于专业综合网管系统向E-OMS作业计划

子系统周期性返回订购的巡检任务结果。  输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier 参数类型 string 参数含义 服务提供方，为E-OMS作业计划子系统。取值参见附录A.3 。 服务调用方，为专业综合网管系统。取值参见附录限定 M 参数类型 string 限定 C serCaller string M 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

A.3 。 inspResultList 参数名称 inspTaskId inspInstance implementTime inspPeriod inspResultParaNVList 参数名称 paraName paraValue 参数名称 resultInspResult InspResultListType 参数类型 string string string string ParaNVListType 参数类型 string string 参数类型 string 参数名 参数值 参数含义 取值为字符串“success”表示调用成功；否则表示调用失败，触发SOAPFault元素。 参数含义 具体错误描述。取值参见附录A.1 。 返回的指定巡检结果 参数含义 巡检任务标识 巡检对象实例 巡检结果的执行时间 巡检周期 巡检任务项目参数结果 参数含义 M 限定 M M M M M 限定 M M 限定 M  InspResultListType序列子项InspResultType：如下表所示  ParaNVListType序列子项ParaNVType：如下表所示  输出参数(outputmessagepart)：如下表所示  错误信息(faultmessagepart)：如下表所示 参数名称 faultInspResult 7.1.1.3 巡检任务撤消通知（NotifyInspWithdr）

 所属接口服务(service)：InspectionService

 所属接口类型(portType)：InspectionServicePortType  接口操作名称(operation)：NotifyInspWithdr

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：在专业综合网管系统侧，如果巡检任务被停止且

该任务结果被E-OMS作业计划子系统订购，则专业综合网管系统统过该操作通知E-OMS作业计划子系统巡检任务被撤消。  输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier 参数类型 string 参数含义 服务提供方，为E-OMS作业计划子系统。取值参见附录A.3 。 服务调用方，为专业综合网管系统。取值参见附录A.3 。 撤消的任务标识 撤消的任务对应的订购标识标识 撤消原因： 限定 M 参数类型 string 限定 C serCaller inspTaskId subscriptionId withdrReason 2

string string string string M M M O 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

Suspended：任务被挂起、 Deleted：任务被删除、 Overtime：执行终止时间到 withdrUserId string 撤消用户标识：系统标识或执行人标识 参数含义 取值为字符串“success”表示调用成功；否则表示调用失败，触发SOAPFault元素。 参数含义 具体错误描述。取值参见附录A.1 。 O  输出参数(outputmessagepart)：如下表所示 参数名称 resultNotifyInspWithdr 参数类型 string 限定 M  错误信息(faultmessagepart)：如下表所示 参数名称 faultNotifyInspWithdr

7.1.2 配置数据接口服务（O）

见规范性引用文件[1]资源数据接口服务定义。 7.2 E-OMS运行调度子系统接口服务定义 7.2.1 故障工单接口服务

7.2.1.1 调用测试操作（IsAlive）

 所属接口服务(service)：FaultFormService

 所属接口类型(portType)：FaultFormServicePortType  接口操作名称(operation)：IsAlive

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于服务调用方判断服务提供方服务是否

可用。

 输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier serCaller 参数类型 string string 参数含义 服务提供方，为总部代码。取值参见附录A.3 。 服务调用方，为省份代码。取值参见附录A.3 。 参数含义 取值为字符串“success”表示该服务可用；否则表示该服务不可用，触发SOAPFault元素。 参数含义 具体错误描述。取值参见附录限定 M M 参数类型 string 限定 C  输出参数(outputmessagepart)：如下表所示 参数名称 参数类型 限定 resultIsAlive string M  错误信息(faultmessagepart)：如下表所示 参数名称 faultIsAlive 参数类型 string 限定 C 3

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

A.1 。 7.2.1.2 接收告警信息（AlarmData）

 所属接口服务(service)：FaultFormService

 所属接口类型(portType)：FaultFormServicePortType  接口操作名称(operation)：AlarmData

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于专业综合网管系统向E-OMS运行调度

子系统自动派发的重大告警信息，以生成故障共担进行调度。可同时派发多个重大告警。

 输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier 参数类型 string 参数含义 服务提供方，为E-OMS运行调度子系统。取值参见附录A.3 。 服务调用方，专业综合网管系统。取值参见附录A.3 。 限定 M serCaller alarmInfoList 参数名称 objectClass objectInstance eventTime systemDN alarmId string M M 限定 M M M C M AlarmInfoListType 告警信息列表 参数类型 string string string string string 参数含义 产生告警的网络资源对象类名称 对象实例标识符，该参数对应objectClass指定类的实例 指明重大告警产生的时间或者告警变化为重大告警的时间 产生通知的被管系统（即IRPAgent）标识。 告警号，告警唯一标识 告警类型 非安全告警取值可为： “CommunicationAlarm”、 “EquipmentAlarm”、 “ProcessingError”、 “EnvironmentalAlarm”、 “QualityOfServiceAlarm”。 安全告警类型取值可为： “Integrity Violation”, “Operational Violation”, “Physical Violation”, “Security Violation”, “Time Domain Violation”。 告警的可能原因，比alarmType 建议罗列作为参考AlarmInfoListType序列子项AlarmInfoType：如下表所示 alarmType string M probableCause 4

string M 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

更详细。具体取值见本规范的附录E（下同）。 perceivedSeverity specificProblem stateChangeDefinition string string string 告警的级别，取值为Critical、Major 告警的详细原因 状态改变信息，状态值发生改变，状态值的定义参见ITU-T X.731。 M M O thresholdInfo 门限信息，该参数只在越限告警中存在, 包括被监测的性能参数（包括子项）名称，门限ThresholdInfoType 值，实际监测到的值，性能数据变化的方向以及性能变化震荡值等。 AttributeSetType 监控对象，当告警类型为“QualityOfServiceAlarm”时为必选。 服务用户，该参数只在安全告警中存在；如果请求服务的服务用户的标识为空，则该域为空。 服务提供者，该参数只在安全告警中存在；接受触发安全告警的服务用户服务请求的服务提供者的标识。 安全告警发现方，该参数只在安全告警中存在；如果安全告警的发现者是服务提供者该域为空。 备份状态，标识发生告警的对象有无备份。 备份对象的DN。 告警的发展趋势，若已知该告警的发展趋势，如级别将降低，或将升高等，该参数存在，取值为less severe，no change，more severe。 可能的修复动作，对该告警的可能修复方式。 附加信息，与通知相关的附加信息（一般可用自然语言描述）。 附加内容，与通知相关的扩展信息。 MC monitoredAttributes C serviceUser string MC serviceProvider string MC securityAlarmDetector string MC backedUpStatus backUpObject string string string O O trendIndication O proposedRepairActions string string O additionalText string O additionalInformation O 5

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

本参数定义了本规范之外的，与此告警相关的信息。  ThresholdInfoType：如下表所示 参数名称 attributeID observedValue thresholdLevel armTime 参数名称 indication low high 参数名称 attribute_name value 参数名称 resultAlarmData 参数类型 string string string 参数类型 string string string 参数类型 string string 参数类型 string 属性名 属性值 参数含义 取值为字符串“success”表示调用成功；否则表示调用失败，触发SOAPFault元素。 参数含义 具体错误描述。取值参见附录A.1 。 门限值 参数含义 门限监测方向，取值Up/Down 门限监测震荡低值 门限监测震荡高值 参数含义 参数含义 越限属性 限定 M M C C 限定 M C M 限定 M M 限定 M ThresholdLevelIndTypeOpt 门限级别  ThresholdLevelIndTypeOpt：如下表所示  AttributeSetType序列子项AttributeValueType：如下表所示  输出参数(outputmessagepart)：如下表所示  错误信息(faultmessagepart)：如下表所示 参数名称 faultAlarmData 7.2.1.3 告警清除通知（NotifyAlarmCleared）

 所属接口服务(service)：FaultFormService

 所属接口类型(portType)：FaultFormServicePortType  接口操作名称(operation)：NotifyAlarmCleared

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于专业综合网管系统向E-OMS运行调度

子系统派发告警清除通知，以同步之前自动派发的重大告警的告警状态。  输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier 参数类型 string 参数含义 服务提供方，为E-OMS运行调度子系统。取值参见附录A.3 。 服务调用方，专业综合网管系统。取值参见附录A.3 。 网管告警号，告警唯一标识。 限定 M 参数类型 string 限定 C serCaller alarmId 6

string string M M 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

eventTime perceivedSeverity string string string 告警清除时间 告警的级别，取值为“Cleared（已清除）” 清除用户信息，当告警的清除是EMS自动发出时，该参数不存在。当告警的清除是由NMS主动发起时，该参数指明发出清除操作的NMS的用户标识。 清除系统信息，当告警的清除是EMS自动发出时，该参数不存在。当告警的清除是由NMS主动发起时，该参数指明发出清除操作的NMS的系统标识。 参数含义 取值为字符串“success”表示调用成功；否则表示调用失败，触发SOAPFault元素。 参数含义 具体错误描述。取值参见附录A.1 。 M M clearUserId O string clearSystemId O  输出参数(outputmessagepart)：如下表所示 参数名称 resultNotifyAlarmCleared 参数类型 string 限定 M  错误信息(faultmessagepart)：如下表所示 参数名称 faultNotifyAlarmCleared 7.2.1.4 接收故障信息（FaultData）

 所属接口服务(service)：FaultFormService

 所属接口类型(portType)：FaultFormServicePortType  接口操作名称(operation)：FaultData

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于E-OMS运行调度子系统接收专业综合

网管系统自动派发重大故障信息。

 输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier 参数类型 string 参数含义 服务提供方，为E-OMS运行调度子系统。取值参见附录A.3 。 服务调用方，专业综合网管系统。取值参见附录A.3 。 限定 M 参数类型 string 限定 C serCaller faultInfoList 参数名称 faultNum string M M 限定 M 7

FaultInfoListType 故障信息列表列表 参数类型 string 参数含义 故障流水号  FaultInfoListType序列子项FaultInfoType：如下表所示 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

faultStartTime faultAlarmTime faultResolveLimit faultLevel faultDesc 参数名称 resultFaultData string string string string string 参数类型 string 故障发生时间 故障通知时间 故障处理时限 故障级别 故障现象描述 参数含义 取值为字符串“success”表示调用成功；否则表示调用失败，触发SOAPFault元素。 参数含义 具体错误描述。取值参见附录A.1 。 M M M M M 限定 M  输出参数(outputmessagepart)：如下表所示  错误信息(faultmessagepart)：如下表所示 参数名称 faultFaultData

7.2.2 配置数据接口服务（O）

见规范性引用文件[1]资源数据接口服务定义。 7.3 专业综合网管系统接口服务定义

见规范性引用文件[1]资源数据接口服务定义。 7.3.1 巡检作业接口服务

7.3.1.1 调用测试操作（IsAlive）

 所属接口服务(service)：InspectionService

 所属接口类型(portType)：InspectionServicePortType  接口操作名称(operation)：IsAlive

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于服务调用方判断服务提供方服务是否

可用。

 输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier serCaller 参数类型 string string 参数含义 服务提供方，为总部代码。取值参见附录A.3 。 服务调用方，为省份代码。取值参见附录A.3 。 参数含义 取值为字符串“success”表示该服务可用；否则表示该服务不可用，触发SOAPFault元素。 参数含义 限定 M M 参数类型 string 限定 C  输出参数(outputmessagepart)：如下表所示 参数名称 参数类型 限定 resultIsAlive string M  错误信息(faultmessagepart)：如下表所示 参数名称 8

参数类型 限定 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

faultIsAlive string 具体错误描述。取值参见附录A.1 。 C 7.3.1.2 查询巡检任务信息（InqrInspTask）

 所属接口服务(service)：InspectionService

 所属接口类型(portType)：InspectionServicePortType  接口操作名称(operation)：InqrInspTask

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于E-OMS作业计划子系向专业综合网管

系统查询巡检任务信息。

 输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier 参数类型 string 参数含义 服务提供方，为E-OMS作业计划子系统。取值参见附录A.3 。 服务调用方，为专业综合网管系统。取值参见附录A.3 。 查询组合过滤条件； 过滤条件的BNF范式定义参见附 录 B 指定的返回结果类型： 1）InspTask表示仅返回巡检任务标识； 2）InspTaskAndAttributes表示返回巡检任务标识及其所有属性。 参数含义 巡检专业类型 巡检对象（网元）类型 巡检对象实例标识 巡检任务类型 巡检周期 巡检首次执行时间（粒度到日） 参数含义 调用成功时返回查询结果； 否则表示调用失败，触发SOAPFault元素。 参数含义 巡检任务标识 限定 M serCaller string M inqrFilter string M returnType string M  可作为操作中的过滤条件inqrfilter的参数：如下表所示 参数名称 inspProfession inspObject inspInstance inspTaskType inspPeriod firstRunTime 参数类型 string string string string string string 备注 -- -- -- -- -- --  输出参数(outputmessagepart)：如下表所示 参数名称 inspTaskList 参数类型 InspTaskListType 限定 M  InspTaskListType序列子项InspTaskType：如下表所示 参数名称 inspTaskId 参数类型 string 限定 M 9

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

inspTaskName inspTaskProf inspTaskType inspPeriod firstRunTime inspObject inspInstanceList inspParaNameList 注： string string string string string string ParaNameListType 巡检任务名 巡检任务专业 巡检任务类型 巡检周期 首次开始执行时间 巡检对象类型 巡检任务项目参数 MC MC MC MC MC MC MC MC InspInstanceListType 巡检对象实例列表 当returnType=InspTask时，限定为MC的参数为空； 当returnType= InspTaskAndAttributes时，限定为MC的参数为必选。  错误信息(faultmessagepart)：如下表所示 参数名称 faultInqrInspTask 7.3.1.3 查询巡检结果信息（InqrInspResult）

 所属接口服务(service)：InspectionService

 所属接口类型(portType)：InspectionServicePortType  接口操作名称(operation)：InqrInspResult

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于E-OMS作业计划子系向专业综合网管

系统查询巡检任务结果信息。

 输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier 参数类型 string 参数含义 服务提供方，为E-OMS作业计划子系统。取值参见附录A.3 。 服务调用方，为专业综合网管系统。取值参见附录A.3 。 查询任务的过滤条件；过滤条件的BNF范式定义参见附 录 B 指定产生结果的开始时间点，为空时默认为巡检任务的首次执行时间 指定产生结果的结束时间点，为空时默认为当前时间。 指定要查询的巡检任务结果参数名称列表 限定 M 参数类型 string 参数含义 具体错误描述。取值参见附录A.1 。 限定 C serCaller string M inqrfilter beginTime string M M string endTime string M resultParaNameList ParaNameListType M  可作为操作中的过滤条件inqrfilter的参数：如下表所示 10

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

参数名称 inspProfession inspObject inspInstance inspTaskType inspPeriod firstRunTime 参数类型 string string string string string string 参数含义 巡检专业类型 巡检对象（网元）类型 巡检对象实例标识 巡检任务类型 巡检周期 巡检首次执行时间（粒度到日） 参数含义 调用成功，返回查询结果； 否则表示调用失败，触发SOAPFault元素。 参数含义 巡检任务标识 巡检对象实例 巡检结果的执行时间 巡检周期 巡检任务项目参数结果 参数含义 参数名 参数值 参数含义 具体错误描述。取值参见下表“失败原因”和附录A.1 。 含义 备注 -- -- -- -- -- --  输出参数(outputmessagepart)：如下表所示 参数名称 inspResultList 参数类型 InspResultListType 限定 M  InspResultListType序列子项InspResultType：如下表所示 参数名称 inspTaskId inspInstance implementTime inspPeriod inspResultParaNVList 参数名称 paraName paraValue 参数名称 faultInqrInspResult  失败原因：如下表所示 失败原因 InvalidTime

7.3.1.4 订购巡检任务结果（SubsInspResult）

 所属接口服务(service)：InspectionService

 所属接口类型(portType)：InspectionServicePortType  接口操作名称(operation)：SubsInspResult

 操作消息模式(implicitoperationType)：request-response-operation

 接口操作描述(documentation)：该操作用于E-OMS作业计划子系向专业综合网管

系统定购巡检任务结果。

 输入参数(inputmessagepart)：如下表所示 参数名称 参数类型 参数含义 限定 11

参数类型 string string string string ParaNVListType 参数类型 string string 参数类型 string 限定 M M M M M 限定 M M 限定 C  ParaNVListType序列子项ParaNVType：如下表所示  错误信息(faultmessagepart)：如下表所示 指定执行时间不合法：beginTime晚于endTime；或beginTime晚于当前时间 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

serSupplier string 服务提供方，为E-OMS作业计划子系统。取值参见附录A.3 。 服务调用方，为专业综合网管系统。取值参见附录A.3 。 E-OMS作业计划子系统侧订购事件接收者对象的引用，系统标识 订购的巡检专业类型列表 订购过滤条件；过滤条件的BNF范式定义参见附 录 B 参数含义 巡检专业类型 巡检对象（网元）类型 巡检对象实例标识 巡检任务类型 巡检周期 巡检首次执行时间（粒度到日） 参数含义 调用成功，返回调用唯一标识；否则表示调用失败，触发SOAPFault元素。 参数含义 具体错误描述。取值参见下表“失败原因”和附录A.1 。 含义 M serCaller string M managerReference inspProfList subsFilter string InspProfListType string M M M  可作为操作中的过滤条件subsFilter的参数：如下表所示 参数名称 inspProfession inspObject inspObjectInstance inspTask inspPeriod inspFirstRunTime 参数类型 string string string string string string 备注 -- -- -- -- -- --  输出参数(outputmessagepart)：如下表所示 参数名称 subscriptionId 参数类型 string 限定 M  错误信息(faultmessagepart)：如下表所示 参数名称 faultSubsInspResult  失败原因：如下表所示 失败原因 1）inspProfList为空时，巡检系统侧的巡检专业已经被managementReferece订购； 2）inspProfList非空时，其指定的所有巡检专业已经被managementReferece订购； 输入参数不合法：subsFilter取值不符合BNF范式；managerReference不合法 inspProfList非空时，其指定的巡检专业中至少存在一个巡检专业不被巡检系统支持 参数类型 string 限定 C AlreadySubscribed InvalidParameter AtLeastOneInspectionProfssionNotSupported 7.3.1.5 撤消巡检结果订购（UnsubsInspResult）

12

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

    

所属接口服务(service)：InspectionService

所属接口类型(portType)：InspectionServicePortType 接口操作名称(operation)：UnsubsInspResult

操作消息模式(implicitoperationType)：request-response-operation

接口操作描述(documentation)：该操作用于E-OMS作业计划子系向专业综合网管系统撤消对巡检任务结果的定购。

 输入参数(inputmessagepart)：如下表所示 参数名称 serSupplier 参数类型 string 参数含义 服务提供方，为E-OMS作业计划子系统。取值参见附录A.3 。 服务调用方，为专业综合网管系统。取值参见附录A.3 。 撤销定购的归属系统侧事件接收者对象的引用 定购的唯一标识符。如果该参数为空表示撤销参数managerReference的所有已由巡检任务结果定购。 参数含义 取值为字符串“success”表示调用成功；否则表示调用失败，触发SOAPFault元素。 参数含义 具体错误描述。取值参见附录A.1 。 限定 M serCaller managerReference string string M M subscriptionId string M  输出参数(outputmessagepart)：如下表所示 参数名称 resultUnsubsInspResult 参数类型 string 限定 M  错误信息(faultmessagepart)：如下表所示 参数名称 faultUnsubsInspResult 7.3.2 配置数据接口服务（O）

见规范性引用文件[1]资源数据接口服务定义。

参数类型 string 限定 C 13

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

附 录 A (规范性附录) 各类代码表

A.1 错误代码表

错误代码 invalidService errorSystemBusy errorSoapRequest errorTimeout invalidParameter errorOther InvalidParameter

A.2 总部/省份/城市代码表

总部代码采用缩写“ZOB”，如下表所示。 名称 总部 英文缩写 ZOB 无效的服务请求 系统忙，无法处理服务请求 错误的SOAP服务请求，如请求消息的格式不符合WSDL 系统处理服务请求超时 无效的输入参数 其他错误 输入参数不合法 错误含义 errorSystemService 处理请求中发生错误 errorServiceRequest 服务请求中包含逻辑错误，如必填字段没有填写 全国各省、地区、直辖市代码表如下表所示。其中所有省、直辖市及下表列出的本地网和城市代码需严格按下表代码填写；没有出现在下表中的本地网/城市，在通知总部核准后由各省分公司自行编码。编码拟定时建议遵循以下原则：在没有与下表中列出的缩写冲突的前提下，按本地网/城市名称全称的拼音首字母缩写处理；若出现冲突，应取本地网/城市名称的首汉字的前两位拼音缩写及其它汉字的拼音首字母缩写，依此类推。

省份、直辖市名称 省份、直辖市 英文缩写 合肥 蚌埠 芜湖 宣城 黄山 安徽 AH 六安 池州 安庆 亳州 巢湖 滁州 阜阳 14

本地网/城市名称 本地网/城市 英文缩写 HF BB WH XC HS LA CIZ AQ BZ CH CUZ FY 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

淮北 淮南 马鞍山 宿州 铜陵 北京 BJ 北京 重庆 重庆 CQ 万州 涪陵 黔江 福州 厦门 泉州 漳州 福建 FJ 宁德 莆田 南平 三明 龙岩 广州 惠州 汕头 深圳 肇庆 中山 珠海 揭阳 东莞 韶关 广东 GD 江门 茂名 佛山 梅州 湛江 清远 汕尾 阳江 云浮 潮州 河源 兰州 甘肃 GS 嘉峪关 天水 HB HN MAS SZ TL BJ CQ WZ FL QJ FZ XM QZ ZZ ND PT NP SM LY GZ HZ ST SZ ZQ ZS ZH JY DG SG JM MM FS MZ ZJ QY SW YJ YF CZ HY LZ JY TS 15

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

平凉 白银 临夏 甘南 武威 张掖 酒泉 金昌 陇南 定西 庆阳 南宁 百色 柳州 广河池 桂林 玉林 广西 GX 贵港 北海 钦州 防城港 梧州 贺州 来宾 崇左 贵阳 遵义 安顺 都匀 贵州 GZ 铜仁 六盘水 凯里 兴义 毕节 石家庄 唐山 秦皇岛 邯郸 河北 HEB 邢台 保定 张家口 承德 廊坊 16

PL BY LX GN WW ZY JQ JC LN DX QY NN BS LZ HC GL YL GG BH QZ FCG WZ HZ LB CZ GY ZY AS DU TR LPS KL XY BJ SJ TS QHD HD XT BD ZJK CD LF 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

沧州 衡水 郑州 开封 洛阳 平顶山 安阳 新乡 焦作 濮阳 河南 HEN 许昌 漯河 三门峡 商丘 周口 鹤壁 驻马店 南阳 信阳 哈尔滨 大庆 齐齐哈尔 牡丹江 佳木斯 鸡西 黑龙江 HLJ 鹤岗 双鸭山 七台河 绥化 伊春 黑河 大兴安岭 海口 海南 HN 文昌 海甸 三亚 武汉 恩施 湖北 HUB 鄂州 黄冈 黄石 荆门 CZ HS ZZ KF LY PDS AY XX JZ PY XC LH SMX SQ ZK HB ZMD NY XY HRB DQ QQHR MDJ JMS JX HG SYS QTH SH YC HH JGDQ HK WEC HAD SAY WH ES EZ HG HS JM 17

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

荆州 十堰 随州 襄樊 孝感 咸宁 仙桃 宜昌 长沙 株洲 湘潭 岳阳 益阳 常德 湖南 HUN 张家界 衡阳 郴州 永州 邵阳 怀化 吉首 娄底 长春 吉林市 延吉 四平 吉林 JL 通化 辽源 松原 白山 白城 南京 苏州 无锡 常州 南通 江苏 JS 镇江 扬州 徐州 盐城 泰州 连云港 淮安 18

JZ SY SZ XF XG XN XT YC CS ZHZ XIT YUY YIY CHD ZJJ HEY CHZ YOZ SHY HUH JIS LOD CC JLS YB SP TH LY SY BS BC NJ SZ WX CZ NT ZJ YZ XZ YC TZ LYG HA 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

宿迁 南昌 九江 上饶 抚州 宜春 江西 JX 吉安 赣州 景德镇 萍乡 新余 鹰潭 沈阳 大连 鞍山 抚顺 本溪 丹东 辽宁 LN 锦州 营口 阜新 辽阳 铁岭 朝阳 盘锦 葫芦岛 呼市 包头 赤峰 通辽 海拉尔 内蒙 NM 集宁 临河 鄂尔多斯 乌海 锡林浩特 乌兰浩特 银川 石嘴山 宁夏 NX 吴忠 固原 SQ NC JJ SR FZ YC JA GZ JDZ PX XY YT SY DL AS FS BX DD JZ YK FX LY TL CY PJ HLD HHHT BT CF TL HM JN LH EDOS WH XM XAM YC 中卫 银南 SZS WZH GY ZW WZH 19

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

西宁 青海 QH 格尔木 海东 成都 南充 达川 宜宾 泸州 内江 自贡 资阳 乐山 四川 眉山 SC 雅安 西昌 攀枝花 绵阳 德阳 广元 广安 巴中 遂宁 阿坝 甘孜 XN GEM HD CD NC DC YB LZ NJ ZG ZY LS MS YA XC PZH MY DY GY GA BZ SN AB GZ 济南 滨州 德州 东营 菏泽 济宁 聊城 临沂 山东 SD 青岛 日照 泰安 威海 潍坊 烟台 枣庄 淄博 莱芜 上海 陕西 20

JN BZ DZ DY HZ JNI LC LY QD RZ TA WH WF YT ZZ ZB LW SH XA SH SX 上海 西安 中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

安康 宝鸡 汉中 商洛 铜川 咸阳 榆林 延安 渭南 太原 大同 晋城 阳泉 运城 山西 SXI 长治 临汾 晋中 忻州 朔州 吕梁 天津 TJ 天津 乌鲁木齐 昌吉 哈密 吐鲁番 奎屯 石河子 克拉玛依 新疆 XJ 伊犁 博乐 塔城 阿勒泰 库尔勒 阿克苏 喀什 和田 克州 西藏 XZ 拉萨 昆明 曲靖 云南 YN 玉溪 保山 思茅 AK BJ HZ SL TC XY YL YA WN TY DT JC YQ YC CZ LF JZ XZ SZ LL TJ URMQ CJ HM TLF KT SHZ KLMY YL BL TC ALT KRL AKS KS HT KZ LS KM QJ YX BS SM 21

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

大理 开远 版纳 楚雄 昭通 文山 德宏 丽江 迪庆 怒江 DL HH BN CX ZT WS DH LJ DQ NJ 浙江 ZJ 香港 澳门 A.3 系统代码表

E-OMS XG AM 临沧 杭州 湖州 嘉兴 绍兴 宁波 舟山 金华 台州 温州 丽水 衢州 -- -- LC HZ HU JX SX NB ZS JH TZ WZ LS QZ -- -- 系统名称 中国联通OSS/电子运维作业计划子系统 中国联通OSS/电子运维运行调度子系统 中国联通OSS/GSM网综合网管系统 中国联通OSS/CDMA网综合网管系统 中国联通OSS/WCDMA网综合网管系统 中国联通OSS/传输网综合网管系统 eomst eomsf gnms cnms wnms tnms 系统代码 移动网 传输网 A.4 时间格式约定

本规范涉及的时间字段内容，格式采用：YYYY-MM-DD hh:mm:ss 示例1：2006-11-13 14:40:20

如果相关时间在系统侧要求粒度不到秒的时间字段可以补零处理 示例2：2006年12月1日，表述为“2006-12-01 00:00:00”

22

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

附 录 B (资料性附录) Filter的约束建议

B.1 改进的filter的BNF范式

下文定义了本规范所使用的Filter的BNF范式，是对OMG CORBA服务规范Trader Service中的constraintExpr定义的简化和改进。 := [ ] := | ”(” ”)” | ”not” | | | | ”in” | ”in” := ”==” | ”!=” | ”<” | ”<=” | ”>” | ”>=” := ”==” | ”!=” := ”==” | ”!=” :=”and”|”or” := | ”+” | ”-” := | ”*” | ”/” := | | ”(” ”)” | ”-” := | | ”(” ”)” := | := ”$” { }* 23

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

:= | | ”-” := { }+ := [ ”.” [ ] ] := | | ”_” := ”’” { }* ”’” := | | := ”{” ”}” := [ { + }* ] := | | := a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | t | u | v | w | x | y | z | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z := 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 := | ~ | ! | @ | # | $ | % | ^ | & | * | ( | ) | - | _ | = | + | [ | { | } | ] | ; | : | “ | \\ | | | < | . | > | / | ? | , := ” ” B.2 优先关系

括号以及操作符的优先级如下所示，优先级从上到下降低。 （） 24

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

not * / + - in == != < <= > >= and or 25

中国联通OSS/专业综合网管系统与电子运维系统间接口技术规范

附 录 C （资料性附录）

专业综合网管系统与E-OMS接口服务WSDL映射

C.1 E-OMS作业计划子系统侧服务定义 C.1.1 巡检作业接口服务

接口服务定义示例如下：

C.1.2 配置数据接口服务

属通用功能的接口描述语言定义，见规范性引用文件[1]定义。 C.2 E-OMS运行调度子系统侧服务定义 C.2.1 故障工单接口服务

接口服务定义示例如下：

C.2.2 配置数据接口服务

属通用功能的接口描述语言定义，见规范性引用文件[1]定义。 C.3 专业综合网管系统侧服务定义 C.3.1 巡检作业接口服务

接口服务定义示例如下：

C.3.2 配置数据接口服务

属通用功能的接口描述语言定义，见规范性引用文件[1]定义。

26