Versions Compared

Key

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

Automation for Jira is a popular tool to get your team automated by creating additional workflows, rules, and processes.

...

This flow can also be achieved by the built-in Templates functionality of Smart Checklist. Visit this page for guidance.

  1. Go to Automation for JiraAutomation Rules

    1. Image Modified
  2. Click Create Rule

  3. Set When: New Trigger

    1. Choose Issue created → Save

      • Image Modified
  4. Add component New Condition

    • Image Modified
  5. Set New Condition

    1. Choose JQL condition

      • Image Modified
    2. Add filter per Issue Type

      Code Block
      issuetype = Bug
      Image Modified
    3. Save Condition

  6. Add component New Action

    • Image Modified
  7. Set New Action

    1. Choose Set entity property

      • Image Modified
    2. Choose Entity type: Issue

    3. Set Property Key

      • Code Block
        com.railsware.SmartChecklist.checklist

    4. Add checklist template in Markdown formatting as the property value

      • Image Modified
    5. Save Action

  8. Save and Turn Automation On

    • Image Modified
  9. You're done! Now every time a "Bug" issue created - a proper Template will be added as a checklist.

Append Checklist Items on Issue Transition

This flow can also be achieved by means of the built-in functionality of Smart Checklist. Visit this page for guidance.

  1. Go to Automation for JiraAutomation Rules

    • Image Modified
  2. Click Create Rule

  3. Set When: New Trigger

    1. Choose Issue transitioned 

    2. Choose from status (e.g. Backlog) and to status (e.g. Selected for Development)

    3. Save

      • Image Modified
  4. Add component New Action

    • Image Modified
  5. Set New Action

    1. Choose Set entity property

      • Image Modified
    2. Choose Entity type: Issue

    3. Set Property Key

      • Code Block
        com.railsware.SmartChecklist.checklist

    4. Add checklist template in Markdown formatting as the property value and add the following in the beginning: 

      • Code Block
        {{issue.fields.Checklists}}

      • Image Modified

...

Alternatively, it is also possible to do the same via Issue Properties:

...

Transition an issue to the next state when all the checklist items are completed

  1. Add trigger "When" Field Value is changed.

    1. Add "Smart Checklist Progress" field and "Edit Issue" as For operator

      1. Image Modified
  2. Then Add "Compare Condition" automation block

    1. Set First Value: {{issue.Smart Checklist Progress}}

    2. Set Condition: "Exactly match regular Expression"

    3. Set Regular expression: (^$|.*Done)

      1. Image Modified
  3. Then Add "Transition Issue" automation block

    1. Set "Destination status", e.g. "Done"

      1. Image Modified
  4. Save the Automation Rule

Check the quick demo:

Add Checklists to Subtasks during New Issue creation

If you want to add checklists to automatically created subtasks - follow these steps.

  1. Choose the trigger Issue created

    1. Image Modified
  2. Choose the action Create sub-tasks

  3. List subtasks you need

    1. Image Modified
  4. Click Add fields  - your subtask will be converted to a separate action step

  5. Choose Same Project to be sure the sub-task is not lost

    1. Image Modified
  6. Add "Checklists" custom field from Choose fields to set

  7. Then add checklist items using checklist Markup formatting. Check the detailed guide.

    1. Image Modified
  8. Save and publish the Automation Rule

  9. Now when you create a Jira issue new sub-tasks will be created automatically

    1. Image Modified
  10. Click on the one that contains the checklist  - see it's rendered with Smart Checklist add-on

    1. Image Modified

Add Checklist to Service Management tickets for certain Request types (not a JIRA issue type)

Service Management Request types are Jira issue types, but specific for Service Management.

  1. You would need to check what issue type you have for "New User Account" requests

    • Image Modified
  2. and then create an Automation rule for this specific issue type. 

  3. E.g. If you have a Request Type called "Get IT help" and it has "Service Request" issue type: 

    • Image Modified
  4. In Automation, you would need to create a rule that would add a checklist to all the new requests of "Service Request" type

    1. Set Trigger. When: Issue Created

    2. Image Modified
    3. Set Condition. If: Issue matches JQL 

      • Code Block
        issuetype = 'Service Request' 

    4. Set Action. Then: Set Issue Property

      • Code Block
        com.railsware.SmartChecklist.checklist

      • And set the value of the checklist you need

Set checklist depending on a custom field value after issue creation

  1. Go to Automation for JiraAutomation Rules

    1. Image Modified
  2. Click Create Rule

  3. Set When: New Trigger

    1. Choose Issue created → Save

      • Image Modified
  4. Add component New Condition

    • Image Modified
  5. Set New Condition

    1. Choose Issue fields condition

      • Image Modified
    2. Select your needed custom field

    3. Choose the condition equals

    4. Add the value of your custom field

      • Image Modified
    5. Save Condition

  6. Add component New Action

    • Image Modified
  7. Set New Action

    1. Choose Set entity property

      • Image Modified
    2. Choose Entity type: Issue

    3. Set Property Key

      • Code Block
        com.railsware.SmartChecklist.checklist

    4. Add checklist template in Markdown formatting as the property value

      • Image Modified
    5. Save Action

  8. Save and turn the Automation Rule On

  9. You're done! Now every time an issue with a defined custom field value is created - a proper Template will be added as a checklist.

Bulk update checklists

This goes about Issues bulk update when you set a value for a field you'd like to populate to all the selected issues.

The field you’ll be populating to update checklists is “Checklists“.

...

Note

Do it before running a bulk import

  1. Go to Automation for Jira → Automation Rules

  2. Click Create Rule

  3. Set When: Field value changed Change

    1. Choose Checklists → Save

      • Image Modified

  4. Add component New Action

    1. Choose Set entity property

      • Image Modified
    2. Choose Entity Type: Issue

    3. Set Property Key

      • Code Block
        
        com.railsware.SmartChecklist.checklist

    4. Add the following to the Property value

      • Code Block
        
        {{issue.Checklists}}

      • Image Modified
    5. Save

  5. Save the rule and Turn Automation On

  6. Proceed with the bulk update.

  7. Once the bulk update is completed, turn the rule off.

Note

Make sure this rule is only enabled when you need it for the bulk update operation. Otherwise, it will constantly run the synchronization, and you don't need that as a normal checklist operation would suffer.

...

You can set Automation to create a request in a Jira Service Management project based on the status of a single item in a checklist.

  1. Create Rule.

  2. Set Trigger → Field value changed, choose Smart Checklist Progress as a field to monitor for changes. Save.

  3. Set New condition → Issue field condition.

  4. Fill Field → Checklists, Condition → contains, set the needed Value/Field. And Save.
    Here’s how it looks:

...

Create a new Jira issue when all checklist items in a “source” Jira issue are completed

You can set the Automation rule to create a new Jira issue if all the checklist items at the "source" issue are marked as completed.

  1. Create Rule.

  2. Set Trigger → Field value changed, choose Smart Checklist Progress as a field to monitor for changes. Save.

  3. Set New condition → Advanced compare condition.

  4. Fill First value → {{issue.Smart Checklist Progress}}, Condition → exactly matches regular expression, Regular Expression → (^$|.*Done). Save
    Here’s how it looks:

...

5. Add Action → Create issue

6. Save the rule and Turn Automation On

...

Info

For any questions or feature requests contact us: smartchecklist@railsware.com