VA的WEB二次开发

发表于 2012-11-27 15:56:18

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。