使用 Azure DevOps Server 或 Services 触发保存在 ALM 中的测试

本主题介绍如何运行保存在 ALM 中的 UFT One 测试。

备注: 本主题描述如何使用 UFT One Azure DevOps 扩展 版本 5.*。为了从最新功能中受益，建议将现有任务的版本更新到 5.*。使用此扩展版本时，请确保从 ADM-TFS-Extension GitHub 存储库安装了相应的 UFT.zip 文件。

先决条件:

在从 ALM 运行 UFT One 测试之前，您必须先设置与 ALM 的集成。

在 Azure DevOps Server 用于运行 UFT One 测试的计算机上，将这些步骤执行一次:

  1. 安装“ALM 连接”工具。

  2. 运行 ALM Client Registration。

有关执行这些步骤的信息，请参阅 ALM 帮助中心中有关安装 ALM 工具和插件的部分。

返回页首

运行保存在 ALM 中的测试

在 Azure DevOps Server 中，执行以下操作:

  1. 创建管道。(注: 如果您要使用 TFS，请跳过此步骤)

    1. 使用 Empty job 模板创建构建管道或发布管道。

      注: 构建管道是在您未显式创建发布管道时创建的管道类型。

    2. 选择包含要运行测试的代理的代理池。

    3. 在管道变量中，添加一个 UFT_LAUNCHER 变量。该变量的值应为 UFTWorking 文件夹的完整路径。

    有关更多详细信息，请参阅 Microsoft Azure 文档。

  2. 按照构建顺序在正确的位置添加 UFT One 任务或构建步骤:

    1. 在“任务”目录中，选择“测试”选项卡以查看所有可用测试任务的列表。

    2. 选择“UFT One ALM 运行”任务，然后单击“添加”。添加的空白新任务将作为构建计划的一部分。

  3. 为任务提供以下详细信息:

    显示名称 (可选)

    默认情况下，Azure DevOps Server CI 系统将使用任务的预设描述符。

    为步骤提供更有意义的名称。

    ALM 服务器

    保存测试的 ALM 服务器。使用以下语法:

    http://<ALM 服务器名称> 或 IP:端口/qcbin

    您可能还需要使用通用注册模式连接到 ALM。

    在这种情况下，请按以下格式输入 URL:“http://<ALM 服务器名称>”或 IP:端口/qcbin/start_a.jsp?common=true。

    ALM 凭据

    根据 ALM 服务器所需的身份验证类型，凭据可以是用户名和密码或用于 SSO 身份验证的 API 密钥。

    • 用户名和密码:

      用户名: 用于访问服务器的 ALM 用户名。

      密码: 上面指定的 ALM 用户的密码。

    • SSO 身份验证:

      选择“启用 SSO”。

      输入您从 ALM 站点管理员处获得的“客户端 ID”和“API 密钥”。

    确保此任务中指定的 ALM 用户或客户端具有打开和运行 UFT One 测试的正确权限。

    有关权限的详细信息，请参阅 ALM 帮助中心。

    域存储包含测试的项目的 ALM 服务器中的域。
    项目包含测试的项目。
    测试集

    使用此构建任务运行的测试集。提供这些测试集的完整 ALM 路径。

    此字段中的每一行都可以包含测试集或文件夹。

    注: 输入测试集的路径时，是否指定根文件夹无关紧要。

    超时

    无法打开或运行测试时要等待的时间 (以秒为单位)。

    如果该字段留空，则不存在超时。

    时间戳模式

    在“扩展”选项卡中定义用于报告的时间戳字段的值格式。

    默认值为 yyyy-MM-dd HH:mm:ss。

    运行模式

    运行测试集的计算机。选项包括:

    • 本地运行 (默认) - 在代理计算机上运行测试。
    • 远程运行 - 在您在“测试工具主机”中指定的主机上运行测试。
    • 在计划的主机上运行 - 在计划的主机上运行测试，如 ALM 中定义。
    测试工具主机

    选择运行测试集的主机的名称。

    注: 远程运行运行模式需要。否则无关。

    要隐藏诸如 ALM 密码或 SSO 凭据等信息，请为此信息定义 Azure 任务变量并将其锁定:

    1. 创建变量: 

      在任务的“变量”选项卡中，为要隐藏其值的每个字段添加一个变量。

      输入变量的值，选择锁定选项。

      提示: (可选) 也可以选择“在队列时间可设置”，以在对内部版本进行排队时可以编辑此值。

      例如，创建一个 MyPassword 变量，然后输入您的 ALM 密码作为其值。

    2. 将变量链接到任务中的相关字段:

      在“任务”选项卡中，单击“链接设置”。

      在“要链接的设置”中，选择要链接到变量的字段，然后在“值”中输入 $(<变量名称>)。单击“链接”以完成该过程。

      例如，选择“密码”字段，然后输入 $(MyPassword)。

  4. (可选) 从“测试”选项卡中，添加“发布测试结果”任务或构建步骤以将测试结果发布到 Azure Pipelines。

    备注: 使用 UFT One Azure DevOps 扩展 2.0.3 或更高版本时支持此选项。

    为该步骤提供以下信息，以基于 UFT One 的 XML 运行结果报告创建 JUnit 报告:

    显示名称指定步骤名称。
    测试结果格式JUnit
    测试结果文件**/*.xml
    搜索文件夹

    提供文件夹的路径，该文件夹包含测试结果 XML 文件。

    使用以下格式: 

    在构建管道中: <UFTWorking\res 文件夹的路径>\Report_$(Build.BuildNumber)

    在发布管道中: <UFTWorking\res 文件夹的路径>\Report_$(Release.ReleaseID)

    测试运行标题

    指定报告的标题。

    如下在标题中使用环境变量，报告名称要基于管道名称和构建或版本号:

    在构建管道中: $(System.DefinitionName)_$(Build.BuildNumber)

    在发布管道中: $(System.DefinitionName)_$(Release.ReleaseID)

    这有助于检索有关 Azure DevOps 的报告。

  5. 为该步骤配置 CI 系统控制选项，包括:

    已启用指定是否应在此构建过程中运行步骤。
    出错时继续指示 CI 系统在此步骤出错时停止或继续构建。
    运行此任务指示 CI 系统何时运行此步骤。要在运行测试失败后发布结果，请选择“即使之前的任务失败，除非构建被取消”。

  6. 将您的管道设置为运行:

    构建管道: 保存管道并将其排队。

    发布管道: 创建版本并部署管道。

    当管道运行时，UFT One 测试作为您添加的任务的一部分运行。

    备注: 如果从 Azure DevOps Server 手动停止运行，则 UFT One 进程仍保持使用中状态，并且您无法通过连接到 ALM 来继续运行测试。

    要解决此问题，请手动停止 UFT.exe 和 UFTRemoteAgent.exe 进程，然后从 Azure DevOps Server 继续构建。

返回页首

查看测试结果

测试运行之后，可以通过以下方式查看运行结果: 

可视报告

在运行结果的“扩展”选项卡中，您可以看到包含以下部分的报告: 

  • “UFT 报告”部分显示测试运行状态。

  • “运行摘要”显示运行的测试数量以及每个状态的百分比。

备注: 如果您正在使用发布管道，则这些结果可在“阶段”级别获得。

JUnit 测试结果报告

如果已添加“发布测试结果”步骤，可以在运行结果的“测试”选项卡上查看 JUnit 结果。

指向 ALM 上保存的运行结果的链接 (如果您从 TFS 运行测试)

UFT One 会自动将指向 ALM 上的运行结果的链接保存为构建项目。

在运行结果的“摘要”选项卡上查看此链接。

例如:

返回页首

另请参见: