Versions Compared

Version Old Version 27 New Version Current
Changes made by

Fiona Sargeant

Zoe Baldwin

Saved on

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 


Excerpt
-include_action_calculate_action_calculatenopaneltrue action node and associated expressions. These are part of actionflows.

Overview

Calculate Node Properties

Image Modified

Use a 

Insert excerpt
_action_calculate
_action_calculate
nopaneltrue

action

node to manipulate data that is passed to it. Calculate

actions Create a  Insert excerpt_action_calculate_action_calculatenopaneltrue node by dragging and dropping a node from the create section in the toolbar
  • Name the calculate something meaningful, e.g. Set Message
    • Disconnect the

    nodes have their own attributes, which can reference incoming data via expressions using one or more of the 115+ functions available in PhixFlow.

    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

    Example

    View file
    nameOpen Calculate Example.mp4
    height250

    Initially there is an actionflow which opens a new screen containing a dynamic text field. The aim of this example is to populate this dynamic text field with a message set by an attribute in a calculate node. The steps for this are:

    Worked Example

    For full details on how to create Calculate actions, including worked examples, see Calculate Action Configuration.

    Insert excerpt
    _

    action

    property_

    screen

    tabs
    _

    action

    property_

    screen

    tabs

    nopaneltrue node from the  Insert excerpt_driving_interface_connection_point_driving_interface_connection_pointnopaneltrueConnect the  Insert excerpt_driving_interface_connection_point_driving_interface_connection_pointnopaneltrue to the 

    namebasic-h
    nopaneltrue

    Insert excerpt

    _action_calculate

    _

    action_calculatenopaneltrue nodeConnect the  Insert excerpt_action_calculate_action_calculatenopaneltrue to the  Insert excerpt_action_screen_action_screennopaneltrue node, using the component input connection point - 'ScreenToOpen'. This is the name of the outermost area/form on the screen, enabling data to be passed to it.Create a calculate attribute
  • Name this Message

    • Add the following expression

    Code Block
    "You have successfully set up a calculate node"
  • Map the calculate attribute to the dynamic text field on the screen 

    1. Right click on the connection and click Configure Mappings

    2. Drag the Message attribute from the calculate (LHS) to the Message attribute on the open screen (RHS)
    3. Close the mapping screen
  • The actionflow configuration is complete.
  • Always remember to test the actionflow to make sure it works.
    • Insert excerpt_property_tabs

    property_toolbar
    _property_

    tabsnamebasic-h

    toolbar
    nopaneltrue

    Insert excerpt
    _parent
    _parent
    nopaneltrue

    Basic Settings

    FieldDescription
    NameEnter the name for the action node.
    Insert excerpt_actionflow_properties_actionflow_propertiesnameshow-namenopaneltrue Insert excerpt_actionflow_properties_actionflow_propertiesnameshow-textnopaneltruePass Through

    Specify whether or not to allow data that has not been processed to pass through to the next action node. 

    Insert excerpt_check_box_untick_check_box_unticknopaneltrue to prevent data that is not processed by this node from passing to the next action node.  Insert excerpt_check_box_tick_check_box_ticknopaneltrue to allow data that is not processed to pass through to the next action node.

    Calculate Attributes

    Description

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

    Output Attributes
    Anchor
    attribute
    attribute

    Calculate actions process data using expressions; see pages in the topic Expressions and PhixScripts.

    This section has a toolbar with standard buttons. 

    The grid contains a list of the expressions that the calculate action will perform. 

    • To add a new expression, in the section toolbar click 
      Insert excerpt
      _add
      _add
      nopaneltrue
       to open a new expression and set the properties.
    • To edit an existing expression, double-click it in the list to open its properties.
    • To remove an expression, select one and in the section toolbar click 
      Insert excerpt
      _delete
      _delete
      nopaneltrue
      .
    • To reorder an attribute, drag and drop the attribute into the desired position. Alternatively, double-click to open its properties and update the Order field.

    Calculate Attributes Properties

    Parent Details

    Basic Settings
    • Click 
      Insert excerpt
      _add
      _add
      nopaneltrue
      . PhixFlow opens the properties for a new calculate attribute.

    Create New Output Attribute

    Field

    		Description
    NameEnter the name of the calculate attribute.
    Type

    Select one of the data types:

    • String
    • Bigstring
    • Integer
    • Float
    • Decimal
    • Date
    • Datetime
    • Graphic
    • TrueFalse
    • Structured Data
    Note

    Make sure you select the same data type as that of the attribute to which you are mapping;

    see 

    see Understanding Data Types.

    Attribute Name Insert excerpt_check_box_tick_check_box_ticknopaneltrue to indicate the calculate attribute matches the name of an attribute in the data.Expression

    Enter an expression. To work in a larger pop-up window, click Image Removed.

    See also:


    Order

    Where the calculate action runs multiple expressions, enter a number to indicate the order in which this expression will be run.

    Remember that an expression that generates a value

    should

    must run before

    an

    any expression that uses the value.

    Expression

    Enter an expression. To work in a larger popup window, click 

    Insert excerpt
    _editor_

    description

    expand
    _

    description

    editor_expand
    nopaneltrue
    .

    See also:

    Input Connections

    The grid contains a list of the connection points that connect into this calculate node.

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

    For details about the Name, Type and Data Attributes properties of the input connection point, see Input Connection Points.

    Advanced

    FieldDescription

    Prioritise Throughput Over Ordering

    Insert excerpt
    _access_access
    Actionflow Properties
    Actionflow Properties
    namePrioritiseThroughputOverOrdering
    nopaneltrue


    Insert excerpt
    _audit
    _audit
    nopaneltrue