FindNextKeyList

Same as the FindKeyList action, except that it locates the next instance.

Syntax

bool FindNextKeyList (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

True if at least one word or phrase on the page, starting from the previously located word, matches any word or pattern in the Keyword file. Otherwise, False.

Level

Field level.

Details

Opens the Keyword file you specify as a parameter, then checks the words or phrases on the current page 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 or FindNextKeyList. 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("Tax")
FindNextKeyList("IRS")

Starting from the word or phrase that was located in the FindKeyList action, this action searches the current page, starting from that previously found word, for the first word or phrase in the first line of the Keyword file (IRS.key). If successful, the search stops and remembers the location of that new word for subsequent actions; if not, the action continues searching using the next word or phrase in IRS.key, starting again from the location of the word previously found by FindKeyList(Tax), repeating this search pattern until a match is found, or until there are no more keywords in the file.