YD/T 2896.5-2016.Intelligent optical distribution network Interface requirements Part 5: Interface between intelligent management terminal and OSS.
1范围
YD/T 2896.5规定了智能管理终端与OSS的接口功能、信息模型和接口定义等要求。
YD/T 2896.5适用于光接入网的智能光分配网络。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
YD/T 2895-2015智能光分配网络总体技术要求
3缩略语
下列缩略语适用于本文件。
ID                                      Identity                          身份标识号
ODN              Opitcal Distribution Network           光分配网络
OSS                Operation Support System            运营支撑系统
WSDL      WebServices Description Language     服务描述语言
XML            eXtensible Markup Language           可扩展标记语言
4术语和定义
YD/T 2895- 2015界定的术语和定义适用于本文件。
5接口功能
5.1 概述
智能光分配网络的智能管理终端与OSS之间接口为I6接口，实现工单信息交互功能，如图1所示。

ICS33.180.01
中华人民共和国通信行业标准
YD/T2896.5-2016
智能光分配网络接口技术要求
第5部分：智能管理终端与OSS的接口IntelligentopticaldistributionnetworkInterfacerequirementsPart5:Interfacebetween intelligentmanagementterminalandOsS2016-01-15发布
2016-04-01实施
中华人民共和国工业和信息化部发布前
范围·
2规范性引用文件
缩略语
4术语和定义·
接口功能·
概述·
5.2智能管理终端鉴权…
工单功能·
6信息模型.
通用对象管理
6.2工单信息模型
6.3工单功能属性
6.4工单功能操作…
7接口定义.
智能管理终端下载工单（ODN.ORDER.I6.001）7.1
7.2智能管理终端回单（ODN.ORDER.I6.002）7.3智能管理终端退单（ODN.ORDER.I6.003）7.4OSS推送工单消息（ODN.ORDER.I6.004）*：7.5接口公共数据信息类型定义
附录A（资料性附录）工单功能工作时序YD/T2896.5-2016
YD/T2896.5-2016
YD/T2896《智能光分配网络接口技术要求》预计分为以下部分：第1部分：智能光分配网络设施与智能管理终端的接口：一第21部分：基于SNMP的智能光分配网络设施与智能光分配网络管理系统的接口：一第22部分：基于Socket方式的智能光分配网络设施与智能光分配网络管理系统的接口：一第3部分：智能管理终端与智能光分配网络管理系统的接口；一第4部分：网络管理系统与OSS的接口；一第5部分：智能管理终端与OSS的接口。本部分为YD/T2896的第5部分。
YD/T2896《智能光分配网络接口技术要求》是智能光分配网络系列标准之一。该系列标准的名称和结构预计如下：
一智能光分配网络总体技术要求：智能光分配网络光配线设施；
智能光分配网络接口技术要求：一智能光分配网络接口测试方法：智能光分配网络光纤活动连接器。本部分按照GB/T1.1-2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国通信标准化协会提出并归口。本部分起草单位：中国电信集团公司、中国信息通信研究院、中国联合网络通信集团有限公司、中国移动通信集团公司、华为技术有限公司、中兴通讯股份有限公司、上海贝尔股份有限公司、武汉烽火科技集团有限公司、深圳市科信通信技术股份有限公司、青岛英凯利信息科技有限公司。本部分主要起草人：任艳、欧月华、石彦斌、陈洁、郭林、王世光、李凡、万光华、陈路斌、彤云、胡碧波、沈启东。
HiiKAoiKAca
1范围
智能光分配网络接口技术要求
第5部分：智能管理终端与OSS的接口本部分规定了智能管理终端与OSS的接口功能、信息模型和接口定义等要求。本部分适用于光接入网的智能光分配网络。2规范性引用文件
YD/T2896.5-2016
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。YD/T2895-2015智能光分配网络总体技术要求3缩略语
下列缩略语适用于本文件。
Identity
OpitcalDistribution Network
OperationSupportSystem
WebServices Description LanguageeXtensibleMarkupLanguage
4术语和定义
身份标识号
光分配网络
运营支撑系统
服务描述语言
可扩展标记语言
YD/T2895-2015界定的术语和定义适用于本文件。5接口功能
5.1概述
智能光分配网络的智能管理终端与OSS之间接口为I6接口，实现工单信息交互功能，如图1所示。oss
智能管理终端
图116接口参考模型
2智能管理终端鉴权
智能管理终端鉴权参数在WSDL文件的header中，格式如表1所示。1
HiiKAoNiKAca
YD/T2896.5-2016
属性名称
5.3工单功能
属性编码
usemame
password
表1鉴权参数
数据类型
String
String
鉴权名称
鉴权密码
智能管理终端与OSS的工单功能主要是完成工单信息的交互，接口功能应满足表2的要求，工单功能的工作时序参见附录A。
表2智能管理终端与OSS的工单功能消息编号
ODN.ORDER.16.001
ODN.ORDER.I6.002
ODN.ORDER.I6.003
ODN.ORDER.16.004
6信息模型
6.1通用对象管理
消息名称
智能管理终端下载工单
智能管理终端回单
智能管理终端退单
OSS推送工单消息
通用对象管理如图2所示。
6.2工单信息模型
工单信息模型如图3所示。
智能管理终端从OSS下载电子工单智能管理终端将已经完成的工单结果返还给OSS智能管理终端将退单的电子工单推送给OSSOSS推送工单消息（工单推送，撤单推送）工单
光路由段
图2通用对象管理
HiiKAoNiKAca
oplicaicode anng
oplicanane srag
tndalType caing
ordeld:Brng
orderfype: shhg
BatveNeld
opticain bLis a -opecainfoTypesoneudonpatchngLld: ld
euedTime:
expecriae
ordeProny Inl
naudonsalus sang
coasudosyoserpup sdng
condudonWoter ding
能日下&工（downloadoder
三t进#美目（repyorder）
智美量五足单（cancelOrden）
+0ss能进工通（消量标证：自烟emg满口号：1001）无座股
puteseg int
nuideseq sinng
weetnbLid Id-hameAndAnyValueTypearPodHon PonPosllon
endPosbn:PotPoln
oplicaRoulelidt: isicopicaRouleTypea工单功能属性
6.3.1工单属性
工单属性如表3所示。
属性名
orderld
orderType
nativeNetId
opticalInfoList
constructionPatchingList
issuedTime
expectTime
orderPriority
constructionStatus
constructionWorkerGroup
construction Worker
属性类型
String
String
String
ouleType: shrng
电iPoslan: PonPosiion
eadPosnDn: PomPoaman
工单信息模型
表3工单属性
YD/T2896.5-2016
dednto: CerlceType
potType: Sidng
polnto:ODNCPType
属性说明
工单编号。
如无特殊说明，本标准中所有string类型取值都不区分大小写工单类型，取值：
create：新装
modify：更改
delcte：拆除
本地网ID
List
String
String
Integer
String
String
String
光路列表，工单类型为更改，有新装和拆除两条光路施工工单列表
下发时间，格式：YYYY-MM-DDHH:MM：SS期望完成时间，格式：YYYY-MM-DDHH:MM：SS工单优先级，取值：
1：紧急
2：普通
施工状态
施工人员班组，施工人员班组唯一标识施工人员账号，施工人员唯一标识HiiKAoNiKAca
YD/T2896.5-2016
光路属性
光路属性如表4所示。
属性名
opticalCode
opticalName
installType
fiberNum
userlnfoList
startPosition
endPosition
opticalRouteList
3光路由段属性
String
String
String
Integer
属性类型
光路属性
光路编码
光路名称
安装类型，取值：
create：新装
modify：更改
delete：拆除
单双纤标识，取值：
1：单纤
2：双纤
List
PortPosition
PortPosition
List
光路由段属性如表5所示。
属性说明
业务属性，用户信息列表
起始位置
终止位置
路由段列表，如果为空，可以根据光路编码查询路由，也可以智能ODN管理系统生成路由段表5
光路由段属性
属性名
routeSeq
bundleSeq
routeType
startPosition
endPosition
6.4工单功能操作
属性类型
Integer
String
String
PortPosition
PortPosition
6.4.1智能管理终端下载工单
属性说明
路由段编号，路由段在光路中的顺序，如第一段路由为1，第二
段路由为2
单双纤序列，取值：
first：第一根纤
second：第二根纤
路由段类型，取值：
patch：跳接
link：成端
路由段起始位置
路由段终止位置
智能管理终端下载工单消息定义如表6所示6智能管理终端下载工单（ODN.ORDER.16.001）表6
消息编码
消息名称
消息功能描述
发送者
接收者
downloadOrder
智能管理终端下载工单消息
智能管理终端下载OSS工单
请求消息发送者为智能管理终端，响应消息发送者为OSS请求消息接收者为OSS，响应消息接收者为智能管理终端HiiKAoiKAca
交互方式
请求消息参数
响应消息参数
输入/输出参数
消息返回
表6（续）
YD/T2896.5-2016
orderlnfo：工单内容列表，list结构，为空时，表示下载当前用户所有待施工工单，详细属性如下：·orderld：工单编号
orderlnfo：工单内容列表，list结构，详细属性如下：·orderld：工单编号
·orderType：工单类型
·nativeNetid：本地网ID
●opticallnfoList：光路列表，list结构，opticalInfo详细属性信息如下：★opticalCode：光路编码
→opticalName:光路名称
◆installType：安装类型
fiberNum：单双纤标识
→userInfoList：业务属性，list结构，包含业务信息如。。。+startPosition：起始位置
→endPosition：终止位置
★opticalRouteList：路由段列表，list结构，opticalRoute包含属性如下：routeSeq：路由段编号
VbundleSeq：单双纤序列
VrouteType：路由段类型
VstartPosition：路由段起始位置VendPosition：路由段终止位置constructionPatchingList：工单，list结构，constructionPatching（跳接）属性如下：→installType：安装类型
→opticalCode:光路编码
→opticalName:光路名称
→startPosition：起始位置
→endPosition：终止位置
●issuedTime：下发时间
·expectTime：期望完成时间
●orderPriority：工单优先级
·constructionStatus：施工状态·constructionWorkerGroup：施工人员班组·constructionWorker：施工人员账号无
Boolean：成功/失败
6.4.2智能管理终端回单
智能管理终端回单消息定义如表7所示。5
HiiKAoNiKAca
YD/T2896.5-2016
消息编码
消息名称
消息功能描述
发送者
接收者
交互方式
请求消息参数
响应消息参数
输入/输出参数
消息返回
feplyOrder
表7智能管理终端回单（ODN.ORDER.16.002）说明
智能管理终端回单消息
智能管理终端将已经完成的工单结果发给OSS请求消息发送者为智能管理终端，响应消息发送者为OSS请求消息接收者为OSS，响应消息接收者为智能管理终端同步
orderlnfo：工单内容，list结构，工单内容信息包括以下属性：。orderld：编号
·nativeNetid：本地网ID
●replyTime：回单时间
·dealWorkerGroup：施工人员班组·dealWorker：施工人员账号
●result：任务是否完成
●detail：完成描述
。 changedPortList:
修改光端口列表，list结构，changedPort的属性如下：◆opticalCode：光路编码
→opticalName：光路名称
+oldPosition：源端子位置
◆newPosition：新端子位置
replyResult：回单结果列表，包括：●orderld：工单编号
●result：结果
Boolean：成功/失败
智能管理终端退单
智能管理终端退单消息定义如表8所示表8
消息编码
消息名称
消息功能描述
发送者
接收者
交互方式
请求消息参数
响应消息参数
输入/输出参数
消息返回
cancelOrder
智能管理终端退单
智能管理终端退单（ODN.ORDER.I6.003）智能管理终端将退单的电子工单推送给OSS请求消息发送者为智能管理终端，响应消息发送者为OSS请求消息接收者为OSS，响应消息接收者为智能管理终端同步
orderlnfo：工单内容列表，list结构，包括如下属性：.orderld：编号
·nativeNetId：本地网ID
·cancelTime：退单时间
·cancelReasonCode：退单原因码·cancelReasonDesc：退单原因描述cancelResult：退单结果列表，包括：·orderld：工单编号
·result：结果
Boolean：
成功/失败
HiiKAoNiKAca
OSS推送工单消息
OSS推送工单消息定义如表9所示。表9OSS推送工单消息（ODN.ORDER.16.004）类别
消息编码
消息名称
消息功能描述
发送者
接收者
交互方式
请求消息参数
响应消息参数
输入/输出参数
消息返回
接口定义
orderMsg
OSS推送工单消息
OSS推送工单消息（工单推送，撤单推送）说明
请求消息发送者为OSS，响应消息发送者为智能管理终端请求消息接收者为智能管理终端，响应消息接收者为OSS同步
orderlnfo：工单内容列表，list结构，包括如下属性：eorderId：编号
·operType：状态
eremark：备注
Boolean:成功/失败
智能管理终端下载工单（ODN.ORDER.I6.001）YD/T2896.5-2016
智能管理终端下载工单定义如表10所示，请求消息如表11所示，响应消息如表12所示。表10
智能管理终端下载工单（ODN.ORDER.I6.OO1）定义类别
消息编码
消息名称
消息功能描述
发送者
接收者
交互方式
接口协议
downloadOrder
智能管理终端下载工单消息
智能管理终端下载OSS工单
请求消息发送者为智能管理终端，响应消息发送者为OSS请求消息接收者为OSS，响应消息接收者为智能管理终端同步
Web service
属性名称
工单内容
工单编号
属性编码
orderInfo
orderld
智能管理终端下载工单请求（Request）参数表数据类型
String
16byte
为0，表示下载当前用户所有待施工工单）必选，工单编号
智能管理终端下载工单响应（Response）参数表表12
属性名称
工单内容
工单编号
属性编码
orderinfo
orderld
数据类型
String
16byte
YD/T2896.5-2016
1.4.1.5.1.
1.4.1.8.1.
1.4.1.8.1.1.
1.4.1.8.1.2.
1.4.1.8.1.3.
1.4.1.8.1.4.
1.4.1.8.1.5.
属性名称
工单类型
本地网ID
光路列表
光路信息
光路编码
光路名称
安装类型
单双纤标识
业务属性
业务信息
起始位置
终止位置
路由段列表
路由段
路由段编号
单双纤序列
路由段类型
路由段起始位置
路由段终止位置
属性编码
orderType
nativeNetid
opticallnfoList
opticallnfo
opticalCode
opticalName
installType
fiberNum
userlnfoList
userlnfo
startPosition
endPosition
opticalRouteList
opticalRoute
routeSeq
bundleSeq
routeType
startPosition
endPosition
constructionPatchi
ngList
constructionPatchi
表12（续）
数据类型
String
String
String
String
String
Integer
NameAndAn
yValueType
PortPosition
PortPosition
Integer
String
String
PortPosition
PortPosition
16byte
32byte
32byte
256byte
16byte
16byte
16byte
取值：
create：新装
modify：更改
delete：拆除
一个工单中可以包含多条光路
工单类型为更改，有新装和拆除两条光路
取值：
create：新装
modify：更改
delete：拆除
取值：
1：单纤
2：双纤
光路起始位置
光路终止位置
路由段
路由段在光路中的顺序，如第一条路由为1，第二条路由为2
光路可能是单纤、双纤的，取值first第一根纤
second第二根纤
路由类型
patch：跳接
link：成端
路由段起始端口
路由段终止端口
属性名称
安装类型
光路编码
光路名称
起始位置
终止位置
下发时间
期望完成时间
工单优先级
施工状态
施工人员班组
施工人员账号
属性编码
installType
opticalCode
opticalName
startPosition
endPosition
issuedTime
expectTime
orderPriority
constructionStatus
construction Work
erGroup
constructionWork
请求消息的XML格式如下：
表12（续）
数据类型
String
String
PortPosition
PortPosition
String
String
Integer
String
String
String






响应消息的XML格式如下：

<1--0 or more repetitions:-->

/orderType>


<1--1 to2repetitions:-->

16byte
32bytebzxz.net
256byte
32 byte
54byte
16byte
32byte
32byte
取值：
create：新装
YD/T2896.5-2016
modify：更改
delete：拆除
起始位置
终止位置
取值：
1：紧急
2：普通
N(特施工)
施工人员班组唯一标识
施工人员唯一标识
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。