Xray for Jira

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

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

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

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

步骤 3：（仅限 Xray Cloud）配置自定义字段和屏幕

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

支持的对象

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

数据传输

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

• 从 Jira 同步的需求 → Test Manager
• 从 Xray 同步的测试用例 → Test Manager
• 从 Test Manager 同步的测试结果 → Xray
• 从 Test Manager 同步的缺陷 → Jira

先决条件

• 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

Install the UiPath® Test Manager for Jira app from the Atlassian Marketplace to enable the Xray integration between your Jira instance and Test Manager.

1. 以管理员身份登录 Jira。
2. 导航至“设置” > “管理Apps” 。
3. 转到“查找新应用程序” 。
4. 使用搜索栏查找适用于 Jira 的 UiPath™ Test Manager 。
5. Select Install to add the app to Jira.

配置 Xray 连接

Set up the Xray connection in Test Manager by entering your Jira server details and credentials so that requirements and test cases can be synchronized between Xray and Test Manager.

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

2. 打开项目。

3. Navigate to Project Settings > Integration.

4. Select New Connection and select XRay from the dropdown to edit the connection.

   

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. Select Save to add the connection. The Xray connection is added to the Integration list.

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 Cloud）

您需要配置一个名为UiPath Automation的Paragraph类型自定义字段，以将其与 Xray for Jira 中的屏幕相关联。 需要执行此步骤，以便您可以在 Xray for Jira 中查看测试用例自动化信息。

有关更多信息，请参阅自定义字段和屏幕配置。

编辑 Xray 连接

Update the configuration details of an existing Xray connection to reflect changes such as a new server URL, updated credentials, or a different project key.

1. 以管理员身份登录 Test Manager。
2. 打开项目。
3. Select the Settings button to open Project Settings.
4. In the Integration list, select an Xray connection to expand the panel.
5. Select Edit to configure the connection.
6. 选择“保存”以确认。

删除 Xray 连接

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

1. 以管理员身份登录 Test Manager。
2. 打开项目。
3. Select the Settings button to open Project Settings.
4. In the Integration list, select an Xray connection to expand the panel.
5. Select Delete to remove the connection.
6. Select Ok to confirm.

通过 Xray 管理测试

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

重要提示：

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

相关文章

缺陷同步

结果

The Xray for Jira project is connected to Test Manager. Requirements and test cases are synchronized from Xray to Test Manager, and test results and defects are synchronized from Test Manager back to Xray and Jira.