Node
Nodes (sometimes referred to as Connectors or Adapters) are the elements that are dropped on to the Workflow Canvas in order to describe an integration process.
Node Categories
Nodes are categorized according to their behavior and appear in different sections of the Node Chooser.
Connectors
Connector Nodes wrap a third party API or service. Most connectors will have full coverage of the underlying API or service and provide Node Samples which show example payloads for each of the supported interactions.
Processors
Processor Nodes typically act on data in memory and include data transformation Nodes such as QuickMap.
Flow Control
Flow Control Nodes perform evaluations that enable conditional branching in the Workflow.
Triggers
Trigger Nodes fire when a condition is met and include time-based schedulers as well as Nodes that wait for external events such as an email to arrive in an Inbox or a file to be created in a specific folder.
Node Visual Elements
Node Header
The Node Header is the top area of the Node which includes the Node icon and name or description.
Node Properties
Node Properties enable Flowgear to interface with the Node by setting and retrieving properties. See Node Properties.
Working with Nodes
Naming
It is best practice to name all Nodes in a Workflow. The name does not need to be unique but should provide a terse description of the purpose of the Node in the context of the workflow it's being used in. Use the form . For example, get customers or prep invoices.
Upgrade Node
When a newer version of a Node is available, this is indicated with a red horizontal strip just under the Node Header.
You can upgrade to the latest version of the Node by clicking v → Upgrade this Node or v → Upgrade all {x} Nodes.
During upgrade, new Node Properties will be added and Properties that no longer exist will be removed. Properties that are present in both the old and new Node version remain unchanged - the value in these Properties as well as any Flow Connectors will be retained.
Node Samples
Node Samples are the quickest way to get a functional integration using a Node that you have not used previously or recently. Click v → Choose Sample to open a list of samples.
A searchable list of samples will be presented. Type a search term to locate the desired sample. Select the sample to have the Node configured for it - Node Properties will be assigned relevant values according to the chosen sample. From there, you can modify Properties for your use-case.
See Node Samples for more information.
Adding Notes to a Node
While Flowgear includes a Note Node which can be added anywhere in the canvas, it's also possible to capture Notes on a specific Node. To add a note to a Node, click v → Add Note. A preview of the note will display above the Node Header. Hovering the note will display its full text and clicking it will allow you to edit it.