Open topic with navigation
Searches for a text string in all subsequent requests.
int web_global_verification( <List of Attributes>, LAST );
List of Attributes
Text: The text string to search for. This attribute must be a non–empty, null–terminated character string. Use the format
The following two attributes are used only when Text is not specified.
TextPfx: The prefix of the text string for which you are searching. Use the format
TextSfx: The suffix of the text string for which you are searching. Use the format
Search: >Where to search for the text. The available values are Headers, Body, NORESOURCE, or All. The default is NORESOURCE. This attribute is optional. Use the format
Fail: The handling option when the string is not found The available values are Found (default) and NotFound. Found indicates that a failure occurs when the text is found (e.g., "Error"). NotFound indicates that a failure occurs when the text is not found. Use the format
ID: A identifying string used to denote this particular call to web_global_verification. For example, it is used in the log file and in calls to web_global_verification_pause.
A marker that indicates the end of the attribute list.
This function returns LR_PASS (0) on success, and LR_FAIL (1) on failure.
The following arguments can be parameterized using standard parameterization: Text, TextPfx, and TextSfx
The web_global_verification function registers a request to search for the specified text string in Web pages return by all subsequent action functions. The script fails if the Fail condition occurs in any subsequent action function. This is in contrast to the web_reg_find function which only registers a request for the next Action function.
To suspend the check, use web_global_verification_pause. If more than one check is in force due to multiple calls to web_global_verification, call web_global_verification_pause for each check you want to suspend.
The web_global_verification function is useful in detecting application level errors that are not represented by HTTP status codes. To locate errors that are represented by HTTP status codes, use web_get_int_property.
You can search the body, headers, html code, or the entire contents of a page. The Search options are:
all: the entire HTML page
headers: only the its headers, not the body
body: the body, excluding all headers, but including all resources
NORESOURCE: only the html body, excluding all headers and resources (default)
If you do not know the exact text to search for, or if the text is not consistent, you can qualify it by its beginning and end, using the TextPfx and TextSfx attributes. The prefix and suffix are actually the boundaries of the text—TextSfx is the right boundary and TextPfx is the left boundary. When using these attributes, you must specify a non–empty value for both attributes, and the Text attributes must not be specified.
When "Fail = Found" is specified (or no Fail condition is specified) with TextPfx and TextSfx and the left and right boundaries are found more than once, each match is issued as an error up to the maximum number of errors configured in the Run-Time Settings > Preferences > Advanced Options. Subsequent matches are logged as informational messages.