Versions Compared

Key

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

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue

This page provides details of the properties for the

one 

Overview

Use the input and output connection points , which you use to wire together on nodes in an actionflow to wire the nodes together.

Todo-Fiona: There are also properties in Action Node Connections - same or different?

Overview

Use the input and output connection points on nodes in an actionflow to wire the nodes together.

  • For input connection points, map which attributes to pass into the node.
  • For output connection points, specify an expression to determine ???  passed onto the next node

     

    • From the Inputs pane on left, into the actionflow.
    • From one node to another within the actionflow. 
      Hover your mouse pointer over a node and click Add Output to add an connector to another node.
    • From a final actionflow node to the Outputs pane on the right of the actionflow.

    Connection points available depend on the purpose of the node.

    • Output connection points: 
      • Calculate
      • Gate
      • View

    Nodes without an output connection represent:

    When you wire nodes together, you need to map which attributes pass through to the next node. To change the mapping, click on the connector to open the Mapping window.

    Node properties have sections for Input Connection Points and Output Connection Points on the node. Double-click on a listed connection point to open its properties.

    Note

    The properties available for connection points can vary depending on the node on which they occur.

    Input

     

    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.

    Connection Points 
    Anchor
    input
    input

    Open the 

    Insert excerpt
    _property_
    toolbar
    settings
    _property_
    toolbar
    settings
    nopaneltrue
     for each connection point (input, lookup, output) by clicking on the node.

    Image Added

    Insert excerpt
    _property_tabs
    _property_tabs
    namebasic-h
    nopaneltrue

    Insert excerpt
    _parent
    _parent
    nopaneltrue

    Basic Settings

    FieldDescriptionConnection Point Found On
    Name
    Enter the
    The name
    for
    of the
    connection pint.Role

    text

    • Primary
    • Component
    Type

    Available when Role is Component

    text

    • Driving
    • Lookup
    Open Mode

    Not seeing this for the INPUTS input connection

    Available when Role is Component.

    text

    • Insert
    • Update
    • Change Fields
    Action Phasedefault
    Actionflow.

    Insert excerpt
    _input
    _input
    namecaps
    nopaneltrue

    Insert excerpt
    _lookup
    _lookup
    nopaneltrue

    Insert excerpt
    _output
    _output
    namecaps
    nopaneltrue

    Action Phase

    The 

    Insert excerpt
    _action_

    audit

    phase
    _action_

    audit

    phase
    nopaneltrue

    Data Attributes

    A list of attributes in other action nodes that you can map into this node. You can refer to these attributes in an expression using the syntax:

    Code Block
    connectionpointname.attributename

    Lookup Attributes are available when Type is Lookup. 

    Double-click on an attribute in the list to display the properties related to this node and connection. This can include Name, Type, Component, Primary Key etc.

    To add a new attribute, click

     that the connection point is in. See Actionflow Phases.

    Insert excerpt
    _

    add

    input
    _

    add

    input
    namecaps
    nopaneltrue

     and specify the Name and Type; see Attribute.Output Connection Points  Anchoroutputoutput

    Insert excerpt
    _

    property_tabs

    lookup
    _

    property_tabsnamebasic-h

    lookup
    nopaneltrue

    Insert excerpt
    _

    parent

    output
    _

    parent

    output
    namecaps
    nopaneltrue

    Basic Settings

    Validation

    The expression properties has sections for Parent Details , Audit Summary and the following Basic Settings:

    Insert excerpt_description_description
    FieldDescription
    NameEnter a name for the output connection pointOrder

    Enter a number to indicate the order in which this expression will be run.
    Remember that an expression that generates a value must run before an expression that uses the value.

    Tip

    The order is very important for exclusive gateway nodes, as the records pass through the first output connection that meets the expression condition.

    Expression

    Enter an expression which evaluates to true or false to determine if stream-items will pass through this connection point. To work in a larger pop-up window, click Image Removed.

    See also:

    Gateways can have an unlimited number of output paths.Output paths process data using expressions; see pages in the topic Expressions and PhixScripts.

    Records pass through the output connection point when the condition in the expression is met.

    Note

    Gateways can have an unlimited number of output paths. If the Gateway Node is Exclusive records only pass through the first output path where the expression condition is met.

    This section has a toolbar with standard buttonsThe grid contains a list of output connection points and their expressions. 

    To add a new output path, in the section toolbar click  Insert excerpt_add_addnopaneltrue to open a new output path and set the expression.
  • To edit an existing output path, double-click it in the list to open its properties.
  • To remove an output path, select one and in the section toolbar click Image Removed Permanently Delete
  • Connection 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
    _

    property_tabs_property_tabsnameaccess-h

    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
    _

    access

    lookup
    _

    access

    lookup
    nopaneltrue

    Insert excerpt
    _

    audit

    output
    _

    audit

    output
    namecaps
    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_changingnopaneltrue

    Not needed??

    Input Connection Points

    Shows a list of available input connection points. Calculate nodes can have

    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


    Tip

    If the

    Insert excerpt
    _run_action
    _run_action
    nopaneltrue
    tool is used on an Actionflow containing Default Expressions, the default values can be overridden on the Run Action window using the tick boxes. True/false fields with a Default Expression of true will be toggled off. To enable, tick the tick box and toggle on.

    Expand
    titleSee example

    Image Added



    Input Connection Points

    See Input Connection Points.

    Input Connections

    A grid of Input Connections. 

    Open Screen Action Input Connections

    The following properties are available for Input Connections for 

    Insert excerpt
    _action_screen
    _action_screen
    nopaneltrue
    action nodes only.

    FieldDescription
    Role

     Specify whether the actionflow will provide data to the view or screen being opened.

    • Primary: selected by default.
      The view or screen opens regardless of data. 
    • Component: 
      The actionflow provides data to the view or screen when it opens.
    Type

    Available when Role is Component.

    Specify the type of connection:

    • Insert excerpt
      _driving_input_connection_point
      _driving_input_connection_point
      nopaneltrue
    multiple 
    • : there can be only one of these.
    • Insert excerpt
      _request_input_connection_point
      _request_input_connection_point
      nopaneltrue
      : there can be multiple of these
    Open Mode


    Excerpt
    namescreenInputConnections

    Available when Role is Component. For example,

    Image Added

    When a screen opens, specify how data fields will display:

    • Insert data fields are cleared and variables are passed to the screen from the actionflow, the screen is then ready for the application user to add new data. Typically used for adding new data.
    • Update Variables created in the actionflow are set on the screen, any filtering is applied, data is retrieved from the server and displayed in the fields. Note the values set by the actionflow are persisted. Typically used for updating existing data.
    • Change Fields Variables passed to the screen are set. Typically used to set a value on one screen from another.


    Attributes
    's

    A list of attributes available on the input connection point. These directly link to the fields available on the form.

    • Primary connection points display the screen properties as attributes.
    • Component connection points display attributes available on the associated form.


    HTML Comment

    Not yet implemented - and may need to be on the input connection page.
    Each open screen node has 1 primary input connection point by default called 'screen'. Available when Input connection point Role is Primary, optionally set:

    FieldTypeDefault Values if not setDescription
    HeightNumber
    Sets the height of the screen
    WidthNumber
    Sets the width of the screen
    TopNumber
    Sets the top position of the screen relative to the window
    LeftNumber
    Sets the left position of the screen relative to the window
    MaximisedBooleanwhatever is set on the screen properties
    • True will open the dashboard in its maximised state.
    • False will open the dashboard in its minimised state and will use the above properties.

    When you connect an open screen node to a screen, PhixFlow automatically adds an input connection point for each form on the screen. The input connection point is automatically set to:

    •  Role Component.
    •  Attributes: all data fields and dynamic text fields are added.
      This means you can map to the attributes and pass data to them.

    Data Attributes

    This section has a toolbar with standard buttonsThe grid contains a list of

    all input connection points and their type.To add a new input connection point, in the section toolbar

    the attributes that will pass through the wire into this node. All nodes can have a driving input connection, which passes data records one-by-one into the node.

    To refer to these attributes in an expression, specify the names of the connection point and attribute with the syntax:

    Code Block
    connectionpointname.attributename

    Double-click on an attribute in the list to display tje properties related to this node and connection. This can include Name, Type, Component, Primary Key etc.

    • To create a new attribute: click 
      Insert excerpt
      _add
      _add
      nopaneltrue
     to open a new input connection point and set its properties
    •  and set the Name and Type; see Attribute.
    • To
    edit
    • add an existing
    input connection point, double-click it in the list to open its properties
    • attribute to this list, open the list of attributes and drag one onto the grid.
    • To open its properties, double-click one of the listed attributes.
    • To remove an
    input connection point
    • attribute, select one and
    in the section toolbar

    The input connection points have sections for  Parent Details , Audit Summary and the following 

    Basic Settings

    FieldDescriptionNameThe name of the connection pointTypeSpecify the type of connection:
    • click 
    Image Removed Permanently Delete
    • Insert excerpt
      _delete
      _delete
      nopaneltrue

    Insert excerpt
    _

    driving

    structured_

    input

    data
    _

    connection_point_driving_input_connection_point

    structured_data
    nopaneltrue

    Request Attributes

    Available for

    Insert excerpt
    _action_view
    _action_view
    nopaneltrue

    : there can be only one of these.

    ,

    Insert excerpt
    _

    request

    action_

    input

    gateway
    _

    connection_point

    action_gateway
    nopaneltrue
    and
    Insert excerpt
    _

    request

    action_

    input

    calculate
    _

    connection

    action_

    point

    calculate
    nopaneltrue

    : there can be multiple of these

    Attributes/Data Attributes/Request Attributes

    A list of attributes in other action nodes that you can map into this node. You can

     nodes, which can have Lookup connection points.

    This section has a toolbar with standard buttonsThe grid contains a list of the attributes that you want to lookup from another table. Lookup connections pass a complete set of records into the node. 

    To refer to these attributes in an

    expression using the syntax

    expression, specify:

    Code Block
    connectionpointname
    req.attributename

    Request Attributes are available when Type is Request. 

    If you double

    Double-click on an attribute in the

    grid, it's properties pane will show relevant properties for

    list to display its properties related to this node and connection. This can include Name, Type, Component, Primary Key etc.

    • To create a new attribute: click 
      Insert excerpt
      _add
      _add
      nopaneltrue
       and set the Name and Type; see Attribute.
    • To change its properties, double-click an attribute in the list; see View Attribute
    for details of these properties.You can also add a new attribute by specifying the properties Name and Type; see Attribute for details of these properties.
    • To delete an attribute, right-click and select 
      Insert excerpt
      _delete
      _delete
      nopaneltrue
      .

    Insert excerpt
    _structured_data
    _structured_data
    nopaneltrue

    Output Connection Points 
    Anchor
    output
    output

    This section is not available for actions that do not require output connections because they represents the end of actionflow processing, e.g. Save, Open Screen, Open URL, and Analysis nodes.

    For all other nodes, the output connection point has an expression that specifies the logic to control whether or not records flow to the next action node. The syntax for a driving connection is:

    Code Block
    connectionpointname.attributename

    The syntax for a lookup connection is:

    Code Block
    req.attributename

    If the expression evaluates to true for the record flowing through the node, it will pass through the connection point onto the next node in the sequence. 

    Insert excerpt
    _property_tabs
    _property_tabs
    namebasic-h
    nopaneltrue

    Basic Settings

    Field

    Description
    NameEnter a name for the output connection point
    Order

    Enter a number to indicate the order in which this expression will be run.
    Remember that an expression that generates a value must run before an expression that uses the value.

    Tip

    The order is very important for exclusive gateway nodes, as the records pass through the first output connection that meets the expression condition.


    Expression

    Enter an expression that evaluates to true or false to specify whether or not records pass through this connection point. To work in a larger popup window, click 

    Insert excerpt
    _editor_expand
    _editor_expand
    nopaneltrue
    .

    See also:


    Note

    Gateways can have an unlimited number of output paths. If the Gateway Action Configuration is Exclusive, records only pass through the first output path where the expression condition is met.

    Actionflow Connector Properties

    Connector properties do not include the name. 

    Basic Settings

    FieldDescription
    InputThe name of the node at the start of this wire.
    Input Connection Point

    The name of the connection point.

    OutputThe name of the node at the end of this wire.
    Output Connection PointThe name of the connection point.

    To remove a mapping, right-click and select Image Added Delete Mapping

    Input Mappings

    The left grid contains a list of attributes available from the input.  

    Output Mappings

    The right grid contains a list of attributes available to map to in the output.   

    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