Validating a Checklist


To prevent an issue from transitioning from one state to another until a checklist is completed, perform the following steps:

  1. Navigate to Settings > Add-ons > Checklist Definitions
  2. Under the Preferences section, select the Sync with custom field check box. This creates a custom field with the name: Checklist Progress, followed by the name of the definition.

  3. Navigate to Settings > Issues > Workflows
  4. Edit the desired workflow
  5. Click the transition that you want to apply the validator to. For example, Done.
  6. Click Validators
  7. Click Add validator, select the Checklist Validator option, and click Add.
  8. In the dropdown list select the checklist you need to validate. If you don't see your checklist here, look for the information messages on the page and consult the notes below.

  9. Select the appropriate type of validation: either all items need to be completed or only the mandatory ones. Click the Add button.
  10. Publish your workflow to ensure that the validator is active.

Notes

For a validator to work you need to configure the definition to sync its completion state with Jira (see step 2 above) so that the corresponding customfield exists.

If some definition does not sync its data, you will see a notification when trying to create a validator. If some definition is configured to sync its data but the customfield does not exist anymore (e.g. it was accidentally deleted), you will see an error message.

Similarly, when viewing the validator, you will see an error if its customfield no longer exists:

Legacy RegExp validator configuration

If you experience any problems with the checklist validator, please contact us via the support portal.

In the meantime you can use the old way to create a RegExp validator manually, as described here. However, please note that this approach is outdated and is generally not recommended.