Versions Compared

Old Version 22

changes.mady.by.user Sarah Gibson

Saved on

compared with

New Version Current

changes.mady.by.user Zoe Baldwin

Saved on

Key

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

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue


Excerpt

This page

provides details of

is for application designers who need to configure functionality for components or events. It explains the properties for the

gateway node

gateway node, which is part of an actionflow.

Live Search
spaceKey@self
additionalnone
placeholderSearch all help pages
typepage

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

indent12pxstylenone

Overview

Image Modified

Use a 

Insert excerpt
_action_gateway
_action_gateway
nopaneltrue
node to control the path that data records take as they flow through an actionflow. You can add several output connection points. On the output connection points, you can specify decision logic to control the path of data, record by record.

Example

Sometimes there is a threshold in your data that affects the way you want to process it. For example you might want someone to approve orders over £1000, whereas orders below this value can be placed without approval.

In the screenshot below, an application screen lists the orders pending approval.

Image Removed

The actionflow for this requires a gateway node to capture orders with a value of £1000 or more so that it can send these to the person authorised to approve them. todo-sarah Provide screenshot and more details once confirmation and phases have been implemented

For a worked example, see Gateway Action Configuration.

Insert excerpt
_property_toolbar
_property_toolbar
nopaneltrue

Insert excerpt
_property_tabs
_property_tabs
namebasic-h
nopaneltrue

Insert excerpt
_parent
_parent
nopaneltrue

Basic Settings

FieldDescription
NameEnter the name
for
of the action node.
Insert excerpt_actionflow_properties_actionflow_propertiesname
show-namenopaneltrue Insert excerpt_actionflow_properties_actionflow_propertiesnameshow-textnopaneltrue
Exclusive

Control whether or not a record can go through more than one output. 

Exclusive Gateway (Single path)

Insert excerpt
_

check

toggle_

box_tick

on
_

check

toggle_

box_tick

on
nopaneltrue
 to make a record go through the first connection point where the condition is met. Exclusive gateways include the visual indicator of their setup: Image Added

Inclusive Gateway (Multiple Paths)

Insert excerpt
_

check

toggle_

box_untick

off
_

check

toggle_

box_untick

off
nopaneltrue
 to make a record go

through any

through all connection

point

points where the condition is met.

Input Connection Points

This section has a toolbar with standard buttons. The grid contains a list of all input connection points and their type; see 

 Inclusive gateways include the visual indicator of their setup: Image Added

Description

We recommend that you always enter a description to explain the purpose of this item.

Rules

FieldDescription
RuleThe expression to be evaluated. If the condition is met, the record will go through the connection point or points (depending on if the gateway is exclusive or inclusive, see above).
OutputThe name of the output connection point.              
OrderThe order the rules should be evaluated in.

Input Connection Points

Gateway nodes can have:

  • one 
    Insert excerpt
    _driving_input_connection_point
    _driving_input_connection_point
    nopaneltrue
  • multiple 
    Insert excerpt
    _request_input_connection_point
    _request_input_connection_point
    nopaneltrue
'

records  will only pass through the output paths if the condition set in the expression is met.

This section has a toolbar with standard buttons. The 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. 

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

    Field

    DescriptionNameEnter an expression name.OrderWhere the gateway action runs and expression for each output path, enter a number to indicate the order in which this expression will be run. Remember that an expression that generates a value should run before an expression that uses the value. The order is especially important if the gateway is marked as exclusive.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:

    Insert excerpt_description_descriptionnopaneltrue Insert excerpt_property_tabs_property_tabsnameaccess-hnopaneltrue Insert excerpt_access_access
    • s

    The grid contains a list of all input connection points and their type.

    • To add a new input connection point, in the section toolbar click 
      Insert excerpt
      _add
      _add
      nopaneltrue
       to open a new input connection point and set its properties; see Input Connection Points.
    • To edit an existing input connection point, double-click it in the list to open its properties.
    • To remove an input connection point, select one and in the section toolbar click 
      Insert excerpt
      _delete
      _delete
      nopaneltrue
      .

    For input connection point properties, see Input Connection Points.

    Output Connection Points

    This section has a toolbar with standard buttons. The grid contains a list of all output connection points.

    This section has a toolbar with standard buttons. The 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. 

    • see Output Connection Points 

    Each output connection point has an expression that specifies the logic to control whether or not records flow to the next action node. 

    For driving output connections, you can refer to an attribute in the expression using the syntax:

    Code Block
    connectionpointname.attributename

    If the expression evaluates to true for the record flowing through the node, it will pass out that connection point onto the next node in the sequence. This can be dependent on if the gateway is marked as exclusive, see below.

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

    Advanced

    FieldDescription

    Prioritise Throughput Over Ordering

    Insert excerpt
    Actionflow Properties
    Actionflow Properties
    namePrioritiseThroughputOverOrdering
    nopaneltrue


    Insert excerpt
    _audit
    _audit
    nopaneltrue



    Learn More

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