03 中国移动网络代维管理系统技术规范 代维与EOMS接口规范分册V11.docx

1、03 中国移动网络代维管理系统技术规范 代维与EOMS接口规范分册V11中国移动通信企业标准中国移动网络代维管理系统技术规范网络代维管理系统与EOMS系统互联接口规范分册版本号：1.1.02012年9月 发 布 2012年9月 实 施中国移动通信集团公司前 言中国移动网络代维管理系统技术规范规定了中国移动网络代维管理系统的建设目标、建设原则、体系结构、功能结构、接口要求、技术要求，供中国移动内部和系统开发、集成厂商共同使用；是中国移动网络代维管理系统建设所依据的技术规范，用于指导全网代维管理IT化手段建设、开发与应用。本分册适用于中国移动网络代维管理系统与EOMS系统互联接口的建设，用于规定中

2、国移动网络代维系统和EOMS系统互联接口的接口流程、工单字段、接口技术要求、接口服务定义等内容。本分册是中国移动网络代维管理系统技术规范系列分册之一。中国移动网络代维管理系统技术规范系列分册的结构、名称如下：序号分册名称01中国移动网络代维管理系统技术规范第1部分：总册02中国移动网络代维管理系统技术规范第2部分：功能需求分册03中国移动网络代维管理系统技术规范第3部分：代维与EOMS接口规范分册04中国移动网络代维管理系统技术规范第4部分：代维与IRMS接口规范分册05中国移动网络代维管理系统技术规范第5部分：部省接口分册06中国移动网络代维管理系统技术规范第6部分：编码规范分册本规范由中国

3、移动通信集团公司网络部制订，由集团公司网络部归口和解释。本规范起草单位：中国移动通信集团公司网络部。本规范主要起草人：王晓琦、石晓萍、王烨、周林、夏凡超、王鹏、徐智岳、杜传业、马松、吴丹、贺军、云雅琼、杜珍祥、童克波、吕晓敏、周云斌、陈为国、陆旻、许贤、周敏、郭艺娴、赵珺、陈宏宇、于洪亮、吕敏、徐铁瑛、诸圣勇、谭凌凯、文晓林、唐继志、霍廷瑞、杨竹。适用范围代维系统与电子运行维护系统互联接口规范适用于指导代维系统与电子运行维护系统互联接口的开发和测试，是代维系统与电子运行维护系统互联建设的主要依据。本规范规定了代维系统和电子运行维护系统互联的接口流程、工单字段、接口技术要求、接口服务定义等内容。

4、规范性引用文件下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本规范，然而，鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本规范。中国移动电子运行维护系统技术规范（第三版）。术语与缩略语下列缩略语适用于本规范：EOMS 电子运行维护系统（Electric Operation Maintenance System）SOAP 简单对象访问协议（Simple Object Access Protocol）WSDL Web服务定义语言（Web Service Def

5、inition Language）总则代维系统与电子运行维护系统互联接口的实施，将架设起中国移动业务部门、网络运行维护部门与业务支撑部门之间的信息桥梁，并将有力地支持多部门协同工作。本期中国移动代维系统与电子运行维护系统互联接口规范适用于下述业务范围：工单在代维系统和电子运行维护系统之间流转，工单包括：故障工单、投诉类工单由于电子运维系统本身承载的故障、投诉类流程已经比较完善，也能够支持转派代维进行处理，为避免重复建设和降低接口复杂度，本规范只约定代维系统和EOMS采用界面集成方式进行对接。其他约定：1） 一次接口调用对应一个工单的一个操作。2） 对应业务开通工单，一个工单的详细信息可以包含多

6、个资源。3） 时间字段格式：YYYYMMDD H24:MI:SS页面集成方式接口1.1 页面集成页面集成方式接口主要内容如下：1） 代维管理系统嵌入EOMS故障和投诉待办工单页面，在代维系统通过链接打开EOMS上的工单，工单的处理在EOMS流程中进行。在用户感知上就跟一个系统处理工单一样。2） EOMS为代维系统提供数据视图(故障工单视图、投诉工单视图)，以供代维系统做相关统计和分析使用。3） 代维人员组织（帐号）、代维角色同步。工单视图 AccidentBaseView：No中文名称字段英文名称字段长度说明1工单编号sheetidstring(50)必选项，EOMS工单编号2工单主题shee

