Integration with Xray test management for Jira

When you use Jira as a change management system on HCL DevOps Test Hub (Test Hub) and you use Xray as the test management application in Jira, you can integrate Xray with Test Hub. With this integration, you can export the test results of the tests that run on Test Hub to your Jira project. You can then view and use the test results in your project in Jira.

Prerequisites

Before you integrate Xray with Test Hub, you must have completed the following tasks:
  • Configured Jira as a change management system on Test Hub. See Configuration of Atlassian Jira as a change management.
  • Installed the Xray test management app in Jira.
    Note: The Xray integration is supported only when the Xray test management application is installed on a Jira cloud.
  • Ensured that you obtained the access and authentication details to Jira from the Jira administrator.
  • Ensured that you are assigned a role as a Project Owner or Tester in the project. See Managing access to the server projects.
  • Created a project in your team space in Test Hub. See Adding a project.

Task flow

You can follow the tasks that are listed in the following table when you want to export test results to your Xray test project in Jira. The table also provides you the links to the information about the tasks.
Task Go to...
Generate the Xray API keys for your username on Jira. Generating API keys for the Xray app in Jira
Use the generated Xray API keys to configure the Xray integration in Test Hub. Configuring the Xray integration
Select an issue in your Xray project in Jira as a location to export the test results of a test run. You must select the issue while you configure a test run on Test Hub. Selecting a Jira Xray issue to export test results

You can manage the Xray settings that you configured in Test Hub. You can edit the saved configuration or you can delete the configuration. For more information, see Managing the Xray configuration.