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 Panel 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.
Rules Control asset and Map visibility, selection, and alarm behavior across Workstations.
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 Variables.

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.
GetCommonAssetProperty Retrieves a commonly used property from an asset.
GetCustomAttributeValue Retrieves the value of a specified Custom Attribute for a given asset.
Note: This function is only available for integrated systems in Advanced Icon Mode .
GetCustomPropertyValue Retrieves the value of a Custom User Property from an asset, map, or workstation using its ID.
GetCollectionItemProperty Retrieves a named property from an item within a collection.
GetVariableValue Retrieves the value of a Global, Workstation, or Workflow variable for use within workflows.
IsLayerVisible Returns a Boolean value indicating whether a selected layer is visible for a given asset.
Note: This function is only available for integrated systems in Advanced Icon Mode .
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".