Azure DevOps

Azure DevOps 通过 UiPath Azure DevOps 扩展程序与 Test Manager 集成，用于将工作项目同步为需求、缺陷和测试用例（可选）。

将 Azure DevOps 集成到 Test Manager，以支持您的测试管理工作、敏捷规划或缺陷跟踪。 通过此集成，您可以将工作项目同步到 Test Manager。

要将 Test Manager 实例连接到 Azure DevOps 项目，请执行以下操作：

1. 在 Azure DevOps 中创建项目
2. 配置 Azure DevOps 连接

先决条件

• Azure DevOps 帐户
• 分配权限以与服务挂钩集成
• Test Manager 管理员帐户
• An External Application registered in Automation Cloud, scoped to Test Manager. See Adding an external application. Without this, the connection fails immediately with an "Incorrect URL" error, even when the Server URL is formatted correctly.
• UiPath™ Test Manager Azure DevOps 扩展程序
• Azure Test Plans - to sync test items with your Test Manager. Test Plans access requires a separate Azure DevOps subscription add-on, licensed through Microsoft — it is not part of any UiPath license and cannot be requested through UiPath. Make sure to validate the integration scenario thoroughly. Consider the following limitations:
  • 无法同步断言。
  • 无法同步手动测试步骤。Azure DevOps 将测试步骤存储在 XML 字段 (Microsoft.VSTS.TCM.Steps) 中，其 REST API 不会将该字段公开为结构化数据 — 这是 Azure DevOps API 约束，而不是 Test Manager 限制。
  • 无法将测试执行设置为“已完成”状态，因为要并行同步结果，测试执行会在 Azure DevOps 中锁定。
  • Test Manager 和 Azure DevOps 中的项目范围有很大不同，因此需要详细规划对象路由。

在 Azure DevOps 中创建项目

使用敏捷工作项目流程创建 Azure DevOps 项目，以支持敏捷规划，并为工作项与 Test Manager 的同步提供目标。

1. 登录到 Azure DevOps。
2. 选择 Create new project（创建新项目）并配置项目设置：
   • 项目名称: 输入项目的名称。
   • Description: Add a description to help you easily identify the use of each project.
   • Version control: Choose your version control.
   • 工作项目流程：从下拉列表中选择“敏捷”作为默认流程，以支持您的敏捷规划方法，包括开发和测试活动。
3. 选择“创建”。

您的项目随即添加到集合中。

配置 Azure DevOps 连接

通过在 Test Manager 和 UiPath™ Azure DevOps 扩展程序中配置集成设置，设置 Test Manager 与 Azure DevOps 项目之间的连接。

Prerequisites（先决条件）：要在 Azure DevOps 上保存 UiPath® Test Manager 扩展程序，您必须是 Azure Administrator 用户。1. 以 Administrator 身份登录 Test Manager。2. 打开您的项目。3. 导航至 Project Settings（项目设置）> Integration（集成）。4.

选择 New Connection（新建连接），然后从下拉列表中选择 Azure DevOps。5. 配置以下连接设置：

• Name（名称）：输入 Azure DevOps 连接的名称。* Description（说明）（可选）：添加说明以供参考。* Server URL（服务器 URL）：添加 Azure DevOps 服务器 URL。例如：https://company-name-serverRegion.cloudapp.azure.com。

• 个人访问令牌：创建一个 PAT 并将其粘贴到此字段中，以授权 Test Manager 执行操作。:::警告：创建 Azure DevOps 连接时，PAT 需要对 Azure DevOps 服务具有完全访问权限。

为此，请在创建或编辑 PAT 时，在 Scopes（作用域）下选择 Full access（完全访问权限）。连接完成后，您可以将 PAT 作用域减少为：Test Management（测试管理）- Read & Write 和 Work Items（工作项）- Read & Write。有关更多信息，请参阅使用个人访问令牌。

:::

• Defect Type: Enter an object type used for bug reporting in Azure DevOps. Otherwise, leave empty if you do not want to use defect integration.

根据为新创建的 Azure DevOps 项目选择的对象类型输入缺陷类型。 例如： Bug或Issue 。

• Project Name: Enter your Azure DevOps project name.

6. 选择该连接以展开面板，并复制 API Key（API 密钥）以备后用。7. 在 Azure DevOps 中打开您的项目，然后转到 Project settings（项目设置）。8.在 Extensions（扩展程序）下，转到 UiPath® Test Manager。9. 配置以下扩展程序设置：

