This page provides details of the properties for the calculate node and associated expressions. These are part of actionflows.

Overview

Use a Calculate 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.

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 Open Screen node from the Driving interface connection point.
Connect the Driving interface connection point to the Calculate 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:
1. Name to Message
2. Expression to:
```
"You have successfully set up a calculate node" 
```
Map the calculate attribute to the dynamic text field on the screen as follows:
1. Right-click on the connection and click Configure Mappings.
2. Drag the Message attribute from the calculate node, on the left, to the Message attribute on the open screen, on the right.
3. Close the mapping screen.
The actionflow configuration is complete.

edc

Always remember to test the actionflow to make sure it works.

Properties Tab

Parent Details

If this item is within or belongs to another, its parent name is shown here. See the Parent Details section on the Common Properties page for more details.

Basic Settings

Field	Description
Name	Enter the name for the action node.
Show in the Repository	An application can have many actionflows, and an individual actionflow can have many nodes. This can lead to many items being listed under Actionflow in the repository. Use this option to omit the node from the repository. to display this node in the repository. to omit this node from the repository.
Pass Through	Specify whether or not to allow data that has not been processed to pass through to the next action node. Untick to prevent data that is not processed by this node from passing to the next action node. Tick to allow data that is not processed to pass through to the next action node.

Calculate Attributes

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 Add New 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 Delete.

Calculate Attributes Properties

Parent Details

Basic Settings

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 Make sure you select the same data type as that of the attribute to which you are mapping; see Understanding Data Types.
Attribute Name	Tick 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 . See also: Expression Basics Internal Variables Functions
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 run before an expression that uses the value.

Description

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

Access and Audit Tab

Security Tab

Access Permissions

See the Common Properties page, Access Permissions section.

Audit Tab

Audit Summary

See the Common Properties page, Audit Summary section.

Sections on this page

Learn More

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

Terminology changes in progress

As part of the redesign of PhixFlow, we are changing the following terms:

dashboard → screen
stream → table
stream attributes → attributes
stream item → record
stream set → recordset
stream view → view
stream item action → record-action
stream action → table-action
driver class → database driver

Calculate Node