YD/T 2896.5-2016 智能光分配网络 接口技术要求 第5部分：智能管理终端与OSS的接口

ICS33.180.01

M33

¥D

中华人民共和国通信行业标准

YD/T2896.5-2016

智能光分配网络接口技术要求

第5部分：智能管理终端与OSS的接口

IntelligentopticaldistributionnetworkInterfacerequirements

Part5:InterfacebetweenintelligentmanagementterminalandOSS

2016-01—15发布2016—04—01实施

中华人民共和国工业和信息化部发布

YD/T2896.5-2016

目次

MH.............................................................................................................................................................................II

1laH...............l

2规范性引用文件…..................................................................................................................……....................-1

3缩略语.........................1

4术语和定义.....................................................................................……..............................................………

5義................................................................................................................................................................1

5.1mm.....................................................................................................................................................1

5.2智能管理终端鉴权.............................................................1

5.3工单功能...............................................................................................2

6齡翻..................................................................................................................................................................2

6.1通用对象管理.....................................................................................................................................……2

6.2工单信息模型.....................................................2

6.3工单功能属性..............................................................................................................................................

6.4工单功能操作...............................................................................................................................................4

7如紋-............................................................................................................................-7

7.1智能管理终端下载工单（ODN.ORDER.I6.001)...................................................................................7

7.2智能管理终端回单（ODN.ORDER.I6.002)................................13

7.3智能管理终端退单（ODN.ORDER.I6.003)......................................................................................16

7.4OSS推送工单消息（ODN.ORDER.I6.004)..................................................18

7.5接口公共数据信息类型定义.................................................................18

