天翼VA虚拟应用管理平台的web服务与VA集群服务是集成在一起的,安装部署方便、安全性强。用户利用VA的Web功能调用,可以实现定制网页、在企业网站中进行集成、与现有应用集成,甚至企业IT平台的单点登录。
VA的web服务
VA的服务端自带嵌入式web服务,包括网页(登录页面、应用列表页面、下载页面等)以及类似 WebService 的功能调用。
Web页面
在浏览器地址栏输入http:// 加服务器地址或域名,便会出现VA集群登录页面:
http://192.168.1.88:666/(内网) ,注意,如果要外网访问,请用外网集群地址,如vatvd.ip.va01.cn,本处以内网地址演示
未安装客户端的用户可以下载并安装AR应用执行器:
登录成功后,得到该用户授权的应用列表页面:
点击页面上的应用图标,由AR执行远程接入应用(必须安装AR)。
功能调用
VA的Web功能调用包含了用户进行二次开发所需的三个方法,它们是:
1. 集群用户登录;
2. 获得集群用户授权的应用程序列表;
3. 集群用户注销。
二次开发原理
1. 调用VA集群web服务的通讯方式:遵循Http协议,用能够识别的URL参数或者Post参数的形式传递命令;
2. 返回数据的内容格式为ini文件格式;
3. 可以根据获得的应用程序数据,重新组织设计界面;
4. 生成AR可识别的连接,由AR实现应用程序的远程调用。
注意:客户端必须安装AR执行器
VA的web二次开发
参数列表
VA的web服务功能调用地址为:/VA/DC.ASP
入口:
返回值:ini文件格式。
实例
以集群http://192.168.1.88:666 为例。
集群服务网址为http://192.168.1.88:666/Va/Dc.asp
第一步,获取SID
1. 集群用户登录,在浏览器中输入以下地址:
http://192.168.1.88:666/Va/Dc.asp?Cmd=Login&UserName=admin&Password=admin&UrlHost=192.168.1.88:666&AuthType=1
注:这里的username为登录用户名, Password为当前用户密码, UrlHost为集群地址
返回成功:
[Result] | |
SID={7C2BCBF6-7CDF-4DC1-AA12-C498D5CA6A51} | |
Ret=OK | |
FarmVer=6.0.1.8037 | |
UserID={EC1426AA-4366-4024-B81E-D14411B62AE7} | |
UserFullName=admin | |
ArSetupVer=6.0.1.8035 | |
ArSetupURL=/download/AR_Setup.exe | |
RightRemoteCmd=0 |
这里我们得到SID为{7C2BCBF6-7CDF-4DC1-AA12-C498D5CA6A51}
第二步,获取应用ID
2. 获得该用户可用应用程序列表:
http://192.168.1.88:666/Va/Dc.asp?Cmd=GetAppList&HasVaUrl=1&HasDesc=1&SID={登录成功返回的SID}
那我们在浏览器中用以下地址来访问:
http://192.168.1.88:666/Va/Dc.asp?Cmd=GetAppList&HasVaUrl=1&HasDesc=1&SID={7C2BCBF6-7CDF-4DC1-AA12-C498D5CA6A51}
显示结果如下:
[Result] | |
SID={7C2BCBF6-7CDF-4DC1-AA12-C498D5CA6A51} | |
Ret=OK | |
[AppList] | |
Count=3 | |
ID1={44AE97DE-33DC-4317-A9D3-4A9C5B9C5797} | |
Name1=应用演示 | |
Type1=10 | |
PDir1=\ | |
IconDatetime1=2015-06-17 00:00:00 | |
Desc1= | |
ID2={6B5973EE-799C-4D1B-BDE0-4930F06A620B} | |
Name2=WindowsTextCopyer | |
Type2=10 | |
PDir2=\ | |
IconDatetime2=2015-06-17 09:00:34 | |
Desc2= | |
ID3={A235CE42-FBE4-4D61-B186-3C1941F06C35} | |
Name3=QQProtect | |
Type3=10 | |
PDir3=\ | |
IconDatetime3=2015-06-17 09:21:24 | |
Desc3= | |
[VAP] | |
VaHead=VA://GTnaC2VipRFLuRnLDP1npRn5DOS5CRFCGRTCmf1oBPB7q5B-BRSvAPS_IBRg-G2U_7bUajBRgK2SCrf1qmPZXjf6qqQB9MPZtPu7tI-7_DtVLGTpvEBRgC2SNPCu7KIfRNN |
在以上列表中,我们看到的是ID1,ID2,ID3,表示是3个应用,每个应用对应的ID
获得应用程序图标的路径是/AppIcon/ 。例如上例中第一个应用程序(应用演示)的图标地址:
http://192.168.1.88:666/AppIcon/{44AE97DE-33DC-4317-A9D3-4A9C5B9C5797}.gif
第三步,如何直接调用
3. 调用远程应用:
VA的客户端程序AR应用执行器在安装时,注册了VA// 的协议http,因此网页地址为 VA// 打头的的URL系统会交给AR解释。
要调用远程应用程序,就要生成AR可识别的连接,由AR实现应用程序的远程调用。本例中执行第一个应用程序的URL为:
复制上面的VAP代码,从va://开始
那么ID1的WEB执行地址为:
VA://GTnaC2VipRFLuRnLDP1npRn5DOS5CRFCGRTCmf1oBPB7q5B-BRSvAPS_IBRg-G2U_7bUajBRgK2SCrf1qmPZXjf6qqQB9MPZtPu7tI-7_DtVLGTpvEBRgC2SNPCu7KIfRNN&appid={44AE97DE-33DC-4317-A9D3-4A9C5B9C5797}
在VAP代码后加上:&appid={应用演示的id}
{44AE97DE-33DC-4317-A9D3-4A9C5B9C5797}为ID1(应用演示)
4. 集群用户注销:
http://192.168.1.88:666/Va/Dc.asp?Cmd=Logout&SID={登录成功返回的SID}
本例为:
http://192.168.1.88:666/Va/Dc.asp?Cmd=Logout&SID={7C2BCBF6-7CDF-4DC1-AA12-C498D5CA6A51}
5. 与现有应用集成的实施效果,集成进WEB
本实例以与OA的集成为例,实施效果如下:
通过提供的集群用户登录接口,获取Login信息,获取一个SID码,并实现AR客户端单点登录,成功登陆后可获取一个UserID。
链接代码如下:
<a href=" VA://GTnaC2VipRFLuRnLDP1npRn5DOS5CRFCGRTCmf1oBPB7q5B-BRSvAPS_IBRg-G2U_7bUajBRgK2SCrf1qmPZXjf6qqQB9MPZtPu7tI-7_DtVLGTpvEBRgC2SNPCu7KIfRNN&appid={44AE97DE-33DC-4317-A9D3-4A9C5B9C5797}
"><img src=" http://192.168.1.88:666/AppIcon/{44AE97DE-33DC-4317-A9D3-4A9C5B9C5797}.gif"></a>
根据列表接口以及获取的SID码获取AppList,并将得到的应用列表显示在界面中,界面中应用对应的图标根据对应程序的ID以及路径/AppIcon/进行获取。
技术支持
为方便用户,公司提供asp、php、asp.net、java 等主流开发平台的Demo脚本,可以向公司技服人员索取。