Skip to main content
Use the Scheduler to run mappings and workflows automatically at a specific time or on a recurring schedule. Open it from Execute > Schedule Job in the main header, or Scheduler in the left navigation menu. The screen has three panels:
  • Scheduled Tasks (left) — the existing scheduled jobs, grouped by job type and then by task type (Workflow or Map). Click a job to load it into the Scheduler panel. Click + to create a new job.
  • Scheduler (center) — the job definition form, or the job’s run history.
  • Activities (right) — the buttons used to save, remove, pause and resume jobs and to view history.
A paused job shows a pause icon in the tree. One Time jobs are removed from the tree automatically after they run.

Create a Scheduled Job

Click + in the Scheduled Tasks panel, then choose one of the three job types at the top of the Scheduler panel. All job types share these fields:
  • Scheduled Job Name — a unique name for the job. The name cannot be changed after the job is saved; create a new job instead.
  • Task Type — Map or Workflow.
  • Task Name — the mapping or workflow to execute. The list is filtered by the selected Task Type.

One Time

Runs the task once at the specified date and time.
  • Start Date — the date and time to run the job. Click the field to pick a date and time from the calendar, or type it in the format MM/DD/YYYY HH:MI AM/PM (for example 11/06/2026 01:00 AM).

Interval

Runs the task repeatedly, starting at the Start Date and then every Interval × Interval Type after that (for example every 1 Days, or every 4 Hours).
  • Start Date — the date and time of the first run. Subsequent runs are calculated from this value.
  • Interval Type — the unit of the interval: Weeks, Days, Hours, Minutes or Seconds.
  • Interval — the number of units between runs. For example, Interval Type Hours with Interval 4 runs the job every four hours.
The Start Date of an Interval job is stored in UTC. If your server runs in a different time zone, allow for the offset when choosing the first run time.

Cron Job

Runs the task on a Unix crontab style schedule. Use this for anything that does not fit a simple interval, such as “01:00 on weekdays” or “the first of every month”.
  • Cron Job — five space-separated fields: minute hour day-of-month month day-of-week. The table below the field lists the allowed values and special characters.
Examples: The syntax is validated when you click Save Job; an invalid expression is rejected with an error message.

Activities

  • Save Job — saves a new job, or saves changes to the selected job.
  • Remove Job — deletes the selected job from the scheduler. You are asked to confirm.
  • Pause Job — stops the selected job from running until it is resumed. The job keeps its definition and shows a pause icon in the tree.
  • Resume Job — resumes a paused job.
  • History — replaces the form with the run history for the selected job. The button changes to Scheduler; click it to return to the job definition.

History

The history view lists every run of the selected scheduled job, with the job ID, task type, task name, status, start time and end time. Use the Search box to filter the list, and click a column heading to sort.
For the detailed log of an individual run, see Mapping History or Workflow History.