For Loop Open (Deprecated)

Opens a counted loop that will iterate a specified number of times. It initializes and exposes a loop control handle plus pass-through values that will be available to the loop body. This node is deprecated and maintained for compatibility; prefer the newer Loop Open/Close nodes.

Usage

Use this node at the start of a counted loop. Set 'remaining' to the number of iterations you want. Wire any auxiliary values you want to carry through the loop into the optional initial_value inputs. Connect its 'flow_control' (and any passthrough values) into the loop body and finish the loop with a matching For Loop Close node.

Inputs

Field	Required	Type	Description	Example
remaining	True	INT	How many iterations the loop should perform. If 0, the loop body will not execute.	5
initial_value1	False	ANY	Optional value passed into the loop as value1; typically used to carry and update state across iterations.	some initial data
initial_value2	False	ANY	Optional value passed into the loop as value2.	another value
initial_value3	False	ANY	Optional value passed into the loop as value3.	true
initial_value4	False	ANY	Optional value passed into the loop as value4.	42

Outputs

Field	Type	Description	Example
flow_control	FLOW_CONTROL	Loop control handle that must be connected to the corresponding For Loop Close node to form a valid loop.	flow_handle_ref
remaining	INT	The starting iteration count provided to the loop.	5
value1	ANY	Pass-through of initial_value1 for use inside the loop.	some initial data
value2	ANY	Pass-through of initial_value2 for use inside the loop.	another value
value3	ANY	Pass-through of initial_value3 for use inside the loop.	true
value4	ANY	Pass-through of initial_value4 for use inside the loop.	42

Important Notes

• Deprecated: This node is deprecated; prefer using Loop Open/Close for new workflows.
• Pairing required: Must be paired with a For Loop Close node. Do not mix with other loop close nodes.
• Iteration count: The loop will not execute if 'remaining' is 0. A hidden 'initial_value0' can override 'remaining' when provided.
• State passthrough: initial_value1–initial_value4 are passed to the loop body as value1–value4 for stateful updates across iterations.
• Type flexibility: Optional values accept any type but should remain consistent across iterations to avoid type conflicts in downstream nodes.

Troubleshooting

• Loop never runs: Ensure 'remaining' is greater than 0 and that 'initial_value0' (if used) is not 0.
• Loop does not close: Verify that the For Loop Close node is used and its 'flow_control' input is connected to this node's 'flow_control' output.
• Unexpected iteration count: Check if a hidden 'initial_value0' is being supplied by an upstream connection, which overrides 'remaining'.
• Values not updating across iterations: Confirm you are wiring the updated values from For Loop Close back into the next iteration as intended.
• Type errors: Keep the types of initial_value1–initial_value4 consistent through the loop body to match downstream expectations.