某通信公司技术规范外部接口分册课件

单击此处编辑母版标题样式,单击此处编辑母版文本样式,第二级,第三级,单击此处编辑母版标题样式,单击此处编辑母版文本样式,第二级,第三级,第四级,第五级,*,中国移动省级NG2-BASS3.0技术规范外部接口分册,16八月2019,中国移动省级NG2-BASS3.0技术规范外部接口分册,目录,1,、总体说明,3,、互动接口,2,、数据源接口,4,、功能接口,目录1、总体说明3、互动接口2、数据源接口4、功能接口,接口规范目标,1,统一规范省级经营分析系统和源系统之间的连接关系和接口特性，规范各数据单元的接口格式,6,降低省级经营分析系统和源系统间数据接口的建设风险和难度，保障数据接口的建设进度,4,减少省级经营分析系统与源系统之间的相互影响，保障生产系统的稳定安全,5,采用数据封装机制，统一规范省级经营分析系统向各外部系统提供信息服务的标准和接口内容,2,继续扩充数据源接口内容，如中央业务类接口。,3,要求实现准实时接口，以提升外部系统数据导入的准实时性，为外部系统提供准实时性的数据访问，提高数据获取和数据访问的准实时性服务能力。,接口规范目标1统一规范省级经营分析系统和源系统之间的连接关系,接口规范原则,在满足业务需求的,前提下，使接口数据,量最少，最大限度地,减轻数据提供方压力,保证省级经营分析,系统与外部系统,数据一致性,具有可靠完善的,接口数据传输,与错误处理机制,互动接口应符合,开放系统的,标准协议,应具备完整性、,规范性、,开放性和灵活性,互动接口应能够,平滑地扩充,互动接口连接,必须具有,安全控制机制,接口定义遵循易理解、,易使用、易交流、,易扩展的原则,扩展原则：,由数据源传送方或数据源接收方发起的接口扩展，都必须采用现有的传输协议与模式，并与现有接口编码规则和命名规则保持一致,编制原则：,接口规范原则在满足业务需求的保证省级经营分析具有可靠完善的互,接口定位,接口定位,接口分类,省级经营分析系统与外部系统的接口包括以下三类：,数据源接口：是省级经营分析系统从外部系统获取数据的接口,互动接口：是省级经营分析系统为外部系统提供数据信息的接口,功能接口：主要包括省级经营分析系统与,4A,安全平台接口、信息推送接口,接口分类 省级经营分析系统与外部系统的接口包括以下三类：,目录,1,、总体说明,3,、互动接口,2,、数据源接口,4,、功能接口,目录1、总体说明3、互动接口2、数据源接口4、功能接口,接口数据来源,直接从省级业务支撑系统获取相关数据，如省级,NG1-BOSS,、,NG1-CRM,；,直接从省级外部数据源系统，如：网管系统、彩铃平台、,DSMP,平台、,OTA,平台、,WAP,网关、网络信令采集子系统、,VGOP,平台、,ERP/MIS,系统等获取相关数据；,间接通过省级,VGOP,系统获取一类业务数据：中央音乐平台,/,无线音乐平台,、手机报平台、飞信平台、号薄,管家平台、,DM,平台、手机视频平台、手机阅读、手机游戏、,PUSHEMAIL,、手机支付、,12580,综合信息平台等的相关数据。,间接通过省级,VGOP,系统获取二类业务数据,间接通过一级经营分析系统获取：新业务营销体验平台、行业应用终端监控平台的相关数据。,接口数据来源 直接从省级业务支撑系统获取相关数据，如省级NG,接口编码原则,接口单元的编码,单元类别代码,二位数字,序列号,三位数值,各接口单元的编码规则是：,接口编码原则 接口单元的编码单元类别代码 二位数字序列,96,中央业务类接口单元,96,中央业务类接口增加了一级,VGOP,作为源系统的部分接口，,4,个新的业务平台手机阅读、手机游戏、,PUSHEMAIL,、手机支付、手机视频；修改部分接口包括：飞信业务平台接口、,12580,平台接口、终端平台接口等。,原手机电视接口停止，变更为手机新增的手机视频接口。,依据：原手机电视接口内容，就是现在的手机视频接口内容，因此跟进一级,VGOP,给经分的手机视频接口进行增补。,96中央业务类接口单元96中央业务类接口增加了一级VGOP作,92,财务类接口单元,本次规范新增财务类接口。具体包括：广告成本、宣传成本、通信网运营成本、营销机构成本、销售费用、管理费用六个接口。,94,网络信令接口单元,停止了,94001,94008,接口；对原有的,94009 A,接口做了增加和修订，同时新增了,94010 Gb,信令接口。,92财务类接口单元本次规范新增财务类接口。具体包括：广告成本,01,客户管理接口单元,01客户管理接口,增加：01036 帐户关系 01037 家庭客户 01038 家庭客户成员 01039 订购实例,;,01040,校园基本信息,01041,学校管理层信息,01042,学生信息,01043,教职工信,01044,学生放号类营销活动目标客户信息；,修订接口：01009帐本，增加“上期结余”；,02,客户服务接口单元,未做修订,01客户管理接口单元01客户管理接口02客户服务接口单元未做,03,员工接口单元,未做修订,04,资源管理类接口单元,修订：在终端设备接口中补充终端类别属性字段；,05,计费帐务接口单元,未做修订,03员工接口单元未做修订04资源管理类接口单元修订：在终端设,06,结算接口单元,未做修订,07-,营销与市场调查接口单元,未做修订,08-,参数配置与计算原则接口单元,新增接口：,08118,打包产品构成，修订：,08015,终端设备类别,06结算接口单元未做修订07-营销与市场调查接口单元未做修订,准实时数据源接口能力支撑,经营分析系统数据源接口的传送周期需满足月、日、小时和分钟等多种周期。对于准实时数据源接口内容不同，对标准化传输的周期的迫切不同，本期规范要求数据源准实时接口支持到小时。,准实时数据源接口的数据获取最终取决源系统的系统提供能力。具体内容参见技术规范总册相关章节。,准实时数据源接口能力支撑 经营分析系统数据源接口的传送周期需,准实时数据源接口单元列表,准实时数据源接口单元列表,目录,1,、总体说明,3,、互动接口,2,、数据源接口,4,、功能接口,目录1、总体说明3、互动接口2、数据源接口4、功能接口,互动接口总表,互动接口总表,互动接口总表（续）,本数据服务的数据集及,6,个方法支撑对外部准实时数据提供的需求，“在线请求,-,同步响应”的消息交换模式即是准实时的，我们采用此交互模式，提高数据请求、数据查询、数据返回各个环节的效率，以达到准实时数据支撑的能力。具体技术实现方式参见技术规范总册“准实时数据提供章节”描述。,互动接口总表（续）本数据服务的数据集及6个方法支撑对外部准实,营销服务互动服务,营销服务互动服务的信息交换方式采用发布订阅方式。营销服务互动服务中的,注册服务,由,服务提供方,提供，,通知服务,由,服务请求方,提供。支持营销服务互动服务数据集有营销互动、资费产品推荐互动、客户关怀互动、,和策反互动等。,服务标识,PublishSubscibeService,服务描述,注册服务由服务提供方提供。服务请求方调用注册服务，用于起订,或退订具体的服务。注册服务支持的数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。,在注册服务的,WSDL,服务描述中需要列出可订阅数据集信息。,实现方式,基于,SOAP,的,Web,服务。,性能要求,单次请求正常网络通讯情况下，响应时间必须在,2,秒之内；同一时间内支持的最大并发请求小于,100,。,方法标识,RegisterRequest,方法描述,服务请求方调用注册服务（,PublishSubscibeService,）的注册方法（,RegisterRequest,），并发送请求消息给服务提供方。服务提供方订阅操作完毕，并返回应答消息给服务请求方。,营销服务互动服务营销服务互动服务的信息交换方式采用发布订阅,通知服务,服务标识,通知服务标识是由服务请求方在填写注册服务的请求信息中定义的。它是由注册服务（,PublishSubscibeService,）的注册方法（,RegisterRequest,）的请求消息中定义的通知服务标识（,ServiceID,）指定的。,服务描述,通知服务由服务请求方提供。服务提供方准备完数据，通过调用通知服务，告诉,服务请求方数据准备完毕。通知服务支持的数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。,实现方式,基于,SOAP,的,Web,服务。,性能要求,单次请求正常网络通讯情况下，响应时间必须在,2,秒之内；同一时间内支持的最大并发请求小于,100,。,方法标识,通知服务方法标识是由服务请求方在填写注册服务的请求信息中定义的。,它是由注册服务（,PublishSubscibeService,）的注册方法（,RegisterRequest,）的请求消息中定义的通知服务方法标识（,FunctionID,）指定的。,方法描述,服务提供方数据准备完毕后，调用服务请求方提供的通知服务方法并传递请求消息。服务请求方接收到通知，返回应答消息给服务提供方。,通知服务服务标识,获取客户统一视图服务的新增内容,在获取客户统一视图服务 增加两个新的方法：,获取集团客户分析属性信息方法,获取集团成员分析属性信息方法,请求消息,获取集团客户分析属性信息方法,获取客户统一视图服务的新增内容在获取客户统一视图服务 增加两,获取集团客户分析属性信息方法,应答消息,获取集团客户分析属性信息方法应答消息,目录,1,、总体说明,3,、互动接口,2,、数据源接口,4,、功能接口,目录1、总体说明3、互动接口2、数据源接口4、功能接口,功能接口类别表,功能接口类别表,省级经营分析系统与,4A,安全平台接口,从帐号登录：,通过改造经营分析系统的认证管理模块、数据安全管理模块来实现,4A,管理平台与经营分析系统之间的单点登录（,SSO,）、集中认证，接收请求并返回认证结果；,从帐号查询：,通过改造经营分析系统的用户管理模块、数据安全管理模块来实现,4A,管理平台对经营分析系统中从帐号及属性的查询；,角色查询：,通过改造经营分析系统的用户管理模块、数据安全管理模块来实现,4A,管理平台对经营分析系统中角色及属性的查询；,从帐号变更：,通过改造经营分析系统的用户管理模块、数据安全管理模块来实现,4A,管理平台对经营分析系统中从帐号及属性的变更、同步；,角色变更：,通过改造经营分析系统的用户管理模块、数据安全管理模块来实现,4A,管理平台对经营分析系统中角色及属性的变更、同步；,从帐号权限查询：,通过改造经营分析系统的权限管理模块、数据安全管理模块来实现,4A,管理平台对经营分析系统中从帐号角色关系、从帐号细粒度权限的查询；,角色权限查询：,通过改造经营分析系统的权限管理模块、数据安全管理模块来实现,4A,管理平台对经营分析系统中角色的权限的查询；,从帐号角色变更：,通过改造经营分析系统的权限管理模块、数据安全管理模块来实现,4A,管理平台对经营分析系统中从帐号的角色关系变更、同步；,从帐号权限变更：,改造经营分析系统的权限管理模块、数据安全管理模块，实现通过,4A,管理平台对经营分析系统中从帐号细粒度权限变更；,审计日志传送：,通过改造经营分析系统的审计日志记录和数据安全管理模块来实现,4A,管理平台对经营分析系统中登录记录和关键操作记录的过滤、格式化和发送。,省级经营分析系统与4A安全平台接口从帐号登录：通过改造经营分,信息推送接口,短信推送接口功能,短信推送接口功能模块负责通过,CMPP,协议与短信网关交互，使经营分析门户的信息以短信方式发送给用户。短信通知接口支持短信的群发与定时发送，传输的内容包括发送流水号、手机号码、发送时间、发送内容、校验等。短信推送接口功能模块应有完善的系统出错处理机制，避免短信的漏发、错发，系统将对没有发送成功的信息进行缓存并进行多次重发。,彩信推送接口功能,彩信推送接口功能负责与彩信网关交互，使经营分析门户可以把信息以彩信方式发送给用户。彩信推送接口传输内容包括流水号、手机号码、发送时间