New Feature Announcement
Global Checklists are currently in BETA and will be available in Issue Checklist for Jira ENTERPRISE once released. Contact our support team if you are Issue Checklist for Jira PRO user and you would like to participate in the Beta.
Company-managed Projects
This validator blocks a transition unless all items, including items on both local and Global Checklists are complete.
To set the workflow validator:
Navigate to Project Settings > Workflows
Click the pencil icon to edit the workflow.
Select Diagram mode and click on the transition where you want to add the validator.
Click on Validators.
Click Add validator.
Select the All checklist items are completed validator and click Add.
Click Add again to confirm creation of the validator.
Click Publish draft to save the changes.
Test the validator by attempting to transition an issue which does not meet the criteria. The transition will fail.
Troubleshooting Validators
Checklist for Jira uses issue entity properties to provide the following features: Therefore, the Checklist must be able to set issue entity properties. This is enabled by default. However, if a jira.permission.* workflow property has been set on a workflow step, Issue Checklist may not be able to set issue entity property. For example, the following property will prevent Checklist from setting issue properties, and features listed above won't work correctly: Removing the jira.permission.* workflow property and using the standard Jira permissions to control who can edit the issue will allow the Checklist functions to work.
Team-managed Projects
You can create a rule in a Team-managed project that will block a transition unless all checklists on the issue (including items on both local and Global Checklists) are complete. If the checklist is not complete, the user will not be shown the target status (similar to a workflow condition in Company-managed projects).
To create the rule:
Navigate to Project settings > Issue types.
Select the appropriate issue type. Use the Search all fields box to find the Checklist Completed custom field and drag it to the appropriate place on the Issue layout. Click Save changes.
Click on the Edit workflow button.
Click Rule.
Select Restrict transition as the Rule type, and choose Restrict to when a field is a specific value. Click Select.
Select the appropriate transition.
Select:
Checklist Completed as the field
Text as the type
Equals as the condition
All Completed as the value
Click Add.
Click the Update workflow button to publish the rule.
