1. Checklist for Jira - Server & Data Center Docs
  2. Administrator Guide

Modifying a Checklist in a Workflow

Created by sidharth sharma (Unlicensed)

Sometimes, Checklists need to be adapted to a particular workflow. The Checklist post-workflow function allows you to perform operation on one or multiple Checklists.

To modify a Checklist in a workflow, perform the following steps:

  1. As an admin user, navigate to Issues > Workflows, edit an existing workflow to locate the transitions, and click Post Functions.
  2. Click Add post function.

    The system displays the Add Post Function To Transition window. 

  3. Select the Modify Checklists option and click Add.

    Function NameSpecify a name that can help you to identify this function when displayed among all the other post workflow transition functions.
    Applicable ChecklistsSelect the Checklist(s) that should receive the operations. If you do not select any Checklist, all Checklists applicable to the transitioning issue are modified.
    Existing Items - Completion

    Select one of the operations that must be applied to the existing Checklist items completion:

    • Do not change items. If you do not want existing items to be changed.
    • Uncheck all items. If you want to uncheck all the existing items.
    • Uncheck items matching the following regular expression. If you want to uncheck specific items that match the defined regular expression.
    • Check all items. If you want to check all the existing items.
    • Check items matching the following regular expression. If you want to check specific items that match the defined regular expression.
    Existing items - Statuses

    Select one of the operations that must be applied to the existing Checklist items statuses:

    • Do not change statuses. If you do not want existing items to be changed.
    • Remove all statuses. If you want to remove the statuses from all the existing items.
    • Remove statuses from items matching the following regular expression. If you want to remove status from specific items that match the defined regular expression.
    New Items

    Specify all the items that you want to add to the Checklist after the transition. You can select Append or Replace to append or replace the current Checklist current items respectively. To append only the items that do not exist in the list, select the Only append items that do not exist check box. By doing so, you can prevent items to be added again if the same transition is applied multiple times.

    Conditional rules

    Configure the conditions that must be satisfied in order to perform the operations. If all the rules are evaluated to true, the operations are performed on the Checklist. If any of the rule is evaluated to false, the operations are not applied. You can currently build rules based on:

    • JQL Query. The query is automatically augmented to run against the current issue only. If the rule is validated then the operations are applied to the Checklist. You can use a JQL filter (that you have designated as your favorite) or create your own query.

    • Issue Label. If the issue is returned specific to an issue label.
    • Issue Type. If the issue is returned specific to an issue type.
  4. Click Add.