Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
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.

  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, below.

  6. 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 Error message when the validator fails. This is due to a known limitation (JSDCLOUD-5853) with Atlassianissues have a status value matching the status values you’ve configured.

When you add this validator to a transition and trigger the transition, the add-on extension 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.

Note

Note: 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

.

Include Page
[Includes] Add Validator
[Includes] Add Validator
Note

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.

Configure the validator

  1. Follow the steps above to add a validator to a transition.

  2. From the list of validators, select Build-your-own (scripted) Validator (JMWE app).

  3. The Build-your-own (scripted) Validator page will open. Configure the validator as needed. See below for details on each of the configurations.

  4. Click Add.

Note

Note that you will need to publish the workflow for the new validator to take effect.

The following configurations are available:

  • 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 against which to check the specified condition againstissues.

  • Error message: Enter the - 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 statusthat will display if the validator fails.

  • 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)

    • Conditional validation - Check this box to configure the validator to only run in specific circumstances.

    • Condition - Only visible when Conditional validation, above, is checked. Enter a Jira expression; if the expression evaluates to true, the validator will run.

    • Skip validation when cloning an issue - Check this option to skip the validator when an issue is being cloned.

Info

You are viewing the documentation for Jira Cloud.