Our new Appfire Documentation Space is now live!

Take a look here! If you have any questions please email support@appfire.com

Linked Issues Status Validator

Are you using JMWE for Jira Server and Data Center and want to learn how to use this validator? Head to our documentation here.

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.

  1. In the Workflow Designer, select the transition.

  2. Click Validators in the properties panel.

  3. Click Add validator.

  4. Select Linked Issue(s) Status Validator from the list of validators.

  5. Click Add to navigate to the Linked Issues Status Validator screen where you can configure the validator as needed. See configuration details here.

  6. Click  Add to add the validator to the transition.

On the Service Management portal view of a request, the customer will not see the Error message when the validator fails. This is due to a known limitation (JSDCLOUD-5853) with Atlassian.

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.

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 Mode section 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:

  1. Add the “Linked Issues Status validator” to the “Close” transition

  2. Select the “Issue Link Type” as “is Epic of”

  3. Select the status “Closed” from “Statuses”

  4. Save the validator

  5. Publish the workflow