Eliminate Source By Pattern

About this task

The function block compares the first Attribute Value element with the value for that attribute from the current item.If no matching Attribute Value is found:

Procedure

  1. The function block continues to look for a match by examining other items.
  2. If still no match is found the:
    • Pattern History Point value is automatically incremented.
    • Function block attempts to find a match for the next attribute name/value pair until a match is found.
  3. This process continues until either of the following occurs.
    • A matching value is found.
    • All items and attribute name/value pairs have been compared without a match.
  4. The  current item fails the comparison and is either weighted or eliminated. The failure is saved as history data.
  5. The next item is compared to the same attribute name/value pair.
  6. This process continues until a matching value is found or all items have been weighted or eliminated.
    When a matching Attribute Value is found:
  7. The function block compares the same Attribute Value element with the value of the corresponding attribute for the next item.
  8. At the conclusion of the pass, the function block stores an index value that corresponds to the position of the next element after the array element for which a match was found.
    This value is stored to the Pattern History Point.Note: After reaching the last element in the array, the Pattern History Point is reinitialized; the end of the pattern wraps back to the beginning comparison with any subsequent items.Notes
    • An Attribute Name element containing the reserved name ANY is a wildcard. The current item will always be selected as a match for this index into the pattern. This reserved name does not require a value; i.e. you can enter any value or no value for the respective Attribute Value element.
    • To compare items that satisfy a named solve (query) or query expression, enter the reserved name SOLVE for this element in the Attribute Name array. (This is  instead of the name of an attribute). You can then enter a named query or query expression as the respective element in the Attribute Value array.