Schedule-based Trigger
Schedule-based triggers enable you to automate task execution at specified intervals using cron expressions. This is ideal for periodic data processing, maintenance tasks, and scheduled operations.
Follow the tutorial for setup instructions.
Basic Schedule-Based Trigger Configuration
The following example shows the basic structure of a schedule-based trigger:
<span><span style="color: var(--shiki-token-function)">resource</span><span style="color: var(--shiki-color-text)"> "tailor_executor" "scheduled_event_executor" {</span></span>
<span><span style="color: var(--shiki-color-text)"> workspace_id </span><span style="color: var(--shiki-token-keyword)">=</span><span style="color: var(--shiki-color-text)"> tailor_workspace.ims.id</span></span>
<span><span style="color: var(--shiki-color-text)"> name </span><span style="color: var(--shiki-token-keyword)">=</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">"scheduled-event-executor"</span></span>
<span><span style="color: var(--shiki-color-text)"> description </span><span style="color: var(--shiki-token-keyword)">=</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">"execute operation on schedule"</span></span>
<span></span>
<span><span style="color: var(--shiki-color-text)"> trigger </span><span style="color: var(--shiki-token-keyword)">=</span><span style="color: var(--shiki-color-text)"> {</span></span>
<span><span style="color: var(--shiki-color-text)"> schedule </span><span style="color: var(--shiki-token-keyword)">=</span><span style="color: var(--shiki-color-text)"> {</span></span>
<span><span style="color: var(--shiki-color-text)"> frequency </span><span style="color: var(--shiki-token-keyword)">=</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">"* * * * *"</span></span>
<span><span style="color: var(--shiki-color-text)"> timezone </span><span style="color: var(--shiki-token-keyword)">=</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">"UTC"</span></span>
<span><span style="color: var(--shiki-color-text)"> }</span></span>
<span><span style="color: var(--shiki-color-text)"> }</span></span>
<span></span>
<span><span style="color: var(--shiki-color-text)"> operation </span><span style="color: var(--shiki-token-keyword)">=</span><span style="color: var(--shiki-color-text)"> {</span></span>
<span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-comment)"># Choose one of the operation types:</span></span>
<span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-comment)"># tailor_graphql = { ... }</span></span>
<span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-comment)"># webhook = { ... }</span></span>
<span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-comment)"># function = { ... }</span></span>
<span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-comment)"># job_function = { ... }</span></span>
<span><span style="color: var(--shiki-color-text)"> }</span></span>
<span><span style="color: var(--shiki-color-text)">}</span></span>
<span></span>Schedule Configuration
Schedule-based triggers use cron expressions to define when operations should execute:
frequency- A cron expression defining the schedule (e.g.,"0 */6 * * *"for every 6 hours)timezone- The timezone for schedule interpretation (e.g.,"UTC","America/New_York")
Common Cron Expression Examples
"* * * * *"- Every minute"0 * * * *"- Every hour"0 0 * * *"- Every day at midnight"0 0 * * 0"- Every Sunday at midnight"0 9 * * 1-5"- Every weekday at 9 AM
Properties
Schedule-Based Trigger Properties
| Property | Type | Required | Description |
|---|---|---|---|
timezone | string | No | This refers to the specific time zone in which the job's scheduled times are interpreted and executed |
frequency | string | Yes | The intervals at which the job is scheduled to run (cron expression) |
For detailed operation properties, see the dedicated operation pages:
- TailorGraphql Operation Properties
- Webhook Operation Properties
- Function Operation Properties
- Job Function Operation Properties
Learn more about executor properties in the Tailor Platform Provider documentation.