FindNextRegExList_InZone

Syntax

bool FindNextRegExList_InZone (StrParam)

Parameters

The name of the Keyword text file. The file contains 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 looks in the process directory and the file must have a .key extension.

Smart parameters are supported.

Returns

True if at least one word in the field, that follows the result of a previous find, 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, starting from the location of a previous find, this action checks the words or phrases in the current field 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. Starting from the location of the last find, if the word is found, the search stops. If no match is found, the next line from the keyword file is read and again the search starts from the result of a previous find.

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 is remembered so the result can be used by subsequent actions. Word matching is case sensitive.

Example

FindRegExList_InZone("InvoiceNum")
FindNextRegExList_InZone("InvoiceNum")  

This action searches the current page, starting from the result of the FindRegExList_InZone action, 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, repeating this search pattern until a match is found, or until there are no more keywords. Although this example shows FindNextRegExList_InZone using the same keyword file, it is allowed to use a different keyword file.