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. Note: When all decisions are eliminated the RCO Output Module, `None`, is executed to handle this condition.
	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.