View Traceability for Story, Test cases, Executions, and Bugs.

Traceability in Jira

Pre-requisites

  1. Jira Project should be integrated with the QMetry project.

  2. QMetry Configuration should be enabled in the Jira Project and its issue types like the story, bug, etc. integrated with QMetry

  3. Uses should authenticate Jira from QMetry by following the below steps.

    • Go to QMetry > Integrations > Jira Integrations.

    • Go to the Integrations tab > Click on cog icon > Configure. Enter the Jira Credentials.

Jira Story synced as QMetry Requirements having linked Test Cases

QMetry Test Case Section

The QMetry Test Case panel in Jira shows the Test Case and test steps details along with Test Execution.

On expanding the test case, two tabs are displayed. The columns under the tabs are resizable for better visibility.

  1. Go to the Jira Story that is synced with QMetry Requirements linked to Test Cases.

  2. Select the QMetry Project. QMetry Project: It shows QMetry Projects with which the Jira story is synced. If the story is synced in more than one QMetry project, the drop-down will show more than one QMetry Project. Once you select the project, QMetry Key populates for the Story synced in QMetry as a requirement.

  3. Under Story, the Test Cases section displays all the Test cases linked to the Requirement. The test case & steps details are shown with respect to the version linked with the Requirement. The Test Case row shows details like Test Case Key, Summary, Linked Version, Last Execution Status, Priority, Estimated Time, Status, and Testing Type. The latest execution status shown in the test case details is irrespective of the version linked to the Requirement - it’s the latest (based on the timestamp) executed status of the test case. Jira users can quickly view the information they need from the Jira Story detail page itself. For example, Developers want to see the current execution status of the test case and bugs linked.

  4. Expand the test case row to view Test Case Steps and Executions details of the test case.

  • Total Executions:

The “Total Executions” column is added to the QMetry Test Case panel in Jira. The column displays the count of all executions performed for the test case. The display of the count of executions makes it easier for users to know at a glance that there are more executions that they may need to refer.

Use Case: Product Owners/QA Managers/Testers reviewing test cases on the QMetry Test Case panel in Jira want to see the total count of executions performed for the test case and the details thereof.

If a Jira Bug/Story is linked with a test case in QMetry, the Total Executions column in the QMetry Test Case Panel in Jira displays the total execution count of executions performed. The count is clickable.

Clicking on the count will open the Executions tab of the Test Case View in the Jira Add-on, which shows all the execution details. Refer to Test Case View in Jira Add-on below on this page.

  • Test Case Steps: The Test Case Steps tab displays the test case steps of the test case version linked with Requirement. The tab displays system fields and user defined fields of test steps irrespective of the test step columns arranged in the test case module of QMetry. User Clicking on the Test Case Key will open the Test Case Details screen in Jira.

Jira New View: Clicking on the QMetry button navigates you to the QMetry panel.

Jira Old View:

  • 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.

    • Details like Test Suite Key, Test Suite Summary, E.V. (Executed Version), Platform, Release, Cycle, Status, linked Bug icon (click on the icon to view the details), Attachments icon (click on the icon to view the details), Comments icon and Executed by (including Date & Time) are shown here.

    • 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 will not show any execution details.

Jira New View:

Jira Old View:

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.

If the Jira story is linked with a test case in QMetry, the test case link in requirement will open a remote issue page for Test Case View. Refer to Test Case View in Jira Add-on below on this page.

Clicking on the Test Case Key will open the Test Case View in Jira Add-on which shows all the test case and execution details.

Test Case View in Jira Add-on

A test case is created and linked with a test suite in QMetry. Release & Cycles and Platforms are associated with the test suite for test execution. On the execution screen, the Jira issue is linked with a test case as an external issue. The issue link opens in Jira.

  • Clicking on the Test Case Key in the Test Case section will open the Test Case View in Jira.

  • The test case detail page in Jira displays Execution & Test case details in separate tabs.

    • Execution tab displays

      • Test case executions for a combination of the test suite, release, cycle, platform, and executed version.

      • Test case step execution details.

      • Linked Bugs, Test logs, Comments for the test executions, and test step.

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

  • Test case details display complete test case information.

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 four tabs on it: Steps, Issues, Attachment, and Comments.

→ If the issue is directly linked to the test case without its execution, then the Executions tab will not show any execution details. The page will appear blank with a relevant message on it.

Issue Links in Jira

The bugs linked directly to requirements in QMetry will now appear in Jira Story “Linked Issues” section.

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: The Executions tab displays details like Test Suite Key, Test Suite Summary, Executed Version, Platform, Release, Cycle, Status, linked Bug (click on the icon to view the details), Attachments (click on the icon to view the details), Comments and Executed by. Test Suite Key has a link on it, clicking on which opens the Test Suite page 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: It displays QMetry Projects with which the Jira story is synced and the version control system is configured. In this case, the drop-down will show more than on QMetry Project.

  • 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

  1. Go to Reports > Open Traceability report.

  2. Select Trace by : 

    1. For Requirement Traceability: Select Trace by Requirement

    2. For Issue Traceability: Select Trace by Issue

  3. Select entity > Apply