When you add this validator to a transition and trigger the transition, the add-on validates the specified condition against the Status of the linked issue(s) (existing and ones added during the transition). If the condition is not met, the transition fails, and an error message.
The list of statuses displayed under the Statuses field has all the statuses across different workflows. This is because the workflow of an issue and that of its linked issues can be different.
Configure the following:
Issue Link Type (mandatory): Select the issue link type that links the current issue to the linked issues to check the specified condition against. Leave "Any (default option)" for no restrictions.
Mode (mandatory): Select one of the following conditions to be run on the linked issue(s) for the transition to be enabled:
All issues must be in the selected statuses below (default option)
At least one issue must be in one of the selected statuses below
No issue must be in one of the selected statuses below
At least one issue must not be in one of the selected statuses below
Issue Type (mandatory): Select the issue type of the linked issue(s) to check the specified condition against. Leave "Any (default option)" for no restrictions.
Statuses (mandatory): Select one or more statuses from the available list to check the specified condition against.
Error message: Enter the error message to be displayed if the condition mentioned in the Modesection is not satisfied. If left empty, the following default error message is displayed: Transition is not authorized because linked issues are not in the required status.
Validator scope: Use this option to control when to run the validator. Conditional Validation (mandatory): Select this option if you want the validation to be performed only in certain cases, such as if the issue is of a certain issue type or only if the issue is unassigned, or more generally satisfies an arbitrary Jira expression mentioned in Condition (displayed only when this option is selected).
A typical use of this workflow validator is to validate that the issues linked to the current issue are in a specific status. Consider a use case where you want to block the user from closing the Epic until all the issues under it are closed. To configure this:
Add the “Linked Issues Status validator” to the “Close” transition