《MAS服务器支持移动办公接口》由会员分享，可在线阅读，更多相关《MAS服务器支持移动办公接口（12页珍藏版）》请在金锄头文库上搜索。
1、文档供参考，可复制、编制，期待您的好评与关注！ MAS服务器支持移动办公功能接口扩展1、背景在移动办公业务中，需要对在移动办公应用中所设置的订购关系信息与在MAS统一服务平台上保存的订购关系信息进行比对鉴权，另外，还需要MAS服务器及时地向MAS统一服务平台上报移动办公业务的活跃用户数和GPRS流量等业务性能信息。为此，需要对原有MAS服务器接口进行扩展。扩展包括两个部分：对MAS服务器与统一服务平台之间接口进行扩展，增加业务鉴权和业务性能上报接口；对MAS服务器与移动办公应用插件之间的接口进行扩展，增加业务鉴权和业务性能上报接口。2、MAS服务器与统一服务平台之间的接口扩展根据基于MAS的移
2、动办公业务的需求，对MAS服务器与统一服务平台之间的接口进行了两个扩展。第一部分为业务鉴权，在请求数据包中MAS服务器将订购关系信息发送给统一服务平台；在统一服务平台返回的响应包中返回本次业务鉴权的结果，并指定下一次业务鉴权需上报的数据及方法。第二部分为业务性能上报，在请求数据包中将某一时间段内的业务性能数据发送给统一服务平台；在统一服务平台返回的响应包中返回接收的结果，并指定下一次性能数据上报时对应的时间段信息。这两个接口全部通过SOAP协议实现，详细定义及数据格式如下。2.1 业务鉴权请求及响应2.1.1业务鉴权请求MAS服务器向MAS统一服务平台发起业务鉴权请求：序号父元素名称元素名称约
3、束类型宽度描述1MasManagermentInterfaceVersion1String1.12MasManagermentInterfaceMsgType1StringBusiAuthenticReq3MasManagermentInterfaceSequenceID1String序列号，从00000001到999999994MasManagermentInterfaceTimeStamp1String时间戳，yyyymmddHHmmss5MasManagermentInterfaceMASID1StringMAS的ID6MasManagermentInterfaceUniMngrID1S
4、tring保留字段，暂时可以先不填这个字段8MasManagermentInterfacePassword1String密码9MasManagermentInterfaceMac address1StringMAS服务器上与MAS统一服务平台连接的网卡的MAC地址10MasManagermentInterfaceBusiConfigInfo*String参见注释1注释1：BusiConfigInfo中的每一项为一个订购关系信息，在订购关系信息中需指明业务的订购编码。“订购编码”为业务类型+通信能力的组合。业务类型定义： CRM：0001SCM：0002ERP：0003OA：0004EMAIL：
5、0005行业应用：0006其它：0007基于MAS的移动办公：8121通讯能力定义：短信能力 0001彩信能力：0002USSD能力：0003WAP能力：0004LBS能力：0005PUSHMAIL能力：0006全业务能力：9999注释2：BusiConfigInfo中的每一项为一个订购关系信息，一个业务可能有多个订购关系信息，如：以81210001开始，代表移动OA业务短信订购关系信息，以812100020003开始，代表移动OA业务彩信和WAP订购关系信息。该项分为三个部分，每个部分之间用;号分割。第一部分格式：订购编码:签约成员总数,订购关系类型。其中“订购编码”为业务类型+通信能力，当
6、一个业务类型开通多种通信能力时，“通信能力”字段为包含所有的通信能力编码的字符串。如订购编码81210001代表移动OA业务短信，订购编码812100020003代表移动OA业务彩信和WAP。“签约成员总数”为该订购编码下签约成员的总数量。“订购关系类型”包括三种，分别为：1 代表在请求中只上报签约成员总数，不上报明细，即第二、第三部分均不填写，但;号仍保留；2 代表在请求中包含订购关系变量，在本周期内新增的订购关系在第二部分中填写明细，减掉的订购关系在第三部分中填写明细；3 代表在请求中包含订购关系全量，在第二部分中填写当前的所有该订购编码下的订购关系明细，第三部分不填写，但;号仍保留。第二
7、部分格式：为用户名 该用户名的签约手机号码的组合，多个组合之间用,号区分，每个组合内部用户名与其对应的手机号码间用一个空格分割，如zhixinyu 138xxxxxxxx,xiaowang 138xxxxxxxx代表两个订购关系明细。对于在第一部分中订购关系类型字段填写为1的情况，本部分不填写；对于在第一部分中订购关系类型字段填写为2的情况，本部分为当前上报周期内的新增订购关系明细；对于在第一部分中订购关系类型字段填写为3的情况，本部分为当前该订购编码下的所有订购关系明细。第三部分格式：为用户名 该用户名的签约手机号码的组合，多个组合之间用,号区分，每个组合内部用户名与其对应的手机号码间用一个
8、空格分割，如zhixinyu 138xxxxxxxx,xiaowang 138xxxxxxxx代表两个订购关系明细。对于在第一部分中订购关系类型字段填写为1和3的情况，本部分不填写；对于在第一部分中订购关系类型字段填写为2的情况，本部分为当前上报周期内的减掉的订购关系明细。订购编码举例1：基于MAS的移动办公业务能力代码为8121，开通所有通信能力字段，则订购编码为：81219999；订购编码举例2：基于MAS的移动办公业务能力代码为8121，开通短信和彩信通信能力，则订购编码为：812100010002。订购关系信息举例1：某个集团客户订购基于MAS的移动办公业务（开通所有通信能力），在上一
9、次业务鉴权时有2个签约关系成员（zhixinyu 138xxxxxxxx和zanghui 139xxxxxxxx），后来新增加了1个签约关系成员（xiaowang 138xxxxxxxx），当前共有3个签约关系成员：如订购关系类型为“订购关系全量”则BusiConfigInfo信息为：81219999:3,3;zhixinyu 138xxxxxxxx,zanghui 139xxxxxxxx,xiaowang 138xxxxxxxx;如订购关系信息类型为“订购关系变量”则BusiConfigInfo信息为：81219999:3,2;xiaowang 138xxxxxxxx;如订购关系信息类型为“
10、签约成员总数”则BusiConfigInfo信息为：81219999:3,1;订购关系信息举例2：某个集团客户订购基于MAS的移动办公业务1（开通短信、彩信通信能力），并在上次业务鉴权时有2个签约关系成员（zhixinyu 138xxxxxxxx,zanghui 139xxxxxxxx），同时订购基于MAS的移动办公业务2（开通WAP通信能力），且在上次业务鉴权时有3个签约关系成员(zhixinyu 138xxxxxxxx,xiaoli 134xxxxxxxx,xiaowang 138xxxxxxxx)，后来业务2删除了一个签约关系成员（xiaowang 138xxxxxxxx），且增加了一个
11、签约关系成员（xiaozhang 135xxxxxxxx）：如业务1订购关系信息类型为“订购关系全量”, 业务2订购关系信息类型为“订购关系全量”则BusiConfigInfo信息为：812100010002:2,3;zhixinyu 138xxxxxxxx,zanghui 139xxxxxxxx;81210004:3,3;zhixinyu 138xxxxxxxx,xiaoli 134xxxxxxxx,xiaozhang 135xxxxxxxx; xiaowang 138xxxxxxxx如业务1订购关系信息类型为“订购关系全量”,业务2订购关系信息类型为“订购关系变量”则BusiConfigI
12、nfo信息为：812100010002:2,3;zhixinyu 138xxxxxxxx,zanghui 139xxxxxxxx;81210004:3,2;xiaozhang 135xxxxxxxx;xiaowang 138xxxxxxxx如业务1订购关系信息类型为“订购关系全量”,业务2订购关系信息类型为“签约成员总数”则BusiConfigInfo信息为：812100010002:2,3;zhixinyu 138xxxxxxxx,zanghui 139xxxxxxxx;81210004:3,12.1.2 业务鉴权响应MAS统一服务平台向MAS服务器返回业务鉴权响应，响应包格式如下：序号父元
13、素名称元素名称约束类型宽度描述1MasManagermentInterfaceVersion1String1.12MasManagermentInterfaceMsgType1StringBusiAuthenticRsp3MasManagermentInterfaceSequenceID1String序列号，从00000001到999999994MasManagermentInterfaceTimeStamp1String时间戳，yyyymmddHHmmss5MasManagermentInterfaceMASID1StringMAS的ID6MasManagermentInterfaceUni
14、MngrID1StringMAS统一服务平台的ID7MasManagermentInterfaceBusiAuthResult*String参见注释1注释1：订购编码中的业务类型和通信能力说明业务类型定义： CRM：0001SCM：0002ERP：0003OA：0004EMAIL：0005行业应用：0006其它：0007插件：8xxx，基于MAS的移动办公为8121通讯能力定义：短信能力 0001彩信能力：0002USSD能力：0003WAP能力：0004LBS能力：0005PUSHMAIL能力：0006注释2：BusiAuthResult中的每一项代表一个订购信息鉴权结果；该项格式为：“订购
15、编码（业务类型+通信能力）:鉴权结果;鉴权类型标志”，其中“订购编码”的格式及含义见订购信息鉴权请求中的相关说明，“鉴权结果”见注释3，“鉴权类型标志”规定MAS服务器在下一次鉴权时需采用的业务鉴权类型，MAS服务器收到业务鉴权响应信息后，需要根据其中的“鉴权类型标志”，在下次鉴权时发起相应类型的业务鉴权请求；注释3：鉴权结果定义：成功：1失败（成员总数或明细不匹配）：2失败（MAS统一服务平台无该业务相关签约成员信息）：3鉴权类型标志定义：签约成员总数：1订购关系增量：2订购关系全量：3鉴权响应举例1：某个集团客户订购基于MAS的移动办公业务（开通所有通信能力），在上一次业务鉴权时有2个签约关系成员（zhixinyu 138xxxxxxxx和zanghui 139xxxxxxxx），后来新
