VAPI-XP 测试

VAPI-XP 测试工具允许您使用 Microsoft VBScript、Microsoft JavaScript（JScript 版本）、PerlScript 和 PythonScript 新建测试脚本，并将这些脚本集成到应用程序管理过程中。

在本主题中︰

VAPI-XP 概述

使用 VAPI-XP 测试脚本，可以测试 COM/DCOM 服务器、基于 SOAP 的 Web Service、Java API（比如 Java 类和 EJB）和控制台应用程序。还可以使用 VAPI-XP 创建 LoadRunner 虚拟用户。

此外，VAPI-XP 与 OpenText Application Quality Management 完全集成，使您能够设计调用任何 OpenText Application Quality Management 测试或测试集的 VAPI-XP 测试脚本，并将其作为您自己的脚本的一部分执行。这允许您生成更高级的测试集执行流，可以在执行期间根据每个测试的状态或类型筛选测试集中的测试。

VAPI-XP 还与 OpenText Application Quality Management Open Test Architecture API 完全集成。所有 Open Test Architecture API 类和方法都可以从 VAPI-XP 用户界面引用，从而可以方便地将其包括在测试脚本中。

Note: 通过执行 ALM 客户端注册，可以将 VAPI-XP 测试工具安装在测试主机上。Application Lifecycle Management 安装和升级指南 中提供了有关执行客户端注册的说明。

返回页首

创建 VAPI-XP 测试脚本

从“测试计划”模块的测试计划树中创建 VAPI-XP 测试脚本。

Note: 还可以将手动测试转换成 VAPI-XP 测试。在“设计步骤”选项卡中，单击“生成脚本”按钮 并选择 VAPI-XP-TEST。OpenText Application Quality Management 会创建包括所定义步骤的代码的 VAPI-XP 测试脚本。它还包括作为原始手动测试一部分调用的测试的代码。有关手动测试的详细信息，请参见设计测试。

