ESLWEB Function

Retrieve a specified "web page" from a remote Web Server.

 

HTTPGet(URL_SV,
         Debug_BV,
         StripTags_BV,
         Decode_BV)

Parameters

URL_SV

A string containing the Universal Resource Locator, including the protocol prefix.The supported protocol prefixes are: HTTP:\\ and HTTPS:\\.

 

Debug_BV

A boolean flag, which if true will result in trace information being recorded in the errorlog.

 

StripTags_BV

A boolean flag, which if true will result in the HTML tags being removed from the string returned from the Host.

 

Decode_BV

A boolean flag, which if true will result in returned string being decoded. This option is the equivalent of using the URLDecode function on the complete string, which is only reasonable if a single field is being returned.

Returns

An ESL string containing the data referenced by the URL.

Description

This function uses the "GET" verb to receive data from a Web Server Host by specifying the URL of the required data.

As an ESL string can contain binary data, so it is possible to receive more than just textual data, as demonstrated by the "WEBPIC" sample.

If this function is unable to process the request, then a NULL string is returned and an error message recorded in the errorlog. Any errors from the Web Server will appear in the returned string. To determine the web status code, call the routine GetWebStatus after this function has completed.