[整理]03 中国移动网络代维管理系统技术规范 代维与EOMS接口规范分册V1.1

中国移动通信企业标准中国移动网络代维管理系统技术规范网络代维管理系统与EOMS系统互联接口规范分册版本号：1.1.02012年9月发布2012年9月实施中国移动通信集团公司-------------目录1 适用范围 (2)2 规范性引用文件 (2)3 术语与缩略语 (2)4 总则 (2)5 页面集成方式接口 (3)5.1 页面集成 (3)5.2 代维组织机构同步 (4)5.2.1 接口服务定义概述 (4)5.2.2 服务接口方法清单 (4)5.2.3 测试服务接口 (4)5.2.4 附件信息约定 (5)5.2.5 详细信息约定 (6)6 接口安全要求 (7)6.1 接口安全设计目标与内容 (7)6.2 不同层面的接口安全措施 (8)6.3 本期接口安全要求 (8)7 修订记录 (9)-------------前言《中国移动网络代维管理系统技术规范》规定了中国移动网络代维管理系统的建设目标、建设原则、体系结构、功能结构、接口要求、技术要求，供中国移动内部和系统开发、集成厂商共同使用；是中国移动网络代维管理系统建设所依据的技术规范，用于指导全网代维管理IT化手段建设、开发与应用。

本分册适用于中国移动网络代维管理系统与EOMS系统互联接口的建设，用于规定中国移动网络代维系统和EOMS系统互联接口的接口流程、工单字段、接口技术要求、接口服务定义等内容。

本分册是《中国移动网络代维管理系统技术规范》系列分册之一。

《中国移动网络代维管理系统技术规范》系列分册的结构、名称如下：本规范由中国移动通信集团公司网络部制订，由集团公司网络部归口和解释。

本规范起草单位：中国移动通信集团公司网络部。

本规范主要起草人：王晓琦、石晓萍、王烨、周林、夏凡超、王鹏、徐智岳、杜传业、马松、吴丹、贺军、云雅琼、杜珍祥、童克波、吕晓敏、周云斌、陈为国、陆旻、许贤、周敏、郭艺娴、赵珺、陈宏宇、于洪亮、吕敏、徐铁瑛、诸圣勇、谭凌凯、文晓林、唐继志、霍廷瑞、杨竹。

-------------1 适用范围《代维系统与电子运行维护系统互联接口规范》适用于指导代维系统与电子运行维护系统互联接口的开发和测试，是代维系统与电子运行维护系统互联建设的主要依据。

本规范规定了代维系统和电子运行维护系统互联的接口流程、工单字段、接口技术要求、接口服务定义等内容。

2 规范性引用文件下列文件中的条款通过本规范的引用而成为本规范的条款。

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

凡是不注日期的引用文件，其最新版本适用于本规范。

《中国移动电子运行维护系统技术规范（第三版）》。

3 术语与缩略语下列缩略语适用于本规范：EOMS 电子运行维护系统（Electric Operation Maintenance System）SOAP 简单对象访问协议（Simple Object Access Protocol）WSDL Web服务定义语言（Web Service Definition Language）4 总则代维系统与电子运行维护系统互联接口的实施，将架设起中国移动业务部门、网络运行维护部门与业务支撑部门之间的信息桥梁，并将有力地支持多部门协同工作。

本期中国移动代维系统与电子运行维护系统互联接口规范适用于下述业务范围：工单在代维系统和电子运行维护系统之间流转，工单包括：故障工单、投诉类工单由于电子运维系统本身承载的故障、投诉类流程已经比较完善，也能够支持转派代维进行处理，为避免重复建设和降低接口复杂度，本规范只约定代维系统和EOMS采用界面集成方式进行对接。

其他约定：1）一次接口调用对应一个工单的一个操作。

2）对应业务开通工单，一个工单的详细信息可以包含多个资源。

3）时间字段格式：YYYYMMDD H24:MI:SS5 页面集成方式接口5.1页面集成页面集成方式接口主要内容如下：1）代维管理系统嵌入EOMS故障和投诉待办工单页面，在代维系统通过链接打开EOMS上的工单，工单的处理在EOMS流程中进行。

在用户感知上就跟一个系统处理工单一样。

2）EOMS为代维系统提供数据视图(故障工单视图、投诉工单视图)，以供代维系统做相关统计和分析使用。

3）代维人员组织（帐号）、代维角色同步。

工单视图AccidentBaseView：5.2代维组织机构同步EOMS系统将工单派往代维处理时需要指定相应的代维公司、或代维小组、或代维人员，因此需要将代维系统组织机构和代维人员信息同步到EOMS系统，同步方式采用Webservcie方式，可以全量同步也可以增量方式同步数据，增量同步每天一次进行增量同步，如果采用4A统一管理组织结构和帐号信息的则同4A做接口在此不再重复叙述。

