Konfiguration des SOAP-Empfänger-Adapters (SAP-Bibliothek

Konfiguration des SOAP-Empfänger-Adapters

Verwendung

Sie konfigurieren den SOAP-Empfänger-Adapter, um damit Informationen vom Integration Server/PCK an Remote Clients oder Web-Services-Server zu versenden.

Integration

Die Adapterkonfiguration ist Teil der Festlegung eines Kommunikationskanals im Strukturlink Integration Server oder im PCK und wird auf der Registerkarte Parameter vorgenommen. Zusätzlich zur Adapterkonfiguration können auf der Registerkarte Module im Modul-Prozessor generische Module angegeben werden, die den Adapter mit Zusatzfunktionen ausstatten.

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 Empfänger als Empfänger-Adapter definiert.

Aktivitäten

Zur Konfiguration des Adapters machen Sie die folgenden Angaben:

Transport-Protokoll

· HTTP (einschließlich HTTPS)

· SMTP (einschließlich SMTPS)

Über dieses Transport-Protokoll verschickt der Adapter SOAP-Messages als E-Mails.

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. Diese Auswahl ist im PCK nicht möglich.

Verbindungsparameter

Die Verbindungsparameter werden in Abhängigkeit vom Transportprotokoll definiert:

Verbindungsparameter

HTTP/HTTPS

SMTP/SMTPS

· Geben Sie unter Ziel-URL die vollständige Adresse (URL) des Web-Service-Provider ein, an den die Message geschickt werden soll.

· Falls der Server eine Benutzer-Authentifizierung benötigt, setzen Sie das Kennzeichen Konfiguriere Benutzer-Authentifizierung und machen Sie folgende Angaben:

¡ Geben Sie den Benutzer an.

¡ Geben Sie das Kennwort mit Bestätigung an.

· Falls der Server ein Zertifikat vom Client anfordert, dann setzen Sie das Kennzeichen Konfiguriere Zertifikatsauthentifizierung

¡ Geben Sie den Schlüsselspeichereintrag an.

¡ Geben Sie die Schlüsselspeicheransicht an.

· Geben Sie unter Ziel-URL die vollständige Adresse (URL) des Web-Service-Provider ein, an den die Message geschickt werden soll.

· Falls der Server eine Benutzer-Authentifizierung benötigt, setzen Sie das Kennzeichen Konfiguriere Benutzer-Authentifizierung und machen Sie folgende Angaben:

¡ Wählen Sie die Authentifizierungsmethode PLAIN oder CRAM-MD5.

¡ Geben Sie den Benutzer an.

¡ Geben Sie das Kennwort mit Bestätigung an.

· Falls der Server ein Zertifikat vom Client anfordert, dann setzen Sie das Kennzeichen Konfiguriere Zertifikatsauthentifizierung

¡ Geben Sie den Schlüsselspeichereintrag an.

¡ Geben Sie die Schlüsselspeicheransicht an.

· Ist der Web-Service-Provider nicht direkt, sondern über einen HTTP-Proxy-Server zu erreichen, dann setzen Sie das Kennzeichen Proxy konfigurieren und machen Sie folgende Angaben:

¡ Host

¡ Port, unter dem der Proxy HTTP-Requests annimmt.

¡ Falls das Proxy eine Benutzer-Authentifizierung benötigt, dann setzen Sie das Kennzeichen Proxy-Benutzer Authentifizierung konfigurieren und geben Sie den Benutzer und das Kennwort mit Bestätigung an.

Mail-Attribute

Für das Transport-Protokoll SMTP/S können Sie Mail-Attribute angeben:

· Geben Sie unter Von die E-Mail-Adresse an, von der die Nachricht kommt.

· Geben Sie unter An die E-Mail-Adresse an, die die Nachricht erhalten soll.

Wenn Sie mehrere Adressen angeben, dann müssen diese durch ein Semikolon getrennt angegeben werden.

· Geben Sie den Betreff der E-Mail-Nachricht an.

Sicherheitseinstellungen

· Wenn Sie in der zugehörigen Empfängervereinbarung im Strukturlink Integration Server oder im PCK zusätzliche Einstellungen zur Web-Services-Sicherheit vornehmen möchten, dann setzen Sie das Kennzeichen.

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

Konvertierungsparameter

Parameter	Angaben
Ohne SOAP-Umschlag	Wenn die Payload der Message ohne SOAP-Umschlag verschickt werden soll, setzen Sie das Kennzeichen.
Header behalten	Wenn der Header der XI-Message in die Web-Services-Message übernommen werden soll, setzen Sie das Kennzeichen.
Anlagen behalten	Wenn Anlagen (Attachments) der XI-Message in die Web-Services-Message übernommen werden sollen, setzen Sie das Kennzeichen.
Kodierte Header verwenden	Wenn die Header der XI-Message kodiert werden sollen, setzen Sie das Kennzeichen.
Query-String verwenden	Wenn ein Query-String angegeben werden soll, setzen Sie das Kennzeichen.
SOAP-Aktion	Geben Sie die SOAP-Aktion an. Die Aktion gibt den Wert für die SOAPAction in Web-Service-Messages an, setzen Sie das Kennzeichen.

Adapterstatus

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