Connecting Nodes
Understanding Connections
Connections (or links) define how data flows between nodes. When you connect an output pin from one node to an input pin of another node, you establish a data pathway in your workflow.
Creating a Connection
Basic Steps
- Click and hold on an output pin (right side of a node)
- Drag the connection line towards the target node
- Release on an input pin (left side of a node) that's compatible
- The connection is created and the nodes are now linked
Tip: As you drag, the compatible pins will highlight in green, showing where you can safely connect.
Connection Rules
Valid Connections
- You can only connect an output pin to an input pin
- Pins must be of compatible data types
- One output pin can connect to multiple input pins
- One input pin can only receive from one output pin
Invalid Connections
- Output to Output - NOT allowed
- Input to Input - NOT allowed
- Incompatible data types - NOT allowed (example: Number to Text)
- Circular connections - NOT allowed (node connected to itself indirectly)
Note: If you try to create an invalid connection, the pin will highlight in red, indicating the action is not allowed.
Connection Types
Different types of pins handle different data:
- Number/Numeric: Integer or floating-point values
- Text/String: Text data
- Boolean: True/False values
- Array/List: Multiple values in sequence
- Object: Complex data structures
- Any: A flexible type that accepts any data
Editing Connections
Modify a Connection
- Right-click on a connection line
- Select "Edit Connection" from the menu
- Adjust the connection properties if available
Delete a Connection
- Method 1: Right-click on the connection line and select "Delete"
- Method 2: Click on the connection line to select it, then press
Delete
Rerouting Connections
To change where a connection connects:
- Click and hold on the end point of a connection (on either node)
- Drag it to a different pin on any node
- Release on the new target pin
Tip: You can also move a connection from one node to another without disconnecting - simply drag the connection endpoint to the new pin.
Connection Visualization
- Normal Connection: Gray line connecting two nodes
- Active Connection: Highlighted in blue during workflow execution
- Error Connection: Red line indicating a compatibility issue
- Hover Connection: Brighter line when you hover over it
Multiple Connections from One Pin
An output pin can connect to multiple input pins. This allows one node's output to feed into many different nodes:
- Connect the first node's output to a second node's input
- From the same output pin, create another connection to a third node
- Repeat as needed - one output can power many inputs
Example: A single "Calculate Value" node can output to three different "Display" nodes, showing the result in three places.
Auto-Connection
Some node systems support automatic connection recognition:
- When you place a new node near an existing connection, the system may suggest auto-connecting it
- Accept or reject the suggestion as needed