5.2.1接口服务定义概述代维管理系统与EOMS接口中所定义的组织机构同步如下表所示：5.2.2服务接口方法清单5.2.3测试服务接口服务接口：EOMSOrganization接口方法：isAlive输入参数：serSupplier（服务提供方的系统代码。

String类型），callTime（服务调用时间，String(20)）输出参数：isAliveResult（String类型。

为0表示相应服务可用；非0表示该服务当前出现问题，则应用相应明文进行说明）5.2.3.1流程服务接口服务接口：EOMSOrganization接口方法：syncOraganization、syncUserinfo输入参数：如下表所示：输出参数：errList（String类型。

为0表示相应服务可用；非0表示该服务当前出现问题，则应用相应明文进行说明）5.2.4附件信息约定为避免人员、组织机构信息过于庞大，webservices接口只负责通知信息，并将人员或组织机构信息形成XML文件信息通知到EOMS系统，EOMS系统通过FTP方式下载XML文件进行解析将人员、组织机构信息导入到EOMS系统中，XML文件格式见“详细信息约定”。

附件信息包括附件的文件名、附件的下载url（URL中不包含中文字符，如果附件的文件名中有中文请在附件的文件名中体现）和附件的长度，其中附件长度的单位为字节。

附件信息采用XML格式封装，封装格式如下例所示：<attachRef><attachInfo><attachName>…</attachName><attachURL>…</attachURL><attachLength>…</attachLength></attachInfo></attachRef>标签解释：<attachRef>：附件内容总标签；<attachInfo>：附件内容；<attachName>：附件名（可以包含中文）；<attachURL>：附件的下载url（URL中不包含中文字符）；<attachLength>：附件的长度。

其中<attachRef>中可包括多个<attachInfo>部分，如果没有附件，则没有<attachInfo>部分，仅存“<attachRef></attachRef>”。

5.2.5详细信息约定5.2.5.1详细信息格式定义接口流转过程中，接口内容除通用字段外，其余业务内容统一用“opDetail：接口内容参数”传输，接口内容中字段信息包括字段中文名、字段英文名、字段类型、字段内容，接口业务信息采用XML格式封装，封装格式如下例所示：<opDetail> //详细信息<recordInfo> //记录内容<fieldInfo> //字段内容<fieldChName>…</fieldChName>//字段中文名<fieldEnName>…</fieldEnName>//字段英文名<fieldContent>…</fieldContent>//字段内容</fieldInfo></recordInfo></opDetail><opDetail>中可包括多个<recordInfo>部分，<recordInfo>中可包括多个<fieldInfo>部分。

如果没有详细信息，则仅存“<opDetail ></ opDetail >”。

5.2.5.2详细信息内容5.2.5.2.1组织机构信息同步5.2.5.2.2人员信息同步6 接口安全要求6.1接口安全设计目标与内容接口安全设计的目标是防止非法程序对系统接口的非法访问。

接口安全设计可包括以下几个方面的内容：网络控制在网络层面对来访程序进行一定的控制，保证来访程序来自于可靠地址。

数据机密性对接口传输的数据进行加密/解密，确保数据在传输过程中不被窃听。

数据完整性对接口传输的数据进行完整性检查，确保数据在传输过程中不被篡改。

授权与鉴权提供对来访程序的相应的用户/口令、权限分配管理功能。

当来访程序访问系统接口时，首先对来访程序进行鉴权，检查来访程序的用户名/口令以及是否拥有对所访问接口程序的访问权限。

审计管理提供接口日志管理功能，包括接口访问日志的记录、查询/检索、备份、删除、示警等。

6.2不同层面的接口安全措施为保证系统接口的安全，可在不同层面实施安全保障措施：网络层在网络设备上设置访问控制列表，限制对接口机的访问。

传输层进行数据加密传输，以保证数据的机密性；实施数据签名，以保证数据的完整性。

应用层实施基于“用户名/口令”的授权/鉴权机制，确保来访程序拥有相应的权限；支持审计管理。

6.3本期接口安全要求本规范对接口安全约定如下：在网络设备上设置接口机的访问控制列表，从而限制对接口机的访问，避免接口机遭受恶意攻击；考虑到EOMS系统与代维管理系统是内网系统，窃听和篡改数据的难度较大，因而不要求实施加密数据传输和数字签名等防护措施；采用“用户名/口令”机制对访问程序进行鉴权。

具体为在服务调用参数中增加用户名/口令，服务调用方被调用时首先进行用户权限认证，若认证失败，则服务调用结束，返回相应的错误代码。

（注：“用户名”是访问系统在被访问系统中的标识，即后文接口服务调用参数中的“服务调用方”。

）；接口双方要约定某种口令更换策略，定期或不定期地更换口令；要求不把口令固定地写在程序中，而是存放在程序外部的数据文件、数据库表或其它数据载体中，以便于能够灵活地修改口令。