7、tTitlestring(400)必选项3故障产生时间alarmCreateTimestring(20)必选项4紧急程度alarmLevelstring(20)必选项，参见编码规范中的紧急程度表5是否集团业务groupBusinessstring(10)6业务影响effctRegionstring(10)7网络分类netTypestring(40)8设备类型equipTypestring(20)9位置alarmLocationstring(100)必选项，故障或者投诉位置10内容描述alarmDetailstring(3000)必选项，故障或投诉内容描述11处理时限dealOutTimestr

8、ing(24)yyyy-MM-dd HH:mm:ss12完成时间finishedTimestring(24)yyyy-MM-dd HH:mm:ss1.2 代维组织机构同步EOMS系统将工单派往代维处理时需要指定相应的代维公司、或代维小组、或代维人员，因此需要将代维系统组织机构和代维人员信息同步到EOMS系统，同步方式采用Webservcie方式，可以全量同步也可以增量方式同步数据，增量同步每天一次进行增量同步，如果采用4A统一管理组织结构和帐号信息的则同4A做接口在此不再重复叙述。1.2.1 接口服务定义概述代维管理系统与EOMS接口中所定义的组织机构同步如下表所示：服务名称中文名称服务提供方

9、服务说明EOMSOrganizationEOMS系统工单处理服务EOMS系统为代维系统提供的组织机构同步服务1.2.2 服务接口方法清单服务接口接口方法名接口方法说明EOMSOrganization测试服务接口（isAlive）A系统在调用B系统相应服务模块中其他接口方法之前，可利用此服务调用判断对方当前服务是否已经部署完毕，以确定所调用的方法当前是否可以正常服务组织机构同步（syncOraganization）代维系统调用EOMS接口，将代维组织机构同步到EOMS用户信息同步（syncUserinfo）代维系统调用EOMS接口，将代维用户信息同步到EOMS1.2.3 测试服务接口服务接口：E

10、OMSOrganization接口方法：isAlive输入参数：serSupplier（服务提供方的系统代码。String类型），callTime（服务调用时间，String(20)）输出参数：isAliveResult（String类型。为0表示相应服务可用；非0表示该服务当前出现问题，则应用相应明文进行说明）1.2.3.1 流程服务接口服务接口：EOMSOrganization接口方法：syncOraganization、syncUserinfo 输入参数：如下表所示：参数名称参数类型（长度）参数说明serialNoString(40)EOMS工单编号serSupplierString(1

11、6)服务提供方，格式为：省份编码_系统名称serCallerString(16)服务调用方，格式为：省份编码_系统名称callerPwdString(50)服务调用方密码(可选)callTimeString(20)服务调用时间attachRefString(2000)附件信息列表，参见“附件信息约定”(附件为opDetail格式的xml文件, 参见“详细信息约定”)opTimeString(20)操作时间输出参数：errList（String类型。为0表示相应服务可用；非0表示该服务当前出现问题，则应用相应明文进行说明）1.2.4 附件信息约定为避免人员、组织机构信息过于庞大，webservi

12、ces接口只负责通知信息，并将人员或组织机构信息形成XML文件信息通知到EOMS系统，EOMS系统通过FTP方式下载XML文件进行解析将人员、组织机构信息导入到EOMS系统中，XML文件格式见“详细信息约定”。附件信息包括附件的文件名、附件的下载url（URL中不包含中文字符，如果附件的文件名中有中文请在附件的文件名中体现）和附件的长度，其中附件长度的单位为字节。附件信息采用XML格式封装，封装格式如下例所示： 标签解释： ：附件内容总标签； ：附件内容； ：附件名（可以包含中文）； ：附件的下载url（URL中不包含中文字符）； ：附件的长度。其中中可包括多个部分，如果没有附件，则没有部分，

13、仅存“”。1.2.5 详细信息约定1.2.5.1 详细信息格式定义接口流转过程中，接口内容除通用字段外，其余业务内容统一用“opDetail：接口内容参数”传输，接口内容中字段信息包括字段中文名、字段英文名、字段类型、字段内容，接口业务信息采用XML格式封装，封装格式如下例所示： /详细信息 /记录内容 /字段内容 /字段中文名 /字段英文名 /字段内容 中可包括多个部分，中可包括多个部分。如果没有详细信息，则仅存“”。1.2.5.2 详细信息内容1.2.5.2.1 组织机构信息同步No字段中文名称字段英文名称字段长度说明1机构IDdeptidvachar2(50)代维机构ID2机构名称dep

