SAService Architect Back to designer
SAService ArchitectDocumentation
Data connectorsTemporal
Endpoint type Temporal / endpoint

Temporal endpoint

A durable Activity or Workflow contract, optionally started by a Temporal Schedule.

When to use

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

Behavior

  • Activity executes an ordinary ServiceLib graph and may perform normal side effects through its stream pipeline.
  • Workflow executes in Temporal deterministic and replay-safe context; side effects must be delegated to Activities.
  • The endpoint can be invoked on demand through Input or started by an optional durable Temporal Schedule.
  • Activity-only timeout and heartbeat fields are hidden in Workflow mode.

General properties

Endpoint identity

PropertyTypeDescription
namestring

Endpoint name unique in the topology.

Required

Temporal properties

Temporal endpoint contract

PropertyTypeDescription
temporalExecutionTypeActivity | Workflow

Selects the execution domain. Activity enters the ordinary ServiceLib runtime graph; Workflow enters the deterministic Temporal Workflow domain.

RequiredDefault: ActivityAllowed: Activity, Workflow
taskQueuestring

Temporal Task Queue used by the Worker.

RequiredDefault: default
workflowExecutionTimeoutmilliseconds

Maximum Workflow execution duration; zero uses the Temporal SDK default.

Default: 0
activityStartToCloseTimeoutmilliseconds

Maximum duration of one Activity attempt.

Default: 30000Minimum: 1Activity only
activityHeartbeatTimeoutmilliseconds

Maximum interval between Activity heartbeats; zero disables heartbeat timeout.

Default: 0Activity only
maximumAttemptsinteger

Maximum Activity attempts including the initial run. The current endpoint contract requires this field.

RequiredDefault: 1Minimum: 1

Schedule properties

Designer schedule policy

PropertyTypeDescription
enabledboolean

Starts scheduler integration when true.

Default: true
tracingEnabledboolean

Creates tracing for each admitted source event.

Default: false
schedulecron expression

Optional UTC schedule expression. Empty keeps the endpoint on-demand only.

scheduleIdstring

Stable Temporal Schedule ID.

Required when schedule is non-empty.
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.

functionPackagestring

Generated handler package.

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

temporalExecutionType: Activity
taskQueue: orders
activityStartToCloseTimeout: 30000
maximumAttempts: 3
schedule: ""