SAService Architect Back to designer
SAService ArchitectDocumentation
Endpoint type Cron / endpoint

Cron endpoint

A local UTC schedule that invokes a generated endpoint function.

When to use

Create this endpoint inside a Cron connector, then select it from an Input or Sink stream.

Behavior

  • The scheduler calls the generated endpoint function.
  • The endpoint function emits application values into the input stream.
  • Missed and overlapping runs follow explicit policies.

General properties

Endpoint identity

PropertyTypeDescription
namestring

Endpoint name unique in the topology.

Required

Schedule properties

Schedule endpoint contract

PropertyTypeDescription
enabledboolean

Starts external endpoint admission when true. When false, the endpoint remains in the generated graph but its transport, Worker, or scheduler integration is not started.

Default: true
tracingEnabledboolean

Creates tracing for each event admitted by an Input endpoint. Sink adapters ignore this flag and only propagate tracing already present in the message context.

Default: false
schedulecron expression

UTC schedule expression.

Required
timezoneUTC

Portable runtimes currently require UTC.

Default: UTC
overlapPolicyAllow | Skip

Behavior when the previous firing is still running.

Default: SkipAllowed: Allow, Skip
missedRunPolicySkip | FireOnce

Behavior after a delayed firing.

Default: FireOnceAllowed: Skip, FireOnce

Function properties

Generated transport handler and code placement

PropertyTypeDescription
functionNamesymbol

Generated endpoint handler name.

functionPackagerelative path

Optional placement below the target-language functions root. Empty uses the root directly; folder/sub-folder is resolved relative to the root selected by publicFunction and functionModule. See Code Generation / Packages and Modules for the language matrix.

Default: empty (functions root)
publicFunctionboolean

Places the handler in shared code.

Default: false
functionDescriptiontext

Generated documentation comment.

functionInitializerGroupstring

Dependency-injection initialization group.

functionModuleModule

Shared module for the handler.

Visible when publicFunction is true.

Configuration example

enabled: true
schedule: */5 * * * *
timezone: UTC
overlapPolicy: Skip