14、tnamevachar2(150)代维机构名称3机构类型depttypevarchar2(4)1公司、2子公司、3 部门、4 组、5 虚拟组4机构DNSdeptdnsvarchar2(150)5上级机构IDparentidvachar2(50)6操作optypeint(2)增量同步时使用，0：新增 1：修改 2：删除7操作时间optimevarchar2(24)格式为：yyyy-MM-dd HH:mm:ss1.2.5.2.2 人员信息同步No字段中文名称字段英文名称字段长度说明1用户编号userIDvarchar2(50)内部编号2用户帐号userAccountvarchar2(50)登录名3

15、用户姓名userNamevarchar2(60)4登录口令passvarchar2(100)5所属组织机构deptIDvarchar2(50)所属的组织结构ID，多个组织ID间用逗号分割6职务duty_idvarchar2(60)7邮箱emailvarchar2(80)8电话telephonevarchar2(50)9移动电话mobilevarchar2(50)10省provincevarchar2(50)11市cityvarchar2(50)12描述属性notevarchar2(150)13用户状态userStatusint(2)0：正常/1：停用(不允许登录)/2：删除(逻辑删除,删除用户

16、不显示),默认为“0”14操作optypeint(2)增量同步时使用，0：新增 1：修改 2：删除15操作时间optimevarchar2(24)格式为：yyyy-MM-dd HH:mm:ss接口安全要求1.3 接口安全设计目标与内容接口安全设计的目标是防止非法程序对系统接口的非法访问。接口安全设计可包括以下几个方面的内容： 网络控制在网络层面对来访程序进行一定的控制，保证来访程序来自于可靠地址。 数据机密性对接口传输的数据进行加密/解密，确保数据在传输过程中不被窃听。 数据完整性对接口传输的数据进行完整性检查，确保数据在传输过程中不被篡改。 授权与鉴权提供对来访程序的相应的用户/口令、权限分

17、配管理功能。当来访程序访问系统接口时，首先对来访程序进行鉴权，检查来访程序的用户名/口令以及是否拥有对所访问接口程序的访问权限。 审计管理提供接口日志管理功能，包括接口访问日志的记录、查询/检索、备份、删除、示警等。1.4 不同层面的接口安全措施为保证系统接口的安全，可在不同层面实施安全保障措施： 网络层在网络设备上设置访问控制列表，限制对接口机的访问。 传输层进行数据加密传输，以保证数据的机密性；实施数据签名，以保证数据的完整性。 应用层实施基于“用户名/口令”的授权/鉴权机制，确保来访程序拥有相应的权限；支持审计管理。1.5 本期接口安全要求本规范对接口安全约定如下： 在网络设备上设置接口

18、机的访问控制列表，从而限制对接口机的访问，避免接口机遭受恶意攻击； 考虑到EOMS系统与代维管理系统是内网系统，窃听和篡改数据的难度较大，因而不要求实施加密数据传输和数字签名等防护措施； 采用“用户名/口令”机制对访问程序进行鉴权。具体为在服务调用参数中增加用户名/口令，服务调用方被调用时首先进行用户权限认证，若认证失败，则服务调用结束，返回相应的错误代码。（注：“用户名”是访问系统在被访问系统中的标识，即后文接口服务调用参数中的“服务调用方”。）； 接口双方要约定某种口令更换策略，定期或不定期地更换口令； 要求不把口令固定地写在程序中，而是存放在程序外部的数据文件、数据库表或其它数据载体中，

19、以便于能够灵活地修改口令。并要求客户端对存放在外部的口令进行可逆加密，以防止客户端口令数据被盗；要求服务端对存放在外部的口令进行不可逆加密，以防止服务端口令数据被盗； 提供日志管理功能，包括接口访问日志的记录、查询/检索、备份、删除、示警等。EOMS系统与代维管理系统接口应提供日志功能，对接口中服务的调用方式（调用其他接口服务或被其他接口所调用）、调用或被调用服务名称、接口服务的调用时间、调用执行的结果等信息进行详细的记录，并提供相应的查询等功能。本小节对接口安全的要求为最基本要求，容许并鼓励接口实施方协商补充更为周全的安全防护措施。修订记录版本日期修订内容V1.02012-6-10征求意见稿。V1.12012-8-31规定中国移动代维系统和EOMS系统互联接口的接口流程、工单字段、接口技术要求、接口服务定义等内容。