Xray for Jira

Xray for Jira 与 Test Manager 的集成作为替代测试管理方法，通过安装连接器并设置新连接进行配置。

Xray Test Management for Jira 集成提供了使用 Test Manager 管理测试的替代方法。 要利用此功能，您需要安装 Jira 连接器，并通过在 Test Manager 中配置新连接来完成集成。

要将您的测试管理器实例连接到 XRay 项目，请按照以下步骤操作：

步骤 1：安装适用于 Jira 的 UiPath™ Test Manager

步骤 2：在 Test Manager 中配置 Xray 连接

支持的对象类型和数据传输方向

支持的对象

• 从适用于 Jira 的 Xray 同步到 Test Manager 的项目为只读项目，但附件、对象标签和测试用例链接除外。
• 缺陷会从 Test Manager 中的测试执行同步到适用于 Jira 的 Xray。

数据传输

下表列出了数据传输的方向和相应的对象：

Xray for Jira	方向	UiPath Test Manager
测试结果	→	测试结果
测试用例	→	测试用例

先决条件

• Jira 服务器帐户
• 适用于 Jira Server 和 Jira Data Center 的 UiPath™ Test Manager - 对于 Xray for Jira Server 和 Jira Data Center 集成而言为必要项。
• 适用于 Jira Cloud 的 UiPath™ Test Manager - 对于 Xray for Jira Cloud 集成而言为必要项。

安装适用于 Jira 的 UiPath™ Test Manager

从 Atlassian Marketplace 安装 UiPath® Test Manager for Jira 应用，以启用您的 Jira 实例与 Test Manager 之间的 Xray 集成。

1. 以管理员身份登录 Jira。
2. 导航至“设置” > “管理Apps” 。
3. 转到“查找新应用程序” 。
4. 使用搜索栏查找适用于 Jira 的 UiPath™ Test Manager 。
5. 选择 Install（安装）以将该应用添加到 Jira。

配置 Xray 连接

通过输入您的 Jira 服务器详细信息和凭据，在 Test Manager 中设置 Xray 连接，以便在 Xray 和 Test Manager 之间同步需求和测试用例。

1. 以管理员身份登录 Test Manager。

2. 打开项目。

3. Navigate to Project Settings > Integration.

4. 选择 New Connection（新建连接），然后从下拉列表中选择 XRay 以编辑连接。

   

5. 配置如下：

   • 名称：输入项目的名称。
   • Description (optional): Add a description.
   • Server URL: Add the Jira Server URL, including the port number. This is the URL of the server that exposes the Jira REST API. It is usually identical to the URL you navigate to when using Jira through your browser. For example: https://company-name.atlassian.net.
   • Web URL (optional): Add the web URL in case the server URL is not hosted under the same address as the web URL used to access Jira resources.
   • Username: The username you use to authenticate to the Jira API.
   • Password (Xray Server only): The password you use to authenticate to the Jira API.
   • Project Key: Enter the project key from Jira which refers to the project you want to integrate.
   • API 令牌（仅适用于 Xray Cloud）：生成 API 令牌。有关 Atlassian API 令牌的更多信息，请参阅管理 Atlassian 帐户的 API 令牌。
   • 客户端 ID （仅限 Xray Cloud）：创建包含 客户端 ID 和 客户端密码 的 API 密钥。您需要是 Jira 管理员才能执行此操作。输入在 Jira Software 中生成的客户端 ID。
   • Client Secret (Xray Cloud only): Enter the Client Secret generated in Jira Software.

6. 选择 Save（保存）以添加连接。会将 Xray 连接添加到集成列表中。

7. Copy the API Key.

8. 打开 Jira 并导航至“项目设置” > “UiPath™ Test Manager” 。

9. Configure project settings and paste the API key in the API Key - XRay Integration field.

   

编辑 Xray 连接

更新现有 Xray 连接的配置详细信息，以反映诸如新服务器 URL、更新的凭据或其他项目密钥等变化。

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

删除 Xray 连接

删除连接将删除所有关联的需求和测试用例。

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

通过 Xray 管理测试

通过 Orchestrator 执行的测试会将结果填充到 Xray。有关使用 Xray 管理测试的更多信息，请参阅 Xray 文档主页。

重要提示：

• 在 Test Manager 中编辑的测试用例不会与 Xray 同步。 相反，在 Xray 中对测试用例所做的更改会反映在 Test Manager 中。

相关文章

缺陷同步

结果

Xray for Jira 项目已连接到 Test Manager。需求和测试用例会从 Xray 同步到 Test Manager，测试结果和缺陷会从 Test Manager 同步回 Xray 和 Jira。