Visual workflows

Choose a workflow trigger and source table

A workflow trigger defines when a process starts and which record reaches its actions. Choosing the right trigger and required fields prevents work from running on the wrong records.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Begin with the event, not the action

Write the condition that makes work necessary before choosing the action that performs it. “A new request arrives in this table” and “Review the queue on a schedule” describe different processes even when both eventually send an email.

The trigger picker offers When record created, When record created or updated, When record updated, At record’s trigger time, and At scheduled time. Inspect the selected table and its fields before assuming that later actions can access the data you have in mind.

Connect the trigger to a real input

  1. Open the workflow and select its trigger, Step 1, on the canvas.
  2. Choose the Event.
  3. Pick the Table, or set the Schedule for At scheduled time.
  4. Under Required fields, tick the fields that must be non-empty for the workflow to fire, or leave them all unticked to fire on every record.
  5. Choose Save, then test the actions with a real row.

Compare event and scheduled starts

Trigger selection
Trigger approachUseful whenInspect
Record eventNew or changed table records should start the taskCorrect table, event, and required fields
Record trigger timeA date on each record should start the taskThe date values on real records
ScheduleWork should run at specified timesTimezone and the next scheduled runs
Manual testingYou are checking a configured operationSample rows and real effects

Avoid accidental repeated work

A process that changes the same data it observes needs careful testing. Kition warns when an Add record action writes to the trigger table, because each created row would fire the trigger again. Establish which input represents one business event and inspect the resulting records or messages.

When a table or field changes, revisit the trigger and action mappings. Switching the trigger table offers to remove field references that do not exist on the new table, and a required field that no longer exists is marked removed with a Remove gate button. Resolve these issues and run a fresh controlled test after structural changes.

Version and sources

This guide describes the Kition desktop app as of source 7d49036f, checked on 2026-11-06. Connected actions also depend on the configured model provider or service. If your installed version is older, some controls may differ.

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.