Select Source by Age

(Available with Order Execution Mgt.)

Description

Select Source By Age applies a weight to items within the source range based on a comparison of a particular attribute value. A weight is applied to all these items except the item with the youngest (highest) or oldest (lowest) value for that attribute.

The applied weight is a value that:

You entered in the Set Block Weights function block's corresponding parameter.

Set Block Weights assigns to this function block.

Notes

If:

A zero weight is applied to this block, items that fail the comparison are eliminated from the range source to leave only one item, i.e. the selected item, remaining in the source range.

There is a tie (if more than one item has the lowest weight) only one item is selected.

Insert an RSA function block before Select Source By Age to specify criteria that determines which item should be selected in case of a tie.

Parameters

This function block has the following parameters:

Parameter	Description
Attribute Id	ID of the attribute to base the comparison on. Note: The selection order is: Items that have a value for this attribute (either the oldest or youngest, depending on the Age parameter). Items with no value for this attribute. Items that do not have this attribute at all.
Attribute Start Character	(Optional) An integer that specifies the first character within the attribute value to be included in a sub-string comparison.
Attribute Length	(Optional) An integer that specifies the number of characters, beginning with the Attribute Start Character, to include in a sub-string comparison.
Comparison	Numeric or alphabetical comparison
Age	Specifies whether to select the item with the oldest (lowest) or youngest (highest) attribute.
Attribute Point ID	(Optional) Text point. Stores the name of attribute. Supercedes Attribute ID.

Note: You can compare the value of an attribute, or the value of sub-strings within an attribute.

Option	Attribute start Character is:		Attribute Length is:	Result
1	Specified	and	Specified	A sub-string of the specified length is compared.
2	Specified	and	Not specified	A sub-string consisting of one character is compared.
3	Not specified	and	Not specified	The entire string representing the attribute is compared.

More information

	Select Lowest Weight
	Select Oldest Item.
	GetTADBItemAttribute.
	TADBSetAttribute.
	RSA function blocks list.