RHTTP_SOAP_REQUEST Function

Sends an HTTP request. Returns an error string (empty if no error).

Syntax

RHTTP_SOAP_REQUEST(request, path, action, soap-env)

Syntax Elements

request	Either an initialised HTTP request (see RHTTP_INIT_REQUEST) or an empty string.
path	Path to data on a server (e.g. /index.html).
action	SOAP action, if any (e.g. PostcodeLookup).
soap-env	Valid SOAP envelope (either AM or NL delimited).

If path is a full URL (that is, starting with http:// and including the host and, optionally, the port) then request can be an empty string ; in this case the request is initialised from the URL. Similarly, if request is an initialised HTTP request, the host (and port) from the URL override the values in the request header.

If path is a simple directory path, request must be an initialised request.

Operation

The request has the following HTTP headers set:

Content-Type: text/xml
SOAPAction: action
Content-Length: automatically set to the correct length

Using RHTTP_SOAP_REQUEST on an active request will result in an error being returned.