Versions Compared

Key

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

Insert excerpt
Get Started
Get Started
namecontent-at-the-top
nopaneltrue

Tip

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

...

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

Let's go through the steps.

Create "Smart Checklist Progress" custom field

Warning

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

  1. Go to "Custom Fields".

  2. Press "Add Custom Field".

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

  4. Name it "Smart Checklist Progress".

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

    Image Removed
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)

...

Go to "Workflows".

...

Status
colourPurple
titleSmart checklist progress
Custom Field ⚡️

Info

RequiresSmart Checklist Progress Custom Field"Smart Checklist Progress" Custom Field set up

Panel
bgColor#FFFAE6

☝🏼 NOTE: Not available in Next-Gen projects. Workflow customization isn't available yet for Next-Gen projects. As of now, it is on the longer-term roadmap of the Atlassian team. Therefore, transition validators are not available either.

Set up Validator

  1. Go to Project Settings → Workflows

  2. Choose the Workflow you want to add validation to and click Edit:

    Image Added

...

  1. Add Validator

    3.1. Choose transition and click on the

...

  1. Validators

...

  1. link:

...

  1. Image Added


    3.2. Add Validator:

...

3.3. Choose

...

Regular Expression Check

...

and click Add:

...

3.4. Choose "Smart Checklist Progress" field

...

and set Regular Expression value to:

Regular Expression 👉🏻

Code Block
(^$|.*Done)

...

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

...

...

4. Then Publish this changed workflow:

...

Check Validator in action

...

  1. Go to

...

  1. your project Board.

  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:

...

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.

7. Then Publish this changed workflow:

...

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!

Tip

If you want to know how to display "Show Checklist progress" on Agile boards read Progress on Agile Board

...

  1. Image Added

Hope everything works for you! 🚀

Insert excerpt
Get Started
Get Started
namesupport-email
nopaneltrue