Atlassian Jira

Integrate your Atlassian Jira instance to Test Manager to add defect reports, and assign stories and requirements to your tests. The integration works with all Jira project types.

To integrate Jira to Test Manager, follow these procedures:

Step 1: Install UiPath® Test Manager for Jira

Step 2: Configure a a Jira connection

Step 3: Configure Jira project

Supported object types and data transfer direction

Supported objects

• Items synchronized from 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 Jira.

Data transfer

The direction of data transfer and corresponding objects are listed in the following table:

Xray for Jira	Direction	UiPath Test Manager
Requirements	→	Requirements
Test cases	→	Test cases
Defect	←	Defects

Install UiPath® Test Manager for Jira

1. Open your Jira instance in your browser.
2. Log in as an administrator.
3. Click Manage Apps from the administration menu.
4. Under Find new Apps search for UiPath®.
5. Select UiPath® Test Manager for Jira.
6. Click Install.

   The latest version of UiPath® Test Manager for Jira is installed.

Configure Jira Connection

All the objects that you create in Test Manager will have the identity of the Jira user used for this connection. The connection is established based on the type of Jira product that you are using. For Jira Data Center, you need to set a connection for Jira Server. For Jira Cloud, you need to configure a connection for Jira Cloud:

1. Log in to Test Manager as an administrator.
2. Open your project.
3. Navigate to Project Settings > Integration.
4. Click New Connection and select either Jira Server(Jira Data Center), or Jira Cloud.
   The default authentication type used is Basic Authentication. You can't change the authentication type.
5. Configure the following connection settings:
   • Name: Enter a name for your Jira connection.
   • Description (Optional): Add a description for reference.
   • Server URL: Add the Jira server URL. 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: Enter the URL of the Jira REST API in case the Jira REST API is not hosted under the same URL as the web UI.
   • User: The username you use to authenticate to the Jira API.
   • Password (Jira Server only): The password you use to authenticate to the Jira API.
   • API Token (Jira Cloud only): Generate an API token. For more information on Atlassian API tokens, see Manage API tokens for your Atlassian account.
   • Defect Type: Specify the Jira object-type to be used for defects. Usually, that will be a bug. To disable defect integration for this connection, select None.

   • Project Key: Enter the project key from Jira which refers to the project you want to integrate.

     
     

     

     
     
6. Click Save.
7. Click the connection to expand the panel and copy the API Key for later use.

Configure Jira Project

1. Open Jira and navigate to the project you want to integrate with Test Manager.
2. Switch to the project settings.
3. Scroll down and select UiPath® Test Manager to open the Test Manager configuration page.
   
   

   

   
   
4. Select all Jira issue types that you want to be synchronized as requirements to Test Manager.
5. Enter the Server URL from Test Manager (e.g., https://{yourDomain}/{organizationName}/{tenantName}/testmanager_).
6. Paste the API Key you copied at step 7 from the previous procedure.
7. Click Save.

Working With Jira Integration

To understand how integration works with the help of Xray for Jira and , take a look at the following video:

Managing Jira connections

The following table lists the actions that you can take to manage your Jira connections.

Action	Description	Procedure
Edit	Edit your connection settings.	Log in to the Test Manager as an administrator. Open your project. Navigate to Project Settings > Integration. Click a Jira connection to expand the panel. Click Edit to configure the connection. Click Save to confirm changes.
Delete	Delete the selected connection and its associated requirements.	Log in to the Test Manager as an administrator. Open your project. Navigate to Project Settings > Integration. Click a Jira connection to expand the panel. Click Delete to remove the connection. Click Ok to confirm changes.

Related articles

Defect synchronization