MAS服务器支持移动办公接口供参习.docVIP

MAS服务器支持移动办公功能接口扩展 1、背景 在移动办公业务中，需要对在移动办公应用中所设置的订购关系信息与在MAS统一服务平台上保存的订购关系信息进行比对鉴权，另外，还需要MAS服务器及时地向MAS统一服务平台上报移动办公业务的活跃用户数和GPRS流量等业务性能信息。为此，需要对原有MAS服务器接口进行扩展。扩展包括两个部分：对MAS服务器与统一服务平台之间接口进行扩展，增加业务鉴权和业务性能上报接口；对MAS服务器与移动办公应用插件之间的接口进行扩展，增加业务鉴权和业务性能上报接口。 2、MAS服务器与统一服务平台之间的接口扩展 根据基于MAS的移动办公业务的需求，对MAS服务器与统一服务平台之间的接口进行了两个扩展。 第一部分为业务鉴权，在请求数据包中MAS服务器将订购关系信息发送给统一服务平台；在统一服务平台返回的响应包中返回本次业务鉴权的结果，并指定下一次业务鉴权需上报的数据及方法。 第二部分为业务性能上报，在请求数据包中将某一时间段内的业务性能数据发送给统一服务平台；在统一服务平台返回的响应包中返回接收的结果，并指定下一次性能数据上报时对应的时间段信息。 这两个接口全部通过SOAP协议实现，详细定义及数据格式如下。 2.1 业务鉴权请求及响应 2.1.1业务鉴权请求 MAS服务器向MAS统一服务平台发起业务鉴权请求： 序号 父元素名称 元素名称 约束 类型 宽度 描述 1 MasManagermentInterface Version 1 String 1.1 2 MasManagermentInterface MsgType 1 String BusiAuthenticReq 3 MasManagermentInterface SequenceID 1 String 序列号，99999999 4 MasManagermentInterface TimeStamp 1 String 时间戳，yyyymmddHHmmss 5 MasManagermentInterface MASID 1 String — MAS的ID 6 MasManagermentInterface UniMngrID 1 String 保留字段，暂时可以先不填这个字段 8 MasManagermentInterface Password 1 String — 密码 9 MasManagermentInterface Mac address 1 String MAS服务器上与MAS统一服务平台连接的网卡的MAC地址 10 MasManagermentInterface BusiConfigInfo * String 参见注释1 注释1：BusiConfigInfo中的每一项为一个订购关系信息，在订购关系信息中需指明业务的订购编码。“订购编码”为业务类型+通信能力的组合。 业务类型定义： CRM：0001 SCM：0002 ERP：0003 OA：0004 EMAIL：0005 行业应用：0006 其它：0007 基于MAS的移动办公：8121 通讯能力定义： 短信能力 0001 彩信能力：0002 USSD能力：0003 WAP能力：0004 LBS能力：0005 PUSHMAIL能力：0006 全业务能力：9999 注释2：BusiConfigInfo中的每一项为一个订购关系信息，一个业务可能有多个订购关系信息，如：始，代表移动OA业务短信订购关系信息，以812100020003开始，代表移动OA业务彩信和WAP订购关系信息。 该项分为三个部分，每个部分之间用;号分割。 第一部分格式：订购编码:签约成员总数,订购关系类型。其中“订购编码”为业务类型+通信能力，当一个业务类型开通多种通信能力时，“通信能力”字段为包含所有的通信能力编码的字符串。如订购编表移动OA业务短信，订购编码812100020003代表移动OA业务彩信和WAP。“签约成员总数”为该订购编码下签约成员的总数量。“订购关系类型”包括三种，分别为： 1 – 代表在请求中只上报签约成员总数，不上报明细，即第二、第三部分均不填写，但;号仍保留； 2 – 代表在请求中包含订购关系变量，在本周期内新增的订购关系在第二部分中填写明细，减掉的订购关系在第三部分中填写明细； 3 – 代表在请求中包含订购关系全量，在第二部分中填写当前的所有该订购编码下的订购关系明细，第三部分不填写，但;号仍保留。 第二部分格式：为’用户名 该用户名的签约手机号码’的组合，多个组合之间用,号区分，每个组合内部用户名与其对应的手机号码间用一个空格分割，如zhixinyu 138xxxxxxxx,xiaowang 138x