益和VA虚拟应用管理平台的web服务与VA集群服务是集成在一起的,安装部署方便、安全性强。用户利用VA的Web功能调用,可以实现定制网页、在企业网站中进行集成、与现有应用集成,甚至企业IT平台的单点登录。
VA的web服务
VA的服务端自带嵌入式web服务,包括网页(登录页面、应用列表页面、下载页面等)以及类似 WebService 的功能调用。
Web页面
在浏览器地址栏输入 http:// 加服务器地址或域名,便会出现VA集群登录页面:
未安装客户端的用户可以下载并安装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
入口:
入口参数名 | 值 | 说明 |
Cmd | Login | 用户登录 |
UserName | VA集群用户名 | |
Password | VA集群登录密码 | |
UrlHost | 集群服务地址和端口号 | |
AuthType | 1 | 登录方式 |
Cmd | GetAppList | 获取应用列表 |
HasVaUrl | 1 | 含链接头信息(编码信息) |
HasDesc | 1 | 含应用的描述 |
SID | 登录成功返回的SID | |
Cmd | Logout | 用户注销 |
SID | 登录成功返回的SID |
返回值:ini文件格式。
实例
以集群 http://demo.eheva.com:600为例。
集群服务网址为 http://demo.eheva.com:600/Va/Dc.asp
1. 集群用户登录:
http://demo.eheva.com:600/Va/Dc.asp?Cmd=Login&UserName=eheuser&Password=123456&UrlHost=demo.eheva.com:600&AuthType=1
返回错误:
[Result]
SID={933B7BDE-4B93-47D9-8DD0-9082A53DAE4C}
Ret=User(user1) Login Error Errorcode(0/0)
UserID=
返回成功:
[Result]
SID={933B7BDE-4B93-47D9-8DD0-9082A53DAE4C}
Ret=OK
UserID={EC1426AA-4366-4024-B81E-D14411B62AE7}
2. 获得该用户可用应用程序列表:
http://demo.eheva.com:600/Va/Dc.asp?Cmd=GetAppList&HasVaUrl=1&HasDesc=1&SID={登录成功返回的SID}
返回值:
[Result]
SID={933B7BDE-4B93-47D9-8DD0-9082A53DAE4C} //登录成功返回的SID
Ret=OK
[AppList]
Count=2 // 2个应用
ID1={44AE97DE-33DC-4317-A9D3-4A9C5B9C5797} //第一个应用ID
Name1=记事本
Type1=10
PDir1=\ //应用程序路径
IconDatetime1=2011-08-12 11:24:26
ID2={491CB115-7989-4973-A678-61F123C36D6B} //第二个应用ID
Name2=记事本(2K8)
Type2=10
PDir2=\2K8专用
IconDatetime2=2011-07-26 10:54:41
[VAP]
VaHead=VA://GTnaC2VirfFPuPnLC56nnRZ7FOSRp5B7GQC5CfunrfBXERSTF5C__PCPIBRg-G2U_7bUajBRgR2V7YRuPGv7YvvZLeR75Mf1nMOSP9PVRPu7XIfS7EOZCMQuqqGOZtoQZtqfBNPu7tISV-iR-LSBRgC2SNPu7KIfRnc5aTI-__ufT_Jxn_5TTLSCRTvPRRNN
获得应用程序图标的路径是 /AppIcon/ 。例如上例中第一个应用程序(记事本)的图标地址:
http://demo.eheva.com:600/AppIcon/{44AE97DE-33DC-4317-A9D3-4A9C5B9C5797}.gif
3. 调用远程应用:
VA的客户端程序AR应用执行器在安装时,注册了 VA// 的协议http,因此网页地址为 VA// 打头的的URL系统会交给AR解释。
要调用远程应用程序,就要生成AR可识别的连接,由AR实现应用程序的远程调用。本例中执行第一个应用程序的URL为:
VA//GTnaC2VirfFPuPnLC56nnRZ7FOSRp5B7GQC5CfunrfBXERSTF5C__PCPIBRg-G2U_7bUajBRgR2V7YRuPGv7YvvZLeR75Mf1nMOSP9PVRPu7XIfS7EOZCMQuqqGOZtoQZtqfBNPu7tISV-iR-LSBRgC2SNPu7KIfRnc5aTI-__ufT_Jxn_5TTLSCRTvPRRNN&appid={44AE97DE-33DC-4317-A9D3-4A9C5B9C5797}
4. 集群用户注销:
http://demo.eheva.com:600/Va/Dc.asp?Cmd=Logout&SID={登录成功返回的SID}
5. 与现有应用集成的实施效果
本实例以与OA的集成为例,实施效果如下:
通过提供的集群用户登录接口,获取Login信息,获取一个SID码,并实现AR客户端单点登录,成功登陆后可获取一个UserID。
根据列表接口以及获取的SID码获取AppList,并将得到的应用列表显示在界面中,界面中应用对应的图标根据对应程序的ID以及路径/AppIcon/进行获取。
技术支持
为方便用户,公司提供asp、php、asp.net、java 等主流开发平台的Demo脚本,可以向公司技服人员索取。