Foreach (Flowgraph Node)

Overview

• Node Name: Foreach
• Category: logic
• File: extensions/flowgraph/nodes/macro/foreach.lua

Creates and runs a separate flowgraph instance for each element in a table. Each instance receives the key and value via the foreach module.

Pin Schema

Input Pins

Output Pins

None.

Data Properties

Behavior

• init(mgr, ...) - Sets destroyTargetOnStop to true, clears targets list.
• postInit() - Configures the elementFile pin to accept .flow.json files.
• work() - On first flow, iterates the input table. For each key/value pair, loads a flowgraph manager from the element file, sets mgr.modules.foreach.key and .value, starts execution, and stores the manager reference.
• _executionStopped() - If destroyTargetOnStop is true, stops and removes all spawned managers.

How It Works

This node is a macro-level iterator. When triggered, it loads a separate flowgraph project file for each element in the table. Each spawned flowgraph gets the current key and value injected into its foreach module, accessible via the Get Foreach node inside the child flowgraph.

The node only executes once per flow activation (tracked by self.done).

Example Usage

-- Iterate over a list of vehicle IDs:
-- table = {101, 102, 103}
-- elementFile = "/flowgraphs/processVehicle.flow.json"
-- Creates 3 flowgraph instances, each with:
--   mgr.modules.foreach.key = 1/2/3
--   mgr.modules.foreach.value = 101/102/103

-- Inside processVehicle.flow.json, use a "Get Foreach" node
-- to access the key and value for that iteration

See Also

• Get Foreach (Flowgraph Node) - Related reference
• Integrated (Flowgraph Node) - Related reference
• I/O (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide