Integration of QMetry with JIRA
QMetry offers integration with JIRA to enable real-time synchronization of Work Items across modules. The integration allows JIRA users to view testing progress directly within JIRA.
Requirements Module: JIRA Work Items such as Epics and Stories are synced in real-time to QMetry. Testers can view these stories directly in the Requirements module and link relevant test cases.
Issues Module: JIRA Work Items like Bugs, Defects, and Tasks are synced bi-directionally with QMetry. You can create and update defects in either system and link them to test executions in QMetry for end-to-end defect traceability.
In JIRA Visibility: All JIRA users having access to the Work Items can view linked test cases, test steps, and execution results directly within JIRA.
Advantages of JIRA Integration
View JIRA stories and bugs in QMetry.
Link Test Cases from QMetry to JIRA work items.
Log, sync and trace issues in both systems.
Execute test cases in QMetry and track them in JIRA.
Link Jira issues with requirement and test case (from Test Suite Execution screen), and create JIRA issues from the Execution screen.
Map Requirement with JIRA Issue Types and sync those issues as requirements in QMetry.
How QMetry Instances, JIRA Instances, and Projects Relate
The following relationships work in different directions, so read them together:
Relationship | Description |
|---|---|
JIRA instances to a QMetry instance | One QMetry instance can integrate with multiple JIRA instance. |
JIRA projects to a QMetry project | One QMetry project can link to multiple Jira project. |
QMetry instances to a JIRA instance | One Jira Data Center instance can connect to more than one QMetry instance. |
QMetry instances to a JIRA project | One Jira project can connect to only one QMetry instance at a time. |
Connect more than one QMetry instance to a single JIRA instance to keep test data separate for business units that share a JIRA instance but must not share test data, such as a general business unit and a regulated healthcare unit. For more information, see About Multiple QMetry Instances.
Note
Support for multiple QMetry instances applies to JIRA Data Center and JIRA Server only.
Roles and Responsibilities
The following roles work with QMetry and JIRA together:
Role | Responsibility |
|---|---|
JIRA system administrator | Installs the app, connects each QMetry instance, and decides which JIRA projects can integrate with which QMetry instance. |
QMetry project administrator | Can map only the JIRA projects that the JIRA system administrator enabled for that QMetry instance. |
JIRA user | Views the test case and Behavior-Driven Development (BDD) panels on a story or defect. A JIRA user can view read-only test coverage data without a QMetry account. |
QMetry user | Views Jira work items in the Requirements module. Views, creates, and updates issues in the Issues module. QMetry users can work only in QMetry projects that they can access. |
QMetry and JIRA Integration Workflow
Step 1: Install QMetry App in JIRA
For installing QMetry in JIRA, refer to Install QMetry in Jira.
Step 2: Connect QMetry to JIRA
Connect each QMetry instance to Jira by using QMetry credentials or a QMetry Open API key. For more information, see the following topics:
Section 3: Verify the Integration is Active
Confirm that the connection is active before you configure projects. For more information, see Verify QMetry-Jira Integration.
Section 4: Select Which JIRA Projects Can Integrate with QMetry
Choose whether to enable the integration for All projects or only Selected projects. If multiple QMetry instances are connected, assign each enabled JIRA project to the appropriate QMetry instance. For more information, see Manage Jira Projects for QMetry Integration.
Note
If a JIRA project is not enabled for integration, the QMetry project administrator cannot select it when mapping projects in QMetry.
Step 5: Map JIRA Projects and QMetry Projects
Link each JIRA project to a QMetry project, and map JIRA work item types to the Requirements module, the Issues module, or both. For more information, see Map Jira with QMetry.
Step 6: Enable QMetry Test case and BDD panels for JIRA Projects
Enable the panels that display QMetry test case and BDD data inside JIRA work items. For more information, see Enable QMetry Test Case and BDD Panels.
What Happens When You Integrate JIRA with QMetry
JIRA work items whose types are mapped to the Issues module are imported and synced with the Issues module. These work items display an external key that indicates the Jira work item key.
QMetry internal issues that were added from the Issues module before the JIRA integration are hidden.
The test case panel in a JIRA work item shows the QMetry instance URL, the QMetry project, and the test cases from the QMetry instance that the JIRA project is linked to.
JIRA sends work item updates only to the QMetry instance that the JIRA project is linked to. Updates from JIRA projects that are disabled or not linked are not sent.