Make sure you are comfortable with the following lessons:
Under Settings → APIs, click Create API Key.
In the dropdown, select Issue Tracker and input a Name. Click Save.
*Note: A Jira admin needs to install the mabl plug-in.
Click on the Configure button from the listing or manage apps page.
Input a name for the integration, the API key created from the mabl app, the workspace ID of your current workspace (found under the Settings → Workspace tab in the mabl app), and select the specific Jira project(s) you’d like to create issues under. Just click Add Integration to complete the setup!
Under Settings → Integrations, click Setup on the Jira Server card.
You will be redirected to the screen with the plugin info you will need. Click Save.
Note: A Jira administrator needs to install the plug-in and create the mabl Jira user. The Jira user needs to have Create Permission privileges in the configured projects.
Under Manage add-ons or Manage apps page in Jira, input the API key and Integration ID from the mabl app. Click Save.
Navigate to the applicable Jira project settings and enable Use in mabl.
You can create a new Jira issue from several places in the mabl app, such as:
Test results → More Actions menu (or clicking Create Issue directly from a failed step)
Test details → Issues tab
Tests page → Issues tab
After clicking the Create issue button, the New Issue form will appear. Select Create new, choose the Project and Issue Type. Click Next.
Input the required fields to create your Jira issue (required fields will be denoted with a red asterisk and will match your Jira configuration). Click Submit.
After a short delay, you will see a green success message at the bottom of your mabl app. You can click to navigate directly to the issue in Jira. The issue will also be visible in mabl on the respective test and the issues tab from the main tests page.
Upon resolving or closing the issue in Jira, the issue status in mabl will update to Closed, automatically!
From the related test or main tests page, you can click to navigate directly to issues in Jira.
The Jira issue will automatically include the test artifacts from mabl (screenshot, network activity HAR file, DOM snapshot, and Chrome step trace if the test was run in Chrome). It will also include details around the associated test, plan, and run to quickly link you back to mabl as needed.
Similar to creating a new issue, you can link to an existing issue. Upon clicking Create Issue in mabl, select Link existing. Choose the Project. Search for the issue to link (you can search by name or by issue ID) and click Submit. You can then navigate to view the issue in Jira.
Setting up the mabl integration with Jira will enable your teams to quickly capture and manage issues uncovered during testing. If your team has any questions or needs assistance with setting up your Jira integration, please reach out via In-App Chat!
Helpful Documentation Links: