Overview
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.ExampleClick 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_screen |
---|
nopanel | true |
---|
| node from the Insert excerpt |
---|
| _driving_interface_connection_point |
---|
| _driving_interface_connection_point |
---|
nopanel | true |
---|
| . - Connect the
Insert excerpt |
---|
| _driving_interface_connection_point |
---|
| _driving_interface_connection_point |
---|
nopanel | true |
---|
| to the Insert excerpt |
---|
| _action_calculate |
---|
| _action_calculate |
---|
nopanel | true |
---|
| 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" |
- 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 |
---|
After configuring an actionflow, always test the actionflow to make sure it works. |
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 SettingsField | Description |
---|
Name | Enter the name for the action node. | Insert excerpt |
---|
| _actionflow_properties |
---|
| _actionflow_properties |
---|
name | show-name |
---|
nopanel | true |
---|
|
| Insert excerpt |
---|
| _actionflow_properties |
---|
| _actionflow_properties |
---|
name | show-text |
---|
nopanel | true |
---|
|
| Pass 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_untick |
---|
nopanel | true |
---|
|
to prevent data that is not processed by this node from passing to the next action node. Insert excerpt |
---|
| _check_box_tick |
---|
| _check_box_tick |
---|
nopanel | true |
---|
|
to allow data that is not processed to pass through to the next action node. |
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 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 |
---|
nopanel | true |
---|
| .
For details about the Name, Type and Data Attributes properties of the input connection point, see Input Connection Points. Calculate AttributesCalculate 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 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 . PhixFlow opens the properties for a new calculate attribute; see Calculate Attributes Properties, below.
Insert excerpt |
---|
| _description |
---|
| _description |
---|
nopanel | true |
---|
|
Calculate Attributes Properties 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 SettingsField | 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 Understanding Data Types. |
| Attribute Name | Insert excerpt |
---|
| _check_box_tick |
---|
| _check_box_tick |
---|
nopanel | true |
---|
|
to indicate the calculate attribute matches the name of an attribute in the data. Insert excerpt |
---|
| _check_box_untick |
---|
| _check_box_untick |
---|
nopanel | true |
---|
|
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. | Expression | Enter an expression. To work in a larger popup window, click Insert excerpt |
---|
| _editor_expand |
---|
| _editor_expand |
---|
nopanel | true |
---|
|
. 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 must run before any expression that uses the value. |
Save and close the calculate attribute properties to return to the calculate properties. |