NG2-BASS30规范培训-技术规范-外部接口分册-易剑光

中国移动省级NG2-BASS3.0技术规范外部接口分册2019年10月3日星期四目录1、总体说明3、互动接口2、数据源接口4、功能接口接口规范目标1统一规范省级经营分析系统和源系统之间的连接关系和接口特性，规范各数据单元的接口格式6降低省级经营分析系统和源系统间数据接口的建设风险和难度，保障数据接口的建设进度4减少省级经营分析系统与源系统之间的相互影响，保障生产系统的稳定安全5采用数据封装机制，统一规范省级经营分析系统向各外部系统提供信息服务的标准和接口内容2继续扩充数据源接口内容，如中央业务类接口。3要求实现准实时接口，以提升外部系统数据导入的准实时性，为外部系统提供准实时性的数据访问，提高数据获取和数据访问的准实时性服务能力。接口规范原则在满足业务需求的前提下，使接口数据量最少，最大限度地减轻数据提供方压力保证省级经营分析系统与外部系统数据一致性具有可靠完善的接口数据传输与错误处理机制互动接口应符合开放系统的标准协议应具备完整性、规范性、开放性和灵活性互动接口应能够平滑地扩充互动接口连接必须具有安全控制机制接口定义遵循易理解、易使用、易交流、易扩展的原则扩展原则：由数据源传送方或数据源接收方发起的接口扩展，都必须采用现有的传输协议与模式，并与现有接口编码规则和命名规则保持一致编制原则：接口定位接口分类省级经营分析系统与外部系统的接口包括以下三类：•数据源接口：是省级经营分析系统从外部系统获取数据的接口•互动接口：是省级经营分析系统为外部系统提供数据信息的接口•功能接口：主要包括省级经营分析系统与4A安全平台接口、信息推送接口功能接口数据源接口省级VGOP接口飞信平台省级外部系统接口彩铃平台DSMP平台网管系统NG1-CRM系统接口客户管理客户…资源管理终端设备有价卡资源定制终端信息客户服务订单……无线音乐平台139邮箱平台…OTA平台DM平台号码资源…WAP网关…12580平台手机报平台PIM平台网络信令手机视频平台一级经营分析系统接口新业务营销体验平台行业应用终端监控平台ERP/MIS4A安全接口信息推送接口…从帐号登录接口从帐号＋凭证方式…短信推送接口彩信推送接口邮件推送接口互动接口营销互动接口分析结果查询接口营销互动类资费产品推荐互动类…客户统一视图明细数据查询接口个人客户基本信息个人客户分析属性信息客户标签属性信息数据及信息业务特征信息NG1-BOSS系统接口计费帐务清单信息帐务信息…结算结算清单…参数配置与计算原则参数配置业务计算原则…帐号/角色管理接口订单受理费用成员管理渠道…营销与市场调查营销计划…缴费信息营销反馈接口手机支付平台手机游戏平台手机阅读平台PushMail平台目录1、总体说明3、互动接口2、数据源接口4、功能接口接口数据来源直接从省级业务支撑系统获取相关数据，如省级NG1-BOSS、NG1-CRM；直接从省级外部数据源系统，如：网管系统、彩铃平台、DSMP平台、OTA平台、WAP网关、网络信令采集子系统、VGOP平台、ERP/MIS系统等获取相关数据；间接通过省级VGOP系统获取一类业务数据：中央音乐平台/无线音乐平台、手机报平台、飞信平台、号薄管家平台、DM平台、手机视频平台、手机阅读、手机游戏、PUSHEMAIL、手机支付、12580综合信息平台等的相关数据。间接通过省级VGOP系统获取二类业务数据间接通过一级经营分析系统获取：新业务营销体验平台、行业应用终端监控平台的相关数据。省级业务支撑系统省级经营分析系统一级业务支撑系统一级VGOP系统一级经营分析系统省级VGOP系统省级CRM系统中央业务平台无线音乐平台PIM平台DM平台省级外部数据源系统DSMP平台ERP/MISETL数据仓库数据集市前端应用无线音乐、手机视频、12580、手机报、飞信、DM、PIM、139邮箱、手机支付、手机阅读、手机游戏、PushMail业务支撑网接口域业务支撑网接口域彩铃平台手机报平台网管系统网络信令采集子系统12580平台手机视频平台OTA平台WAP网关飞信平台139邮箱平台新业务营销体验平台行业应用终端监控平台……省级BOSS系统互动接口......系统安全管理4A管理平台信息推送业务支撑接入网关新业务营销体验、行业应用终端图例：蓝色空心箭头表示数据源接口实心黑色箭头表示省级经营分析内部数据流粉色空心箭头表示互动接口潜蓝色空心双向箭头表示功能类接口灰色实心箭头表示中央业务平台和一级业务支撑系统的接口手机支付平台手机游戏平台手机阅读平台PushMail平台接口编码原则接口单元类别名称类别代码字冠接口单元类别名称类别代码字冠客户管理01财务92客户服务02网络信令接口94成员管理03OTA平台接口95资源管理04中央业务类96计费帐务05网管接口97结算06彩铃98营销与市场调查07DSMP99参数配置与计算原则08接口单元的编码单元类别代码二位数字序列号三位数值各接口单元的编码规则是：单元类别代码字冠序列号96中央业务类接口单元96中央业务类接口增加了一级VGOP作为源系统的部分接口，4个新的业务平台手机阅读、手机游戏、PUSHEMAIL、手机支付、手机视频；修改部分接口包括：飞信业务平台接口、12580平台接口、终端平台接口等。原手机电视接口停止，变更为手机新增的手机视频接口。依据：原手机电视接口内容，就是现在的手机视频接口内容，因此跟进一级VGOP给经分的手机视频接口进行增补。92财务类接口单元本次规范新增财务类接口。具体包括：广告成本、宣传成本、通信网运营成本、营销机构成本、销售费用、管理费用六个接口。94网络信令接口单元停止了94001——94008接口；对原有的94009A接口做了增加和修订，同时新增了94010Gb信令接口。01客户管理接口单元01客户管理接口增加：01036帐户关系01037家庭客户01038家庭客户成员01039订购实例;01040校园基本信息01041学校管理层信息01042学生信息01043教职工信01044学生放号类营销活动目标客户信息；修订接口：01009帐本，增加“上期结余”；02客户服务接口单元未做修订03员工接口单元未做修订04资源管理类接口单元修订：在终端设备接口中补充终端类别属性字段；05计费帐务接口单元未做修订06结算接口单元未做修订07-营销与市场调查接口单元未做修订08-参数配置与计算原则接口单元新增接口：08118打包产品构成，修订：08015终端设备类别准实时数据源接口能力支撑经营分析系统数据源接口的传送周期需满足月、日、小时和分钟等多种周期。对于准实时数据源接口内容不同，对标准化传输的周期的迫切不同，本期规范要求数据源准实时接口支持到小时。准实时数据源接口的数据获取最终取决源系统的系统提供能力。具体内容参见技术规范总册相关章节。准实时数据源接口单元列表5001语音清单用户使用GSM/TD业务清单，含GSM/TD国际漫游来访清单计费帐务类5002GPRS清单用户使用GPRS业务清单，含GPRS国际漫游来访清单计费帐务类5003移动梦网短信清单用户使用移动梦网短信业务清单计费帐务类5004移动梦网WAP清单用户使用移动梦网WAP业务清单计费帐务类5005普通短信清单用户使用普通点对点短信业务清单计费帐务类5009智能网VPMN清单用户使用智能网VPMN业务的清单计费帐务类5016互联互通短信清单用户互联互通服务使用记录计费帐务类5018MMS清单用户使用彩信服务记录计费帐务类目录1、总体说明3、互动接口2、数据源接口4、功能接口互动接口总表服务名称数据集接口单元说明信息交互方式分类名称营销服务互动服务营销互动营销活动配置对一个具体的营销与服务活动进行概括描述的接口。发布－订阅方式营销活动目标客户规则指营销活动中需要选择的目标客户群过滤的规则信息。发布－订阅方式营销活动目标客户指营销活动所选择的营销目标客户群的信息。发布－订阅方式活动触发规则用于全程精确营销信令实时匹配的各种参数规则接口。发布－订阅方式活动执行区域指营销活动执行所覆盖的区域信息。发布－订阅方式资费产品推荐互动资费产品推荐通过客户细分、资费预演等专题分析，形成资费产品推荐信息。发布－订阅方式客户关怀互动客户挽留名单通过数据挖掘方法预测可能流失的客户，形成客户挽留名单信息。发布－订阅方式客户关怀信息通过客户细分模型等数据挖掘方法，对客户群体进行细分。发布－订阅方式策反互动策反方案信息通过分析潜在客户的消费行为、消费能力等轮廓信息生成策反方案。发布－订阅方式互动接口总表（续）分析结果查询服务分析结果查询业务历史数据分析结果数据集该接口用于经营分析系统向外部系统提供历史报表访问。在线请求—异步响应方式明细数据查询明细数据结果数据集该接口用于经营分析系统向外部系统提供详细数据访问。在线请求—异步响应方式客户统一视图服务客户统一视图获取个人客户基本属性信息该接口用于获取指定的个人客户的基础属性相关信息，包括基本属性、终端使用、终端功能属性等。在线请求—同步响应方式获取个人客户分析属性信息该接口用于获取指定的个人客户分析属性信息，包括客户行为属性、增值业务营销属性等。在线请求—同步响应方式获取客户标签属性信息该接口用于查询客户对应的客户标签信息。在线请求—同步响应方式获取客户数据及信息业务特征信息该接口用于获取客户使用数据及信息业务的行为特征信息。在线请求—同步响应方式获取集团客户分析属性信息方法该接口用于获取集团客户行为、产品、应用等特征信息。在线请求—同步响应方式获取集团成员分析属性信息方法该接口用于获取集团成员行为等特征信息。在线请求—同步响应方式本数据服务的数据集及6个方法支撑对外部准实时数据提供的需求，“在线请求-同步响应”的消息交换模式即是准实时的，我们采用此交互模式，提高数据请求、数据查询、数据返回各个环节的效率，以达到准实时数据支撑的能力。具体技术实现方式参见技术规范总册“准实时数据提供章节”描述。营销服务互动服务营销服务互动服务的信息交换方式采用发布－订阅方式。营销服务互动服务中的注册服务由服务提供方提供，通知服务由服务请求方提供。支持营销服务互动服务数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。服务标识PublishSubscibeService服务描述注册服务由服务提供方提供。服务请求方调用注册服务，用于起订或退订具体的服务。注册服务支持的数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。在注册服务的WSDL服务描述中需要列出可订阅数据集信息。实现方式基于SOAP的Web服务。性能要求单次请求正常网络通讯情况下，响应时间必须在2秒之内；同一时间内支持的最大并发请求小于100。方法标识RegisterRequest方法描述服务请求方调用注册服务（PublishSubscibeService）的注册方法（RegisterRequest），并发送请求消息给服务提供方。服务提供方订阅操作完毕，并返回应答消息给服务请求方。通知服务服务标识通知服务标识是由服务请求方在填写注册服务的请求信息中定义的。它是由注册服务（PublishSubscibeService）的注册方法（RegisterRequest）的请求消息中定义的通知服务标识（ServiceID）指定的。服务描述通知服务由服务请求方提供。服务提供方准备完数据，通过调用通知服务，告诉服务请求方数据准备完毕。通知服务支持的数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。实现方式基于SOAP的Web服务。性能要求单次请求正常网络通讯情况下，响应时间必须在2秒之内；同一时间内支持的最大并发请求小于100。方法标识通知服务方法标识是由服务请求方在填写注册服务的请求信息中定义的。。它是由注册服务（PublishSubscibeService）的注册方法（RegisterRequest）的请求消息中定义的通知服务方法标识（FunctionID）指定的。方法描述服务提供方数据准备完毕后，调用服务请求方提供的通知服务方法并传递请求消息。服务请求