Insert excerpt

	_Banners
	_Banners
name	actionflow
nopanel	true

This page is for application designers who need to configure functionality for components or events. It explains the properties for the calculate node and associated expressions, which is part of an actionflow.

Excerpt

Map the calculate attribute to the dynamic text field on the screen as follows:

Right-click on the connection and click Configure Mappings.
Drag the Message attribute from the calculate node, on the left, to the Message attribute on the open screen, on the right.
Close the mapping screen.

The actionflow configuration is complete.

Tip

Overview

Image Modified

Use a

Insert excerpt

	_action_calculate
	_action_calculate
nopanel	true

node to manipulate data that is passed to it. Calculate nodes have their own attributes, which can reference incoming data via expressions using one or more of the 115+ functions available in PhixFlow.

Example

Click to play the following video that shows an example of using a calculate node in an actionflow.

View file

name	Open Calculate Example.mp4
height	250

The video shows an actionflow that opens a new screen containing a dynamic text field. It then populates the dynamic text field with a message, which is set in a calculate node attribute. The steps for are:

Drag a calculate node from the toolbar and drop it into the actionflow diagram.

Name the calculate something meaningful, e.g. Set Message

Disconnect the Insert excerpt_action_screen_action_screennopaneltrue node from the Insert excerpt_driving_interface_connection_point_driving_interface_connection_pointnopaneltrue.Connect the Insert excerpt_driving_interface_connection_point_driving_interface_connection_pointnopaneltrue to the Insert excerpt_action_calculate_action_calculatenopaneltrue node.

To pass data into the actionflow, go to the Inputs section on the left. Connect the component input connection point ScreenToOpen to the calculate node.

Click on the calculate node to open its properties.

In the Attributes section, add a new calculate attribute and set:

Name to Message

Expression to:

Code Block
"You have successfully set up a calculate node"

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.

Input Connection Points

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

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

Calculate Attributes

Calculate

After configuring an actionflow, always test the actionflow to make sure it worksFor a worked example, see Calculate Action Configuration.

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Insert excerpt

	_property_toolbar
	_property_toolbar
nopanel	true

Insert excerpt

	_parent
	_parent
nopanel	true

Basic Settings

Field	Description
Name	Enter the name for the action node.

Insert excerpt_actionflow_properties_actionflow_propertiesnameshow-namenopaneltrue Insert excerpt_actionflow_properties_actionflow_propertiesnameshow-textnopaneltruePass Through

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
nopanel true
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
nopanel true
.
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.
Click
Insert excerpt
_add
_add
nopanel true
. PhixFlow opens the properties for a new calculate attribute

; see Calculate Attributes Properties, below. Insert excerpt_description_descriptionnopaneltrue Insert excerpt_audit_auditnopaneltrueCalculate Attributes Properties Anchorattributeattribute Insert excerpt_property_tabs_property_tabsnamebasic-hnopaneltrue Insert excerpt_property_toolbar_property_toolbarnopaneltrue Insert excerpt_parent_parentnopaneltrue

Basic Settings

.

Create New Output Attribute

Field

Description

Name

Enter 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. Insert excerpt_check_box_untick_check_box_unticknopaneltrue to indicate the calculate attribute does not have the same name as an attribute in the data. In this case you will need to map the data attribute to this calculate attribute.

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 must run before any expression that uses the value.

Expression

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

Insert excerpt

	_editor_expand
	_editor_expand
nopanel	true

.

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
_

audit

add
_

audit

add
nopanel true

Save

and

close

set the

calculate attribute properties to return to the calculate properties.

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
nopanel true
.

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

Advanced

Field

Description

Prioritise Throughput Over Ordering

Insert excerpt

	Actionflow Properties
	Actionflow Properties
name	PrioritiseThroughputOverOrdering
nopanel	true

Insert excerpt

	_audit
	_audit
nopanel	true

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page

Panel

borderColor	#00374F
titleColor	white
titleBGColor	#00374F
borderStyle	solid
title	Sections on this page

Table of Contents

maxLevel	3
indent	12px
style	none

Learn More

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

Insert excerpt_terms_changing_terms_changingnopaneltrue

Versions Compared

Old Version 45

New Version Current

Key

Overview

Example

Input Connection Points

Calculate Attributes

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Basic Settings

Output Attributes
Anchor
attribute
attribute

Basic Settings

Create New Output Attribute

Input Connections

Advanced

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page

Page Comparison

Versions Compared

Old Version 45

New Version Current

Key

Overview

Example

Input Connection Points

Calculate Attributes

Insert excerpt_property_tabs_property_tabsnamebasic-hnopaneltrue

Basic Settings

Output Attributes Anchorattributeattribute

Basic Settings

Create New Output Attribute

Input Connections

Advanced

Live SearchspaceKey@selfadditionalnoneplaceholderSearch all help pagestypepage

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Output Attributes
Anchor
attribute
attribute

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page