Manage scheduled tasks
Overview
In Sitefinity CMS scheduled tasks are used to execute a predefined set of operations at a particular point in time. You can, for example, schedule a news item to be published at a particular date and time or schedule a site sync operation.
You can also create custom scheduled tasks, for example, using Sitefinity CMS event system to postpone the execution of heavy operations.
Sitefinity CMS has a page where you can view all scheduled tasks that are in progress, stopped, pending, or failed and take respective actions.
PREREQUISITES: To access the Scheduled tasks page, you must have administrative permissions.
Scheduled task page
To access the page with the list of all scheduled tasks, navigate to Administration » Scheduled tasks.
A list of all scheduled tasks in your Sitefinity CMS instance appears:
- The list contains failed, stopped, started, and pending tasks.
- All completed tasks do not appear – they can be found in the
Trace.log. - The list contains system tasks, as well as custom scheduled tasks that you create.
For more information, see Scheduled tasks API.
For each task, the following information is displayed:
|
Property |
Description |
|
Task name |
This is the full name of the class responsible for the execution of the task |
|
Item name |
The title appears below the name. This is the user-friendly name of the task as defined in the task definition. If there is no such name defined, the title does not appear. |
|
Recurrence indication |
When a task is recurring, next to its name, the system displays Recurring (?). If you click the question mark, the system displays the recurrence interval as a crontab expression in a tooltip. |
|
Status |
This is the status of the task. It can be one of the following:
|
|
Scheduled for |
This is the scheduled execution date of the task. |
|
Executed on |
This is the date when the system attempted to execute the task. |
NOTE: You can stop the execution of all scheduled stasks on a particular node of a load-balanced setup. For more information, see Disable the execution of scheduled tasks.
Task actions
You can access each task actions by expanding its Actions link. Depending on their status, you can perform the following actions with the scheduled tasks:
-
Failed tasks
You can attempt to Retry a failed task -
Pending tasks
You can Start a pending task.
To start a task means that instead of the scheduled execution date and time, you change it to the current date and time. When the scheduling module finishes processing current tasks, it will execute it. -
All tasks
You can delete all types of tasks.IMPORTANT: Deleting a stopped or a started task may cause data corruption. You must proceed with caution.
NOTE: You cannot start a stopped task and you cannot stop a started task. You must do that from the module where you have started or stopped the operation. For example, if you have stopped moving images from one library to another, to resume the operation, you must go to the Libraries module where you have stopped it
Sort tasks
By default, tasks are sorted by scheduled execution date in ascending order (by column SCHEDULED FOR). You can change that using the Sort dropdown box in the toolbar.
You can sort tasks:
- by Scheduled date - ascending
- by Execution date – ascending
- Alphabetically – ascending or descending
- by Status
Filter tasks
You can filter tasks by status, using the following filters in the right pane:
- All tasks
- Pending
- Started
- Stopped
- Failed
- Recurring
Search tasks
Searches in the task name.
You can sort the search results.
