Edit this page on GitHub

Home > docs > triggers > Cron Triggers

Cron Triggers

You can schedule execution of flows by defining one or multiple cron triggers.

Each cron trigger is required to specify the flow to execute with the entryPoint parameter. Optionally, key/value pairs can be supplied as arguments.

The spec parameter is used to supply a regular schedule to execute the flow by using a CRON syntax.

The following example trigger kicks off a process to run the hourlyCleanUp flow whenever the minute value is 30, and hence once an hour every hour.

flows:
  hourlyCleanUp:
    - log: "Sweep and wash."
triggers:
  - cron:
      spec: "30 * * * *"
      entryPoint: hourlyCleanUp

Multiple values can be used to achieve shorter intervals, e.g. every 15 minutes with spec: 0,15,30,45 * * * *. A daily execution at 9 can be specified with spec: 0 9 * * *. The later fields can be used for hour, day and other values and advanced CRON features such as regular expression usage are supported as well.

Cron triggers that include a specific hour of day, can also specify a timezone value for stricter control. Otherwise the Concord instance specific timezone is used.

flows:
  cronEvent:
    - log: "On cron event."
triggers:
  - cron:
      spec: "0 12 * * *"
      timezone: "Europe/Moscow"
      entryPoint: cronEvent

Values for the timezone are derived from the tzdata database as used in the Java TimeZone class. You can use any of the TZ values from the full list of zones.

Each trigger execution receives an event object with the properties event.fireAt and event.spec as well as any additional arguments supplied in the configuration (e.g. arguments or activeProfiles):

flows:
  eventOutput:
    - log: "${name} - event run at ${event.fireAt} due to spec ${event.spec} started."
triggers:
  - cron:
      spec: "* 12 * * *"
      entryPoint: eventOutput
      activeProfiles:
      - myProfile
      arguments:
        name: "Concord"

Scheduled events are a useful feature to enable tasks such as regular cleanup operations, batch reporting or processing and other repeating task that are automated via a Concord flow.

Note: standard limitations apply.