FindNextKeyList_InZone

Same as the FindNextKeyList action, except that it searches the current field only.

Syntax

bool FindNextKeyList_InZone (StrParam)

Parameters

The name of the Keyword text file. The file will contain a list of words or phrases, separated by new lines, that will be used for matching.
The file name can be provided in one of two ways:
  1. A full path name of the file, including the .key extension.
  2. The file name only, with no extension specified. The application will look in the process directory and the file must have a .key extension.
Smart parameters are supported.

Returns

False if the Fingerprint file (.cco) of the current source page has not been loaded, or is empty. Otherwise, True.

Level

Field level.

Details

Opens the Keyword file you specify as a parameter, then checks the words or phrases in the current field against the keywords in the list to find a match. The search starts from the last word that had been found using an action such as FindKeyList_InZone or FindNextKeyList_InZone. The location of the found word or phrase that matches an entry in the keyword file will be remembered so the result can be used by subsequent actions. Matching is case sensitive.

To improve matching, this action automatically adjusts the search criteria to allow for common character substitutions. For example, if the list includes "will" and the recognition read "wi11", a match will still occur.

Common substitutions include characters: B8, Z2, S5, oO0 and iItl1.

Example
FindKeyList_InZone("Inventory")
FindNextKeyList_InZone("Parts")       

This action searches the current field, starting from the first word of the zone, for the first occurrence of a word or phrase in the Keyword file "Inventory.key". If a match is found, the application will then look for a word from within the Keyword file "Parts.key", starting from the previously found word from the FindKeyList_InZone action and using the first word or phrase in the "Parts.key" file. If successful, the search stops and remembers the location of the new word for subsequent actions; if not, the action continues searching using the next word in "Parts.key", starting again from the location of previously found word in the zone, repeating this search pattern until a match is found, or until there are no more keywords in the file.