Configuring the Receiver SOAP Adapter 

Use

You need to configure the receiver SOAP adapter to send information from the Integration Server or the PCK to remote clients or Web services 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 in the module processor to specify generic modules, 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 indicator Configure Certificate Authentication. ○       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 indicator Configure Certificate Authentication. ○       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 a confirmation.

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 is to 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, select Select Security Profile.

See: Security Settings for the Receiver SOAP Adapter

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

●      Also specify the Persist Duration for the messages.

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 specifies the value for the SOAPAction in Web service messages; set the indicator.

Advanced Tab Page

Adapter-Specific Message Attributes

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

You can evaluate the following attributes in the message header:

Description	Technical name
You can set the entire URL.	TServerLocation
Authentication Keys	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 included in the HTTP request under the names specified 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 with confirmation for each key value. This means that you do not need to write passwords in the enhanced message header.

If you want to enter or display the respective authentication key, select View Authorization Keys. You can enter and confirm passwords for each authentication key (TAuthKey or TproyxAuthKey).

Adapter Status

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