Configuring the Condition node

The view of the Condition node properties window depends on how many nodes are connected to it. If one node is connected, the window has the following tabs: Children, Condition, Dictionaries, and General.

condition execution tab

On the Children tab, select Execution type (the node’s action when the conditions specified on the Conditions tab are executed):

  • Execute all children if the condition is true – if the node is in this type, all child nodes will be executed if the condition is true, otherwise they will not.

  • Execute specific children if the condition is true, others if false – if the node is in this type, it will fail to execute child nodes that should not be executed and displays an error.

For the Execute specific children if the condition is true, others if false type, it is possible to select all available nodes in the Available nodes field and move them to two fields:

  • Execute if condition is true

  • Execute if condition is false

If several parent nodes are connected to the Condition node, the Parents tab will be displayed instead of the Children tab. The Parents tab displays all connected nodes:

condition parents tab

In the list on the left, set the priority of the parent nodes using the Move up/Move down buttons; 1 is the highest priority of node execution.

If necessary, enable the Allow execution with incomplete parents option, which allows you to continue executing child nodes even if some of the parent nodes have not been fully executed. This option is particularly useful in situations where completing all parent nodes is not critical.

Note that child nodes will only use one parent node during execution. This node must meet all conditions, be successfully completed, and have the highest priority.

Configuring the Condition tab

The Condition tab allows you to prescribe conditions for the execution of child nodes:

condition condition empty

To add, clone, or delete conditions, use the toolbar with the corresponding buttons:

Add – allows users to add new conditions to the list. Clone – allows users to copy existing conditions. The option is enabled only after you select one of the conditions from the list.

Remove – allows users to delete conditions. The option is enabled only after you select one of the conditions from the list.

Move up/Move down – allows users to navigate through the list of conditions and change their position within the (sub)folder. The buttons are enabled only after you select one of the conditions from the list.

The name of the condition is generated from its settings, so the user can click on it as a single object.

The Negate all option allows you to invert the result of the calculation: the calculated logical value is reversed, true will become false, and false will become true.

When adding multiple conditions, use the logical operators And/AndNot/Or. Select the required operator from the drop-down list on the left.

condition options operator

To manage condition settings, click on the required condition so that its parameters are displayed in the Condition options area.

condition options

The Condition options field allows users to specify сonfigurable parameters for different types of conditions.

condition options type

There are following conditions available:

  • SRL condition

  • PDL condition

  • Records count

  • Columns count

  • Has column

  • Has file

Options for the SRL and PDL conditions on the input field toolbar include:

  • button operators – access the list of available SRL and PDL-operators.

  • button columns – toggle the display of input columns on or off next to the expression editor. Double-click a column name in the list to insert it into your expression. Use the Filter field to search for particular columns either by their names or tags (#).

  • button functions – toggle the display of SRL and PDL functions on or off next to the expression editor. When you select a function in the list, a brief description in the field appears below. Double-click a function name in the list to insert it into your expression. For more information refer to corresponding sections: PDL function reference and/or SRL function reference.

  • button user manual – quickly access SRL manual and PDL manual.

  • View – configure miscellaneous display options.

Click Check syntax to verify if the expression you have typed into the text area for a condition is correct. If an error is found, a prompt appears displaying information about the syntax error. Study the SRL syntax guide (see the link above) to avoid errors. You will need to correct the error before attempting to execute the node. During execution, PolyAnalyst performs a second check of the syntax for each condition, and the process fails if any conditions are incorrect.

Configuring the Dictionaries tab

The Dictionaries tab is used to select the dictionaries used during execution:

condition dictionaries tab

By default, the Use default dictionaries checkbox is checked. The user may wish to add or remove dictionaries from the default list.

The field on the left contains a list of groups of dictionaries. The groups are marked either with a green checkmark or a green square sign. The checkmark indicates that all the dictionaries of this group are used by default. The square sign means that only some of the dictionaries in the group are used by default.

If you uncheck the option Use default dictionaries, you can select and deselect both whole groups of dictionaries and individual dictionaries.