SOAP Web Client class.
Properties of this class that begin with Http are passed through to the
%Net.HttpRequest instance used by the class.
The only supported use of this class is as the super class for a SOAP Web Client.
Parameters, properties and methods may be used by the application.
If the web client has the parameter SOAPACTIONQUOTED=1, then the web client will
quote the SOAPAction value for SOAP 1.1. The default will be SOAPACTIONQUOTED=0
in order to be compatible with earlier versions of Cache.
Default charset for remote SOAP binary server.
This parameter is by default used to dertermine if binary message needs to be UTF8 encoded.
The SOAPVERSION parameter specified the version of SOAP which is supported.
Possible values for the version are 1.1 and 1.2. The default value "" specifies
that both SOAP 1.1 and SOAP 1.2 are supported.
If HttpAccept202=0 (default) we follow the WS-I Basic Profile which calls for HTTP response
status 202 to be used only if no SOAP envelope is in the HTTP response and return an error if no envelope.
If HttpAccept202=1, HTTP status 202 will treated just the same as HTTP status 200.
The HttpResponse.StatusCode property may be checked to see if 202 was actually returned.
property HttpInitiateAuthentication as %String [ Transient ];
A client may initiate a connection to the server with an "Authorization" header containing
the initial token for the server for a chosen authentication scheme.
%Net.HttpRequest is asked to initiate the connection by setting the InitiateAuthentication property
to a string which is a single scheme name. This form will bypass the initial 401 error from
the server when the client knows that the server will accept the specified scheme.
Supported schemes are Negotiate, Kerberos, NTLM and Basic.
property HttpProxyAuthorization as %String [ Transient ];
Sets/get the 'Proxy-Authorization:' header field in the Http request.
A user agent that wishes to authenticate itself with a proxy--
usually, but not necessarily, after receiving a 407 response--may do
so by including an Proxy-Authorization header field with the request. The
Proxy-Authorization field value consists of credentials containing the
authentication information of the user agent for the realm of the
resource being requested.
property HttpProxyHTTPS as %Boolean [ Transient ];
HttpProxyHTTPS property is ignored since the use of SSL to the end point
is now determiend from the url.
If using a proxy server and this is true then it issues a request for an https page
rather than the normal http page. This allows a proxy server that support https to
support a secure connection from this %Net.Httprequest class.
property HttpProxyServer as %String [ Transient ];
If you need to make SOAP request through a proxy server you specify the
proxy server host name in this property. If this property is defined then
the http request will be directed at this machine and it will forward the
request to the machine at Location and return the response.