Scheduled actions

Add a scheduled action

To add a Scheduled action:

1. Navigate to Jira Settings → Manage apps → Scheduled actions.
   
   

   Open

   

    

2. Click Add scheduled action on the top right corner to navigate to Scheduled action editor where you can add the configuration details.
   
   

   Open

   

    

   Add the following:

   • Action name (mandatory): Enter a meaningful name for the action.

   • Description: Enter a more detailed explanation of what the action would accomplish.

   • User (mandatory): Start typing into the field to select a user from the auto-suggestions. The scheduled action is run as the selected user.

   • Schedule (mandatory): Set the schedule for this action. This schedule is defined in UTC time. You can run the schedule every hour, every day, every week, every month, or every year at specific times. A schedule can be set as frequently as once every 10 minutes. For examples of different schedules, click here.

   • Target Issues (mandatory): Select issues on which the specified post-functions are run.

     • JQL Expression (mandatory): Enter a JQL expression that returns a set of issues. For example, to fetch issues from ProjA in Open status, use:
       project = ProjA and status = open
       You can also include Groovy Template markup that returns a JQL query. For example, to fetch issues assigned to the current user, use:
       <% if (issue.get("assignee")) { %> assignee = ${currentUser.name} <% } else { %> issuekey=INVALID-1 <% } %>

     • Max. issues (mandatory): Enter the maximum number of issues that the JQL search can return. The maximum limit here is 1000.

   • Post-functions: Add one or more post-functions that are run on each issue returned by the JQL search mentioned in the previous section.
     Click Add post-function to navigate to the window that lists all the available post-functions. Select a post-function, configure as needed and add it to the list here. The post-functions added here are run in the sequence displayed. You can use the ☰ handle to drag a post-function and drop it wherever required in the list to reorder the sequence.
     Use Edit or Remove to make changes to the respective post-function or delete it from the list here.

   • Error handling
     Skip subsequent post-functions if a post-function encounters an error: Select this option to skip running the remaining post functions in the sequence when an error occurs in one of the post functions.

3. Click Save to save the configuration and add the scheduled action to the list on the Scheduled actions page.

Examples of schedules

Edit a scheduled action

1. On the Scheduled actions page, click the menu icon next the scheduled action you wish to modify and select Edit .

2. Modify the action details in the Scheduled action editor screen.

3. Click Save to save the changes.

Copy a scheduled action

Sometimes it is easier to create a new action based on one that already exists. The Copy option lets you do just that.

1. On the Scheduled actions page, click the menu icon next the action you wish to duplicate and select Copy.

2. A new scheduled action is created with “Copy of” in front of the action name and the Status is disabled by default.

3. Follow the steps in Edit a scheduled action above, to make modifications.

Delete a scheduled action

1. On the Scheduled actions page, click the menu icon next the action you wish to delete and select Delete to remove the respective action permanently.

2. Click OK in the confirmation dialog to confirm. The scheduled action is deleted.

Enable/disable a scheduled action

In the Scheduled actions screen, turn the toggle Off or On to disable or enable the respective scheduled action. By default, a newly created scheduled action is enabled.