(Available with Order Execution Mgt.)
Description
Range Source Eliminate By Expression Mismatch evaluates values in expressions.
Any value that does not adhere to a stated value is considered a "mismatch" and is eliminated.
Example
An expression that is evaluated is:
'color' = ""BLUE""
Any item that is not BLUE is eliminated.
Important:
This block is designed to work only when a valid danger point is configured.
A danger point:
Must be either of two types:
Integer, long.
Boolean.
All other types throw an exception.
Can be device or virtual point.
Can have a point value of zero or non zero.
The danger point value is considered in elimination decision, when the value is non-zero and if the evaluation type is Breakabale (neither Soft nor Hard ) type.
If an invalid danger point or no danger point is configured, the function block will not work and throws CORLOG warning.
Parameters
This function block has the following parameters:
Parameter |
Description |
|||
Always Evaluate |
Hard, Soft or Breakable. Controls what happens when the extension eliminates all items in the range source. |
|||
|
Hard |
All items will remain eliminated. Enter a wait state after the logic script has completed. |
||
|
Soft |
Roll back any eliminations made by this extension. |
||
|
Breakable |
Roll back any eliminations made by this extension that have a danger point value of TRUE (non zero). Routing modules first use the danger defined for each individual decision. However, one of the following may occur instead. |
||
|
|
If: |
Then: |
|
|
|
No danger point has been configured for the decision. |
The site-wide danger point will be used. |
|
|
|
This function block is used in the decision output logic, |
The site-wide danger point will be used. |
|
|
|
No danger point can be found for a decision. |
The decision remains eliminated. |
|
Expression |
Attribute expression that sources will be evaluated against. |
|||
|
Operators |
|||
|
Basic |
>, >=, <, <=,= and != |
||
|
|
Where |
|
|
|
|
> |
Greater than |
|
|
|
>= |
Greater or equal |
|
|
|
< |
Less than |
|
|
|
<= |
Less or equal |
|
|
|
= |
Equals |
|
|
|
!= |
Not |
|
|
|
<> |
Not (greater than or less than) |
|
|
Modifiers |
#, % |
||
|
|
Where |
|
|
|
|
# |
Integer |
|
|
|
% |
Floating (decimal) |
|
|
Boolean |
and, or, (combine sub-conditions) |
||
|
Exists value |
= "$Exists" |
Attribute exists |
|
|
|
<> "$Exists" |
Attribute does not exist |
|
|
Note: This evaluation is similar to the SQL Where condition. |
|||
|
Examples |
|||
|
'var' ="value" |
|||
|
('var' ="value") AND ('var < "value") |
|||
|
'COLOR' = $EXISTS |
|||
|
Syntax Notes |
|||
|
A variable is surrounded by single-quotes. A value is surrounded by double-quotes. At least one space is required around an operator. Parentheses can be placed around sub-expressions to include more than one sub-expression in the expression. An integer value must be started with a pound sign #. A float must be started with a % sign %. |
|||
|
Note: Case is not important; any entry will be treated as upper case. |
|||
Expression Point ID |
(Optional) point containing a dynamically changeable expression. Supercedes Expression. |
|||
|
|
|
|
|
RSA function blocks list. |