Versions Compared

Key

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

In SmartStore.NETSmartstore, you are often required to run tasks at specified times on a regular basis to manage various activities. The Task  Scheduler enables you to schedule jobs that automatically run predefined scheduled tasks at the specified time. The types of tasks which can be scheduled cover:

  • Sending queued emails

  • Deleting obsolete or transient records from the database

  • Cleaning up the temporary files folder

  • Cache management

  • Updating currency exchange rates

  • Generating feed or export files

Besides the tasks that are part of the application core, third party plugins may also install custom tasks, e.g. to poll or synchronize (external) data on a regular basis.



Panel
bgColor#f7f7f7
titleOn this page
Table of Contents
maxLevel2


Accessing the Scheduled Tasks List

Scheduled tasks can be viewed and managed by navigating to System -> Scheduled Tasks

Scheduled Tasks ListImage Removed
Scheduled Tasks ListImage Added

All tasks are listed with information under the following headings:

  • Enabled - Shows whether the task is scheduled or disabled 

  • Cron Expression - the cron expression defining the frequency at which the task is executed and its human readable description below

  • Last Run- Info about the task's last execution (date and time, duration and possible error)

  • Next Run - the date and time when the task is next scheduled to be executed. This column will be empty if the task is disabled. If the task is currently running, an animated progress indicator will be displayed instead.

  • Actions -

 Options
  •  Options to edit the task, run it manually or cancel the task (if it's running)

Running a Task Manually

To run a task manually, head to the Scheduled Tasks list and choose  Run Now in the Actions column. It will run immediately. 

Editing a Task

To edit a scheduled task, go to the Edit Task screen by choosing Edit in the Actions column.

Editing a taskImage Removed
Editing a taskImage Added

150px|Field

Description

Enabled

Check the box to enable the scheduled execution of the task in accordance with the cron expression. Uncheck to disable scheduled execution. Disabled tasks can still be executed manually.

Disable on Error

Check the box if the task should be disabled automatically when an error occurs during scheduled execution.

Cron Expression

Enter an expression that defines the schedule for the automatic execution of the task. Read more about cron expressions further below.

 


Types of Tasks

150px|Task Name

Description

Default Schedule

Send E-Mails

Sends all e-mails in the message queue. For more information about the e-mail queue, read the topic Analyzing the Message Queue.
(warning) If you disable this task, neither you nor your customers will receive e-mails anymore.

Every minute

Clear E-Mail Queue

Clears queued e-mail entries that have already been processed to ensure that its size does not grow indefinitely.

At 02:00 AM every day

Delete Logs

Deletes log entries which are older than 7 days to ensure that its size does not grow indefinitely.

At 01:00 AM every day

Delete Guest Accounts

Deletes transient guest customer accounts which are older than 24 hours to ensure that its size does not grow indefinitely.

At 01:00 AM every day

Clear Cache

Clears the application's memory cache to free up memory.

Every 4 hours

Cleanup Temporary Files

Deletes temporary application files from folder App_Data/_temp to free up disk space. Does NOT touch subfolders.

At 03:30 AM every day

Update Currency Exchange Rates

Fetches updated currency exchange rates from a web service and imports them into the application database.

Every 15 minutes

Clear Transient Uploads

Deletes transient (unassigned) uploaded binary data from the database and file system to ensure that its size does not grow indefinitely.

At 01:30 AM and 01:30 PM every day

Anchor
Cron
Cron

Cron Expressions

A cron expression is a string of 5 'time interval' fields that defines the frequency at which a task is executed. Each of these fields can be expressed as either a numerical value or a special character, and each field is separated by a space character. 

The following graph shows what a cron expression consists of:

* * * * * | | | | | | | | |

* * * * * | | | | | | | | | +----

Day

of

the

Week

(range:

0-6

or

SUN-SAT,

0

standing

for

Sunday)

|

|

|

+------

Month

of

the

Year

(range:

1-12

or

JAN-DEC)

|

|

+--------

Day

of

the

Month

(range:

1-31)

|

+----------

Hour

(range:

0-23)

+------------

Minute

(range:

0-59)

 

  • Any of these 5 fields may be an asterisk (*). This would mean the entire range of possible values, i.e. each minute, each hour, etc.

  • Any field may contain a list of values separated by commas, (e.g. 1,3,7) or a range of values (two integers separated by a hyphen, e.g. 1-5).

  • After an asterisk ( * ) or a range of values, you can use the slash character (/) to specify that values are repeated over and over with a certain interval between them. For example, you can write "0-23/2" in Hour field to specify that a certain action should be performed every two hours (it will have the same effect as "0,2,4,6,8,10,12,14,16,18,20,22"); value "*/4" in Minute field means that the action should be performed every 4 minutes, "1-30/3" means the same as "1,4,7,10,13,16,19,22,25,28".

  • In the Month and Day of Week fields, you can use the names of months or days of weeks abbreviated to the first three letters ("JAN,FEB,...,DEC" or "MON,TUE,...,SUN") instead of their numeric values.

Cron Expression Examples

Here are some full examples:

Expression

Meaning

*   *   *   *   *

Every minute

5   *   *   *   *

Five minutes past every hour (00:05, 01:05, 02:05 etc.).

0/15 * * * *

Every 15 minutes

0 */2 * * *

Every 2 hours

0 1 * * *

Every day at 01:00 AM

*   12   *   *   1

Every minute from 12:00 PM, only on Monday

59   11   *   *   1 , 2 , 3 , 4 , 5

At 11:59 AM, only on Monday, Tuesday, Wednesday, Thursday, and Friday

59   11   *   *   1 - 5

This pattern is equivalent to the previous one. Value ranges are omitted and defined using the hyphen character

*/ 15   9 - 17   *   *   *

Every 15 minutes, between 09:00 AM and 05:59 PM

*   12   10 - 16 / 2   *   *

Every minute from 12:00 PM, every 2 days, between day 10 and 16 of the month

*   12   1 - 15 , 17 , 20 - 25   *   *

Every minute from 12:00 PM between the 1st and the 15th, the 20th and the 25th, and the 17th of the month.