Visual workflows
Test a workflow with representative sample data
A workflow test runs a configured action against a real row. It helps uncover missing fields and connection problems before the workflow is enabled.
Updated
By Kition Docs
Verified against Kition 0.2.0 (7d49036f) on 2026-11-06
Choose a sample that exercises the mapping
Use a row that contains the values your action actually needs. For an email, that includes the recipient and content fields; for a record action, it includes values compatible with the destination table. A completely blank record is rarely a useful success test.
Treat a test as a real execution. Send test email and Run with sample deliver a message; Run now creates a real record; record tests update the table. Only a filter’s Run with sample row is a dry run that changes nothing. Choose a controlled destination and label the sample clearly.
Run and inspect a controlled test
- Save the trigger and action settings and resolve the reported field errors.
- Select the action on the canvas and find its test section: Test step for Send email, Test with real data for Add record, or Test action for other record actions.
- Pick an existing row (Use existing row), and check field substitutions and the destination before running.
- Run the test and read its result or error.
- Verify the real output, then repeat with an important edge case such as a missing optional value.
Cover more than one result
| Sample | What it checks |
|---|---|
| Complete normal record | The intended mapping and output |
| Missing optional value | How incomplete information appears |
| Different real category | Whether assumptions were too narrow |
| Row a filter should stop | That the run is marked skipped |
Promote a tested configuration carefully
After a successful test, inspect the destination rather than relying only on a success message. A message can be sent to the wrong recipient, and a record can be created with values in the wrong fields. Validation confirms the settings are complete; review confirms your intent.
Test runs from Test step are kept out of the regular run history. Save any corrections and rerun the relevant test before enabling. When the table, connection, or body changes later, repeat the check that covers that dependency instead of assuming an old test remains valid.
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
Build your first visual workflow
A Kition workflow is a trigger followed by a chain of actions. It turns repeatable table work into an inspectable sequence with validation, testing, and run history.
Inspect workflow runs and diagnose failures
Workflow run history is the record of executions and their outcomes. It connects a configured process with evidence of what actually happened.
Send email from a visual workflow
The Send email action delivers a message through a selected SMTP connection. A tested connection and a reviewed recipient, subject, and body are all required for a useful result.