Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue

Overview

Actionflows can use data displayed on screens. This data can be manipulated within an actionflow and can be saved onto tables. Sometimes consume data through their Connections (also known as the Input Connection Points). There are also circumstances where an actionflow does not require any input data from the screen from which it is initiated. In this case, use the event as the input for the actionflow. An event is triggered by mouse-clicks (On-Click, Double-Click)  or keyboard presses (On-Enter). Connecting an event to an actionflow means the actionflow runs in response to the event, regardless of any data suppliedand instead the Input Connection Point is configured to consume an event, such as a mouse click. All Actionflows are connected to an event that runs the actionflow,  and have at least one Input Connection Point as its driving input connection point i.e. of type Input.

Input Connection Points

Input Connection points are the interface to the actionflow. They define the inputs, lookups and outputs the actionflow is expecting, and allows values from the incoming inputs to be mapped onto these. For example, an actionflow may expect specify what data, if any, is passed through them.

Expand
titleClick to see example...

Two screens use the same actionflow.

One actionflow expects an Area Code to calculate a distance.

One

The screen passes the actionflow a Postcode, this is mapped into the actionflow onto the Area Code attribute using the Input Connection Point mapping.

Image Modified


A second screen can reuse the actionflow (this is referred to as

a different

an instance) and pass in a Zip Code

which 

which is mapped into the actionflow using the Input Connection Point mapping

Image Modified

Driving and Lookup Connection Points

  • If you connect a node via a driving connection, records are returned individually to the connected node and flow one by one through the remainder of the actionflow.
  • If you connect a node via a lookup connection, the records are returned as an array within one recordset. Nodes wired via lookup connection points require both:
    • Data Attributes: add attributes from the view. PhixFlow looks-up data from these attributes. 
    • Request Attributes: when the actionflow runs, PhixFlow returns the data to these attributes.

The following sections explain the properties for input and output connection points.

Input Connection Point Setup Wizard

When a new input is connected the mapping wizard will appear. To reopen the mapping wizard:

  1. Right-click the input Click on the connector between the Input Data and the Input Connection Point.Select 

Insert excerpt
_

mappingConfigure

mappingIcon
_

mappingConfigure

mappingIcon
nopaneltrue

.

Mapping Properties

Data to be Used

Data NameDescription
Selected RecordsRecords selected in the Input. For example multiple records selected on a grid.
Edited RecordsRecords that have been edited on the input. For example, only records which have been edited on a grid.
PageAll records on a page. For example a single record being edited using a form.
Dragged RecordsSelected records that have been dragged onto a drop target.
Drop Target RecordsRecords Dropped onto a drop target.

Mappings

  1. Drag a record from the left (input) onto a corresponding record on the right (Input Connection Point)
    1. If no corresponding record exists in the Input Connection point one can be added by dropping an incoming record into the empty space on the right, this causes a new record to be created.
  2. This input is now mapped correctly into the actionflow. 
  3. Repeat for all required inputs.
  4. Click Confirm Mapping.

Further information, see Wiring Actionflows.


Input Connection Points 


Expand
titleInput


Excerpt
name_CPBasic

Basic Settings

FieldDescriptionConnection Point Found On
NameThe name of the Actionflow.

Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Insert excerpt
_output
_output
namecaps
nopaneltrue

Action Phase

The 

Insert excerpt
_action_phase
_action_phase
nopaneltrue
 that the connection point is in. See Actionflow Phases.

Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Insert excerpt
_output
_output
namecaps
nopaneltrue



Excerpt
name_CPValidation

Validation

FieldDescriptionConnection Point Found On
Minimum RecordsThe minimum number of records that the Actionflow needs to run. If the received records are not above the minimum set, the Actionflow will not run.

Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Maximum RecordsThe maximum number of records that the Actionflow is permitted to runIf the received records exceed the maximum set, the Actionflow will not run.

Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue


Input Parameters

FieldDescriptionConnection Point Found On
Name

The name of the input parameters (attributes) mapped into the Actionflow.

Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Insert excerpt
_output
_output
namecaps
nopaneltrue

TypeThe data type (e.g. integer) of each input parameter (attribute) mapped into the Actionflow.

Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Insert excerpt
_output
_output
namecaps
nopaneltrue

Default Expression

A value or expression that is evaluated when no value is mapped to the attribute, or if the value is null or unavailable (e.g. if the user did not have permission to see it).

Default value expressions do not use the order they are set in and are automatically resolved in the appropriate order based upon other attributes they reference.

For referencing attributes, use the notation, in.attributeName


Note

If ${_NULL} is entered, this will convert to a null value, not an empty string.


Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Insert excerpt
_output
_output
namecaps
nopaneltrue


Insert excerpt
_audit
_audit
nopaneltrue


Expand
titleOutput

Insert excerpt
Input Connection Points
Input Connection Points
name_CPBasic
nopaneltrue

 Input Parameters

FieldDescriptionConnection Point Found On
Name

The name of the input parameters (attributes) mapped into the Actionflow.

Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Insert excerpt
_output
_output
namecaps
nopaneltrue

TypeThe data type (e.g. integer) of each input parameter (attribute) mapped into the Actionflow.

Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Insert excerpt
_output
_output
namecaps
nopaneltrue

Default Expression

A value or expression that is evaluated when no value is mapped to the attribute, or if the value is null or unavailable (e.g. if the user did not have permission to see it).

Default value expressions do not use the order they are set in and are automatically resolved in the appropriate order based upon other attributes they reference.

For referencing attributes, use the notation, in.attributeName


Note

If ${_NULL} is entered, this will convert to a null value, not an empty string.


Insert excerpt
_input
_input
namecaps
nopaneltrue

Insert excerpt
_lookup
_lookup
nopaneltrue

Insert excerpt
_output
_output
namecaps
nopaneltrue



Insert excerpt
_audit
_audit
nopaneltrue


Live Search
spaceKey@self
additionalnone
placeholderSearch all help pages
typepage

Panel
borderColor#00374F
titleColorwhite
titleBGColor#00374F
borderStylesolid
titleSections on this page

Table of Contents
maxLevel3
indent12px
stylenone


Learn More

For links to all pages in this topic, see Understanding Actionflows


Insert excerpt
_terms_changing
_terms_changing
nopaneltrue