FindRegExList_InZone

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

Syntax

bool FindRegExList_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

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

Level

Field level only.

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 entries in the keyword file are expected to be regular expressions.

To perform the action, the search first looks for the first word or phrase in the keyword file. If the word or phrase is found in the current field zone, the search stops. If no match is found, the next line from the keyword file is read and again the current field zone is searched. This process continues until a match is found or all of the lines in the keyword file have been read. 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. Word matching is case sensitive.

Example
FindRegExList_InZone("InvoiceNum")  

This action searches the current page, from the first word of the current field, for the first keyword in the Keyword file (InvoiceNum.key). If successful, the search stops and remembers the location of that word for subsequent actions; if not, the action continues searching for the next word in InvoiceNum.key, starting from first word of the current field, repeating this search pattern until a match is found, or until there are no more keywords.