ESLWEB Function

Send form data with a tailored header to a Common Gateway Interface (i.e.CGI) on a remote Web Server and retrieve the resultant "web-page".

 

HTTPPostWithHdr(URL_SV,
                   Header_SV,
                   EncodedFormData_SV,
                   Debug_BV,
                   StripTags_BV,
                   Decode_BV)

Parameters

URL_SV

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

 

Header_SV

A string containing the HTML header required by the receiving CGI.

 

EncodedFormData_SV

A string containing the data string to be posted to the Host Web Server. When this function is used with a web service, this string will typically contain a Simple Object Application Protocol structure.

 

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 returned by the specified CGI having processed the form data.

Description

This function uses the "POST" verb to send custom HTML header and body data to a Web Server Host by specifying the URL of the CGI designed to process it. Once the data has been processed the resultant string is retrieved.

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.