Creating SOAP Services and Web Clients with Ensemble
Settings for the SOAP Outbound Adapter
[Back] 
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Provides reference information for settings of the SOAP outbound adapter, EnsLib.SOAP.OutboundAdapter.
Summary
The outbound SOAP adapter has the following settings:
Group Settings
Basic Settings Web Service URL, Web Service Client Class, SOAP Credentials, Credentials
Connection Settings SSL Configuration, SSL Check Server Identity
Proxy Settings Proxy Server, Proxy Port, Proxy HTTPS, ProxyHttpTunnel, ProxyHttpSSLConnect
Additional Settings ResponseTimeout, HttpVersion, ConnectTimeout
The remaining settings are common to all business operations. For information, see Settings for All Business Operations in Configuring Ensemble Productions.
ConnectTimeout
Specifies the number of seconds to wait for the connection to the server to open. The default value is 5.
If the connection is not opened in this time period, the adapter retries repeatedly, up to the number of times given by Failure Timeout divided by Retry Interval.
Credentials
Specify the ID of the Ensemble credentials that contain the username and password to be used in the HTTP header. For information on creating Ensemble credentials, see Configuring Ensemble Productions.
HttpVersion
Specifies the HTTP version that the adapter should report in the HTTP request it sends to the server.
ProxyHTTPS
Specifies whether the proxy (if any) uses HTTPS to communicate with the real HTTP/HTTPS server.
ProxyHttpTunnel
Specifies whether the adapter use the HTTP CONNECT command to establish a tunnel through the proxy to the target HTTP server.
ProxyPort
Specifies the proxy server port on which to send HTTP requests, if using a proxy server. The default value is 80.
ProxyServer
Specifies the proxy server through which to send HTTP requests, if any.
ProxyHttpSSLConnect
Specifies whether the adapter should use a proxy SSL connection to the proxy. Note that the use of SSL to the eventual endpoint is determined by the protocol part of web service's location URL.
ResponseTimeout
Specifies the timeout for getting a response from the remote web server (the timeout for opening the connection to the server is set by ConnectTimeout). The default value is 30.
SOAPCredentials
Specify the ID of the Ensemble credentials that contain the username and password to be used in the WS-Security header of the SOAP request. For more information on WS-Security support, see Securing Caché Web Services in the Caché documentation set.
SSLCheckServerIdentity
Specifies that when making an SSL connection, the adapter should check that the server identity in the certificate matches the name of the system being connecting to. This defaults to specifying that the check should be made. Uncheck this for test and development systems where the name specified in the SSL certificate does not match the DNS name.
SSLConfig
The name of an existing SSL/TLS configuration to use to authenticate this connection. Choose a client SSL/TLS configuration, because the web client initiates the communication.
To create and manage SSL/TLS configurations, use the Management Portal. See the chapter Using SSL/TLS with Caché in the Caché Security Administration Guide. The first field on the Edit SSL/TLS Configuration form is Configuration Name. Use this string as the value for the SSLConfig setting.
If your SSL configuration requires a private key password, include that in the SSL Config setting. To do so, add a vertical bar character | after the configuration name, followed by the password. For example: MySSLItem|mypassword.
Note:
You must also ensure the web service is at a URL that uses https://. The web service location is determined by the WebServiceURL setting; if this is not specified, the Ensemble web client assumes the web service is at the URL specified by the LOCATION parameter in proxy client class.
WebServiceClientClass
Specifies the full name (including package) of the proxy client class, specifically the class that actually sends and receives SOAP messages to the web service.
WebServiceURL
Specifies the URL where the web service is located. If this setting is not given, the adapter uses the default location (the LOCATION parameter) declared in the proxy client class; see the WebServiceClientClass setting. Note that SSL will only work if this URL uses https://