Use the Vansah - Test Plan Traceability Matrix gadget to see which Jira work items or Test Folders are covered by your Test Plans, how many Test Cases they contain, and their overall testing result. Follow the links in the matrix to investigate the tests or related bugs.
Before you begin
Use a Jira dashboard you can edit.
Make sure Vansah is available in the Jira spaces you want to report on and that you can access the relevant Test Plans and Jira work items.
Prepare the Test Plans and link the Test Cases you want to report on.
1. Add the gadget
Open the Jira dashboard and select Edit.
Select Add gadget and search for Test Plan Traceability Matrix.
Add the Vansah gadget, then open its configuration. If it is already on the dashboard, use the gadget’s menu and select Configure.
2. Choose the spaces and Test Plans
In Space, choose one or more Jira spaces containing your Test Plans.
Under Test Plan(s) selection, select the three-dot button to open the plan picker.
Browse the plan folders and select the Test Plans to include. If you chose multiple Jira spaces, use the picker’s space selector to browse each one.
Select Apply to return to the configuration.
Optionally use More to add filters, such as labels, case types, releases, or environments. Available property filters depend on the Jira space settings.
Select Save.
To change an existing selection, open configuration and choose Modify Selected Test Plans in the plan selection control.
A dashboard gadget configured through this plan picker uses the latest iteration of each selected Test Plan. Check that iteration when comparing the matrix with a Test Plan view.
Read the matrix
Column | How to use it |
Test Plan | Shows the plan key and name, such as DEMO-P13. Select the link to open the plan. |
Test Cases | Shows the related Jira work item or Test Folder, followed by its Test Case count and overall result. Select a nonzero Test Case count to see the matching tests. |
Work items/bugs | Shows the number of distinct Jira work items linked to the matching test logs. Select the count to open those work items. |
For a Standard Test Plan, the Test Cases column shows the work item or folder the plan belongs to. For an Advanced Test Plan, it shows a separate row for each included work item or folder.
Jira status and test results are different. A badge such as TO DO, IN PROGRESS, or DONE describes the Jira work item’s workflow. The result beside the Test Case count summarizes testing, such as Passed, Failed, Untested, or a result in progress.
For example, 3 Test Cases (FAILED) summarizes the group of three tests. It does not mean all three failed. Open the count to review each result.
Find a plan or export the matrix
Use Search Test Plan to find a displayed plan by its name or key. Clear the search to show all configured plans again.
Open the gadget’s Options menu (three dots) and select Export to download the matrix as XLSX or HTML.
If information is missing
A plan is missing: Clear the search, confirm its Jira space is selected, and check that the plan is included in the saved configuration.
A row shows 0 Test Cases: Open the plan and check that Test Cases are linked to the relevant work item or folder. Review any saved filters.
Results differ from another view: Compare the same plan iteration and filters. The matrix uses the latest matching run for each linked Test Case; it does not total every historical run.
The bug count is blank: Check whether Jira work items are linked to the test logs included in this report. A blank count does not prove that the requirement has no Jira links.
For a summary of execution totals and rates by plan, see the Test Plan Traceability Summary gadget.