- Getting started
- Project management
- Documents
- Working with Change Impact Analysis
- Create test cases
- Assigning test cases to requirements
- Cloning test cases
- Exporting test cases
- Linking test cases in Studio to Test Manager
- Delete test cases
- Manual test cases
- Importing manual test cases
- Document test cases with Task Capture
- Parameters
- Enabling governance at project level
- Disabling governance at project level
- Enabling governance at test-case level
- Disabling governance at test-case level
- Managing approvers for governed test cases
- Managing governed test cases in the In Work state
- Managing governeed test cases in the In Review state
- Managing governed objects in the Signed state
- Managing comments for governed test cases
- Applying filters and views
- Importing Orchestrator test sets
- Creating test sets
- Adding test cases to a test set
- Assigning default users in test set execution
- Enabling activity coverage
- Enabling Healing Agent
- Configuring test sets for specific execution folders and robots
- Overriding parameters
- Cloning test sets
- Exporting test sets
- Applying filters and views
- Accessibility testing for Test Cloud
- Searching with Autopilot
- Project operations and utilities
- Test Manager settings
- ALM tool integration
- API integration
- Troubleshooting
Test Manager user guide
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.
To connect your Test Manager instance to an XRay project follow these procedures:
Supported object types and data transfer direction
Supported objects
- 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.
Data transfer
The direction of data transfer and corresponding objects are listed below:
- Requirements synchronized from Jira → Test Manager
- Test Cases synchronized from Xray → Test Manager
- Test Results synchronized from Test Manager → Xray
- Defects synchronized from Test Manager → Jira
Prerequisites
- Jira Server account
- 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
- Log in to Jira as an administrator.
- Navigate to Settings > Manage Apps.
- Go to Find new apps.
- Use the search bar to find UiPath® Test Manager for Jira.
- Click Install to add the app to Jira.
Configure Xray Connection
-
Log in to Test Manager as an administrator.
-
Open your project.
-
Navigate to Project Settings > Integration.
-
Click New Connection and select XRay from the dropdown to edit the connection.
-
Configure as follows:
- Name: Enter a name for your Xray project.
- 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 Token (Xray Cloud only): Generate an API token. For more information on Atlassian API tokens, see Manage API tokens for your Atlassian account.
- Client Id (Xray Cloud only): Create an API Key containing a Client Id and Client Secret. You need to be a Jira administrator to perform this action. Enter the Client Id generated in Jira Software.
- Client Secret (Xray Cloud only): Enter the Client Secret generated in Jira Software.
-
Click Save to add the connection. The Xray connection is added to the Integration list.
-
Copy the API Key.
-
Open Jira and navigate to Project Settings > UiPath® Test Manager.
-
Configure project settings and paste the API key in the API Key - XRay Integration field.
Configure Custom Field and Screens (Xray Cloud Only)
You need to configure a custom field of type Paragraph, named UiPath Automation to associate it with screens in Xray for Jira. This step is needed so you can view test case automation information in Xray for Jira.
For more information, see Custom Fields and Screen Configuration.
Editing an Xray Connection
- Log in to the Test Manager as an administrator.
- Open your project.
- Click the Settings button to open Project Settings.
- In the Integration list, click an Xray connection to expand the panel.
- Click Edit to configure the connection.
- Click Save to confirm.
Deleting an Xray Connection
Deleting the connection removes all associated requirements and test cases.
- Log in to the Test Manager as an administrator.
- Open your project.
- Click the Settings button to open Project Settings.
- In the Integration list, click an Xray connection to expand the panel.
- Click Delete to remove the connection.
- Click Ok to confirm.
Managing Tests Via Xray
The tests executed through the Orchestrator propagate the results to Xray. For more information on managing tests using Xray, see the Xray Documentation Home.
- 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.
Related articles