Show Vansah testing information alongside Jira work items in the Filter Results dashboard gadget. A saved Jira filter can highlight work items with failed testing, while columns show the Vansah status and execution metrics your team uses.
Before you begin
Ask a Jira administrator to configure Vansah workflow fields and check their Jira field mappings.
Confirm the name of your mapped test-status field. The default is Vansah TR Status, but your team may use a different name such as Testing Status.
Make sure you can search the relevant Jira space, save a filter, and edit the target dashboard.
Use a work item with linked Test Cases and recorded results to check that the mapped field contains the expected value.
1. Create a filter for failed testing
Open Jira’s work item search and switch to JQL. JQL is Jira’s search language.
Enter the query below, replacing DEMO with your Jira space key and the field name with the one mapped in Vansah.
project = DEMO
AND "Vansah TR Status" IN ("Failed", "Failed-In-Progress")
ORDER BY key ASC
The JQL field project refers to the Jira space. Keep that exact field name in this example.
Run the search and check the returned work items.
Save the search with a meaningful name, such as Failed Testing — DEMO. Share the filter with the people who need to use the dashboard.
Use the exact field and option names from your Jira site. Vansah can use customized result names, so choose the values offered by Jira’s search suggestions if your team has renamed them.
For more about field-name searches, see Atlassian’s JQL fields guide.
2. Add the Filter Results gadget
Open the Jira dashboard and enter its edit mode if required.
Select Add gadget, search for Filter Results, and add the Atlassian gadget.
Close the gadget picker and open the gadget’s configuration.
You need edit access to the dashboard. See Atlassian’s gadget setup guide if the add or edit controls are unavailable.
3. Choose the filter and columns
In Saved Filter, select the filter you created.
Choose how many work items to display.
Under Columns to display, keep useful fields such as Key and Summary, then add your mapped Vansah test-status field.
Optionally add Vansah Pass Rate, Vansah Fail Rate, or Vansah Coverage if those fields are mapped. Use your site’s actual field names.
Set the refresh option you want and save the gadget.
This screenshot uses a custom field named Testing Status. Select Vansah TR Status or your own mapped field when configuring your dashboard.
4. Read and verify the results
Each row is a Jira work item returned by the saved filter. Select its key to review the requirement and linked Test Cases. The test-status field summarizes the included testing; it is separate from the work item’s Jira workflow status.
Default test-status value | How to read it |
Failed | Testing is complete and at least one included Test Case failed. It does not mean every Test Case failed. |
Failed-In-Progress | The aggregate status reports a failure while testing is still incomplete. |
Blocked | The aggregate status reports blocked testing. The failed-testing filter above does not include this value. |
To include blocked work items in the same review list, use:
project = DEMO
AND "Vansah TR Status" IN ("Failed", "Failed-In-Progress", "Blocked")
ORDER BY key ASC
Use the saved field values for dashboard filtering. The gadget refreshes according to its configuration; it does not show every test-result change instantly. Open the work item’s Vansah panel when you need the underlying execution details.
Use the fields in workflow rules
Vansah’s workflow field integration supplies Jira custom-field values. Enabling it or adding this gadget does not automatically prevent transitions or move work items between Jira statuses.
If your team needs a testing gate, a Jira administrator must configure and test the appropriate workflow rule separately. See Configure Vansah Workflow Fields for the field setup and related workflow guidance.
Troubleshoot the dashboard
Issue | What to check |
Jira does not recognize the field or an option | Check the mapped field’s exact name and available option values. If similar field names exist, ask your Jira administrator to identify the correct field. |
The gadget shows no rows | Run the saved filter directly. Confirm the Jira space key, field values, and work item access. A work item with no matching field value will not appear. |
The saved filter is unavailable | Confirm that it was saved and that the current user can access it. |
A viewer sees different or fewer work items | Check that the dashboard, saved filter, and underlying work items are shared with that viewer. |
The test-status column is blank or unexpected | Check the Vansah field mapping and the work item’s linked tests. Allow the update to finish, then refresh the gadget. Compare the same testing scope and result-source settings. |