Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can prevent the Jira issue from transition to the next state if not all Smart Checklist items are checked. That's done by validating the "Smart Checklist Progress" custom field on a specific value.

Warning

Not available in next-gen projects. Please see the details here.

Info

This instruction describes the process of setting up a validator for CLOUD and SERVER instances. Read carefully which one you are trying to set up.

The process is pretty straightforward and covers:

  • "Smart Checklist Progress" custom field creation

  • Setting Up Validator for Cloud/Server

  • Verifying validator for Cloud/Server

...

Warning

Make sure you don't have this field on your Jira instance already.

  1. Go to "Custom Fields".

  2. Press "Add Custom Field".

  3. Choose "TextField (single line)".
    Image Modified

  4. Name it "Smart Checklist Progress".

  5. Associate screens to the projects where you want to track progress and set up a validator.

...

  1. Image Added
Warning

IMPORTANT

When adding the custom field "Smart Checklist Progress", mind the caps letters and exact wording.

Set up transition validator for CLOUD Instances (info) (read about Server below)

  1. Go to "Workflows".

  2. Choose one that you want to add validation to and click Edit:

...

  1. Image Added
  2. Choose transition and click on the "Validators" link:

...

  1. Image Added
  2. Add Validator:

...

  1. Image Added
  2. Choose "Regular Expression Check":

...

  1. Image Added
  2. Choose "Smart Checklist Progress" field.

  3. Set Regular Expression value to:

    Code Block
    (^$|.*Done)

...

  1. Image Added

  2. Click Add -  a new Validator will be saved: 

...

9. Then Publish this changed workflow:

...

Check Validator in action. CLOUD Instances

  1. Go to Kanban board (or Issue view).

  2. Try to change the state of an item with opened checklist items.

  3. You'll get the error:

...

  1. Image Added
  2. If you check all Smart Checklist items - you'll be able to transition the Jira issue successfully:

...

  1. Image Added
  2. Enjoy!

Set up transition validator for SERVER Instances (info) (read about Cloud above)

  1. Go to "Workflows".

  2. Choose one that you want to add validation to and click Edit.

  3. Choose transition and click on the "Validators" link:

...

4. Add Validator:

...

5. Choose "All Smart Checklist items are checked off".

6. Click Add - a new Validator will be saved.

...

Check Validator in action. SERVER Instances

  1. Go to Kanban board (or Issue view).

  2. Try to change the state of an item with opened checklist items.

  3. You'll get the error:

...

4. If you check all Smart Checklist items - you'll be able to transition the Jira issue successfully!

...