While Loop Open (Deprecated)¶
Opens a legacy while-loop block and emits a flow-control token plus up to five initial values that will circulate through the loop. It does not evaluate the loop condition itself; it simply initializes the loop and passes values forward to be handled by the corresponding close node.
Usage¶
Use this node at the start of a loop when building a legacy while-style control flow. Connect its FLOW_CONTROL output to SaltWhileLoopClose to create the loop, and wire any initial_value sockets to seed the variables that will iterate. The actual loop continuation condition is enforced at the close node. Prefer the newer Loop Open/Close nodes for new workflows.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| condition | True | BOOLEAN | Initial condition value for the loop. Provided for compatibility; the continuation logic is handled by the close node. | True |
| initial_value0 | False | WILDCARD | First value to carry into the loop. Can be any type. | 0 |
| initial_value1 | False | WILDCARD | Second value to carry into the loop. Can be any type. | start |
| initial_value2 | False | WILDCARD | Third value to carry into the loop. Can be any type. | 42 |
| initial_value3 | False | WILDCARD | Fourth value to carry into the loop. Can be any type. | 3.14 |
| initial_value4 | False | WILDCARD | Fifth value to carry into the loop. Can be any type. | {'key': 'value'} |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| FLOW_CONTROL | FLOW_CONTROL | Flow-control token to establish the loop and link to the corresponding close node. | |
| value0 | * | Pass-through of initial_value0 for use inside the loop body. | 0 |
| value1 | * | Pass-through of initial_value1 for use inside the loop body. | start |
| value2 | * | Pass-through of initial_value2 for use inside the loop body. | 42 |
| value3 | * | Pass-through of initial_value3 for use inside the loop body. | 3.14 |
| value4 | * | Pass-through of initial_value4 for use inside the loop body. | {'key': 'value'} |
Important Notes¶
- This node is deprecated. Prefer using Loop Open and Loop Close for new designs.
- The loop condition is not enforced here; it must be connected and evaluated at SaltWhileLoopClose.
- Supports up to five wildcard payload sockets (initial_value0–4) that circulate through the loop.
- All initial_value inputs are optional; missing values propagate as empty/None and should be handled in your graph.
- Must be paired with SaltWhileLoopClose to form a functioning loop.
Troubleshooting¶
- No loop occurs: Ensure FLOW_CONTROL from this node is connected to SaltWhileLoopClose and that SaltWhileLoopClose receives a valid condition input.
- Values are None inside the loop: Provide initial_value inputs or ensure upstream nodes produce outputs before this node executes.
- Socket mismatch errors: Keep payload counts consistent between the open and close nodes; both sides expect up to five values in the same order.
- Unexpected infinite looping: Check the condition wired into SaltWhileLoopClose and verify it becomes false when the loop should terminate.