Skip to main content

Start workflow step

Start an approval workflow or a list workflow from a Yeeflow form action, and verify which workflow instances start.

Use Start workflow in a form action to start an approval workflow or a workflow for selected records in a data list. For example, a Request review button can start a review workflow for the purchase request whose ID the action passes to the step.


When to Use the Start Workflow Step Process

When a page or control event should start a workflow, attach this step to the form action for that event. Examples include a button click and a form submission. Form Actions

Note

The Start workflow step is available in list forms, approval forms, and dashboards.


Configuration Steps

  1. In the form or dashboard designer, open Actions. Open or create the action that the event should run, then choose Add a step → Start workflow.

  2. Set Execution Condition when the workflow should start only if a rule passes. Enable Continue next step when condition is not met if the action should skip the workflow launch and continue with its next step. Execution conditions of actions

  3. Choose a Workflow type and configure the target below.

Approval form Workflow. Select the target Application and Approval form. If the workflow needs values from the current form, open Settings next to Set variables and map those values to its variables.

Data list workflow. Under Data item, choose Select a data item. Select the Application and Data source. In Item Id(s), enter the target ID or IDs, use a variable, or choose records with the selector. In Select a list workflow, choose the workflow configured for that list.

The Start workflow form action set to Data list workflow, showing Select a data item, Application, Data source, Item Id(s), and Select a list workflow.

Save the action and bind it to the intended event. Test it with inputs that meet the condition and inputs that fail it. In workflow instances, confirm that the expected workflow started and check the approval variables or list record IDs it received. When the condition fails, check that the launch was skipped. View and manage workflow instances

Additional Notes

For Data list workflow, this step can launch the same list workflow for up to 50 selected IDs per run. The page sends one start request per ID in sequence and shows a loading indicator while it sends them. Refreshing or leaving the page interrupts the launches still pending. Keep the page open until loading finishes. If the run was interrupted, check which instances started before retrying any remaining IDs.


Summary

Workflow type

What this step starts

Approval form Workflow

An approval workflow for a selected form, with optional variable values.

Data list workflow

The selected list workflow for each supplied item ID, for up to 50 selected IDs per run.


For workflow setup and an agent-initiated launch, see the workflow designer overview, Manage workflow definitions, and Start a workflow tool.

Did this answer your question?