Xray for Jira

The Xray Test Management for Jira integration provides an alternative to managing your tests using the Test Manager. To take advantage of this, you need to install the Jira connector and complete the integration by configuring a new connection in the Test Manager.

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

Step 1: Install UiPath® Test Manager for Jira

Step 2: Configure Xray connection in Test Manager

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

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

支持的对象

• Items synchronized from Xray for Jira to Test Manager are read-only except for attachments, object labels and test case links.
• Defects are synchronized from test executions in Test Manager to Xray for Jira.

数据传输

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

Xray for Jira	方向	UiPath Test Manager
要求	→	要求
测试用例	→	测试用例
缺陷	←	缺陷

先决条件

• Jira 服务器帐户
• UiPath® Test Manager for Jira Server and Jira Data Center - required for Xray for Jira Server and Jira Data Center integration.
• UiPath® Test Manager for Jira Cloud - required for Xray for Jira Cloud integration.

Install UiPath® Test Manager for Jira

1. 以管理员身份登录 Jira。
2. 导航到 “设置” >“ 管理应用程序”。
3. 转到“ 查找新应用程序” 。
4. Use the search bar to find UiPath® Test Manager for Jira.
5. 单击“ 安装 ”，将应用程序添加到 Jira。

配置 Xray 连接

1. Log in to Test Manager as an administrator.
2. 打开项目。
3. 导航到 “项目设置” >“ 集成”。
4. 单击 “新建连接” ，然后从下拉列表中选择“ XRay ”以编辑连接。
   
   

   

   
   
5. 配置如下：
   • 名称：输入项目的名称。
   • 说明 （可选）：添加说明。
   • 服务器 URL：添加 Jira 服务器 URL，包括端口号。 这是公开 Jira REST API 的服务器的 URL。 它通常与通过浏览器使用 Jira 时导航到的 URL 相同。 例如： https://company-name.atlassian.net 。
   • 网页 URL （可选）：添加网页 URL，以防服务器 URL 的托管地址与用于访问 Jira 资源的网页 URL 不同。
   • 用户名 ：用于对 Jira API 进行身份验证的用户名。
   • 密码 （仅限 Xray 服务器）：用于对 Jira API 进行身份验证的密码。
   • 项目密钥：输入 Jira 中的项目密钥，该密钥是指要集成的项目。
   • API 令牌 （仅限 Xray Cloud）： 生成 API 令牌。 有关 Atlassian API 令牌的更多信息，请参阅 管理 Atlassian 帐户的 API 令牌。
   • 客户端 ID （仅限 Xray Cloud）： 创建包含客户端 ID 和客户端密码的 API 密钥。 您需要是 Jira 管理员才能执行此操作。 输入在 Jira Software 中生成的客户端 ID。
   • 客户端密码 （仅限 Xray Cloud）：输入在 Jira Software 中生成的客户端密码。
6. 单击“ 保存 ”以添加连接。 Xray 连接随即添加到“集成”列表中。
7. 复制 API 密钥。
8. Open Jira and navigate to Project Settings > UiPath® Test Manager.
9. 配置项目设置并将 API 密钥粘贴到“ API 密钥 - XRay 集成 ” 字段中。
   
   

   

   
   

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

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

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

编辑 Xray 连接

1. Log in to the Test Manager as an administrator.
2. 打开项目。
3. 单击“ 设置” 按钮以打开“项目设置”。
4. 在“集成” 列表中，单击 Xray 连接以展开面板。
5. 单击“ 编辑 ”以配置连接。
6. 单击“保存”以确认。

删除 Xray 连接

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

1. Log in to the Test Manager as an administrator.
2. 打开项目。
3. 单击“ 设置” 按钮以打开“项目设置”。
4. 在“集成” 列表中，单击 Xray 连接以展开面板。
5. 单击“ 删除 ”以删除连接。
6. 单击“确定”以确认。

通过 Xray 管理测试

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

重要提示：

• Test cases edited in the Test Manager are not synchronized with Xray. Conversely, changes made to test cases in Xray are reflected in the Test Manager.

相关文章

缺陷同步