Action Nodes
Every attribute is passed through* but in order to use an attribute in a specific action node it must be mapped in to it as an input parameter.- *although there can be exceptions such as the converge action,
Once a mapping is configured you it will reused in all instances of the actionflow. This is because the action nodes sit within the actionflow itself and only the data coming into and out of an actionflow changes (for each instance) Excerpt |
---|
|
Action NodesAction nodes are the building blocks of Actionflows |
, they and are represented as a circle with an icon. They perform specific tasks, e.g. |
updating datadecision gateways, performing calculations, and API integrations, and are |
wired joined together using connectors. Image Modified |
Action nodes can be dragged from the toolbar onto the canvas to create a new action, and some can be clicked to see existing objects, e.g. click Insert excerpt |
---|
| _action_screen |
---|
| _action_screen |
---|
nopanel | true |
---|
|
to list existing screens, which can then drag be dragged from the Repository onto the canvas.
Most action nodes run once per record they receive on their driving from the input connection point. However, some action nodes only trigger once run after receiving the final record or once per flow, e.g. Insert excerpt |
---|
| _action_screen |
---|
| _action_screen |
---|
nopanel | true |
---|
|
, Insert excerpt |
---|
| _action_phase |
---|
| _action_phase |
---|
name | start |
---|
nopanel | true |
---|
|
and Insert excerpt |
---|
| _action_url |
---|
| _action_url |
---|
nopanel | true |
---|
|
nodes.
Usually, action nodes have Image Removed Driving connections, which pass data through to the next action node. Some action nodes have a Image Removed Lookup connection, which send out a request for data, that is then returned to the action node data.
Nodes must be connected sequentially starting from the Image Removed Driving interface connection point. Records will then pass through each node and be manipulated accordingly.
For most action nodes, data flow is configured when attributes are mapped to the input connection points. For Insert excerpt |
---|
_action_gateway | _action_gateway | nopanel | true |
nodes, the data flow can be controlled by mapping to the output connection points. This is because the expressions in a gateway provide the logic for which path the data flows, and different paths may require different data to pass through the gateway.Types of Action Node (move to own page)
The following table summarises the purpose of each type of action node, the types of connections available on an action node and how each node runs.
- Pass-through and Join nodes (only attributes common to all paths leading to the Join can be passed through)
Icon | Description | How it runs | Available Connections |
---|
Insert excerpt |
---|
_action_actionflow | _action_actionflow | nopanel | true |
---|
See Actionflow Node
Embeds an Actionflow within the current Actionflow. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_screen | _action_screen | nopanel | true |
---|
See Open Screen Node
Add an action to open a specified screen. If the specified screen contains a start phase button the node can then be connected to a start phase node. The buttons can be mapped to each output of the node to trigger different pathways depending on what the user clicks. For example, this method is used if the process requires confirmation by the user. A confirmation screen can appear with a message 'Are you sure?' with two options - Yes - the Actionflow continues to the yes output.
- No - the Actionflow stops
| Once per flow | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_view | _action_view | nopanel | true |
---|
See View Node
Add a node for a data view. The Actionflow uses views for additional data to use when processing records. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_request_connection | _request_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_calculate | _action_calculate | nopanel | true |
---|
See Calculate Node
Add an action to manipulate the data that is passed to the calculate action. In the calculate action, write an expression using one or more of the 115+ functions available in PhixFlow. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_gateway | _action_gateway | nopanel | true |
---|
See Gateway Node
Add a node to specify decision logic. Gateways control the route that records take as they flow through the Actionflow. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_request_connection | _request_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_url | _action_url | nopanel | true |
---|
See Open URL Node
Add an action to open a specified URL. | Once per flow | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_save | _action_save | nopanel | true |
---|
See Save Node
Add a node to save the specified record(s) to its table. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_delete | _delete | nopanel | true |
---|
Add a node to delete the specified record(s) from its table. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_bulk_delete | _action_bulk_delete | nopanel | true |
---|
Insert excerpt |
---|
_action_analysis | _action_analysis | nopanel | true |
---|
See Analysis Node
Runs analysis on the specified tables. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_http | _action_http | nopanel | true |
---|
See HTTP Node
Performs an HTTP request. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_email | _action_email | nopanel | true |
---|
See Email Node
Sends an Email to specified recipients. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_json | _action_json | nopanel | true |
---|
See JSON Node
Handles JSON data and returns record objects as defined by the configuration. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_for_each | _action_for_each | nopanel | true |
---|
Insert excerpt |
---|
_action_loop | _action_loop | nopanel | true |
---|
See Loop Nodes
Facilitates the ability to loop within an actionflow for tasks such as polling or paging through results. | Once per record | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_action_converge | _action_converge | nopanel | true |
---|
Insert excerpt |
---|
_action_phase | _action_phase | name | start |
---|
nopanel | true |
---|
See Phase Node
Starts the phase specified by the user on the node. To add a phase node there must be more than one phase in the actionflow. | Once per flow | Insert excerpt |
---|
_driving_connection | _driving_connection | nopanel | true |
---|
Insert excerpt |
---|
_structured_data | _structured_data | nopanel | true |
---|
Expand |
---|
title | Understanding New Terms |
---|
|
We have covered numerous new terms in this chapter. Let's recap on the terms we have used and what they mean.
Inbound Connection Point
Outbound Connection Point
Input Parameters
Output Attributes
Input Data
Pass-through Nodes
Join Nodes
Excerpt |
---|
|
Where attributes require processing by an action node, e.g. in an expression, the attributes must be mapped in as Input Parameters. These attributes are then mapped out of the action node as Output Attributes. Connectors between the action nodes pass through every attribute*, including any not mapped**. *attributes not mapped are referred to as pass-through attributes. **there can be exceptions, e.g. Converge action. Tip |
---|
Once mappings are configured they will reused in all instances of the Actionflow. This is because the action nodes sit within the Actionflow itself and only the data coming into and out of an Actionflow changes for each instance. |
|
For the specifics of mappings and connectors, see 1.08 Mappings and Connectors.
Image Modified