Input Connection Points

Overview

Input Connection Points are the interface to the actionflow. They define the inputs, lookups (optional) and outputs (optional) the actionflow is expecting, and specify what data, if any, is passed through them. Where no data is required the input can be an event such as a mouse-click or scheduled task.

 Click to see example...

Two screens use the same actionflow.

One actionflow expects an Area Code to calculate a distance. The screen passes the actionflow a Postcode, this is mapped into the actionflow onto the Area Code attribute using the Input Connection Point mapping.


A second screen can reuse the actionflow (this is referred to as an instance) and pass in a Zip Code which is mapped into the actionflow using the Input Connection Point mapping

Input Connection Point Setup Wizard

When a new input is connected the mapping wizard will appear. To reopen the mapping wizard click on the connector between the Input Data and the Input Connection Point.

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.

Further information, see Wiring Actionflows.

Input Connection Points 

A driving connection, records flow into the actionflow one by one. An event is classed as a single driving record. An actionflow requires at least one input connection point.

 Properties Tab

Basic Settings

FieldDescription
NameThe name of the Actionflow.
Action Phase

The  Phase that the connection point is in. See Actionflow Phases.

Validation

  • Minimum Records: The 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.
  • Maximum Records: The maximum number of records that the Actionflow is permitted to runIf the received records exceed the maximum set, the Actionflow will not run.

Input Parameters

FieldDescription
Name

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

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

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

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

 Audit Tab

Audit Summary

See the Common Properties page, Audit Summary section.

Output Connection Points

Output Connection Points return records as individual records.

 Properties Tab

Basic Settings

FieldDescription
NameThe name of the Actionflow.
Action Phase

The  Phase that the connection point is in. See Actionflow Phases.

Input Parameters

FieldDescription
Name

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

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

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

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

 Audit Tab

Audit Summary

See the Common Properties page, Audit Summary section.

Lookup Connection Points

Lookup Connection Points return records as a single recordset to the actionflow.

 Properties Tab

Basic Settings

FieldDescription
NameThe name of the Actionflow.
Action Phase

The  Phase that the connection point is in. See Actionflow Phases.

Validation

  • Minimum Records: The 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.
  • Maximum Records: The maximum number of records that the Actionflow is permitted to runIf the received records exceed the maximum set, the Actionflow will not run.

Request Parameters

Attributes used to filter the lookup.

FieldDescription
Name

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

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

Default Expression

A value or expression that is evaluated when no value is mapped to the attribute, 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

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

Response Parameters

Attributes returned by the lookup.

FieldDescription
Name

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

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

Default Expression

A value or expression that is evaluated when no value is mapped to the attribute, 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

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

 Audit Tab

Audit Summary

See the Common Properties page, Audit Summary section.

Sections on this page

Learn More

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



Terminology changes in progress

As part of the redesign of PhixFlow, we are changing the following terms:

dashboard → screen   
stream → table
stream attributes → attributes
stream item → record
stream set → recordset
stream view → view
stream item action → record-action 
stream action → table-action
driver class → database driver