Validate Mandatory Items Completion before Transition

Owned by Mariya Solovey, created
Last updated: Jan 30, 2024
2 min read

Prevent the Jira issue from transitioning to the next state if any mandatory checklist items remain unchecked/uncompleted 🚀

Jira permissions needed: grant users Jira administrators global permissions to setup validator of mandatory items completion before transition

 

You can prevent the Jira issue from transitioning to the next state if some mandatory checklist items remain unchecked/uncompleted.

Here is an example of default and custom statuses created on the Cloud instance:

image-20240129-122408.png

 

Statuses for
UNCHECKED/UNCOMPLETED items

 

 

Statuses for
CHECKED /COMPLETED items

 

You can do this by adding a corresponding validator to your workflow transition.


Set up a transition validator:

  1. Go to Project Settings → “Workflows".

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

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

    image-20231229-150931.png

     

  4. Add Validator:

    image-20231229-151005.png

     

  5. Choose "Smart Checklist Mandatory Validator":

    image-20231229-151046.png

     

  6. Click Add -  the new Validator will be saved: 

    image-20231229-151121.png

  7. Publish the changed workflow:

image-20231229-151146.png


Check Validator in action:

  1. Open the issue where you want to change the status.

  2. Add Smart Checklist mandatory items to the issue. Follow the steps from Mandatory items testarchived to do it.

  3. Try to change the state of an issue with open mandatory checklist items (any items in status Todo, In progress, and any other not checked custom status) to Done (or any other issue status for which you add the validator).

  4. You'll get the Transition failed error:

    image-20240129-122743.png

  5. If you complete all Smart Checklist mandatory items - you'll be able to transition the Jira issue successfully.

  6. Enjoy 🚀