附录A(资料性附录）工单功能工作时序..........................................................................................................21

YD/T2896.5-2016

,i.

刖口

YD/T2896《智能光分配网络接口技术要求》预计分为以下部分：

一一第1部分：智能光分配网络设施与智能管理终端的接口；1

一一第21部分：基于SNMP的智能光分配网络设施与智能光分配网络管理系统的接口；

一一第22部分：基于Socket方式的智能光分配网络设施与智能光分配网络管理系统的接口；

一一第3部分：智能管理终端与智能光分配网络管理系统的接口；

——第4部分：网络管理系统与OSS的接口；

——第5部分：智能管理终端与0SS的接口。

本部分为YD/T2896的第5部分。

YD/T2896《智能光分配网络接口技术要求》是智能光分配网络系列标准之一。该系列标准的名称

和结构预计如下；

——智能光分配网络总体技术要求；

一一智能光分配网络光配线设施；

一一智能光分配网络接口技术要求；

一一智能光分配网络接口测试方法；

一一智能光分配网络光纤活动连接器。

本部分按照GB/T1.1-2009给出的规则起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。

本部分由中国通信标准化协会提出并归口。

本部分起草单位：中国电信集团公司、中国信息通信研究院、中国联合网络通信集团有限公司、中

国移动通信集团公司、华为技术有限公司、中兴通讯股份有限公司、上海贝尔股份有限公司、武汉烽火

科技集团有限公司、深圳市科信通信技术股份有限公司、青岛英凯利信息科技有限公司。

本部分主要起草人：任艳、欧月华、石彦斌、陈洁、郭林、王世光、李凡、万光华、陈路斌、

肜云、胡碧波、沈启东。

YD/T2896.5-2016

智能光分配网络接口技术要求

第5部分：智能管理终端与OSS的接口

1范围

本部分规定了智能管理终端与OSS的接口功能、信息模型和接口定义等要求。

本部分适用于光接入网的智能光分配网络。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

_YD/T2895-2015智能光分配网络总体技术要求

3缩略语

下列缩略语适用于本文件。

IDIdentity身份标识号

ODNOpitcalDistributionNetwork光分配网络

OSSOperationSupportSystem运营支撑系统

WSDLWebServicesDescriptionLanguage服务描述语言

XMLextensibleMarkupLanguage可扩展标记语言

4术语和定义

YD/T2895-2015界定的术语和定义适用于本文件。

5接口功能

5.1概述

智能光分配网络的智能管理终端与OSS之间接口为16接口，实现工单信息交互功能，如图1所示。

图116接口参考模型

5.2智能管理终端鉴权

智能管理终端鉴权参数在WSDL文件的header中，格式如表1所示。

YD/T2896.5-2016

表1鉴权参数

序号属性名称属性编码数据类型长度次数描述

I.名称usernameString200..1鉴权名称

2.密码passwordString200..1鉴权密码

5.3工单功能.

智能管理终端与OSS的工单功能主要是完成工单信息的交互，接口功能应满足表2的要求，工单功能

的工作时序参见附录A。

表2智能管理终端与OSS的工单功能

消息编号消息名称功能

ODN.ORDER.I6.001智能管理终端下载工单智能管理终端从OSS下载电子工单

ODN.ORDER.I6.002智能管理终端回单智能管理终端将已经完成的工单结果返还给〇ss

ODN.ORDERJ6.003智能管理终端退单智能管理终端将退单的电子工单推送给OSS

ODN.ORDER.I6.004OSS推送工单消息OSS推送工单消息（工单推送，撤单推送）

6信息模型

6.1通用对象管理

通用对象管理如图2所示。

图2通用对象管理

6.2工单信息模型

工单信息模型如图3所示。

YD/T2896.5-2016

图3工单信息模型

6.3工单功能属性

6.3.1工单属性

工单属性如表3所示

表3工单属性

属性名属性类型属性说明

orderldString工单编号。

如无特殊说明，本标准中所有string类型取值都不区分大小写

orderTypeString工单类型，取值：

create:新装

modify:更改

delete:拆除

nativeNetldString本地网ID

opticallnfoListList<opticalInfoType>光路列表，工单类型为更改，有新装和拆除两条光路

constructionPatchingListList施工工单列表

issuedTimeString下发时间，格式：YYYY-MM-DDHH:MM::SS

expectTimeString期望完成时间，格式：YYYY-MM-DDHH:MM::SS

orderPriorityInteger工单优先级，取值：

1:紧急

2:普通

constructionStatusString施工状态

constructionWorkerGroupString施工人员班组，施工人员班组唯一标识

constructionWorkerString施工人员账号，施工人员唯一标识

YD/T2896.5-2016

6.3.2光路属性

光路属性如表4所示。

表4光路属性

属性名属性类型属性说明

opticalCodeString光路编码

opticalNameString光路名称

installTypeString安装类型，取值：

create:新装

modify:更改

delete:拆除

fiberNumInteger单双纤标识，取值：

1:单纤

2:双纤

useiinfoListList<NameAndAnyValueType>业务属性，用户信息列表

startPositionPortPosition起始位置

endPositionPortPosition终止位置

opticalRouteListList<opticalRouteType>路由段列表，如果为空，可以根据光路编码查询路由，

也可以智能ODN管理系统生成路由段

6,3.3光路由段属性

光路由段属性如表5所示。

表5光路由段属性

属性名属性类型属性说明

routeSeqInteger路由段编号，路由段在光路中的顺序，如第一段路由为1，第二

段路由为2

bundleSeqString单双纤序列，取值：

first:第一根纤

second:第二根纤

routeTypeString路由段类型。取值：

patch:跳接

link:成端

startPositionPortPosition路由段起始位置

endPositionPortPosition路由段终止位置

6.4工单功能操作

6.4.1智能管理终端下载工单

智能管理终端下载工单消息定义如表6所示。

表6智能管理终端下载工单（ODN.ORDER.16.001)

类别说明

消息编码downloadOrder

消息名称智能管理终端下载工单消息

消息功能描述智能管理终端下载0SS工单

发送者请求消息发送者为智能管理终端，响应消息发送者为0SS

