Parses the server response data and verifies the specified string within the boundaries if the string starts with the given parameter. If the verification condition is not met, an error is raised. The severity of this error can be specified. The result of the verification can be retrieved by an optional out-parameter. A subsequent low-level web function will not return a value until the request has finished. A cache hit is not performed unless the WEB_FLAG_DONT_FORCE_LOAD option is set. The verification is done even if this option is set and the verified request or a certain part of a page is a cache hit.
When verifying/parsing an HTML page that consists of multiple frames (HTML documents), you can specify which frame document to verify/parse by specifying the nDocNum parameter. By default (1) the top document (for example, a frameset) is scanned. This applies to HTML pages that are retrieved through a page-level command like WebPageUrl or WebPageLink.
It is important to know that all parsing and verification functions must be specified before the Web API call for which the response data should be parsed/verified. You can specify multiple parse/verification functions before a Web API call. The order of the parse/verification functions is not relevant (Exception: WebParseDataBound and WebVerifyDataBound using the flag WEB_FLAG_SYNCHRON).
This verification feature can be enabled/disabled globally (Profile Settings / Web / Verification / Data / Data verification).
WebAPI.bdh
WebVerifyDataBound( in sLeftBoundary : string, in sRightBoundary : string, in sVerify : string, in nOptions : number optional, in nDocNum : number optional, in nSeverity : number optional := SEVERITY_ERROR, out bSuccess : boolean optional );
Parameter | Description |
---|---|
sLeftBoundary | Left boundary of the data to compare. |
sRightBoundary | Right boundary of the data to compare. |
sVerify | String to compare with the parsed data. |
nOptions |
(optional)
|
nDocNum | Specifies the document to verify (optional). Specify WEB_DOC_ALL if you want to verify all documents. If this parameter is omitted, the first document gets verified. (see the above definition of FLAG_INCLUDE_EMBEDDED) |
nSeverity |
Optional: Severity of the error that is raised if the verification fails. Can be one of the following values:
|
bSuccess | If a variable is provided, it will receive result of the verification (optional). |
dcltrans transaction TMain var bResult: boolean; begin WebVerifyDataBound("<b>Begin", "X.X</b>", "End "); WebPageUrl("http://mycompany.com/"); WebVerifyDataBound("<b>Begin","X.X</b>", "End ", 0, 0, SEVERITY_WARNING); WebVerifyDataBound("<html>","</html>", "no body", WEB_FLAG_CASE_SENSITIVE | WEB_FLAG_IGNORE_WHITE_SPACE); WebUrl("http://mycompany.com/Shop/default.htm"); WebVerifyDataBound("Name:", "\r\n", "Smith",WEB_FLAG_IGNORE_WHITE_SPACE, 2, SEVERITY_Error, bResult); WebPageUrl("http://mycompany.com/frame/framea.html"); if not bResult then Print("Verification failed"); end; end TMain;