Sync Requirements and Issues from Jira to QMetry

Once you configure and map the Jira issue types, the system automatically imports the requirements into the selected folder. All fields from Jira are synced to QMetry, and Jira fields displayed as read-only.

QMetry auto-syncs all Jira fields during the initial setup. To reflect newly added custom fields in Jira, you can manually sync the projects. By default, imported requirements are added to the “Import” folder specified during mapping.

Pre-requisites

  • Configure the Jira project with a QMetry project.

  • Map relevant Jira issue types to the Requirement module.

Syncing Requirements from Jira

QMetry auto-syncs all Jira fields during the initial setup.

To reflect newly added custom fields:

  1. Go to Jira Integrations.

  2. Click Sync Projects.

Note

Cascading Select List fields created in QMetry or synced from Jira work items are currently unavailable in QMetry Insights for custom reporting.

In JQL/Filter Scope

The In JQL/Filter Scope column shows whether a issue currently matches the active JQL filters. Items marked ‘No’ are outside the filter scope but still continue to auto-sync with the latest updates.

Note

This column appears only in projects mapped with Jira or Azure.

QPro_Integration_JSONScope.png

You can update or delete entities in QMetry that has ‘In JQL Scope’ set to “No”. Deleted entities are removed from QMetry and return as new entries only if they meet the filter scope again.

Managing the Import Folder

QPro_Integration_JiraFolder

Move Synced Requirements to Another Folder

You can move Jira-synced requirements from the default “Import” folder to another folder. Synced requirements when moved are not re-imported to the default folder. They continue to sync in the new folders.

Archiving Folders Containing Synced Requirements

Folders containing Jira-synced requirements (including archived requirements) cannot be archived or deleted directly. To archive or delete such folders, you must move all requirements to a different folder.

To Archive folder having archived requirements, perform the following steps:

  1. Unarchive the requirements.

  2. Bulk move the requirements to another folder.

  3. Re-archive the requirements. (Optional)

  4. Archive or delete the now-empty folder.

Note

The default Import folder cannot be archived or deleted.

Viewing Requirement Details in QMetry

Jira synced requirements display the following information:

  1. Jira System and Custom Fields (including Sprint and Labels).

  2. Latest 10 Comments and Attachments from Jira issue.

The QMetry panel on the Jira issue page displays test case linkages to the requirement.It also shows the QMetry Project linked to the Jira story. Once you select the project, the QMetry Key is populated for the issue synced as a requirement in QMetry.

QPro_JiraIntegration_ViewRQ

Test Case Execution in Jira

The Test Case section on the story page displays linked test cases and their execution details. This helps developers and product managers track test execution summary directly on the Jira story page.

Note

Only test cases that are linked to the story and are associated with a test suite execution appears in this section.

Use the Filter icon in the Test Case section to filter executions by Release, Cycle, Platform, Build, or Test Suite Key.

Note

  • Filters reset on page refresh.

  • Test execution filters do not apply to cross-project test suites and executions.

  • Use Test Suite Keys to filter cross-project executions.

QPro_JI_TE

View Test Case Execution Summary

  1. Click the graph icon to view execution statistics.

  2. Select latest execution or all executions.

  3. Click to view summary of statuses. All custom statuses gets displayed.

  4. Count of issues linked to test cases and steps during the execution.

Note

  • Unplanned test cases are excluded from Execution Summary.

  • The graph resets on refresh.

QPro_JI_ViewTCESummary

Sync Issues from Jira to QMetry

Once Jira issue type is mapped to the Issue module in QMetry, you can:

  • Create new issues in Jira directly from QMetry while executing test cases.

  • Link existing Jira issues to test cases or individual test steps.

  • View issues that are already linked.

QMetry Issue module remains visible even if the QMetry Project is integrated with Jira Project.

Refer to Projects using Jira integration for Issue (Bug) Tracking for more details.

Create Jira issues from the Test suite execution window

Create_Jira_issues_from_the_Test_suite_execution_window__1_.png

Test case and Step details are automatically added to the Issue Description.

Sync Deletion of Requirements or Issues in Jira

When a requirement or issue is deleted in Jira, QMetry automatically deletes the corresponding item.

Linking Issue to Requirement in QMetry

For projects integrated with Jira, if bugs are directly linked to requirements in QMetry, they appear as issue links on the corresponding Jira story page.

Note

  • The Issue Links in Jira are created only when you have authenticated your Jira credentials in QMetry. Issue links are generated in Jira by a cron job that runs every 5 minutes.

  • To authenticate:

    1. Go to Integrations.

    2. Click the cog icon and select Configure.

    3. Enter your Jira Credentials.

The following image displays Bugs directly linked to Requirements in QMetry.

If the requirement is associated with test cases, then issues linked to the test cases (either directly or indirectly through execution) will also appear on the Issues tab of that requirement.

  • The linked issue gets displayed in the corresponding story/issue in Jira under the Linked Issues section if the story and issue linked in QMetry are from the same Jira instance.

  • If the issue is unlinked in requirement in QMetry, the issue in Jira also gets unlinked from the corresponding story or issue in Jira. The linkage relation will not be displayed in Jira anymore.

  • If an Issue link is deleted from Jira Story for an Issue Linked to QMetry Requirement, it does unlink the bug in QMetry Requirement.

  • If an Issue link is added in a Jira Story in Jira for a Requirement Imported in QMetry. The issues will not be auto-linked in QMetry.

  • The story in Jira reflects linked issues under the Linked Issues section as “relates to”.

Clicking on the issue key in the Issue links opens the issue details page in Jira.

  • The QMetry Test Case panel will show the details of the Test Case and the Test Execution on which this bug is logged.

  • Test Case will have two tabs: Test Case Steps and Executions.

The Test Case Steps tab shows steps under the test case.

The Executions tab shows the execution during which the issue was logged.

If the issue is directly linked to the test case without its execution, then the Executions tab will not show any execution details.

Publication date: