Jira integration with Test Management

Learn how to integrate Jira with Test Management to streamline testing workflows, better tracking, and enhance management.

Jira integration with BrowserStack’s Test Management allows you to create a more efficient workflow by directly linking Test Cases, test results, and Test Runs with the relevant Jira issues. This integration helps streamline your testing process and ensures better issue tracking and test case management from within your Jira environment as you would from Test Management.

Integrate Jira with the Test Management

Depending on your Jira instance type, choose the appropriate procedure for either:

• Jira On Cloud: For Jira instances hosted on the cloud.
• Jira self-hosted: For Jira instances hosted on your own servers.

Prerequisite

BrowserStack Local Binary

To successfully integrate BrowserStack with your Jira self-hosted instance, you need to set up the BrowserStack Local Binary. Follow these steps to ensure everything is correctly configured.

1. Download the latest version of the BrowserStack Local Binary.
2. Before running the binary, ensure the file has execute permissions:
   chmod +x BrowserStackLocal
   
3. To connect BrowserStack with your Jira self-hosted instance, use the following command: ./BrowserStackLocal --local-identifier integrations-repeater --only <jira-host-url-without-https>,<jira-port>,<ssl 0 or 1> --key <browserstackKey>
   

This will ensure that you have the necessary setup to connect their local environment to BrowserStack before proceeding with the integration steps.

Integrate Jira On Cloud

Follow these steps to integrate Jira on cloud with your Test Management.

1. In the left navigation bar of Test Management, click Integrations.

   

2. Click Connect on the Jira tile.

   

3. Select Jira On Cloud from the dropdown menu.

   

4. Choose your authentication method:
   • Click Connect with OAuth to log in using OAuth.
   • Click Continue with PAT to use a Personal Access Token (PAT).
5. Follow the on-screen instructions to complete the authentication.

After successful authentication, the Jira tile should indicate a connected status. Your Jira On Cloud instance is now integrated with the Test Management, allowing you to create and track issues directly from the tool.

Integrate Jira self-hosted

Follow these steps to integrate Jira self hosted with your Test Management.

1. In the left navigation bar of Test Management, click Integrations.

   

2. Click Connect on the Jira tile.

   

3. Select Self Hosted from the dropdown menu.

   

4. Click Continue with Jira.

5. Enter your Atlassian host URL and API token to complete the integration.

   

6. Click Continue.

After successful authentication, the Jira tile should indicate a connected status. Your Jira Self-Hosted instance is now integrated with the Test Management, allowing you to create and track issues directly from the tool.

Link Jira issues in Test Management

First, Integrate Jira with Test Management to connect Jira issues to test cases and test runs from Test Management.

Link Test Cases with Jira requirement issues

You can connect Jira requirement issues to a test case while creating a test case in the Create Test Case form.

1. Log in to Test Management.
2. In the Test case dashboard, click Create Test Case.
3. Enter the required details, including the Title and Test Case Fields.
4. In the Requirements field, click the downward arrow and select Jira.
5. Click Select options to link existing issues or select click here to open the Jira Issue linking dialog.
   
6. In the dialog, you can:
   • Create a new Jira requirement issue.
     • Select the Host and Project.
     • Select the Issue Type and enter the relevant fields.
     • Click Create.
       
   • Update an existing Jira requirement issue.
     • Select the Issue from the dropdown.
     • Update the relevant fields.
     • Click Update.
       
7. Click Create to create the test case linked to the Jira Issue.

Link Test Case results with Jira defect issues

You can link the Jira defect issues with failed or passed test case results.

1. Log in to Test Management.
2. In the left navigation bar, click Test Runs.
3. Select the desired test run and test case within the test run to add the result.
4. At the bottom of the test case details view, click Add Result.
5. Add the Status and Defects.
6. Click Select options to link existing defects (issues) or select click here to open the Jira defect Issue linking dialog.
   
7. In the dialog, you can:
   • Create a new Jira issue.
     • Select the Host and Project.
     • Select the Issue Type and enter the relevant fields.
     • Click Create.
       
   • Update an existing Jira issue.
     • Select the Issue from the dropdown.
     • Update the relevant fields.
     • Click Update.
       
8. Click Add Result to add the defect issue to the test run.

Link Test Runs with Jira requirement issues

You can link a Jira requirement issue while creating the Test Run. Select or enter a Jira Issue, you can select or enter multiple Jira Issues in the Jira Issues field.

You can connect a Jira requirement issue while creating the Test Run. Follow these steps:

1. Log in to Test Management.
2. In the left navigation bar, click Test Runs.
3. Enter the required details, including the Test Run Name.
4. In the Requirements field, click the downward arrow and select Jira.
5. Click Select options to link existing issues or select click here to open the Jira Issue linking dialog.
   
6. In the dialog, you can:
   • Create a new Jira requirement issue.
     • Select the Host and Project.
     • Select the Issue Type and enter the relevant fields.
     • Click Create.
       
   • Update an existing Jira requirement issue.
     • Select the Issue from the dropdown.
     • Update the relevant fields.
     • Click Update.
       
7. Click Create to create the test run connected with the Jira Issue.

Check linked requirements issues in a test run

To view requirements linked to a specific test run, follow these steps:

1. In the left navigation bar, click Test Runs.
2. Select the test run you want to check.
3. From the test run details page, click Linked Issues.
4. Ensure the Requirements linked to Test Run tab is active.
5. From the Select your tool dropdown, choose Jira to view issues linked from Jira.

The linked requirement issues from Jira will display here. You can also switch to Defects linked to Results tab and view the linked defect issues.

If no linked issues appear:

1. Click Go to Integrations to connect or troubleshoot your Jira integration.