Procedure documentationConfiguring the Communication Channel with Adapter Type WS Locate this document in the navigation structure

 

Using a communication channel that you have implemented the adapter type WSfor, you can configure communication between Web service consumer and Web service provider (for direct communication), or conmmunication between Integration Server and a connected Web service consumer or Web service provider (for Integration Server communication).

For more information, see:

Communication Channel (Adapter Type WS)

Take note that in order for scenarios in which Web service consumers and Web service providers communicate with each other to be configured completely that it will be necessary for further settings to be made in the relevant backend systems and that further configuration tools will have to be used. In addition to this, the specific procedure depends on the application case and the required security settings. A detailed description of these procedures and the tools for configuring scenarios for the most important application cases is given in a separate guide in SAP Developer Network (SDN). You can find this guide in the SAP Community Network (SDN) under https://www.sdn.sap.com/irj/sdn/soa-management > SOA Management > Service Configuration and Monitoring > SAP NetWeaver Process Integration 7.1 - Configuring Web Service Scenarios (Guide).

Using Previous Adapter Type Versions

For compatibility reasons the version of the adapter type WS is offered which was previously available in earlier support packages of SAP NetWeaver PI 7.1. Use the older version (SAP BASIS 7.10) in cases where you have performed configuration work on the basis of such an earlier support package and you now want to proceed with this work on the basis of the current support package.

For specific cases, SAP recommends using the previous version.

Example Example

Using previous adapter type versions is offered, for example, when you have already executed configuration work on the basis of an installation of SAP NetWeaver PI 7.1 and would like to continue with this work after upgrading to SAP Enhancement Package 1 of SAP NetWeaver PI 7.1.

End of the example.

It is generally recommended that you always select the adapter type version that corresponds to the oldest release of all the backend systems that are connected. When configuring direct communication between the Web service provider and Web service consumer you must determine the lowest backend release between the provider and consumer. When configuring Integratin Server communication you must determine the lowest backend release between the Integration Server, provider, and the consumer.

Example Example

Communication between an SAP system based on AS APAB 7.11 and an Integration Server based on SAP Enhancement Package 1 of SAP NetWeaver PI 7.1: Use the current adapter type version (SAP BASIS 7.11).

End of the example.

If addition you must use the older adapter type version if you want to configure direct communication between an ABAP-based and a Java-based backend system (irrespective of the release of the Java backend system).

By default you can only select the current adapter type version in the communication channel editor. To be able to select the older adapter type version, you must first import the relevant adapter metadata into the ES Repository.

For more information, see: Configuring Adapter Type WS Communication Channels (Old Version)

Procedure

You perform the following steps to specify the attributes of the communication channel.

1. Creating a Communication Channel, Specifying a Direction and Adapter Type

First create the communication channel, specify whether it is to be a sender or receiver channel and choose the adapter type WS (current version).

  1. Call the create dialog box for communication channels and specify the necessary key values (party and communication components).

    For more information, see: Defining Communication Channels

  2. Select the adapter type in the communication channel editor.

    Select the input help for Adapter Type.

    For the current version of the adapter type WS, select the entry with the following values:

    • Name: WS

    • Namespace: http://sap.com/xi/XI/System

    • Software component version: SAP BASIS 7.11

      Caution Caution

      Using the software component version you specify whether you want to use the current or older version of the adapter type WS.

      You specify the older version, which is still offered for compatibility reasons, by selecting the software component version SAP BASIS 7.10.

      End of the caution.

  3. Choose Copy.

    These are the default attributes:

    • Transport Protocol: HTTP 1.0

    • Message Protocol: WS 1.0

    • Adapter Engine: Integration Server

2. Define Type of Web Service Call

The type of Web service call specifies whether the call is made locally (same logical system), or remotely (different logical system). Depending on your choice, select or deselect the checkbox Local Call.

You can only configure this setting for a receiver channel.

The call type you select determines which other attributes you can define.

3. Specify Metadata Access (Receiver Channels Only)

With the following settings you specify how the Web service consumer accesses the metadata of the Web service provider that is configured by the receiver channel.

Note Note

The attributes for metadata access are only displayed for receiver channels and non-local calls.

End of the note.

For more information, see: Configuring Metadata Access (Receiver Channels Only)

4. Specify Communication Security and Authentication Methods

With these settings you specify the fundamental communication security and with it a compatible authentication method. The authentication method determines how the Web service consumer authenticates themself with the Web service provider.

For more information, see: Configuring Communication Security and Authentication Methods

5. Specify the Source of the Response Encryption Certificate

When using asymmetrical message signature and encryption, you can define the source of the certificate further which is used to encrypt the response message.

This option only exists for cases where the receiver of the message (that sends the response message) is an SAP system .

For more information, see: Determining the Source of the Response Encryption Certificate

6. Determine Technical Transport Settings

With these settings your determine the technical details for the connection.

For more information, see: Configuring Technical Transport Settings