要创建 VAPI-XP 测试脚本：

  1. 请参阅创建测试以创建测试，并确保“类型”字段设置为“VAPI-XP-TEST”。

  2. 在“VAPI-XP 向导”对话框中，指定以下内容，然后单击“下一步”。

    Note: 在每个对话框中，都可以单击“完成”以关闭向导，并继续在“测试脚本”选项卡中创建测试脚本。

    字段 描述
    脚本语言

    选择脚本语言。

    注:

    • 要使用 ActiveState 的 ActivePython 或 ActivePerl 脚本创建 VAPI-XP 测试脚本，必须在计算机上安装该脚本语言。从“测试脚本”选项卡的帮助菜单中，选择 ActivePython 主页或 ActivePerl 主页，并按相应安装说明进行操作。

    • Microsoft 的 VBScript 和 JScript 通常与 Internet Explorer 一起安装。如果您的计算机上未安装这些脚本语言，请从“测试脚本”选项卡的帮助菜单中选择 VBScript 主页或 JScript 主页，并按相应安装说明进行操作。
    脚本名称 输入 VAPI-XP 测试脚本的名称。
    创建 LoadRunner Vuser

    当您选择 VBScript 或 JavaScript 作为测试脚本语言时启用。

    创建可在 LoadRunner Controller 中运行的 LoadRunner 虚拟用户脚本。

    要在 Controller 中运行此虚拟用户，必须在 LoadRunner 客户端计算机上安装最新版本的 ALM 连接插件。有关详细信息，请参阅工具。

  3. 在向导的“选择测试类型”步骤中，选择要创建的测试类型，然后单击“下一步”。

  4. 如果选择了“COM/DCOM 服务器测试”测试类型，请选择要测试的 COM/DCOM 对象在机器注册表中的程序 ID，并单击 + 按钮。将显示每个选定的 COM/DCOM 对象及其描述。

  5. 如果您选择“Java 类测试”测试类型，请指定以下内容:

    字段 描述
    Java 类名

    输入要测试的 Java 类的全名，然后单击 + 按钮。输入的 Java 类名称将出现在文本框中。

    只能使用带有不使用参数的公共构造函数的 Java 类。
    如果您使用 Java 虚拟机，请指定以下内容:
    JVM 运行时 Java 虚拟机运行时可执行文件（通常是 java.exe）。
    Java 编译器

    在执行平台重新编译字节码的可执行文件（通常是 javac.exe）。
    类路径 运行指定 Java 应用程序时需要的其他（非标准）Java 库的列表，中间用分号 (;) 隔开。注意，如果不指定 Java 类路径，OpenText Application Quality Management 将使用环境变量 CLASSPATH。
    JVM 参数 Java 虚拟机运行时可执行文件的参数。

    Note: 使用 Java 虚拟机时，按以下方式将 BSF DLL 的位置添加到系统路径:

    1. 在“控制面板”中，选择系统 > 系统属性，然后单击高级选项卡。

    2. 单击“环境变量”按钮，在“系统变量”区域中，通过添加以下 DLL 的路径来编辑“路径”参数: msvcp60.dll、bsfactivescriptengine.dll 和 bsfactivescriptengine_g.dll。

    3. 单击“确定”。

  6. 如果您选择“Web 服务 (SOAP) 测试”测试类型，请指定以下内容:

    字段 描述
    SOAP 客户端库

    选择 SOAP 客户端库。

    支持两个 SOAP 客户端库: Microsoft SOAP SDK 和 PocketSOAP。即使选择使用 PocketSOAP，也必须安装 Microsoft SOAP SDK 才能解析 Web 服务。如果未在计算机上安装 Microsoft SOAP SDK，请运行 OpenText Application Quality Management 安装 DVD 上 Redist 目录中的 SoapToolkit30.exe 文件。
    Web 服务定义 输入或选择要测试的 URL，然后单击 + 按钮。

  7. 如果选择“控制台应用程序测试”测试类型，请指定以下内容并单击 + 按钮。

    字段 描述
    应用程序可执行文件 输入要测试的应用程序文件的名称。
    命令行参数 输入要测试的应用程序文件的参数。
    使用 VAPI-XP 输出而不是标准输出 是否要使用 VAPI-XP 输出窗口替换标准输出。
    应用程序超时

    输入 OpenText Application Quality Management 等待应用程序完成运行的时间 (以毫秒为单位)。注意，如果超时设置为 -1，则 OpenText Application Quality Management 将会一直等待到应用程序完成运行为止。

  8. 在“服务”列表中，选择要添加到测试脚本的函数。双击或拖放每个函数以将其添加到脚本代码。函数将添加到“服务”列表下面的框中。

  9. 必要时，输入其他参数或将其他代码添加到下窗格的脚本中。

  10. 单击完成。新测试将出现在测试计划树中选定的主题文件夹下面。

返回页首

编辑 VAPI-XP 测试脚本

使用 VAPI-XP 向导创建 VAPI-XP 测试脚本之后，可以在“测试脚本”选项卡中编辑该脚本。

Tip: 选择查看 > 窗口屏幕或单击窗口屏幕按钮 ，可以在单独窗口中显示“测试脚本”选项卡。

