Jira Cloud integration - usage

With the mabl integration for Jira Cloud editions, available here, software development teams get the following benefits:

  • Capture issue details in Jira directly from mabl test results, including screenshot, DOM snapshot, network activity (HAR) file, and Chrome performance trace from the point of test failure
  • Quickly triage a reported issue in Jira thanks to mabl’s comprehensive diagnostics data, including speed index, gathered from every step of the test
  • Quickly trace Jira issues to mabl tests and vice versa in both systems
  • Attach tests and test results to existing Jira issues for traceability and test case management

With the mabl integration for Jira Cloud, anyone in your workspace can easily create a Jira ticket in no time

📘

Don't have the Jira Cloud integration configured?

Visit our setup and configuration doc to get started.

Use cases

Escalating failures

Create a detailed issue with rich diagnostic data in a few steps. The Jira issue created from the failure will also link directly back to the test and run it was created from, meaning validating the issue locally or in the cloud is faster than ever.

Test case management

Associate mabl tests and test runs with existing Jira issues such as requirements and even custom XRay or Zephyr issue types such as test cases. This lets you keep track of your requirements and tests in a single place outside of mabl so your whole team has visibility. For example, link a mabl test to a Jira issue or XRay test to keep track of which tests relate to what test cases.

Creating a new Jira Issue

You can create a new Jira issue from a few places in the mabl app:

  • Test results page > "More actions" menu or a failed step
  • Test details page > issues tab
  • Tests page > issues tab

From the test results page

  1. Click "Create issue in Jira" under "More actions" when viewing any mabl test result, or the "Create Issue" button on any failing step. A form will then appear.
744

The location of the "Create issue in Jira" link in the "More actions" menu.

1018

The "Create Issue" button attached to every failing test step.

Selecting where to create the issue

  1. As shown below, select the integration to use via the "Issue Tracker" field.
  2. Ensure "Create new" is selected.
  3. Select the project you'd like to create the issue in via the "Project" dropdown.

Specifying the issue type and issue details

  1. Use the "Issue Type" field to select the type of Jira issue you'd like to create. Then, click "Next" to continue.
1008
  1. Fill out the necessary fields to create your Jira issue as you would if you were creating the issue within Jira itself. Required fields will be marked with the same red * that appears next to the Summary field below.
1058

The New Issue form, showing the Summary field as required.

  1. Once you're done click the green "Submit" button at the bottom to create the issue.

Viewing the issue in Jira

  1. After a short delay, a green success message should appear at the bottom of your screen within the mabl app. Click to be taken directly to the issue within Jira in a new tab.
490

You should see your newly created issue within Jira complete with all the info you've previously entered. The example below displays the diagnostic info attached, as well as the mabl section of the Jira issue with additional details and links to the test run.

1094

A sample Jira issue created from a mabl test run.

🚧

Unsupported fields

There's only one type of field that's not supported by the Jira Cloud issue creation today: linked issues.

If you'd like to link an issue, you can do so from within Jira after the issue has been created. View more about linking issues within Jira here, or read below to learn more about linking multiple mabl tests or results to a single Jira ticket.

Linking tests or results to an existing Jira issue

It's just as easy to link to an existing Jira issue, even custom issues like XRay or Zephyr test cases. This gives you the ability to keep track of your mabl tests and outside test cases in the same place.

Similar to above, you can create a new link from:

  • Test results page > "More actions" menu or a failed step
  • Test details page > issues tab
498

The "New issue" button can be found on the "Issues" tab of any user-created test.

Now, select the "Link existing" button and the relevant project containing the issue you'd like to link.

1670

Once you've done the above, you'll want to search for the issue to link. You can search by the name of the issue, such as Basic smoke test case, or the Jira issue ID, MCA-197 for example.

Once you've found the issue, you're ready to click "Submit" to finalize the connection. A message will appear with a link to the issue. Clicking it will take you to the associated issue, as shown below with an existing XRay test.

1530

An XRay test associated with a mabl test, displaying three manually linked test runs.

Managing Jira issues in mabl

All mabl workspace users can see information about Jira issues created from mabl in a few different places:

  • Test results page, in the header
  • Test details page > issues tab
  • Tests page > issues tab

Showing associated Jira issues with a given test run in mabl makes it easy for users reviewing the test logs to see what issues have already been captured in Jira, and create new ones as needed.

1610

Jira issues linked to a specific test run.

Users can track the status of all Jira issues associated with a test from the Issues tab on the test details page in mabl. Issues linked to different runs of that tests will also be shown on that screen. Clicking on the issue ID will take the Jira to the issue details in Jira.