Logic Editor

The Logic Editor allows for the configuration of logical expressions within Workflows.

The Logic Editor contains the below panes to configure your logical expression.

Objects

Objects are items which you can retrieve the Properties of. The types of Objects available are below. The Properties of these objects can be viewed here.

Alarms All currently active Alarms in Runtime.
Collections All Collections available to the project.
Display Layout The Display Layouts created and their associated Display Layout Items.
Environment The Runtime Environment. This includes information such as the current date and the name of the Workstation.
Integrated Systems Installed Integrated Systems and their assets.
Language The Language being used in Runtime.
Logging Information about an action or event being logged.
Maps The Maps created and their associated Objects.
OPC An OPC system.
Sound Service Sounds being played in Runtime.
User Security If Security is enabled, Commands can be issued on the logged in user.
Workstation Management Information about the Workstation running the Workflow.
Failover Management Information about the Failover Management.
TriggeringItem The Object which triggered this Workflow.
Variables The variables which have been defined within the Start block.

Properties

The Properties pane contains selectable attributes of an Object, such as its Item ID or Name.

Operations

AND Items on both sides of this operator must evaluate to true for this to evaluate to true. Otherwise, false.
OR One of the items on either side of this operator must evaluate to true for this to evaluate to true. Otherwise, false.
NOT The item after this evaluates to its opposite. True becomes false, and vice versa.
< Less than.
> Greater than.
( Opening parentheses. Used to separate parts of the expression.
) Closing parentheses. Used to separate parts of the expression.
+ Add two values together.
- Subtract one value from another.
<= Less than or equal to.
>= Greater than or equal to.
<> Not equal.
= Equal.
* Multiply two values.
/ Divide the left value by the right value.

Functions

HasItem Check if a collection of String values contains a specific String.
GetAssetProperty Retrieve a specific property of an asset with a specific ID.
GetCollectionItemProperty Retrieve a specific property from an item within a collection.
AddSeconds Modify the date and time.
Contains Check if a value contains a specific sequence of characters.

Constants

Constants are static values that are set in the expression.

String A text value. This value is represented by the color Blue.
Integer A numerical value with no decimals. This value is represented by the color Green.
Time A time in the HH:MM:SS format.
Date A date in the YYYY-MM-DD format.
Note: When creating Expressions, ensure the correct data type is being evaluated by selecting either String or Integer from the drop-down menu. If left on Default, the platform will attempt to infer the type automatically. However, mismatched types may be auto-converted, which can lead to unexpected results. For example:

  • Integer + String (numeric) → The String is converted.

    Ex: 1 (int) + "1" (string) = 2.

  • String + Integer → The Integer is converted.

    Ex: "1" (string) + 1 (int) = "11".