Scheduled actions

Create a Scheduled action

To create a schedule action:

1. Navigate to the Jira Settings → Apps → Scheduled actions

2. Click on "Scheduled actions"

3. Click on "New scheduled action"

   1. Add a name and an optional description

   2. Add a Schedule (see below)

   3. Add the Target issues (see below)

   4. Add the post-functions (see below)

4. Click on "Save"

Edit a scheduled action

1. Click on “Edit” for the scheduled action

2. Modify the action details

3. Click on “Save”

Delete a scheduled action

1. Click on “Delete” for the scheduled action

2. Click on “OK”

3. The scheduled action is deleted.

Schedule

Configure how often this scheduled action should run. Every time the action runs, the JQL search below will be run, and the post-function(s) in the action will be run on each issue returned by the search, in turn.

Add a schedule

Enter the schedule in this section. Note that the schedule is expressed in UTC time. You can run the schedule every hour, every day, every week, every month, every year at specific times. 

Target issues

Input a JQL search that will return the issues on which the post-functions should be run. To input a JQL:

1. Click on "Edit JQL"

2. Input a JQL expression that will return the issues on which the post-functions should be run. See here to know how to write a JQL. For example:

   project = TEST and issuetype = Bug

3. Click on "Search" to check the issues returned by the JQL. It is recommended to check the results of the JQL to avoid invalid JQL.

4. Click on "Submit"

5. Select the maximum number of issues that the JQL search should return. Note that this cannot be more than 1000. 

Post-functions

On each issue returned by the JQL search above, the configured post-functions will be run, in the order in which they appear. You can reorder the post-functions by dragging them using the ☰ handle.

Add a post-function in an action

1. Click on “Edit” for a scheduled action

   1. Click on “Add post-function”

   2. Select the post-function

   3. Configure the post-function

   4. Click on “Save”

2. Click on “Save”

Edit a post-function in an action

1. Click on “Edit” for the action

   1. Click on “Edit” for the specific post-function

   2. Modify the post-function

   3. Click on “Save”

2. Click on “Save”

Reorder the post-function sequence in an action

1. Click on “Edit” for the action

   1. Drag the ☰ handle and reorder the post-functions

   2. Click on “Save”

2. Click on “Save”

Remove a post-function in an action

1. Click on “Edit” for the action

   1. Click on “Remove” for the specific post-function

2. Click on “Save”

Passing variables within a sequence

Using the {% setContextVar %} Nunjucks tag you can pass data from one post-function to all subsequent post-functions.

• context: Holds all the context variables added in the current post-function. For example, if you create a context variable myVar in the first post-function of the sequence:

  {% setContextVar myVar = "a value" %}

  This variable will then be available to all its subsequent post-functions as:

  {{ context.myVar }}

   Note that this variable will not be available in the Nunjucks tester.

Variables specific to the Create Issue post-function

• newIssueKey: Stores the issue key of the last issue created by a Create Issue(s) post-function in the action. You can access it as:

   

• newIssueKeys: Stores an array of the keys of all the issues created by any Create Issue(s) post-function in the action. You can access the created issues from

  For example: to add a comment on the current issue with the keys of the issue created

   

You can access the information of a specific issue using the issue filter. For example: To get the assignee of the issue created by the Create Issue post-function

Error handling

If one of the post-functions fails with an error, the remaining post-functions in the sequence are run anyway. To stop the execution of subsequent post-functions after an error occurs, select the option “Skip subsequent post-functions if a post-function encounters an error”.