03 中国移动网络代维管理系统技术规范 代维与EOMS接口规范分册V11.docx
《03 中国移动网络代维管理系统技术规范 代维与EOMS接口规范分册V11.docx》由会员分享，可在线阅读，更多相关《03 中国移动网络代维管理系统技术规范 代维与EOMS接口规范分册V11.docx（11页珍藏版）》请在冰豆网上搜索。
03中国移动网络代维管理系统技术规范代维与EOMS接口规范分册V11
中国移动通信企业标准
中国移动网络代维管理系统技术规范
网络代维管理系统与EOMS系统互联
接口规范分册
版本号：
1.1.0
2012年9月发布2012年9月实施
中国移动通信集团公司
前言
《中国移动网络代维管理系统技术规范》规定了中国移动网络代维管理系统的建设目标、建设原则、体系结构、功能结构、接口要求、技术要求，供中国移动内部和系统开发、集成厂商共同使用；是中国移动网络代维管理系统建设所依据的技术规范，用于指导全网代维管理IT化手段建设、开发与应用。
本分册适用于中国移动网络代维管理系统与EOMS系统互联接口的建设，用于规定中国移动网络代维系统和EOMS系统互联接口的接口流程、工单字段、接口技术要求、接口服务定义等内容。
本分册是《中国移动网络代维管理系统技术规范》系列分册之一。
《中国移动网络代维管理系统技术规范》系列分册的结构、名称如下：
序号
分册名称
01
中国移动网络代维管理系统技术规范第1部分：
总册
02
中国移动网络代维管理系统技术规范第2部分：
功能需求分册
03
中国移动网络代维管理系统技术规范第3部分：
代维与EOMS接口规范分册
04
中国移动网络代维管理系统技术规范第4部分：
代维与IRMS接口规范分册
05
中国移动网络代维管理系统技术规范第5部分：
部省接口分册
06
中国移动网络代维管理系统技术规范第6部分：
编码规范分册
本规范由中国移动通信集团公司网络部制订，由集团公司网络部归口和解释。
本规范起草单位：
中国移动通信集团公司网络部。
本规范主要起草人：
王晓琦、石晓萍、王烨、周林、夏凡超、王鹏、徐智岳、杜传业、马松、吴丹、贺军、云雅琼、杜珍祥、童克波、吕晓敏、周云斌、陈为国、陆旻、许贤、周敏、郭艺娴、赵珺、陈宏宇、于洪亮、吕敏、徐铁瑛、诸圣勇、谭凌凯、文晓林、唐继志、霍廷瑞、杨竹。
适用范围
《代维系统与电子运行维护系统互联接口规范》适用于指导代维系统与电子运行维护系统互联接口的开发和测试，是代维系统与电子运行维护系统互联建设的主要依据。
本规范规定了代维系统和电子运行维护系统互联的接口流程、工单字段、接口技术要求、接口服务定义等内容。
规范性引用文件
下列文件中的条款通过本规范的引用而成为本规范的条款。
凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本规范，然而，鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件，其最新版本适用于本规范。
《中国移动电子运行维护系统技术规范（第三版）》。
术语与缩略语
下列缩略语适用于本规范：
EOMS电子运行维护系统（ElectricOperationMaintenanceSystem）
SOAP简单对象访问协议（SimpleObjectAccessProtocol）
WSDLWeb服务定义语言（WebServiceDefinitionLanguage）
总则
代维系统与电子运行维护系统互联接口的实施，将架设起中国移动业务部门、网络运行维护部门与业务支撑部门之间的信息桥梁，并将有力地支持多部门协同工作。
本期中国移动代维系统与电子运行维护系统互联接口规范适用于下述业务范围：
工单在代维系统和电子运行维护系统之间流转，工单包括：
故障工单、投诉类工单
由于电子运维系统本身承载的故障、投诉类流程已经比较完善，也能够支持转派代维进行处理，为避免重复建设和降低接口复杂度，本规范只约定代维系统和EOMS采用界面集成方式进行对接。
其他约定：
1）一次接口调用对应一个工单的一个操作。
2）对应业务开通工单，一个工单的详细信息可以包含多个资源。
3）时间字段格式：
YYYYMMDDH24:
MI:
SS
页面集成方式接口
1.1页面集成
页面集成方式接口主要内容如下：
1）代维管理系统嵌入EOMS故障和投诉待办工单页面，在代维系统通过链接打开EOMS上的工单，工单的处理在EOMS流程中进行。
在用户感知上就跟一个系统处理工单一样。
2）EOMS为代维系统提供数据视图（故障工单视图、投诉工单视图），以供代维系统做相关统计和分析使用。
3）代维人员组织（帐号）、代维角色同步。
工单视图AccidentBaseView：
No
中文名称
字段英文名称
字段长度
说明
1
工单编号
sheetid
string（50）
必选项，EOMS工单编号
2
工单主题
sheetTitle
string（400）
必选项
3
故障产生时间
alarmCreateTime
string（20）
必选项
4
紧急程度
alarmLevel
string（20）
必选项，参见编码规范中的《紧急程度表》
5
是否集团业务
groupBusiness
string（10）
6
业务影响
effctRegion
string（10）
7
网络分类
netType
string（40）
8
设备类型
equipType
string（20）
9
位置
alarmLocation
string（100）
必选项，故障或者投诉位置
10
内容描述
alarmDetail
string（3000）
必选项，故障或投诉内容描述
11
处理时限
dealOutTime
string（24）
yyyy-MM-ddHH:
mm:
ss
12
完成时间
finishedTime
string（24）
yyyy-MM-ddHH:
mm:
ss
1.2代维组织机构同步
EOMS系统将工单派往代维处理时需要指定相应的代维公司、或代维小组、或代维人员，因此需要将代维系统组织机构和代维人员信息同步到EOMS系统，同步方式采用Webservcie方式，可以全量同步也可以增量方式同步数据，增量同步每天一次进行增量同步，如果采用4A统一管理组织结构和帐号信息的则同4A做接口在此不再重复叙述。
1.2.1接口服务定义概述
代维管理系统与EOMS接口中所定义的组织机构同步如下表所示：
服务名称
中文名称
服务提供方
服务说明
EOMSOrganization
EOMS系统工单处理服务
EOMS系统
为代维系统提供的组织机构同步服务
1.2.2服务接口方法清单
服务接口
接口方法名
接口方法说明
EOMSOrganization
测试服务接口
（isAlive）
A系统在调用B系统相应服务模块中其他接口方法之前，可利用此服务调用判断对方当前服务是否已经部署完毕，以确定所调用的方法当前是否可以正常服务
组织机构同步
（syncOraganization）
代维系统调用EOMS接口，将代维组织机构同步到EOMS
用户信息同步
（syncUserinfo）
代维系统调用EOMS接口，将代维用户信息同步到EOMS
1.2.3测试服务接口
服务接口：
EOMSOrganization
接口方法：
isAlive
输入参数：
serSupplier（服务提供方的系统代码。
String类型），callTime（服务调用时间，String（20））
输出参数：
isAliveResult（String类型。
为0表示相应服务可用；非0表示该服务当前出现问题，则应用相应明文进行说明）
1.2.3.1流程服务接口
服务接口：
EOMSOrganization
接口方法：
syncOraganization、syncUserinfo
输入参数：
如下表所示：
参数名称
参数类型（长度）
参数说明
serialNo
String（40）
EOMS工单编号
serSupplier
String（16）
服务提供方，格式为：
省份编码_系统名称
serCaller
String（16）
服务调用方，格式为：
省份编码_系统名称
callerPwd
String（50）
服务调用方密码（可选）
callTime
String（20）
服务调用时间
attachRef
String（2000）
附件信息列表，参见“附件信息约定”
（附件为opDetail格式的xml文件,参见“详细信息约定”）
opTime
String（20）
操作时间
输出参数：
errList（String类型。
为0表示相应服务可用；非0表示该服务当前出现问题，则应用相应明文进行说明）
1.2.4附件信息约定
为避免人员、组织机构信息过于庞大，webservices接口只负责通知信息，并将人员或组织机构信息形成XML文件信息通知到EOMS系统，EOMS系统通过FTP方式下载XML文件进行解析将人员、组织机构信息导入到EOMS系统中，XML文件格式见“详细信息约定”。
附件信息包括附件的文件名、附件的下载url（URL中不包含中文字符，如果附件的文件名中有中文请在附件的文件名中体现）和附件的长度，其中附件长度的单位为字节。
附件信息采用XML格式封装，封装格式如下例所示：
…
…
…
标签解释：
Ø：
附件内容总标签；
Ø：
附件内容；
Ø：
附件名（可以包含中文）；
Ø：
附件的下载url（URL中不包含中文字符）；
Ø：
附件的长度。
其中中可包括多个部分，如果没有附件，则没有部分，仅存“”。
1.2.5详细信息约定
1.2.5.1详细信息格式定义
接口流转过程中，接口内容除通用字段外，其余业务内容统一用“opDetail：
接口内容参数”传输，接口内容中字段信息包括字段中文名、字段英文名、字段类型、字段内容，接口业务信息采用XML格式封装，封装格式如下例所示：
//详细信息
//记录内容
//字段内容
…//字段中文名
…//字段英文名
…//字段内容
中可包括多个部分，中可包括多个部分。
如果没有详细信息，则仅存“”。
1.2.5.2详细信息内容
1.2.5.2.1组织机构信息同步
No
字段中文名称
字段英文名称
字段长度
说明
1
机构ID
deptid
vachar2（50）
代维机构ID
2
机构名称
deptname
vachar2（150）
代维机构名称
3
机构类型
depttype
varchar2（4）
1公司、2子公司、3部门、4组、5虚拟组
4
机构DNS
deptdns
varchar2（150）
5
上级机构ID
parentid
vachar2（50）
6
操作
optype
int
（2）
增量同步时使用，0：
新增1：
修改2：
删除
7
操作时间
optime
varchar2（24）
格式为：
yyyy-MM-ddHH:
mm:
ss
1.2.5.2.2人员信息同步
No
字段中文名称
字段英文名称
字段长度
说明
1
用户编号
userID
varchar2（50）
内部编号
2
用户帐号
userAccount
varchar2（50）
登录名
3
用户姓名
userName
varchar2（60）
4
登录口令
pass
varchar2（100）
5
所属组织机构
deptID
varchar2（50）
所属的组织结构ID，多个组织ID间用逗号分割
6
职务
duty_id
varchar2（60）
7
邮箱
email
varchar2（80）
8
电话
telephone
varchar2（50）
9
移动电话
mobile
varchar2（50）
10
省
province
varchar2（50）
11
市
city
varchar2（50）
12
描述属性
note
varchar2（150）
13
用户状态
userStatus
int
（2）
0：
正常/1：
停用（不允许登录）/2：
删除（逻辑删除,删除用户不显示）,默认为“0”
14
操作
optype
int
（2）
增量同步时使用，0：
新增1：
修改2：
删除
15
操作时间
optime
varchar2（24）
格式为：
yyyy-MM-ddHH:
mm:
ss
接口安全要求
1.3接口安全设计目标与内容
接口安全设计的目标是防止非法程序对系统接口的非法访问。
接口安全设计可包括以下几个方面的内容：
Ø网络控制
在网络层面对来访程序进行一定的控制，保证来访程序来自于可靠地址。
Ø数据机密性
对接口传输的数据进行加密/解密，确保数据在传输过程中不被窃听。
Ø数据完整性
对接口传输的数据进行完整性检查，确保数据在传输过程中不被篡改。
Ø授权与鉴权
提供对来访程序的相应的用户/口令、权限分配管理功能。
当来访程序访问系统接口时，首先对来访程序进行鉴权，检查来访程序的用户名/口令以及是否拥有对所访问接口程序的访问权限。
Ø审计管理
提供接口日志管理功能，包括接口访问日志的记录、查询/检索、备份、删除、示警等。
1.4不同层面的接口安全措施
为保证系统接口的安全，可在不同层面实施安全保障措施：
Ø网络层
在网络设备上设置访问控制列表，限制对接口机的访问。
Ø传输层
进行数据加密传输，以保证数据的机密性；实施数据签名，以保证数据的完整性。
Ø应用层
实施基于“用户名/口令”的授权/鉴权机制，确保来访程序拥有相应的权限；支持审计管理。
1.5本期接口安全要求
本规范对接口安全约定如下：
Ø在网络设备上设置接口机的访问控制列表，从而限制对接口机的访问，避免接口机遭受恶意攻击；
Ø考虑到EOMS系统与代维管理系统是内网系统，窃听和篡改数据的难度较大，因而不要求实施加密数据传输和数字签名等防护措施；
Ø采用“用户名/口令”机制对访问程序进行鉴权。
具体为在服务调用参数中增加用户名/口令，服务调用方被调用时首先进行用户权限认证，若认证失败，则服务调用结束，返回相应的错误代码。
（注：
“用户名”是访问系统在被访问系统中的标识，即后文接口服务调用参数中的“服务调用方”。
）；
Ø接口双方要约定某种口令更换策略，定期或不定期地更换口令；
Ø要求不把口令固定地写在程序中，而是存放在程序外部的数据文件、数据库表或其它数据载体中，以便于能够灵活地修改口令。
并要求客户端对存放在外部的口令进行可逆加密，以防止客户端口令数据被盗；要求服务端对存放在外部的口令进行不可逆加密，以防止服务端口令数据被盗；
Ø提供日志管理功能，包括接口访问日志的记录、查询/检索、备份、删除、示警等。
EOMS系统与代维管理系统接口应提供日志功能，对接口中服务的调用方式（调用其他接口服务或被其他接口所调用）、调用或被调用服务名称、接口服务的调用时间、调用执行的结果等信息进行详细的记录，并提供相应的查询等功能。
本小节对接口安全的要求为最基本要求，容许并鼓励接口实施方协商补充更为周全的安全防护措施。
修订记录
版本
日期
修订内容
V1.0
2012-6-10
征求意见稿。
V1.1
2012-8-31
规定中国移动代维系统和EOMS系统互联接口的接口流程、工单字段、接口技术要求、接口服务定义等内容。
升级会员 