ESLWEB Function

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

 

HTTPPost(URL_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:\\.

 

EncodedFormData_SV

A string containing the data string to be posted to the Host Web Server, typically in the format: name1=value1[name2=value2]... Each value clause should be encoded to eliminate any reserved characters.

 

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 data to a Web Server 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.