View Traceability in Jira Cloud
View traceability for stories, test cases, executions, and bugs.
Prerequisites
Integrate your Jira Project with a QMetry project.
Enable QMetry Configuration in the Jira Project.
Complete mapping of Jira and QMetry Work Items.
Authenticate your Jira connection:
Login to QMetry and select Integrations.
Select Jira Integrations.
On the Integrations tab, click the cog icon.
Select Configure and enter the Jira Credentials.
Jira Story synced as QMetry Requirements having linked Test Cases
QMetry Panel in Jira
The QMetry panel in Jira shows the test cases, the execution summary, and test step details. When you expand a test case, two tabs appear: Test Case Steps and Executions.
To view Test Cases Linked to a Requirement, do the following:
 |
Open the Jira Story synced with a QMetry Requirement that is linked to a test case.
Select the QMetry Project from the QMetry projects drop down with which the Jira story is synced. If the story is synced in multiple projects, all linked projects are displayed in the list. Once you select a project, the Entity Key of the corresponding requirement in QMetry is automatically populated.
Note
When you open a synced Jira issue type from within a QMetry project, the QMetry Project list in the QMetry section automatically selects the originating QMetry project.
The Test Case panel displays all Test cases linked to the Requirement. The Test case and step details are shown with respect to the version linked with the Requirement.
Note
The last execution status displayed is the latest executed status of the test case, regardless of the version linked to the requirement.
Expand the test case row to view Test Case Steps and Executions details of the test case. You can select specific columns to customize the view.
Test Case Steps
The Test Case Steps tab displays the test case steps of the test case version linked with Requirement. Clicking the Test Case Key opens the Test Case Details screen in Jira.
Executions
The Executions tab displays Test case executions for a combination of test suite, release, cycle, platform, and executed version, for all versions that test case.
Test Suite Key has a link on it, clicking on which opens the Test Suite page in QMetry.
 |
If the issue is directly linked to the test case without its execution, then the Executions tab does not show any execution details.
 |
If a bug is linked to the test case, the count is displayed in the Bug column. The bug details are available by clicking on the count, which opens up the Issues pop-up. Clicking on the Issue Key opens the issue detail page in Jira.
Total Executions
The Total Executions column displays the count of all executions performed for the test case.
The Total Executions column in the QMetry Test Case panel shows how many times a test case has been executed. Click the count to open the execution details in the Test Case View.
Product owners, QA managers, and testers who review test cases in Jira can see how often a test case was executed and then drill down into each execution.
If a Jira Bug or Story is linked with a test case in QMetry, the Executions tab in Jira displays the total issues linked to the execution. The count is clickable and it displays the issue details.
Test Run UDFs
Test Run UDFs are user-defined fields that testers fill in when executing a test case in QMetry. In Jira, you can view the values entered for each execution without leaving the issue.
Visibility Conditions
The Test Run UDFs column and tab appear only if Test Run UDFs are associated with the Test Run module of the selected QMetry project.
If the selected project has no Test Run UDFs, the column does not appear in the column selection list.
Test Run UDFs Icon
The icon in the Test Run UDFs column shows at a glance whether the execution data is complete.
Icons | Meaning |
|---|---|
Green icon with a star | All mandatory Test Run UDFs have values. |
Blue icon with a star | At least one mandatory Test Run UDF is blank. |
Blue icon without a star | The execution has no mandatory Test Run UDFs. |
To View Test Run UDFs from the Executions Tab
 |
In the QMetry panel, expand the test case row and open the Executions tab.
Click the icon in the Test Run UDFs column for the execution. The Test Run UDFs dialog box opens and lists each UDF with its selected value.
Mandatory UDFs are marked with a red asterisk. Large Text UDFs display rich text formatting.
To view Test Run UDFs from the Test Case View
Click the Test Case Key to open the Test Case View in Jira.
On the Executions tab, expand the execution row.
Open the Test Run UDFs tab.
Test Case View in Jira Add-on
Create a test case and link it to a test suite in QMetry. Associate releases, cycles, and platforms with the test suite for test execution. On the execution screen, link the Jira issue to the test case as an external issue. The issue link opens in Jira.
Click the Test Case Key in the Test Case section to open the Test Case View in Jira. The test case page in Jira shows execution details and test case details on separate tabs.
The Execution tab displays:
Test case executions for each combination of test suite, release, cycle, platform, and executed version.
Test case step execution details.
Linked bugs, test logs, and comments for the test executions and test steps.
Test Run UDFs for each execution.
The Test Case Details tab displays complete test case information.
If the issue is linked directly to the test case without an execution, the Executions tab shows no execution details.
Test Case Details
The Test Case Details tab displays details of system fields as well as user-defined fields entered for the test case in QMetry and its Execution Status Summary.
 |
Executions
The Executions tab displays test suites in which the test case was executed. The test suite link opens in QMetry. You can view Bugs, Attachments, S.C. (Step Count), and Comments for the test case. The counts can be clicked to expand the test suite row to show its relevant tab in the expanded area. Other columns include Executed by and A.T. (Actual Attendant Time). The columns are resizable for better visibility.
Each test suite row is expandable. The expanded area has five tabs: Steps, Issues, Attachment, Comments, and Test Run UDFs. The Test Run UDFs tab appears only if Test Run UDFs are configured for the project.
If the issue is linked directly to the test case without an execution, the Executions tab shows no execution details. The page is blank and displays a message.
 |
Issue Links in Jira
The bugs linked directly to requirements in QMetry will now appear in Jira Story “Linked Issues” section of the Jira story.
Bugs linked from the Test Suite Execution Screen in QMetry
When a test case is marked as failed during the execution, and a bug is raised on the Test Suite Execution screen, that bug gets raised in Jira and its external key (Jira issue key) is shown in QMetry. On clicking on the External Key of the issue in QMetry, it opens bug details in Jira. The Test Cases section on the Jira issue details page also displays the Linkage Level of the issue - Test Case/Test Step along with other details of the test case.
Expand the test case row to view Test Case Steps and Executions details of the test case.
On expanding the test case, two tabs are displayed:
Test Case Steps: The Test Case Steps tab displays the test case step details.
Executions: displays the Test Suite Key, Test Suite Summary, Executed Version, Platform, Release, Cycle, Status, linked Bug icon, Attachments icon, Comments icon, Test Run UDFs icon, and Executed by. Click an icon to view its details. The Test Suite Key is a link that opens the test suite in QMetry.
BDD Panel in Jira when Jira stories are synced in QMetry
When a version control system is configured for the QMetry project, the BDD panel will be visible in the stories imported as requirements. The BDD panel in QMetry will appear read-only for the requirement imported from Jira; however, any changes made in the BDD panel in Jira will reflect in the BDD panel in QMetry .
Scenario: If one Jira project is configured with more than one QMetry Project and Jira stories are synced in QMetry. Here, one Jira story is synced in more than one QMetry project.
QMetry Project: lists the QMetry projects with which the Jira story is synced and the version control system is configured.
For the selected project, provide BDD Configuration details to pull the BDD details.
Version Control list will populate according to QMetry Project selection.
The repository list will populate according to selected Version Control.
Whatever changes you make in BDD and push, it will impact only the selected QMetry Project.
Traceability in QMetry
Go to Reports and click Open Traceability report.
Select Trace by:
For Requirement Traceability: select Trace by Requirement.
For Issue Traceability: select Trace by Issue.
Select entity > Apply
