Skip to content

Reference & Data Model

Trigger (workflow_trigger)

A trigger defines when a workflow starts. There is exactly one per deployment version.

The trigger follows from the on field of the rules document. On save, Aligia writes exactly one row per version with type, configuration and status. The consumers (database change stream, manual start) read this table to assign an event to the right workflow. Whether a workflow is enabled is the status of its active version’s trigger. (Data type: configuration, written by the system)

No page of its own. The on field of the rules document Polaris writes (workflow_v3_upsert) defines the trigger; enabling and disabling goes through workflow_v3_set_enabled. See Guides › Triggers.

Field Technical Type Required Meaning Notes
Workflow definition_id Reference yes associated definition System
Version deployment_version Number yes deployment version the trigger belongs to System
Trigger type type Selection yes manual or cdc derived from on
Configuration config – yes for cdc: table and change kinds System
Status status Selection yes „Aktiv“ (Active, active) / „Deaktiviert“ (Disabled, disabled) superseded is not displayed
on in the document Type Starts the workflow … Configuration
manual manual on request (workflow_trigger), e.g. by Polaris none
db.<table>:insert / :update / :change cdc when records of the table are created, updated or both table; change kinds „Erstellen“ (Create, c), „Aktualisieren“ (Update, u)

Saving refuses deletes (db.<table>:delete).

Condition: The document’s global condition when decides whether a run continues; single rules can carry their own when condition. A CDC trigger delivers the row before and after.

Related to Kind Required On delete
Workflow definition belongs to yes kept (row is only hidden)
Value Label Meaning
active Aktiv (Active) trigger armed
disabled Deaktiviert (Disabled) starts nothing, not even manually; default for new and newly accepted versions
superseded – replaced by a newer version; not displayed
  • A status change takes effect immediately on all consumers.

Workflow definition · Execution