Versions Compared

Key

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

Excerpt

A workflow validator that ensures the specified field or fields have a value during a transition.

When this validator is added to a transition and that transition is triggered, the add-on checks for a value in the selected field or fields. If no values are found, an error message is displayed; this error message will display a default value, or it can be customized.

To add 'Field Required' validator to a transition:

  1. In Jira Administration, go to Workflows and click the Edit link to open the workflow.

  2. Select the required transition.

  3. Select the Validators tab and click Add validator.

  4. Select Field Required Validator from the list of validators.

  5. Select the field name(s) in the Field(s) drop-down.

Note

Please note: only 10 (ten) custom fields can be added to the selected fields for the Field Required validator; more than ten system fields can be added. If more than ten custom fields are added, it will not be possible to add the validator to the transition. This is a known issue with Jira expressions, as documented in ACJIRA-2312.

6. Add a message in the Error message field to customize the error that is displayed to the user.

7. 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 Atlassian.

Note that this validator does not work for the following fields: Security Level, Watchers, Epic Color, Epic Name, Epic Status, Raised during.

Also, some custom fields from other apps, like Team of Jira Portfolio, though available in the list are not supported because of certain limitations (of the apps).

Info

Related links :

Image Removed

You are viewing the documentation for Jira Cloud.

Image Added

Validator Scope

Check the Ignore Scope option if the validation should only occur in certain cases. Examples include if the issue is of a certain issue type, has certain field values, or more generally satisfies an arbitrary Jira expression.


Use case

A typical use of this workflow validator is to validate that the field of the issue has a value during the transition. Consider a use case where you want to check that the “Approvers” field is not empty when sending the ticket for approvals. To configure this:

  1. Add the Field Required Validator to the “Send for Approval” transition.

  2. Select the Approvers field and configure an error message, if necessary.

  3. Save the validator.

  4. Publish the workflow.