Range Source Eliminate By Expression Mismatch

(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.

 

 

 

 

 

More information

RSA function blocks list.