Use the mabl integration for Jira to create and link Jira issues with mabl tests. With the Jira integration, you can:
- Attach mabl tests and test results to Jira issues for better traceability.
- Capture comprehensive diagnostic data from mabl test results in Jira issues, including screenshots, DOM snapshot, network activity, and Chrome step trace.
- Review failing or flaky mabl tests associated with Jira issues.
This article explains how to:
Looking for setup instructions?
For setup instructions, check out the following articles:
How to create new issues
The process for creating Jira issues in mabl starts with the New issue form. You can access the New issue form from the following areas of the mabl app:
- From a test run: On the test output page, click on More actions (...) > Create issue in Jira
- From a test: On the test details page, open the Issues tab and click on the + New issue button.
- On the issues page: Click on Tests in the left-hand navigation, select the Issues tab and click on the + New issue button.
Creating an issue from a test run
The new issue form
In the New issue form, enter the following information:
- Issue Tracker: Select the issue tracker for this plugin
- Select "Create new"
- Project: Select the Jira project where you want to create the issue
- Type: Select the type of issue you want to create
The New issue form
Click on the Next button and fill out the required fields to create the new Jira issue.
Creating a new Jira issue in mabl
Unsupported field
The "linked issues" field is not supported by the Jira integrations. If you want to link an issue, you can link it from within Jira after creating the issue.
Click on the Submit button to create the issue. A success message appears at the bottom of the screen in the mabl app. Click on the link to go directly to the Jira issue in a new tab.
Issues created from a test run include the following diagnostic info from the failing step:
- Screenshot
- Step trace
- DOM snapshot
- HAR file
Jira issue with mabl test diagnostics
How to link to existing issues
To link a mabl test or test run to an existing Jira issue, click on the + New issue or Create issue button and take the following steps:
- Issue Tracker: Select the issue tracker for this plugin
- Choose "Link existing"
- Project: Select the project containing the issue you want to link to
- Issue to Link: Search by the name of the issue or its Jira issue ID
Click on Submit to finalize the connection. A success message appears at the bottom of the screen in the mabl app. Click on the link to go directly to the Jira issue in a new tab.
Limitation
Linking to existing Jira issues is not supported for the Jira Server integration.
Jira shows the associated tests and test runs in the "mabl" section of the issue.
Associating mabl tests with test cases
If your team uses XRay for Jira or Zephyr for Jira, you can also link mabl tests and test results to a test case ID.
An XRay test case associated with mabl test runs
Note
While the Jira integration supports manually linking mabl test runs to a test case ID, it is not possible to automatically sync mabl test results with a test case.
mabl currently does not support a native integration with any test case management (TCM) tools. For more information on setting up a custom integration with a TCM tool using scripts, see the article on integrating with test case management tools.
How to manage Jira issues in mabl
You can review all Jira issues from the issues page - Tests > Issues - or from the Issues tab of a specific test.
- Click on the Jira link to review the related issue in Jira and request updates.
- Re-run the mabl test to reproduce the issue or validate a fix.
Note on Jira statuses
mabl only shows “Open” and “Closed” statuses for linked Jira issues. If a linked Jira issue has a status other than "Closed", such as "Pending", "Done" or "Shipped", it will appear as an "Open" issue in mabl.
Unlinking issues
When an issue is resolved and the status is closed, you may unlink the issue from mabl. Unlinking is also useful in the following situations:
- You accidentally linked the test to the wrong ticket.
- There is a duplicate ticket
- The linked ticket was deleted in Jira
Select the issue and click the Unlink button. Confirm your choice by clicking the Unlink button again in the modal:
Unlinking a Jira ticket from the mabl app