MAS服务器支持移动办公接口.docx
- 文档编号:20195717
- 上传时间:2023-04-25
- 格式:DOCX
- 页数:20
- 大小:44.07KB
MAS服务器支持移动办公接口.docx
《MAS服务器支持移动办公接口.docx》由会员分享,可在线阅读,更多相关《MAS服务器支持移动办公接口.docx(20页珍藏版)》请在冰豆网上搜索。
MAS服务器支持移动办公接口
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
序列号,从00000001到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
Macaddress
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中的每一项为一个订购关系信息,一个业务可能有多个订购关系信息,如:
以81210001开始,代表移动OA业务短信订购关系信息,以812100020003开始,代表移动OA业务彩信和WAP订购关系信息。
该项分为三个部分,每个部分之间用;号分割。
第一部分格式:
订购编码:
签约成员总数,订购关系类型。
其中“订购编码”为业务类型+通信能力,当一个业务类型开通多种通信能力时,“通信能力”字段为包含所有的通信能力编码的字符串。
如订购编码81210001代表移动OA业务短信,订购编码812100020003代表移动OA业务彩信和WAP。
“签约成员总数”为该订购编码下签约成员的总数量。
“订购关系类型”包括三种,分别为:
1–代表在请求中只上报签约成员总数,不上报明细,即第二、第三部分均不填写,但;号仍保留;
2–代表在请求中包含订购关系变量,在本周期内新增的订购关系在第二部分中填写明细,减掉的订购关系在第三部分中填写明细;
3–代表在请求中包含订购关系全量,在第二部分中填写当前的所有该订购编码下的订购关系明细,第三部分不填写,但;号仍保留。
第二部分格式:
为’用户名该用户名的签约手机号码’的组合,多个组合之间用,号区分,每个组合内部用户名与其对应的手机号码间用一个空格分割,如zhixinyu138xxxxxxxx,xiaowang138xxxxxxxx代表两个订购关系明细。
对于在第一部分中订购关系类型字段填写为1的情况,本部分不填写;对于在第一部分中订购关系类型字段填写为2的情况,本部分为当前上报周期内的新增订购关系明细;对于在第一部分中订购关系类型字段填写为3的情况,本部分为当前该订购编码下的所有订购关系明细。
第三部分格式:
为’用户名该用户名的签约手机号码’的组合,多个组合之间用,号区分,每个组合内部用户名与其对应的手机号码间用一个空格分割,如zhixinyu138xxxxxxxx,xiaowang138xxxxxxxx代表两个订购关系明细。
对于在第一部分中订购关系类型字段填写为1和3的情况,本部分不填写;对于在第一部分中订购关系类型字段填写为2的情况,本部分为当前上报周期内的减掉的订购关系明细。
订购编码举例1:
基于MAS的移动办公业务能力代码为8121,开通所有通信能力字段,则订购编码为:
81219999;
订购编码举例2:
基于MAS的移动办公业务能力代码为8121,开通短信和彩信通信能力,则订购编码为:
812100010002。
订购关系信息举例1:
某个集团客户订购基于MAS的移动办公业务(开通所有通信能力),在上一次业务鉴权时有2个签约关系成员(zhixinyu138xxxxxxxx和zanghui139xxxxxxxx),后来新增加了1个签约关系成员(xiaowang138xxxxxxxx),当前共有3个签约关系成员:
如订购关系类型为“订购关系全量”则BusiConfigInfo信息为:
81219999:
3,3;zhixinyu138xxxxxxxx,zanghui139xxxxxxxx,xiaowang138xxxxxxxx;
如订购关系信息类型为“订购关系变量”则BusiConfigInfo信息为:
81219999:
3,2;xiaowang138xxxxxxxx;
如订购关系信息类型为“签约成员总数”则BusiConfigInfo信息为:
81219999:
3,1;;
订购关系信息举例2:
某个集团客户订购基于MAS的移动办公业务1(开通短信、彩信通信能力),并在上次业务鉴权时有2个签约关系成员(zhixinyu138xxxxxxxx,zanghui139xxxxxxxx),同时订购基于MAS的移动办公业务2(开通WAP通信能力),且在上次业务鉴权时有3个签约关系成员(zhixinyu138xxxxxxxx,xiaoli134xxxxxxxx,xiaowang138xxxxxxxx),后来业务2删除了一个签约关系成员(xiaowang138xxxxxxxx),且增加了一个签约关系成员(xiaozhang135xxxxxxxx):
如业务1订购关系信息类型为“订购关系全量”,业务2订购关系信息类型为“订购关系全量”则BusiConfigInfo信息为:
812100010002:
2,3;zhixinyu138xxxxxxxx,zanghui139xxxxxxxx;
81210004:
3,3;zhixinyu138xxxxxxxx,xiaoli134xxxxxxxx,xiaozhang135xxxxxxxx;xiaowang138xxxxxxxx
如业务1订购关系信息类型为“订购关系全量”,业务2订购关系信息类型为“订购关系变量”则BusiConfigInfo信息为:
812100010002:
2,3;zhixinyu138xxxxxxxx,zanghui139xxxxxxxx;
81210004:
3,2;xiaozhang135xxxxxxxx;xiaowang138xxxxxxxx
如业务1订购关系信息类型为“订购关系全量”,业务2订购关系信息类型为“签约成员总数”则BusiConfigInfo信息为:
812100010002:
2,3;zhixinyu138xxxxxxxx,zanghui139xxxxxxxx;
81210004:
3,1
2.1.2业务鉴权响应
MAS统一服务平台向MAS服务器返回业务鉴权响应,响应包格式如下:
序号
父元素名称
元素名称
约束
类型
宽度
描述
1
MasManagermentInterface
Version
1
String
1.1
2
MasManagermentInterface
MsgType
1
String
BusiAuthenticRsp
3
MasManagermentInterface
SequenceID
1
String
序列号,从00000001到99999999
4
MasManagermentInterface
TimeStamp
1
String
时间戳,yyyymmddHHmmss
5
MasManagermentInterface
MASID
1
String
—
MAS的ID
6
MasManagermentInterface
UniMngrID
1
String
—
MAS统一服务平台的ID
7
MasManagermentInterface
BusiAuthResult
*
String
参见注释1
注释1:
订购编码中的业务类型和通信能力说明
业务类型定义:
CRM:
0001
SCM:
0002
ERP:
0003
OA:
0004
EMAIL:
0005
行业应用:
0006
其它:
0007
插件:
8xxx,基于MAS的移动办公为8121
通讯能力定义:
短信能力0001
彩信能力:
0002
USSD能力:
0003
WAP能力:
0004
LBS能力:
0005
PUSHMAIL能力:
0006
注释2:
BusiAuthResult中的每一项代表一个订购信息鉴权结果;该项格式为:
“订购编码(业务类型+通信能力):
鉴权结果;鉴权类型标志”,其中“订购编码”的格式及含义见订购信息鉴权请求中的相关说明,“鉴权结果”见注释3,“鉴权类型标志”规定MAS服务器在下一次鉴权时需采用的业务鉴权类型,MAS服务器收到业务鉴权响应信息后,需要根据其中的“鉴权类型标志”,在下次鉴权时发起相应类型的业务鉴权请求;
注释3:
鉴权结果定义:
成功:
1
失败(成员总数或明细不匹配):
2
失败(MAS统一服务平台无该业务相关签约成员信息):
3
鉴权类型标志定义:
签约成员总数:
1
订购关系增量:
2
订购关系全量:
3
鉴权响应举例1:
某个集团客户订购基于MAS的移动办公业务(开通所有通信能力),在上一次业务鉴权时有2个签约关系成员(zhixinyu138xxxxxxxx和zanghui139xxxxxxxx),后来新增加了1个签约关系成员(xiaowang138xxxxxxxx),当前共有3个签约关系成员:
如订购关系类型为“订购关系全量”则鉴权请求中的BusiConfigInfo信息为:
81219999:
3,3;zhixinyu138xxxxxxxx,zanghui139xxxxxxxx,xiaowang138xxxxxxxx;
若鉴权成功,且MAS统一服务平台要求下一次鉴权的鉴权类型为“订购关系全量”,则鉴权响应为:
81219999:
1;3
若鉴权成功,且MAS统一服务平台要求下一次鉴权的鉴权类型为“订购关系增量”,则鉴权响应为:
81219999:
1;2
鉴权响应举例2:
某个集团客户订购基于MAS的移动办公业务1(开通短信、彩信通信能力),并在上次业务鉴权时有2个签约关系成员(zhixinyu138xxxxxxxx,zanghui139xxxxxxxx),同时订购基于MAS的移动办公业务2(开通WAP通信能力),且在上次业务鉴权时有3个签约关系成员(zhixinyu138xxxxxxxx,xiaoli134xxxxxxxx,xiaowang138xxxxxxxx),后来业务2删除了一个签约关系成员(xiaowang138xxxxxxxx),且增加了一个签约关系成员(xiaozhang135xxxxxxxx):
如业务1订购关系信息类型为“订购关系全量”,业务2订购关系信息类型为“订购关系全量”则鉴权请求中的BusiConfigInfo信息为:
812100010002:
2,3;zhixinyu138xxxxxxxx,zanghui139xxxxxxxx;
若鉴权成功,且MAS统一服务平台要求下一次鉴权的鉴权类型为“订购关系增量”,则鉴权响应为:
812100010002:
1;2
81210004:
1;2
若鉴权成功,且MAS统一服务平台要求下一次鉴权的鉴权类型为“订购关系全量”,则鉴权响应为:
812100010002:
1;3
81210004:
1;3
若鉴权成功,且MAS统一服务平台要求下一次鉴权时,业务1的鉴权类型为“订购关系全量”,业务2的鉴权类型为“签约成员总数”,则鉴权响应为:
812100010002:
1;3
81210004:
1;1
2.2业务性能上报请求及响应
2.2.1业务性能上报请求
由MAS服务器在特定时刻向MAS统一服务平台发起。
序号
父元素名称
元素名称
约束
类型
宽度
描述
1
MasManagermentInterface
Version
1
String
1.1
2
MasManagermentInterface
MsgType
1
String
BusiSendReq
3
MasManagermentInterface
SequenceID
1
String
序列号,从00000001到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
Macaddress
1
String
MAS服务器上与MAS统一服务平台连接的网卡的MAC地址
10
MasManagermentInterface
BusicapaData
*
String
参见注释1
注释1:
BusicapaData
该项分为三个部分,每个部分之间用;号分割。
具体结构为:
性能数据编码;业务性能数据;统计的起始结束时间
第一部分“性能数据编码”的格式:
业务编码:
性能编码。
其中“业务编码”为业务类型(长度为4位)。
如业务编码8121代表移动OA;“性能编码”为业务的性能数据的代码组合。
如:
0001代表上传GPRS流量,0002表示上传业务的活跃用户数,00010002表示上传GPRS流量和业务的活跃用户数的组合,000200010003表示上传业务的活跃用户数,GPRS流量,开户用户数的组合。
在第二部分的‘业务性能数据’中多项业务性能数据的排列顺序按照‘性能数据的代码组合’进行排序。
具体的业务性能数据和其代码对应关系请见表一:
表一:
业务性能数据和其代码对应表
业务性能数据
代码
备注
GPRS流量
0001
单位为k
活跃用户数
0002
开户用户数
0003
短信成功发送条数
0004
彩信成功发送条数
0005
WAPPush成功发送条数
0006
LBS定位成功次数
0007
第二部分“业务性能数据”格式:
为多项“业务性能数据”的组合,各项业务性能数据之间用空格区分,如:
12k2030对应着第一部分中的“性能编码”的000100030002,表示:
GPRS流量为12k,开户用户数为30人,活跃用户数为20人,同样203012k对应着第一部分中的“性能编码”的000300020001,也表示:
GPRS流量为12k,开户用户数为30人,活跃用户数为20人,只是在该字段中各项业务性能数据的排列顺序不对。
第三部分格式:
为“统计的起始结束时间”,具体格式为:
yyyymmddHHmmss,yyyymmddHHmmss。
该时间的填写有两种情况:
第一种情况:
由上一次业务数据上报响应所规定。
即本次业务数据上报中的‘统计的起始结束时间’由上一次业务数据上报响应包中的数据决定。
第二种情况:
该种情况为由于网络等原因,未收到上次的业务数据上报响应数据包,此时“统计的起始结束时间”默认为两次业务鉴权间的时间段。
“业务数据上报请求”举例一:
8121:
000200030001;20301300k;20080429201230,20080429211230
表示需要上报移动办公业务在2008年4月29日20点12分30秒到2008年4月29日21点12分30秒间的活跃用户数、业务开户数、GPRS流量上传给统一服务平台,其中20301300k分别对应表示活跃用户数、业务开户数、GPRS流量,对应数据代码‘000200030001’。
“业务数据上报请求”举例二:
8121:
000300020001;30201300k;20080429201230,20080429211230
表示需要上报移动办公业务在2008年4月29日20点12分30秒到2008年4月29日21点12分30秒间的业务开户数、活跃用户数、GPRS流量上传给统一服务平台,其中30201300k分别对应表示业务开户数、活跃用户数、GPRS流量,对应数据代码‘000300020001’。
“业务数据上报请求”举例三:
8121:
000100020030004;1300k20301897;20080429201230,20080429211230
表示需要上报移动办公业务在2008年4月29日20点12分30秒到2008年4月29日21点12分30秒间的‘GPRS流量、活跃用户数、业务开户数、发送成功的短信数’,上传给统一服务平台,其中300k20301897分别对应表示GPRS流量、活跃用户数、业务开户数、发送成功的短信数,对应数据代码‘0001000200030004’。
2.2.2业务性能上报响应
MAS统一服务平台收到MAS服务器发出的业务性能上报后,返回响应给MAS服务器。
序号
父元素名称
元素名称
约束
类型
宽度
描述
1
MasManagermentInterface
Version
1
String
1.1
2
MasManagermentInterface
MsgType
1
String
BusiSendRsp
3
MasManagermentInterface
SequenceID
1
String
序列号,从00000001到99999999
4
MasManagermentInterface
TimeStamp
1
String
时间戳,yyyymmddHHmmss
5
MasManagermentInterface
MASID
1
String
—
MAS的ID
6
MasManagermentInterface
UniMngrID
1
String
—
MAS统一服务平台的ID
7
MasManagermentInterface
BusiRecResult
1
String
如果成功接收,返回true,否则返回false。
7
MasManagermentInterface
AddBusiValue
*
String
参见注释1
注释1:
AddBusiValue该项格式为:
“性能数据编码:
下次业务性能上报的统计的起始结束时间”
举例一:
8121:
000100020003:
20080429201230,20080429211230
表示移动办公业务在下次业务数据上报时,需要将2008年4月29日20点12分30秒到2008年4月29日20点12分30秒间内的GPRS流量、活跃用户数和开户用户数数据上传给统一服务平台。
2.3其他说明
2.3.1业务鉴权和业务性能上报时间
若某MAS服务器所在集团客户开通移动办公业务,MAS服务器需要向MAS统一服务平台发起业务鉴权和业务性能数据上报,业务鉴权和业务性能数据上报时间周期和时间点与服务器的认证鉴权一致,先进行服务器认证鉴权,再进行业务性能数据上报,最后进行业务鉴权;
如某MAS服务器所在集团客户未开通移动办公业务,该MAS服务器无须向MAS统一服务平台发起业务鉴权和业务性能数据上报。
2.3.2业务鉴权消息包大小
若某MAS服务器向MAS统一服务平台发起的业务鉴权中有签约关系明细信息且签约明细条数大于一千,则须分多次向MAS统一服务平台发起业务鉴权,多次鉴权中最后一次明细条数小于等于一千,其他鉴权明细等于一千,但每个鉴权信息包中的“签约成员总数”字段均须填写该业务中的签约成员总数量。
2.3.3MAS服务器对业务鉴权响应和业务性能上报响应消息的处理
MAS服务器对业务鉴权和业务性能上报平台响应结果信息只做日志记录,不做其他处理。
2.3.4首次业务鉴权时机和内容
MAS服务器启动后,按照启动流程先进行注册,之后进行服务器鉴权。
此后进行首次业务鉴权,为避免大量的订购关系信息对MAS服务平台的冲击,首次业务鉴权只上报签约成员总数,不上报明细,后续的业务鉴权上报信息则需根据MAS服务平台返回的响应指令确定。
3、MAS服务器与移动办公插件之间的接口扩展
为了更顺利地向二代MAS服务器过渡,MAS服务器与移动办公插件之间的接口采用Webservice方式。
移动办公插件必须具备web服务端,以便接收从MAS服务器发出的业务鉴权指令和性能上报时间通知。
3.1接口流程
接口包括三个操作:
APSvcAuthentic:
移动办公插件业务鉴权;
APSvcPerfCmd:
移动办公插件业务性能上报通知;
APSvcPerfReport:
移动办公插件业务性能上报。
MAS服务器要与MAS服务平台之间进行业务鉴权,对应的数据
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- MAS 服务器 支持 移动 办公 接口