要编辑 VAPI-XP 测试脚本：

  1. 在测试计划树中选择 VAPI-XP 测试，并单击测试脚本选项卡。将显示测试脚本。

    2. Note: 要查看或编辑创建的测试脚本的属性，请选择测试 > 属性。

  2. 要查看可以添加到脚本的对象定义、方法和属性的列表，请选择以下选项之一：

    • 测试 > 引用 > COM 库引用。打开“引用”对话框，可以在其中选择要查看的 COM 对象定义、方法和属性。

    • 测试 > 引用 > SOAP Web Service 引用。打开“添加 Web Service 引用”对话框，可以在其中输入要查看的 Web Service 对象定义或方法。

    • 测试 > 引用 > Java 类引用。打开“添加 Java 类引用”对话框，可以在其中输入要查看的 Java 类对象定义或方法。

  3. 选择查看 > 浏览器，或单击显示/隐藏浏览器按钮 。将显示以下选项卡。

    选项卡 描述
    库

    显示可以添加到脚本的 VAPI-XP (SRunner)、OpenText Application Quality Management (TDAPIOLELib) 和 COM/DCOM 对象定义、方法及属性的列表。

    有关 VAPI-XP 对象定义、方法和属性的说明，请参见使用 VAPI-XP API。

    有关 OpenText Application Quality Management 对象定义、方法和属性的说明，请参阅Open Test Architecture API 参考。
    Soap

    显示可以添加到脚本的 Web Service 对象定义和方法的列表。
    Java

    显示可以添加到脚本的 Java 类对象定义和方法的列表。
    Function 显示脚本中包含的函数的列表。
    对象

    显示可以添加到脚本的已定义名称的对象列表。

    Note: 如需获取每个对象定义、方法或属性的描述，请选择查看 > 输出，并单击帮助选项卡。

  4. 要将对象定义、方法或属性添加到脚本中的当前函数，请将光标放在代码中相应位置，并双击库、Soap 或 Java 选项卡中的对象定义、方法或属性。

  5. 要添加对象并定义名称，请在库、Soap 或 Java 选项卡中选择对象定义、方法或属性，再选择“测试”>“添加对象”。在“添加对象”对话框中，输入要分配给对象的名称，并单击“确定”。

    6. 要将对象添加到脚本，请双击对象，或右键单击并选择插入到脚本中。

  6. 要检查代码语法，请选择“测试”>“检查语法”，或单击“语法检查”按钮 。选择查看 > 输出以在输出选项卡中查看验证结果。

  7. 在“测试脚本”选项卡中执行其他编辑功能:

    • 要撤消上一个操作，请单击“撤消”按钮 。要恢复撤消的操作，请单击“恢复”按钮 。

    • 要从脚本的一个部分删除代码段，并将其放置在脚本的另一个部分中，请选择代码段并依次单击“剪切”和“粘贴” 按钮。

    • 要从脚本的一个部分复制代码段，并将其放置在脚本的另一个部分中，请选择代码段并依次单击“复制”和“粘贴” 按钮。

    • 要删除代码段，请选择代码段并单击“删除”按钮 。

    • 要在脚本中找到特定文本，请单击“在脚本中查找”按钮 。在“查找文本”对话框中，输入要搜索的文本。选择搜索的选项、方向、范围和起点，并单击确定。

      要在脚本中查找下一处文本，请选择搜索 > 查找下一个。

    • 要在脚本中找到特定文本并用其他文本进行替换，请单击替换按钮 。在“查找文本”对话框中，在“要查找的文本”框中输入要搜索的文本。在“替换为”框中输入替换此文本的文本。选择搜索的选项、方向、范围和起点，并单击确定。要在脚本中替换文本的所有实例，请单击全部替换按钮。

    • 要在脚本中找到特定行号，请选择搜索 > 转到行号。在“转到行号”对话框中，输入要查找的行号并单击确定。

    • 要更改编辑器选项，比如边距、字体和屏幕/文本颜色，请单击“编辑器”按钮 。在“编辑器”、“显示”和“颜色”选项卡中设置所需属性，并单击确定。

  8. 完成脚本编辑之后，单击保存按钮 以保存变更。

返回页首

将 AUT 环境和 VAPI-XP 结合使用

版本: AUT 环境和功能测试集仅对 ALM 版本 可用。有关版本及其功能的信息，请参阅版本和生命周期。要了解您正在使用何种版本，请咨询站点管理员。

