Konfiguration des SOAP-Sender-Adapters 

Verwendung

Sie konfigurieren den SOAP-Sender-Adapter, um damit Inhalte von Remote Clients bzw. Inhalte von Web-Services-Servern an den Integration Server/an das PCK zu versenden.

Integration

●      Die Adapterkonfiguration ist Teil der Festlegung eines Kommunikationskanals im Integration Server oder im PCK und wird auf der Registerkarte Parameter vorgenommen. Eine Erweiterung um eigene Module auf der Registerkarte Modul im Modul-Prozessor ist bei diesem Adapter nicht möglich.

●      Die Eingangsadresse für SOAP-Messages ist: http://host:port/XISOAPAdapter/MessageServlet?channel=party:service:channel

Unter party:service:channel geben sie den Partner-, Service-Namen und den Namen des Kommunikationskanals an. Falls kein Partner angelegt wurde, machen Sie folgende Angabe: channel=:service:channel

Voraussetzungen

...

       1.      Sie haben einen Kommunikationskanal angelegt oder einen bestehenden Kommunikationskanal geöffnet.

       2.      Sie haben auf der Registerkarte Parameter den Adaptertyp SOAP ausgewählt.

       3.      Sie haben den Adapter über den Auswahlknopf Sender als Sender-Adapter definiert.

Aktivitäten

Zur Konfiguration des Adapters machen Sie die folgenden Angaben:

Transport-Protokoll

HTTP

Message-Protokoll

SOAP 1.1

Adapter-Engine

Wählen sie die Adapter-Engine auf dem Integration Server aus oder wählen Sie eine dezentral installierte Adapter-Engine aus. Im PCK ist diese Auswahl nicht möglich.

Registerkarte Allgemein

Sicherheitsprüfung beim Eingang

Wählen Sie die HTTP-Sicherheitsebene für eingehende Messages aus:

●      HTTP

●      HTTPS ohne Client-Authentifizierung

●      HTTPS mit Client-Authentifizierung

Siehe: HTTP and SSL, dort unter Enforcing HTTP Security for Incoming Messages

Sicherheitsparameter

●      Wollen Sie in der zugehörigen Sendervereinbarung im Integration Server oder im PCK zusätzliche Einstellungen zur Sicherheit vornehmen, wählen Sie Sicherheitsprofil wählen. Siehe: Sicherheitseinstellungen für SOAP-Sender-Adapter

Wenn Sie das Kennzeichen setzen, dann muss es genau eine Sendervereinbarung für den hier definierten Kommunikationskanal geben.

●      Wählen Sie unter Sicherheitsprofil aus, ob Sie Web-Services-Sicherheit oder S/MIME einstellen möchten.

●      Geben Sie dann außerdem die Aufbewahrungszeit für die Messages an.

Konvertierungsparameter

Parameter	Angaben
Keinen SOAP-Umschlag verwenden	Der Adapter erwartet eine Nachricht ohne SOAP-Umschlag, wenn das Kennzeichen gesetzt ist. Haben Sie das Kennzeichen gesetzt, dann müssen Sie in der URL zusätzlich nosoap=true mitgeben. Der Adapter stellt die gesamte Message in die XI-Payloads ein.
Header behalten	Wenn der Header der Web-Services-Message in die XI-Message übernommen werden soll, dann setzen Sie das Kennzeichen.
Anlagen behalten	Wenn Anlagen (Attachments) der Web-Services-Message in die XI-Message übernommen werden sollen, dann setzen Sie das Kennzeichen.
Kodierte Header verwenden	Wenn die XI-Header-Informationen in den kodierten String übernommen werden sollen, dann setzen Sie das Kennzeichen.
Query-String verwenden	Wenn die XI-Header-Informationen in einen Query-String übernommen werden sollen, dann setzen Sie das Kennzeichen.

Vorgabe XI-Parameter

Setzen Sie für folgende Parameter die Vorgabewerte:

●      Interface-Namensraum

●      Interface-Name

Verarbeitungsparameter

Geben Sie unter Quality-of-Service an, wie die Message durch die Integration Engine/durch das PCK verarbeitet werden soll:

●      Best Effort (synchrone Verarbeitung)

●      Exactly Once (asynchrone Verarbeitung)

Eine garantierte einmaliger Ausführung findet statt, wenn der Client einen GUID mitschickt. Siehe: Bereitstellung von Exactly Once

●      Exactly Once In Order (asynchrone Verarbeitung über Queues)

Eine garantierte einmalige Ausführung unter Beibehaltung der Reihenfolge aufeinander folgender Messages findet statt, wenn der Client einen GUID mitschickt.

Geben Sie den Queue-Namen an.

Registerkarte Erweitert

Adapterspezifische Message-Attribute

Um Adapterattribute im Message-Header der XI-Message abzulegen, setzen Sie das Kennzeichen Adapterspezifische Message-Attribute setzen.

Folgende Attribute werden, falls der Sender sie zur Verfügung stellen kann, in den XI-Message-Header übernommen, wenn Sie das Kennzeichen Variable Transportanbindung setzen:

Name	Technischer Name
Remote-Benutzer	SRemoteUser
Remote-Host	SRemoteHost

Um weitere Header-Felder zu übernehmen, setzen sie das jeweilige Kennzeichen. Sie können dann folgende Attribute und deren Werte in den XI-Message-Header ablegen:

Name	Technischer Name
Variabler Header	XHeaderName1
Variabler Header	XHeaderName2
Variabler Header	XHeaderName3

Die Bezeichnung der Felder und Parameter muss der Bezeichnung der Felder und Parameter, die zusätzlich durch den HTTP-Request eingehen, entsprechen.

Der Attributnamensraum für den Adapter ist: http://sap.com/xi/XI/System/SOAP.

Adapterstatus

Setzen Sie den Adapter Aktiv, um ihn für den Message-Austausch einzusetzen.