Scheduled Jobs

Before you start

What are Scheduled Jobs?

Scheduled Jobs allow you to automate the running of scripts at regular intervals saving your administrators time, and reducing the risk of human error. You can specify when, and how often, a job should run.

How to use Scheduled Jobs

You may want to use a Scheduled Job to:

• Create an issue once per month.

• Email a report to users, on a schedule.

• Delete inactive users on a monthly basis.

• Change the status of an issue depending on the time it has been open.

• Automatically escalate an issue based on the elapsed time using Escalation Services.

Say, I have a team of consultants who need to fill out expenses at the end of every month. I can create a Scheduled Job to automatically create a task for each user at the end of every month to remind them to complete their expenses.

As a Jira administrator, it's key to keep my instance healthy and reduce costs by removing inactive users. I can set up a job to run a script that deletes inactive users on a monthly basis.   

Create a Scheduled Job

You can use Scheduled Jobs to ensure code runs either at a specified time of day/week/month, or on an interval, in order to perform an automated task in your Jira instance. 

Follow the steps below to use this feature:

1. Navigate to ScriptRunner → Scheduled Jobs.
   Depending on whether or not you have already created scheduled jobs, you are presented with either a landing screen or a list of previously created jobs.
2. Click Create Scheduled Job from the initial landing screen if none have been previously created. If you would prefer to make use of our built-in examples, click Add Examples to add two scheduled job examples.
   
   OR
   Click Create Scheduled Job from the previously created list.
   
3. (Optional) Click Edit or Delete via the Actions ellipsis for the relevant scheduled job you would like to modify/delete.
4. Enter a name in The Scheduled Job called field.
   
5. Activate the Enable Scheduled Job toggle. When set to Enabled, the scheduled job is active as soon as it has been saved.
6. Click on the edit pencil within the On this schedule field.
   • The Scheduler dialog lets you choose between running your script on several days during the week (e.g. Monday, Wednesday, Friday), or running your script on particular days of the month (e.g. the last day of the month, the 2nd Tuesday of the month).
   • You can enable a monthly schedule.
   • Additionally, you can select an hour interval during which time your script will run.
   • Each Scheduled Job can execute for the same length of time as Script Listeners, Post Functions and in the Script Console as documented in the script limitations. See also the Escalation Service that lets you configure code that will be executed against each issue returned from a JQL search, on a schedule. This is useful for performing automated transitions/releases/updates of issues.
   • You can test your script using the Run Now button, which will execute the script and return the results and logs.
7. Click Save. 

Edit a Scheduled Job

1. Navigate to ScriptRunner → Scheduled Jobs. A list of all scheduled jobs is shown.

2. Click Edit on the Actions ellipsis of the scheduled job you wish to edit.
   

3. Amend the fields as required. As previously noted, you can click the Run Now button to test your script.
4. Click Save when all changes have been made. You can also click Revert to undo those changes.