Configuring the Receiver SOAP Adapter 

Use

You configure the receiver SOAP adapter to send information from the Integration Server/PCK to remote clients or Web service servers.

Integration

You configure the adapter on the Parameters tab page during the definition of a communication channel in the Integration Server or in the PCK. In addition to the adapter configuration, you can use the Module tab page to specify generic modules in the module processor, which give the adapter additional functions.

Prerequisites

...

       1.      You have created a new communication channel or have opened an existing one.

       2.      On the Parameters tab page you have selected the adapter type SOAP.

       3.      You have selected the Receiver radio button to define the adapter as a receiver adapter.

Activities

To configure the adapter, specify the following:

Transport Protocol

●      HTTP (including HTTPS)

●      SMTP (including SMTPS)

The adapter uses this transport protocol to send SOAP messages as e-mails.

Message Protocol

SOAP 1.1

Adapter Engine

Select the Adapter Engine on the Integration Server, or select a non-centrally installed Adapter Engine. This selection is not available in the PCK.

General Tab Page

Connection Parameters

You define the connection parameters depending on the transport protocol:

HTTP/HTTPS	SMTP/SMTPS
●      Under Target URL, enter the complete address (URL) of the Web service provider that you want to send the message to. ●      If the server requires a user authentication, set the Configure User Authentication indicator and specify the following: ○       Specify the User. ○       Enter the Password and confirm. ●      If the server requests a certificate from the client, set the Configure Certificate Authentication indicator. ○       Specify the Keystore Entry. ○       Specify the Keystore View.	●      Under Target URL, enter the complete address (URL) of the Web service provider that you want to send the message to. ●      If the server requires a user authentication, set the Configure User Authentication indicator and specify the following: ○       Select the PLAIN or CRAM-MD5 authentication method. ○       Specify the User. ○       Enter the Password and confirm. ●      If the server requests a certificate from the client, set the Configure Certificate Authentication indicator. ○       Specify the Keystore Entry. ○       Specify the Keystore View.
●      If the Web service provider can only be reached by using an HTTP proxy server and not directly, set the Configure Proxy indicator and enter the following: ○       Host ○       Port (used for receiving proxy HTTP requests) ○       If the proxy requires a user authentication, set the Configure Proxy User Authentication indicator and enter the User and Password, and confirm.

Mail Attributes for Transport Protocol SMTP/S

If you have selected SMTP/S as the transport protocol, you can specify mail attributes:

●      Under From, specify the e-mail address from which the message is sent.

●      Under To, specify the e-mail address that will receive the message.

If you enter more than one address, you must separate them with a semicolon.

●      Under Cc, specify the other addresses to which the e-mail is to be sent. The addresses you specify here are visible to the receiver.

●      Under Bcc, specify the other addresses to which the e-mail is to be sent. The addresses you specify here are not visible to the receiver.

●      Enter the Subject of the e-mail message.

Security Parameters

●      If you want to make additional settings for security in the relevant receiver agreement on the Integration Server or in the PCK, set the Select Security Profile indicator.

See: Security Settings for the Receiver SOAP Adapter

●      Select the security profile Web Services Security or S/MIME.

●      Specify the Persist Duration for messages in days, hours, minutes, and seconds.

Conversion Parameters

Parameter	Details
Do Not Use SOAP Envelope	If the payload of the message is to be sent without a SOAP envelope, set the indicator.
Keep Headers	If the header of the XI message is to be included in the Web service message, set the indicator.
Keep Attachments	If attachments of the XI message are to be included in the Web service message, set the indicator.
Use Encoded Headers	If the headers of the XI message are to be encoded, set the indicator.
Use Query String	If a query string is to be specified, set the indicator.
SOAP Action	Specify the SOAP action. The action species the value for the SOAPAction in Web service messages.

Advanced Tab Page

Adapter-Specific Message Attributes

To process adapter attributes in the message header of the XI message, select Use Adapter-Specific Message Attributes and Variable Transport Binding.

You can evaluate the following attributes in the message header:

Description	Technical Name
Server URL (you can set the complete URL here)	TServerLocation
Authentication Key	TAuthKey
Proxy URL	TProxyLocation
Proxy Authentication Key	TProxyAuthKey
SOAP Action	THeaderSOAPACTION

If you want to transfer header fields, set the relevant indicator for Variable Header. The technical names for the fields are XHeaderName1, XHeaderName2, XHeaderName3. The parameters are embedded in the HTTP request under the names you enter here.

The attribute namespace for the adapter is http://sap.com/xi/XI/System/SOAP.

Authentication Keys

If authentication is required for the receiver system, you can enter a password and a confirmation for each key value. This means that you do not need to write passwords in the enhanced message header.

If you want to specify or display authentication keys, select View Authorization Keys.

You can enter and confirm passwords for each authentication key value (TAuthKey or TproyxAuthKey).

Adapter Status

Set the adapter to Active to enable messages to be exchanged.