Reference & Data Model
Trigger (workflow_trigger)
A trigger defines when a workflow starts. There is exactly one per deployment version.
Purpose
Section titled “Purpose”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)
Where in the app
Section titled “Where in the app”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.
Fields
Section titled “Fields”| 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 |
Trigger types
Section titled “Trigger types”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.
Relations
Section titled “Relations”| Related to | Kind | Required | On delete |
|---|---|---|---|
| Workflow definition | belongs to | yes | kept (row is only hidden) |
States
Section titled “States”| 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 |
Rules & automation
Section titled “Rules & automation”- A status change takes effect immediately on all consumers.