Trigger shape (schedule)

Introduction

Trigger schedule options are used to schedule the associated process flow to run at a specified frequency and/or time. Here, you can use intuitive selection options to define your requirements or - if you are familiar with regular expressions - use advanced options to build your own expression.

Trigger schedules are based on Coordinated Universal Time (UTC).

Scheduling options (occurrence)

Schedules can be defined based on the following occurrences:

• Minutes

• Hourly

• Daily

• Monthly

• Advanced

Show me

Minutes

Define a schedule to run every x minutes - for example:

Behind the scenes, the minutes schedule uses a */n * * * * Cron expression. This means: run when the value is a multiple of n.

For example, choosing to run a flow every 45 minutes would be expressed as */45 * * * * , so the flow will trigger on the hour (0) and 45 minutes past the hour.

If you only want to trigger the flow at 45 minutes past the hour, you should use the advanced option and define a Cron expression in the form: n * * * * , where n is the required number of minutes. For example: 45 * * * * The following website may be useful if you need help with Cron expressions: https://crontab.guru/

Hourly

Define a schedule to run every x hours - for example:

Daily

Define a schedule to run on selected days of the week at a given start time - for example:

Use the every dropdown list for quick daily presets, or define custom settings:

Show me

Monthly

Define a schedule to run on selected days of the month or weeks, for selected months, at a given start time - for example:

Use the every dropdown list for quick monthly presets, or define custom settings:

Show me

Advanced

If you are familiar with cron expressions, you can select this option to activate the cron expression field beneath and enter your required expression directly:

Patchworks supports the 'standard' cron expression format, consisting of five fields: minute, hour, day of the month, month, and day of the week.

minute (0-59) hour (0-23) day_of_month (1-31) month (1-12) day_of_week (0-6)

Each field is represented by a number or an asterisk (*) to indicate any value. For example: 0 5 * * * would run at 5 am, every day of the week.

Extended cron expressions (where six characters can be used to include seconds or seven characters to include seconds and year) are not supported.

Adding a trigger schedule

Follow the steps below to add a new trigger schedule.

Step 1 To add a new schedule, click the add new schedule button:

Step 2 Select an occurrence.

Step 3 Define your required settings for the occurrence.

Step 4 Click save to save this schedule. The schedule is added to the shape - for example:

Multiple schedules

You can add a single schedule or multiple schedules. When you add multiple schedules, ALL of them will be active.