• 需求类型（需求类型）：选择要向其分配测试的对象类型。这些内容将在 Test Manager 中显示为需求。有关更多信息，请参阅要求。
• 服务器 URL ：添加 Test Manager URL。URL 应采用以下格式： https://cloud.uipath.com/{ {organizationName}/{tenantName}/testmanager _。
• API: Paste the API key.
• Manage Tests with Azure DevOps: Select this option to manage your tests through Azure DevOps. Otherwise, leave this option off, to manage your tests through Test Manager.

10. 选择“保存”。

    

使用 Azure DevOps 集成

要了解集成的工作原理，请考虑以下示例：

• 同步工作项目
• 通过 Azure DevOps 管理测试

同步工作项目

You can create work items (e.g. Epic) in Azure DevOps and synchronize them with Test Manager. The work items will show up on the Requirements page.

1. 登录到 Azure DevOps 并打开项目。
2. 选择 加号按钮，然后从下拉列表中选择 New work item（新建工作项）。
3. 配置您的工作项，然后选择 Save & Close（保存并关闭）。有关更多信息，请参阅添加和更新工作项。
4. 登录 Test Manager 并转到 Requirements（需求）以查看同步的工作项。要刷新页面，请选择 Requirements（需求）面包屑元素。
   备注：

   要同步在集成之前创建的工作项，请打开单个工作项，选择 Actions（操作）按钮，然后从下拉列表中选择 Push to Test Manager（推送到 Test Manager）。

通过 Azure DevOps 管理测试

您可以使用 Test Cloud 进行测试自动化，以及使用 Azure DevOps 进行测试管理。若要同时使用这两个解决方案，首先需要在集成配置中选择“使用 Azure DevOps 管理测试” 。有关详细信息，请参阅配置 Azure DevOps 连接。

现在，您可以通过将测试用例从 Azure DevOps 推送到 Test Manager 来管理测试。换句话说，系统会将类型为“测试用例”的全部 Azure 工作项目都将推送到 Test Manager。确保将测试用例添加到您的 Azure 测试计划中，因为这里是推送结果的目标位置。有关更多信息，请参阅创建测试计划和测试套件。

完成此同步后，您可以通过 Studio 自动化测试用例。之后，如果您使用 Orchestrator 执行测试用例，则系统会将结果推送到您的 Azure 测试计划。

Azure DevOps 数据流矩阵

下表总结通过原生 UiPath Azure DevOps 扩展程序在 Azure DevOps 和 Test Manager 之间同步哪些数据以及同步方向。此矩阵不适用于Test Manager Connect ，它通过 Planview® Hub 使用单独的同步机制。

Azure DevOps 对象/数据	方向	同步机制	注意/限制
工作项目（Epic、用户故事等）	Azure DevOps → Test Manager	保存时自动；将显示在“要求”页面上	集成之前创建的项目需要手动“推送到 Test Manager”操作
测试用例工作项目	Azure DevOps → Test Manager	需要在连接中启用“使用 Azure DevOps 管理测试”	必须将执行结果添加到 Azure 测试计划，否则执行结果无处可同步回
手动测试步骤（Microsoft.VSTS.TCM.Steps 字段）	未同步	—	Azure DevOps 将测试步骤存储为 XML 字段，其 REST API 不会公开为结构化数据——这是 Azure DevOps API 约束，而不是 Test Manager 限制
断言	未同步	—	根据 Azure 测试计划先决条件，无法同步
测试执行结果	Test Manager/Orchestrator → Azure DevOps 测试计划	自动化执行通过 Orchestrator 运行，并将结果推送到链接的 Azure 测试计划	无法在 Azure DevOps 中将执行设置为“已完成” — 它们保持解锁状态，因此结果可以保持并行同步
缺陷	Test Manager → Azure DevOps	从“执行”页面日志手动创建（ “创建缺陷” ）	每个项目一次只能为一个连接器启用缺陷同步

管理 Azure DevOps 连接

编辑 Azure DevOps 连接

编辑连接设置。

1. 以管理员身份登录 Test Manager。
2. 打开项目。
3. 选择 Settings（设置）按钮以打开“项目设置”。
4. 在集成列表中，选择 Azure DevOps 连接以展开面板。
5. 选择 Edit（编辑）以配置连接。
6. 选择“保存”以确认。

删除 Azure DevOps 连接

删除选定的连接及其关联的要求。

1. 以管理员身份登录 Test Manager。
2. 打开项目。
3. 选择 Settings（设置）按钮以打开“项目设置”。
4. 在集成列表中，选择 Azure DevOps 连接以展开面板。
5. 选择 Delete（删除）以移除连接。
6. 选择“确定”以确认。

相关文章

缺陷同步

结果

Azure DevOps 项目已连接到 Test Manager。工作项会作为需求进行同步，在 Test Manager 中创建的缺陷会同步回 Azure DevOps。