当 VAPI-XP 测试属于功能测试集的一部分时，可以使用服务器端执行运行它们。使用服务器端执行时，可以利用 AUT 环境。AUT 环境允许用户通过参数化用于测试的环境数据，使测试执行更具动态性。不需要定义和运行几个使用相同逻辑但需要不同环境参数的不同 VAPI-XP 测试，只需将 VAPI-XP 测试计划为使用已定义的 AUT 环境配置，ALM 就会在运行时将相关配置插入测试。

有关设置 AUT 环境配置和环境参数的信息，请参见实验室资源。

要在 VAPI-XP 脚本中使用 AUT 环境配置，请使用以下函数:

Post

在调用访问 AUT 参数的函数之前调用此函数。

currentRun.post()

getRunTimeParameterByName

基于参数名返回环境参数值。

currentRun.getRunTimeParameterByName(Name)

名称。环境参数名。
getRunTimeParameterByGuid

基于参数 Guid 返回环境参数值。

currentRun.getRunTimeParameterByGuid(Guid)

Guid。环境参数 Guid。
isSSE

如果作为功能测试集中的服务器端执行测试运行测试，则返回 TRUE。

currentRun.isSSE

ReservationId

如果作为功能测试集中的服务器端执行测试运行测试，则返回测试的时间段 ID。否则，返回 NULL。

currentRun.ReservationID

返回页首

使用 VAPI-XP API

VAPI-XP 工具包含可以在创建测试脚本时引用的内置 VAPI-XP 对象定义库。

TDHelper 对象

TDHelper 对象提供以下可用于执行 OpenText Application Quality Management 相关任务的函数。

Function 描述
RunTestSet

执行选定测试集，并返回累计的测试集执行状态。

RunTestSet([Name = "default"], [Filter = ""], [Locally = FALSE], [Host = ""], [HostGroup = ""])

名称。测试集名称。可选。默认值 = "default"

筛选。测试筛选。定义要运行的测试。如果为空，则指示 OpenText Application Quality Management 运行指定测试集中的所有测试。可选。默认值 = ""

Locally。如果设置为 TRUE，则指示 OpenText Application Quality Management 本地运行测试集。可选。默认值 = FALSE

Host。将运行测试集的主机。可选。默认值 = ""

HostGroup。将运行测试集的主机组。可选。默认值 = ""
RunTest

执行选定测试，并返回测试执行状态。

RunTest(Name, Instance, TestSet, [Locally = FALSE], [Host = ""], [HostGroup = ""])

名称。测试名称。

Instance。测试实例。

TestSet。测试集名称。

Locally。如果设置为 TRUE，则指示 OpenText Application Quality Management 本地运行测试集。可选。默认值 = FALSE

Host。将运行测试集的主机。可选。默认值 = ""

HostGroup。将运行测试集的主机组。可选。默认值 = ""
AddDefect

如果测试正在以调试模式运行，则将新缺陷添加到当前测试。如果测试正在以测试模式运行，则将新缺陷添加到当前测试集中测试实例的当前运行。返回创建的缺陷对象。

AddDefect([Fields], [stepKey])

Fields。二维数组 —— 第一维为字段名，第二维为字段值。可选。

stepKey。与新缺陷相关的步骤的步骤 ID。可选。
AddDefectUI

使用 OpenText Application Quality Management“新建缺陷”对话框，将新缺陷添加到当前测试 (在调试模式中) 或当前运行 (在测试模式中)。

AddDefectUI([stepKey])

stepKey。与新缺陷相关的步骤的步骤 ID。可选。
AddStepToRun

将新步骤添加到当前运行。返回创建的步骤对象。

AddStepToRun(Name, [Desc], [Expected], [Actual], [Status])

名称。步骤名。

Desc。步骤描述。可选。

Expected。预期步骤结果。可选。

Actual。实际步骤结果。可选。

Status。步骤状态。可选。
DownLoadAttachment

下载与测试对象关联的附件。返回执行下载的本地路径。

DownLoadAttachment(Name, item)

名称。附件名称。

item。附件关联的对象的参考。
UpLoadAttachment

上载附件并与测试对象关联。

