SAService Architect Back to designer
SAService ArchitectDocumentation
Scheduling & TemporalCron
Scheduling guide Cron endpoint -> Input<T>

Cron endpoint

Converts recurring occurrences into zero, one, or many graph input values.

When to use

Use this page while designing, implementing, operating, or troubleshooting scheduled and durable execution.

Behavior

  • schedule uses five fields without seconds: minute, hour, day of month, month, and day of week.
  • Skip overlap rejects an occurrence while previous work is active.
  • Allow permits overlap.
  • FireOnce collapses missed occurrences into one catch-up call; Skip discards them.

Cron expression format

Enter exactly five whitespace-separated fields. timezone is configured separately and the current portable contract accepts only UTC.

  • */5 * * * * runs every five minutes.
  • 0 * * * * runs at minute zero of every hour.
  • 0 9 * * 1-5 runs at 09:00 UTC from Monday through Friday.
  • Do not add a seconds field.
  • Do not constrain both day of month and day of week in the same expression.

Endpoint flow

Schedule properties

Designer Schedule group.

PropertyTypeDescription
enabledboolean

Registers the endpoint when true.

Default: true
tracingEnabledboolean

Creates a trace for each admitted scheduled event.

Default: false
schedulestring

Portable five-field cron expression without seconds: minute hour day-of-month month day-of-week.

RequiredDefault: */5 * * * *
timezoneenum

Schedule timezone.

RequiredDefault: UTCAllowed: UTC
overlapPolicyenum

Concurrent occurrence policy.

RequiredDefault: SkipAllowed: Allow, Skip
missedRunPolicyenum

Missed occurrence policy.

RequiredDefault: FireOnceAllowed: Skip, FireOnce

Function properties

Generated callback identity and placement.

PropertyTypeDescription
functionNamestring

Generated callback type or class.

Required
functionPackagerelative path

Optional path below the generated functions root. Empty places the callback directly in that root; folder/sub-folder is resolved from the language-specific root documented under Code Generation / Packages and Modules.

Default: empty (functions root)
publicFunctionboolean

Places the generated callback in shared module code.

Default: false
functionModuleModule

Shared Module that owns the callback.

Visible when publicFunction is true.
functionInitializerGroupstring

Dependency-injection initialization group for the generated callback.

Product-level example

schedule: "0 9 * * 1-5"
timezone: UTC
overlapPolicy: Skip
missedRunPolicy: FireOnce