Reference Node

The reference node is a secondary type of node that can be added to a flowchart.

Unlike regular nodes, which represent a state and can have information, these are placeholders for other flowcharts. When the flow reaches one, a new instance of the corresponding flowchart is created and control is transferred to it.

This type of nodes are meant to help splitting up flowcharts in case they become too large or if it's necessary for unique portions of a larger flowchart to be available individually.

Creating reference nodes

To create a reference node in a flowchart, open a Flowchart View for it from the Project Bar and then right-click in any empty space of the Flowchart View and select the Add reference node option from the context menu. Doing that will create a node at the position of the pointer.

For more information on further editing of nodes, see the Flowchart View section of the manual.

Node properties

Tag
A string used to identify a node at runtime. The Flowchart Controller plugin has several actions, conditions and expressions that can be used with a tag to target specific nodes.
Reference flowchart
The flowchart that should be created upon reaching this node.
Reference start node
The tag of the node that should visited in the referenced flowchart. If left empty the default start node is used.
Runtime tag
The tag given to the referenced flowchart at runtime to be able to identify it. This is analogous to the tag a flowchart can be given when it is instantiated through the Flowchart Controller's Start flowchart action. If left empty a unique tag is assigned.
Caption
An editor-only property. This is an optional name that can be given to a reference node to help distinguish it from others.
Parent Index
In the case a node is connected to multiple parent nodes, this property appears and displays an index that can be given to each parent. Used by some actions and expressions in the case a node has more than one parent.
Construct 3 Manual 2024-05-01