Scheduled Jobs

Scheduled Jobs allow you to orchestrate multiple actions, such as import and export feeds, job retrials, system updates, etc to be executed automatically. You can set the sort order for the execution of your Retrial, run the sequence at the given time, or manually, in just one click.

Main functions

Every job has a type Job (type of the Scheduled Jobs), Name, Status and Scheduling. Scheduling defines frequency of job runs. To use it, press i to get the syntax. For example, 0 0 SUN on the picture below runs the job on every Sunday. Default Name (if not set manually) is the same as Job and Scheduling is "/10 *".

You can also run the job right now, not regarding the schedule. You can do it by pressing Execute Now button.

Note that no two executions can be run in the same minute. The time used in it is system time.

All job executions can be seen in log.

Scheduled Jobs types

Scheduled Jobs can provide different job types to execute:

Automatic system update

This jobs start system update on the schedule you set. The settings set by update are taken from the Modules menu, so it is essentially pressing the Update button on the set time.

Import Feed

This job starts the selected import feed on the schedule you set. The settings set by the feed are taken from the feed menu, so it is essentially pressing the Import button on the set time.

Automatic PDF generation

This job starts generating PDFs as assets that are appropriate for selected PDF template.

Note that this job may take a lot of time and server resources, so please schedule its execution when you do not need to work in the system.

Refresh Cache for Dynamic Relations

This job is used when you use dynamic relations, such as dynamic categories. Refreshing cache is needed for relations to show up-to-date data.

Export Feed

This job starts the selected export feed on the schedule you set. The settings set by the feed are taken from the feed menu, so it is essentially pressing the Export button on the set time.

Recalculate Product Price

This job is used when you use dynamically calculated prices. This job starts recalculating action for all products.

Note that this job may take a lot of time and server resources, so please schedule its execution when you do not need to work in the system.

Update exchange rates via ECB

This job inserts current exchange rates taken from ECB to PIM currencies. Only currencies and rates supported by ECB are affected by this job.

Connector

This job starts the selected connector on the schedule you set. The settings set by the feed are taken from the connector menu, so it is essentially pressing the Execute button on the set time.

Failed jobs retrial

This job looks for the selected jobs done by import and export feeds and/or other scheduled jobs and then starts ones of them that had failed status in the last hours set in Maximum hours to look back field.

Delete data jobs

Scheduled jobs also include jobs for deleting outdated data. These are system jobs which start with the "Delete". Only administrator can change the settings of the delete jobs in the config.php file. By default, import and export jobs and their logs, attachments, notifications, action history records and queue items older than 21 days are deleted. Cleaning is run once a week, every Sunday. To see the status of the delete jobs, you need to select the Jobs tab on the Scheduled jobs page.

Delete records permanently

After the are deleted by the job, they are stored in the database for 14 days before they are deleted permanently. This value can be changed in the config.php file or from the user interface. In order to set the number of days after which the record will be permanently deleted, you need to create a corresponding variable in the system. The following variables are available for this purpose:

• actionHistoryDeletedMaxDays - determines the time of storing Action History records in the database
• authLogsDeletedMaxDays - determines the time of storing Auth Logs in the database
• jobsDeletedMaxDays - determines the time of storing Jobs in the database
• notificationsDeletedMaxDays - determines the time of storing Notifications in the database
• queueItemsDeletedMaxDays - determines the time of storing Queue Items in the database
• scheduledJobLogsDeletedMaxDays - determines the time of storing Scheduled Jobs Logs in the database
• exportJobsDeletedMaxDays - determines the time of storing Export Job Logs in the database
• importJobsDeletedMaxDays - determines the time of storing Import Job Logs in the database

In this example, the value of variable exportJobsDeletedMaxDays is set to 0. This means that the records will be permanently deleted from the database immediately after removing from the system.