UpLoadAttachment(path, item)

path。要上载的项目的本地路径（完全指定的文件名）。

item。附件关联的对象的参考。

TDInput 对象

TDInput 对象提供以下可用于从最终用户获取输入值的函数。

Function 描述
GetInput

显示“输入”对话框，允许您从最终用户处获取输入值。

GetInput([Caption],[Name])

Caption。对话框标题。可选。

名称。输入值的名称。可选。

TDOutput 对象

TDOutput 对象提供以下可用于控制 VAPI-XP 输出选项卡的函数。

Function 描述
Clear 方法

清除输出选项卡。

Clear

Print 方法

在输出选项卡中将文本消息打印到新行。

Print(Msg)

HookDebug 属性

设置或删除 OutputDebugString 选项卡 API 函数的挂钩。

HookDebug

Text 属性

获取或设置输出选项卡文本。

String Text

XTools 对象

XTools 对象提供以下可用于执行常规任务的函数。

Function 描述
run

用传递的属性运行命令行。

run(Command, [Args = ""], [Timeout = -1], [UseOutput = TRUE])

Command。应用程序可执行文件。

Args。应用程序参数。可选。默认值 = ""

Timeout。超时（以毫秒为单位）。如果值为 -1，则 OpenText Application Quality Management 会一直等待到应用程序完成运行为止。

UseOutput。如果为 TRUE，则 OpenText Application Quality Management 用 VAPI-XP 输出窗口替换标准输出。
WrapArray

从对象数组中创建变量数组。例如，如果调用的对象返回字符串数组作为方法结果，则所支持的脚本引擎均不能读取该数组。调用 WrapArray 函数并作为函数参数传递返回的数组，会创建脚本引擎能够理解的变量数组。

WrapArray (array)

array。要打包的数组。
Sleep

暂停执行指定时间的脚本。

Sleep(interval)

interval。脚本执行暂停的时间（以毫秒为单位）

返回页首

运行 VAPI-XP 测试

创建并编辑 VAPI-XP 测试脚本之后，可以采用调试模式或测试模式运行测试脚本。

概述

在运行 VAPI-XP 测试之前，请考虑以下事项:

以调试模式运行 VAPI-XP 测试

执行测试时无需将测试包括在测试集中，也无需在 OpenText Application Quality Management 项目中创建测试运行数据。

通常建议开发测试时使用调试模式，测试创建完成之后切换测试模式。
以调试模式运行 VAPI-XP 测试

在“测试实验室”模块中将测试添加到测试集之后，便可以采用测试模式运行 VAPI-XP 测试。

以测试模式运行 VAPI-XP 测试时，测试运行数据创建于 OpenText Application Quality Management 项目中。可以从测试计划模块或测试实验室模块中以测试模式运行 VAPI-XP 测试。

Note: 要远程运行 VAPI-XP 测试，必须在执行测试的主机计算机上安装 ALM 客户端注册插件和 ALM 连接插件。有关插件的详细信息，请参阅工具。

要以调试模式运行 VAPI-XP 测试：

  1. 在“测试计划”模块中，从测试计划树中选择 VAPI-XP 测试，并单击测试脚本选项卡。

  2. 选择“测试”>“执行 (调试模式)”，或单击“执行脚本”按钮 。OpenText Application Quality Management 开始执行选定测试脚本。

  3. 选择“查看”>“输出”以查看测试脚本生成的输出。

    • 要清除“输出”选项卡，请单击“清除输出”按钮 。

    • 要将输出文本复制到剪贴板，请选择文本并单击“将选定文本复制到剪贴板”按钮 。

    • 要在 Web 浏览器中查看测试脚本输出，请单击“在 Web 浏览器中打开输出文本”按钮 。

    • 要打印测试脚本输出，请单击“打印输出”按钮 。

  4. 要在 VAPI-XP 测试完成运行之前停止执行，请选择测试 > 停止，或单击停止按钮 。

