Insert excerpt | ||||||||
---|---|---|---|---|---|---|---|---|
|
This topic is for application designers who want to understand the concepts of actionflows.
Note |
---|
For applications created in PhixFlow versions 8.3 and earlier, use actions and stream item actions to configure user interaction with data; see Using Stream Actions. This page explains the concepts of the new actionflow feature, introduced in PhixFlow 9.0. |
Overview
Actionflows are diagrams in which you create the functionality of your application. Actionflows are wired onto the screen using connectors and attached to event handers:
- either to on a component such as a button or area
- or to data views grid components and their attributes.
- to card components
When the user triggers an action with a mouse-click or keyboard-pressan event handler, PhixFlow processes the actionflow. Actionflows can affect data, for example by making making changes to stream-items, such as update or delete.
Actionflows can also move the user through their task, by validating input or opening the next screen.
For example, a CRM system simple contact application includes a screen where the user enters details of a new customercontact. When the user clicks the update button, PhixFlow runs the actionflow to:
- Check the input provided is appropriate
- Add the new customer contact stream-item to the CRM database
- Provide a confirmation message.
This page explains actionflow concepts. For details of how to create an actionflow and their properties see: Actionflows.
Iframe | ||||||
---|---|---|---|---|---|---|
|
Reusing Actionflows
You can reuse an actionflow throughout your application. This means you only need to create one actionflow for functionality that occurs on different screens or layouts, such as to save or update stream-items. You can also include an actionflow as a node within another actionflow.
Note |
---|
When you reuse an actionflow, you do not create a copy of it. You are using the actionflow itself. An instance of an actionflow is the combination of the actionflow and its input connections. You can change an actionflow and the same change occurs in all the instances where it is used. The changes do not affect the input connections to the actionflow. Todo-Anthony - check this is true: However, if you remove or add nodes, you will need to wire the input/output connectors for all the instances of the actionflow. |
For each instance of an actionflow, you specify which data the actionflow takes by wiring to connectors. This means you can connect to attributes with any name.
Todo-Anthony - how do you select an actionflow to reuse it.
Actionflow Diagram
The following illustration shows the layout of an actionflow diagram. The numbered areas are explained below.
- Toolbar
The toolbar contains icons that you drag onto the actionflow canvas to create the different nodes, such as a calculate action.
If the source is empty, you are editing the actionflow.
If the source contains a name, you are editing an actionflow instance.
The source indicates what triggers the actionflow. This can be:
- Action Origin
The origin indicates the event that triggers the actionflow instance. It displays its location in a hierarchy showing:- the name of screen
- the name of the component, such as a button, grid or card component
- the event type, such as a double-
- click
- Options
These options affect the entire
- actionflow instance, such as hiding the loading spinner.
- Inputs
Inputs to an actionflow for that actionflow instance- Event starts the actionflow
- either a user-triggered action, such as a mouse click on a button.
- or system-triggered action such as a task plan.
- regardless of data. The actionflow will always run when triggered by the origin.
- Data provides data to the actionflow. The
- data displayed belongs to the same
- a stream.
- related attributes.
- sorting and filtering of stream-items.
- data display, such as grid or form fields.
These specify the data and events that the actionflow requires. All instances of the actionflow require appropriate inputs to be wired to these connectors.
Connectors collect data, pass data back to the calling object and perform lookups on data.
- screen or component as the event handler. Data could be any data bound component on a screen, including:
- grid components.
- card components.
- forms
- screen or component as the event handler. Data could be any data bound component on a screen, including:
- Input Interface
This is the first junction between the actionflow instance and the actionflow contents. The interface contains connection points which connect the inputs to the action nodes. There are 2 connection points available, these are:- Driving connection point
- Lookup connection point
- Canvas
The canvas represents the reusable actionflow. It contains action nodes which are connection together using connection points. The nodes on the diagram represent individual
- actions that pass or process the data from the
- connections. The data passes using
- driving connections or
- lookup connections
- Output Interface
This is the second junction between the actionflow instance and the actionflow contents. The interface contains connection points which connect the action nodes to the outputs. There is only 1 type of connection point available, a driving connection point. - Outputs
Outputs from an actionflow for that actionflow instance. These are data bound components which you want to send data to after the actionflow has completed. The output resembles the input area without the event. Outputs could be any data bound component on a screen, including:- grid components.
- card components.
- forms
View file | ||||
---|---|---|---|---|
|
Actionflow Nodes
In an actionflow diagram, each smallest action that PhixFlow can perform is represented as a circle, called a node. Nodes can be:
- data interactions - save, delete, add
- data calls and calculations - connecting to data to look-up, use or process stream-items
- screen interactions - to open or close screens in the application
- another actionflow - this means you can represent a complex step as a single node
- gateways - decision points with logic to determine which path PhixFlow takes next.
As you add nodes to the actionflow, you wire the output connector of one node to the input connector on the next. In this way, you are create the logical steps needed to complete a specific piece of functionality. Todo-Anthony Update picture
Reusing Actionflows
You can resuse an actionflow throughout your application. This means you only need to create one actionflow for functionality that occurs on different screens or layouts, such as to save or update stream-items. You can also include an actionflow as a node within another actionflow.
Note |
---|
When you reuse an actionflow, you do not create a copy of it. You are using the actionflow itself. An instance of an actionflow is the combination of the actionflow and its input connections. You can change an actionflow and the same change occurs in all the instances where it is used. The changes do not affect the input connections to the actionflow. Todo-Anthony - check this is true: However, if you remove or add nodes, you will need to wire the input/output connectors for all the instances of the actionflow. |
For each instance of an actionflow, you specify which data the actionflow takes by wiring to connectors. This means you can connect to attributes with any name.
Todo-Anthony - how do you select an actionflow to reuse it.
Unreachable Actions
Dashboards have a section called unreachable actions - Todo-Anthony - what this means and how to use it.
Illustration
The picture below shows an actionflow that validates the format of data to ensure it is a valid area code. It's input connection is called Area Code
.
The actionflow is reused by two applications, shown on the left. Each application has separate data with different fields. The actionflow takes data from:
Postcode
data in the Contact AppZip Code
in the Asset Manager App.
This shows that an actionflow can take its input from an attribute with any name. It also illustrates the 2 instances of the actionflow:
- Instance 1 is the actionflow with input from
Postcode
- Instance 2 is the actionflow with input from
Zip Code
As actionflows are reusable, you:
- create an actionflow, setting up all the nodes, wires and the logic
- use and actionflow, connecting it to screen components, events and data, thin mapping the data through the actionflow.