接收者请求消息接收者为0SS,响应消息接收者为智能管理终端

YD/T2896.5-2016

表6(续)

类别说明

交互方式同步

请求消息参数orderlnfo:工单内容列表，丨ist结构，为空时，表示下载当前用户所有待施工工单，详细属性如下：

鲁orderld:工单编号

响应消息参数orderlnfo:工单内容列表，list结构，详细属性如下：

籲orderld:工单编号

•orderType:工单类型

•nativeNetld:本地网ID

•optica丨InfoList:光路列表，list结构，opticallnfo详细属性信息如下：

今opticalCode:光路编码

今opticalName:光路名称

今installType:安装类型

今fiberNum:单双纤标识

令userlnfoList:业务属性，list结构，包含业务信息如。。。

今startPosition:起始位置

今endPosition:终止位置

今opticalRouteList:路由段列表，list结构，opticalRoute包含属性如下：

ZrouteSeq:路由段编号

ZbundleSeq:单双纤序列

ZrouteType:路由段类型

/startPosition:路由段起始位置

ZendPosition:路由段终止位置

•constructionPatchingList:工单，list结构，constructionPatching(跳接）属性如下1

今installType:安装类型

今opticalCode:光路编码

今opticalName:光路名称

今startPosition:起始位置

今endPosition:终止位置

鲁issuedTime:下发时间

•expectTime:期望完成时间

•orderPriority:工单优先级

春constructionStatus:施工状态

•constructionWorkerGroup:施工人员班组

籲constructionWorker:施工人员账号

输入/输出参数无

消息返回Boolean:成功/失败

6.4.2智能管理终端回单

智能管理终端回单消息定义如表7所示。

YD/T2896.5-2016

表7智能管理终端回单（ODN.ORDER.I6.002)

类别说明

消息编码replyOrder

消息名称智能管理终端回单消息

消息功能描述智能管理终端将已经完成的工单结果发给0SS

发送者请求消息发送者为智能管理终端，响应消息发送者为0SS

接收者请求消息接收者为0SS,响应消息接收者为智能管理终端

交互方式同步

请求消息参数orderlnfb:工单内容，list结构，工单内容信息包括以下属性：

鬱ordedd:编号

•nativeNetld:本地网ID

參replyTime:回单时间

•dealWorkerGroup:施工人员班组

鲁dealWorker:施工人员账号

•result:任务是否完成

•detail:完成描述

•changedPoitList;修改光端口列表，丨ist结构，changedPort的属性如下：

今opticalCode:光路编码

令opticaiName:光路名称

今oldPosition:源端子位置

今newPosition:新端子位置

响应消息参数replyResult:回单结果列表，包括：

籲orderld:工单编号

«result:结果

输入/输出参数无

消息返回Boolean:成功/失败

6.4.3智能管理终端退单

智能管理终端退单消息定义如表8所示。

表8智能管理终端退单（ODN.ORDER.I6.003)

类别说明

消息编码cancelOrder

消息名称智能管理终端退单

消息功能描述智能管理终端将退单的电子工单推送给OSS

发送者请求消息发送者为智能管理终端，响应消息发送者为OSS

接收者请求消息接收者为OSS,响应消息接收者为智能管理终端

交互方式同步

请求消息参数•orderlnfo:工单内容列表，list结构，包括如下属性：

籲orderld:编号’

*nativeNetld:本地网ID

籲cancelTime:退单时间

•cancelReasonCode:退单原因码

參cancelReasonDesc:退单原因描述

响应消息参数cancelResult:退单结果列表，包括：

鲁orderld:工单编号

鲁result:结果

输入/输出参数无

消息返回Boolean:成功/失败

YD/T2896.5-2016

6.4.4OSS推送工单消息

OSS推送工单消息定义如表9所示。

表9OSS推送工单消息（ODN.ORDER.I6.004)

类别说明

消息编码orderMsg

消息名称OSS推送工单消息

消息功能描述0SS推送工