要从测试计划模块中以测试模式运行 VAPI-XP 测试：

  1. 从测试计划树中选择 VAPI-XP 测试，并单击测试脚本选项卡。

  2. 选择测试 > 执行 (测试模式)。将打开“选择测试集”对话框。

  3. 在测试集框中，选择包含当前 VAPI-XP 测试的测试集。

  4. 在实例框中，选择要运行的测试实例。

  5. 在运行名称框中，输入要分配给测试运行的名称。

  6. 单击“确定”。OpenText Application Quality Management 开始执行选定测试。

  7. 要查看测试脚本生成的输出，请选择“查看”>“输出”。

  8. 要在 VAPI-XP 测试完成运行之前停止执行，请选择测试 > 停止，或单击停止按钮 。

要从测试实验室模块中以测试模式运行 VAPI-XP 测试：

  1. 从测试集选项卡中，选择包含要运行的 VAPI-XP 测试的测试集。

  2. 在执行网格中选择要运行的测试，并单击运行按钮。将打开“自动运行器”对话框，显示选定测试。

  3. 在运行于主机列中，选择运行 VAPI-XP 测试的主机计算机，或选择本地运行所有测试以在本地计算机上运行测试。

  4. 单击运行按钮。当 OpenText Application Quality Management 开始执行选定 VAPI-XP 测试时，将打开“VAPI-XP 测试脚本”窗口。OpenText Application Quality Management 完成测试执行时，“自动运行器”对话框将显示测试运行的状态。

返回页首

调试 VAPI-XP 测试脚本

如果测试运行未成功完成，则可以使用 VAPI-XP 的集成调试器协助您调试 VAPI-XP 测试脚本。

Note: 无法使用集成调试器调试 PerlScript 或 PythonScript 测试脚本。

要调试 VAPI-XP 测试脚本：

  1. 从测试计划树中选择 VAPI-XP 测试，并单击测试脚本选项卡。

  2. 选择“调试”>“集成调试器”。工具栏上将显示控制调试过程的额外按钮。

  3. 要在脚本中设置断点，请在脚本中选择要设置断点的行，并选择“调试”>“切换断点”，或单击“切换断点”按钮 。

    或者，在脚本中单击行旁边的灰色边距。选定行将以红色突出显示。

  4. 单击“执行脚本”按钮 。OpenText Application Quality Management 开始执行脚本，并在定义的断点处停止。“输出”选项卡将显示以下消息。

  5. 要指示 OpenText Application Quality Management 在断点之后输入脚本，请选择“调试”>“步入”，或单击“步入”按钮 。断点之后的脚本行将以蓝色突出显示。

  6. 要指示 OpenText Application Quality Management 跳过脚本中的行，请单击“步过”按钮 ，或选择“调试”>“步过”。

  7. 要指示 OpenText Application Quality Management 执行脚本，请选择“调试”>“步出”，或单击“步出”按钮 。输出将显示在输出选项卡中。

  8. 要查看或编辑脚本中每个变量的值，请选择“调试”>“变量”，或单击“显示变量”按钮 。

    将打开“变量”对话框，显示可用于当前脚本的变量。选择变量以查看其属性。

    要更改变量的值，请在“值”框中输入要分配给它的新值，然后单击“更新”。单击确定以保存变更，并关闭“变量”对话框。

  9. 要在调试时查看有关特定变量的信息，请选择“调试”>“监视”，或单击“显示监视窗口”按钮 以显示“监视”选项卡。

    要将变量添加到“监视”选项卡，请单击 +，在“提示”框中输入变量名称，然后单击“确定”。变量及其值将显示在“监视”选项卡中。

  10. 要指示 OpenText Application Quality Management 继续执行脚本，请选择“调试”>“继续执行”，或单击“继续执行”按钮 。

  11. 选择“调试”>“停止调试”，或单击“停止调试”按钮 可使集成调试器停止调试脚本。

返回页首