Excerpt |
---|
A workflow validator which ensures that the current issue's linked issues (existing and ones added during the transition) |
respect the specified condition against selected statuses. |
Click Edit for the workflow that has the transition you wish to configure the validator on.
In the Workflow Designer, select the transition.
Click on Click
Validators
in the properties panel.Click on
Add
validator
.Select
Linked Issue(s) Status Validator
from the list of validators.Click on Click
Add
to add the validator on the transition.Select the issue link type from the
Issue Link
drop-down.Select the issue type from the
Issue Type
field.Select the status(es) of the linked issues from the
Statuses
field.Click on navigate to the Linked Issues Status Validator screen where you can configure the validator as needed. See configuration details here.
Click
Add
to add the validator to the transition.
Note |
---|
On the Service Management portal view of a request, the customer will not see the |
Info |
---|
Are you using JMWE for Jira Server and Data Center and want to learn how to use this validator? Head to our documentation here. |
Related articles
When you add this validator to a transition and trigger the transition, the add-on checks validates the specified condition against the Status of each the linked issue(s) (existing and ones added during the transition). If any linked issue the condition is not in one of the selected statuses then met, the transition fails, and an error message is displayed.
Note |
---|
The list of statuses that is displayed under the |
Configuration details
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).
Use case
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
Select the “Issue Link Type” as “is Epic of”
Select the status “Closed” from “Statuses”
Save the validator
Publish the workflow