Versions Compared

Version Old Version 5 New Version Current
Changes made by

Zoe Baldwin

Zoe Baldwin

Saved on

Key

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

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue

Overview

Inputs.pngImage Removed

Actionflows can use data displayed on screens. This data can be manipulated within an actionflow and can be saved onto tables. Sometimes an actionflow does not require any 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 supplied.

Input Connection Points

Input Connection points

are the interface to the actionflow. They define the inputs, lookups (optional) and outputs (optional) 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. Where no data is required the input can be an event such as a mouse-click or scheduled task.

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

Input Connection Point Setup Wizard

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

:
  • Right-click the input Connection Point
    • Select 

    click on the connector between the Input Data and the Input Connection Point.

    Insert excerpt
    _

    mappingConfigure

    mappingIcon
    _

    mappingConfigure

    mappingIcon
    nopaneltrue

    .Further information, see Wiring Actionflows

    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 Actionflows.

    Image Added 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.

    Insert excerpt
    _property_tabs
    _property_tabs
    namebasic-h
    nopaneltrue

    Basic Settings

    FieldDescription
    NameThe name of the Actionflow.
    Action Phase

    The 

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

    Validation

    FieldDescription
    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.

    Minimum Records Error Message

    (Available in PhixFlow 12.1+)

    		Enter an error message that will show if the Minimum Records is not reached.
    Maximum Records

    The maximum number of records that the Actionflow is permitted to run. If the received records exceed the maximum set, the Actionflow will not run.

    Maximum Records Error Message

    (Available in PhixFlow 12.1+)

    		Enter an error message that will show if the Maximum Records is exceeded.

    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


    Note

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


    Insert excerpt
    _audit
    _audit
    nopaneltrue

    Image AddedOutput Connection Points

    Output Connection Points return records as individual records.

    Insert excerpt
    _property_tabs
    _property_tabs
    namebasic-h
    nopaneltrue

    Basic Settings

    FieldDescription
    NameThe name of the Actionflow.
    Action Phase

    The 

    Insert excerpt
    _action_phase
    _action_phase
    nopaneltrue
     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


    Note

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


    Insert excerpt
    _audit
    _audit
    nopaneltrue

    Image AddedLookup Connection Points

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

    Insert excerpt
    _property_tabs
    _property_tabs
    namebasic-h
    nopaneltrue

    Basic Settings

    FieldDescription
    NameThe name of the Actionflow.
    Action Phase

    The 

    Insert excerpt
    _action_phase
    _action_phase
    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

     that the connection point is in. See Actionflow Phases.

    Validation

    FieldDescription
    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.

    Minimum Records Error Message

    (Available in PhixFlow 12.1+)

    		Enter an error message that will show if the Minimum Records is not reached.
    Maximum Records

    The maximum number of records that the Actionflow is permitted to run. If the received records exceed the maximum set, the Actionflow will not run.

    Maximum Records Error Message

    (Available in PhixFlow 12.1+)

    		Enter an error message that will show if the Maximum Records is exceeded.

    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


    Note

    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


    Note

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


    Insert excerpt
    _audit
    _audit
    nopaneltrue