Workflow Canvas v2

The Canvas is a visual editor for the same Workflow definition shown in Code view.

Layouts

Layout	Best used for
`Detailed`	Editing complete Step Parameter and Return lists side by side.
`Flow — vertical`	Reading top-to-bottom execution and focusing on selected Property panels.
`Flow — horizontal`	Reading left-to-right execution and focusing on selected Property panels.

Changing layout does not change Workflow YAML or execution order. Expanded/collapsed state and the layout preference are design presentation state.

Workflow boundaries and Steps

The Canvas includes pseudo-Steps for Workflow Parameters and Returns. Between them, each ordinary Step shows its Node/Method contract. Control-flow Steps contain one or more nested execution scopes.

Click a + zone to add a Step at that exact root or nested position. Drag a Step header to reorder it where scope rules permit. Collapsed containers can expand when a dragged Step targets one of their nested zones.

Properties and connections

Parameters appear on the consuming (left-hand) side of a Step and Returns on the producing (right-hand) side. Nested rows represent an Object or Array item shape.

Select a Property to edit its literal Value or Expression. Drag or click compatible Property endpoints to build a reference connection.

Canvas highlights compatible targets and existing connections. A visual type match is design guidance rather than a confirmation that a particular mapping is valid.

Use Pan to move the viewport. Use Select steps for rectangle selection and Shift-click selection, then copy or cut the selected subtree. Paste inserts at the nearest add zone.

Search matches Step names and Properties. The Home control or Home key centers a selected Step or returns to the default view. Expand/collapse all changes the visible detail without changing the Workflow.

Preview and editing modes

Canvas Preview mode displays evaluated compile-time samples where available. It does not invoke steps.

Property edit mode allows adjustment of a Step's schema. Apply or cancel this mode before using Workflow-level Undo/Redo or making unrelated structural edits.

Read-only Canvas

When Release Management is enabled and a later Environment is selected, the design is read-only. You can inspect the published definition and its Environment state, but return to Test to change and save it.

Map a ForEach in both Step panels

In either Flow layout, you can open the same ForEach Step in both Property panels. Use its Parameters panel for the active Items fields and its Returns panel for the output mapping. Each panel emphasizes its own Property section so you can connect the current item to Result without switching to the Detailed layout.

This is useful when the loop returns a projection of the input item, including a loop with no child Steps. The usual container scope rules still apply: active Items references belong inside the loop, and later Steps consume Result.