IBM Rational Quality Manager集成

Rational Quality Manager 是 IBM 公司的一个测试管理工具。Squish 测试可以通过执行适配器（Squish 适配器）从 Rational Quality Manager 中启动。Squish 适配器是一个单独的应用程序，必须在 Rational Quality Manager 并行执行。它可以在不同于服务器的系统上执行，并需要注册到服务器上。Squish 适配器本身必须根据服务器和它应该使用的 Squish 安装进行配置。

安装 Squish 适配器

要安装适配器，请将 tar.gz 或 zip 归档提取到您选择的目录中。适配器可以安装在可以连接到 Rational Quality Manager 服务器的任何系统上。Rational Quality Manager 和 Squish 适配器可以安装在同一系统上。

Squish 适配器概念

Rational Quality Manager 中的测试脚本资源用于选择和配置将执行 Squish 测试的 Squish 适配器。测试脚本资源必须指定一个配置文件名和要执行的 Squish 测试。配置文件必须至少包含 Squish 测试套件可以找到的目录的基路径。

Squish 适配器在其启动期间可以选择的配置文件目录中查找配置文件。这样，您就不需要更改测试脚本以在另一台机器上运行适配器。您只需要为每台机器适应配置文件。

准备测试配置文件

Squish 适配器在执行测试时使用测试配置文件。测试配置文件是一个包含属性及其值的简单文本文件，具有 .conf 文件扩展名。适配器在启动时通过 -configDir 参数配置的目录中寻找配置文件。

启动 Squish 适配器

先决条件

作为先决条件，必须安装 Java 1.5 或更高版本。Java 可执行文件必须可通过系统的可执行搜索路径访问。由于 Squish 适配器使用 Python 脚本将 Squish XML 结果转换为 HTML，因此还必须在可执行搜索路径中提供 Python 版本 2.4、2.5、2.6 或 2.7。

概述

要启动 Squish 适配器，必须运行启动脚本。传递给此脚本的命令行参数将自动写入 Squish 适配器安装目录中的配置文件 Config.ini。因此，在第一次运行时必须指定一些命令行参数。传递给启动脚本的所有参数对于 Windows 和 Linux 都是相同的。对于 Windows，启动脚本命名为 start.bat，对于 Linux，它名为 start.sh。以下示例使用了 start.bat

start.bat -repository https://<hostname>:<port>/<qm> -user <userid> -userFile <filename> -password <password> -passwordFile <filename> -squishDir <directory> -configDir <directory> -projectArea <name>

上述概述中提到的各个参数的准确含义如下

• -repository https://hostname:port/qm：RQM 服务器的主机名/IP、RQM 服务器运行所在的端口，以及 Rational Quality Manager 的上下文根（默认为 qm，但可以进行自定义）。
• -user userid：在 RQM 内部具有运行适配器许可证的注册用户 ID。
• -userFile filename：如果用户 ID 包含非ASCII字符，则必须将其写入UTF-8 编码的文件作为单行。仅在 Windows 上运行 Squish 适配器的第一次启动时需要此操作。
• -password password：使用的用户 ID 密码。
• -passwordFile filename：如果密码包含非ASCII字符，则必须将其写入UTF-8 编码的文件作为单行。仅在 Windows 上运行 Squish 适配器的第一次启动时需要此操作。
• -squishDir directory：Squish 安装的目录路径。
• -configDir directory：适配器应查找测试配置文件的路径。
• -projectArea name：正在登录的项目名称或别名。默认值为 QualityManager。

Squish 适配器的完整选项可以在随 tar.gz 和 zip 文件提供的 readme.txt 文件中找到。

示例：启动 RQM 服务器

该示例显示适配器连接到在端口 9443 上运行的 RQM 服务器 192.168.1.42，使用默认的上下文根 qm。使用用户 bert 和密码 xxxyz 登录到项目区域 froglogic。Squish 安装在 C:\Squish 上，配置文件在 C:\SquishAdapterConfigs 中查找。

start.bat -repository https://192.168.1.42:9443/qm -user bert -password xxxyz -squishDir C:\Squish -configDir C:\SquishAdapterConfigs -projectArea froglogic

重新启动 Squish 适配器

第一次运行后，Squish 适配器将从位于 Squish 适配器安装目录内的 Config.ini 文件中读取其配置。因此，启动适配器无需提供任何命令行参数。

从 Rational Quality Manager 使用 Squish 适配器

为了通过 Rational Quality Manager 准备执行 Squish 测试，请创建一个测试脚本资源。

1. 登录 Rational Quality Manager。
2. 打开应该创建测试的项目。
3. 选择 构建 > 创建测试脚本。

这会创建一个新的测试脚本。现在选择用于测试运行的 Squish 适配器，并按以下方式配置它

1. 选择 类型 > 命令行。

   

2. 选择 使用测试机器本地的测试资源，然后单击 选择适配器。

   

3. 从列表中选择 Squish 适配器，然后单击 下一步。

   

4. 在 项目路径 字段中输入 Squish，然后单击 转到。然后选择用于测试运行的配置文件，最后单击 完成。

   

5. 在 参数 字段中，指定要从本测试脚本运行的那个测试套件和测试用例。

   

6. 单击 保存 保存测试脚本。

执行测试脚本

执行测试脚本超出了本文档的范围。在 Rational Quality Manager 手册中有不同的执行测试脚本的方法描述。

可以通过 Rational Quality Manager 提供的测试执行记录访问测试脚本运行的成果。记录显示了测试运行的总体结果，并包含日志文件的更详细信息。日志文件可在 结果详细信息 下找到。

Squish 适配器如果执行的任何测试验证失败，将会将执行结果标记为 失败。如果发生错误，执行结果将被标记为 错误。如果所有测试验证都通过，则将结果设置为 通过。