Jira Workflow Validators are rules that must be satisfied before a work item can transition between statuses.
Vansah integrates with Jira Workflow Validators to enforce test quality gates — for example, requiring all Test Cases to pass before a work item moves to Done.
When enabled, Vansah automatically updates each Jira work item with a real-time Test Result Status, Pass Rate, Fail Rate, and Test Coverage value.
Steps to enable workflow validator support
Go to Apps > Vansah in your Jira top menu.
Click Configure.
Enable Jira Workflow Validator Support.
Optional: Enable Child Work Item Test Result Status to roll up test results from child work items into the parent Epic's overall status.
Steps to associate the Vansah custom field to your screens/spaces
Click the Vansah custom field shown in the configuration screen.
Associate it with the required Screens and Jira Spaces.
Note: You can rename the Vansah custom field or select a different custom field from the list.
Steps to link Test Cases to your work items
Ensure your Test Cases are linked to the relevant Jira work items and executed before the validator is triggered.
Steps to configure the validator on a workflow transition
In Jira, go to your Space Settings > Workflows.
Edit the relevant workflow and select the transition to validate.
Add a Regular Expression Check validator using the Vansah TR Status field.
Steps to set a default Test Result Status for new work items (optional)
Click the Vansah TR Status field in the configuration screen.
Click Edit Default Value.
Select a valid status (e.g. N/A) from the dropdown.
Click Set Default.
Test Result Status values
Status | Meaning | Required |
No-Test-Cases | No Test Cases linked | Yes |
Untested | All linked Test Cases are untested | Yes |
Passed | 100% coverage, all passed | Yes |
Passed-In-Progress | Some passed, at least one untested | Yes |
Failed | 100% coverage, all failed | Yes |
Failed-In-Progress | Some failed, at least one untested | Yes |
N/A | All Test Cases marked Not Applicable | Yes |
N/A-In-Progress | Some N/A, at least one untested | Yes |
Example — Transition only when all tests pass
To block a work item from moving to Done unless all Test Cases have Passed:
Add a Regular Expression Check validator to the TESTING → DONE transition.
Set the field Vansah TR Status =
Passed.
If the condition is not met, Jira will block the transition and display a message to the user.
