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 Integration Server oder im PCK und wird auf der Registerkarte Parameter vorgenommen. Zusätzlich zur Adapterkonfiguration können auf der Registerkarte Modul 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.
Registerkarte Allgemein
Verbindungsparameter
Die Verbindungsparameter werden in Abhängigkeit vom Transportprotokoll definiert:
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 Benutzer-Authentifizierung konfigurieren 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 Zertifikatsauthentifizierung ansehen. ○ 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 Benutzer-Authentifizierung konfigurieren 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 Zertifikatsauthentifizierung ansehen. ○ 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 Transport-Protokoll SMTP/S
Für das Transport-Protokoll SMTP/Skö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 unter Cc an, an welche Adressen die E-Mail ebenfalls gesendet werden soll. Die hier angegebenen Adressen sind für den Empfänger sichtbar.
● Geben Sie unter Bcc an, an welche Adressen die E-Mail ebenfalls gesendet werden soll. Die hier angegebenen Adressen sind für den Empfänger nicht sichtbar.
● Geben Sie den Betreff der E-Mail-Nachricht an.
Sicherheitsparameter
Wollen Sie in der zugehörigen Empfängervereinbarung im Integration Server oder im PCK zusätzliche Einstellungen zur Sicherheit vornehmen,wählen Sie Sicherheitsprofil wählen.
Siehe: Sicherheitseinstellungen für SOAP-Empfänger-Adapter
● Wählen Sie das Sicherheitsprofil Web-Services-Sicherheit oder S/MIME aus.
● Geben Sie dann außerdem die Aufbewahrungszeit für die Messages an.
Konvertierungsparameter
Parameter |
Angaben |
Keinen SOAP-Umschlag verwenden |
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. |
Registerkarte Erweitert
Adapterspezifische Message-Attribute
Um Adapterattribute im Message-Header der XI-Message zu verarbeiten, setzen Sie das Kennzeichen Adapterspezifische Message-Attribute verwenden und außerdem das Kennzeichen Variable Transportanbindung:
Folgende Attribute im Message-Header können dann ausgewertet werden:
Beschreibung |
Technischer Name |
Server-URL (Hier kann die komplette URL gesetzt werden.) |
TServerLocation |
Authentifizierungsschlüssel |
TAuthKey |
Proxy-URL |
TProxyLocation |
Proxy-Authentifizierungsschlüssel |
TProxyAuthKey |
SOAP-Aktion |
THeaderSOAPACTION |
Wollen Sie Header-Felder übernehmen, setzen Sie das jeweilige Kennzeichen für Variabler Header. Die technischen Namen der Felder sind XHeaderName1, XHeaderName2, XHeaderName3. Unter diesen hier eingegebenen Bezeichnungen werden die Parameter in den HTTP Request übernommen.
Der Attributnamensraum für den Adapter ist: http://sap.com/xi/XI/System/SOAP.
Authentifizierungsschlüssel
Wird für das Empfängersystem eine Authentifizierung verlangt, können Sie hier für den jeweiligen Schlüsselwert ein Kennwort mit Bestätigung hinterlegen. Auf diese Weise ist es nicht nötig, Kennwörter in den erweiterten Message-Header zu schreiben.
Wenn Sie Authentifizierungsschlüssel eingeben oder anzeigen möchten, wählen Sie Berechtigungsschlüssel anzeigen. Sie können zum Wert des Authentifizierungsschlüssels (TAuthKey oder TProyxAuthKey) ein Kennwort mit Bestätigung eingeben.
Adapterstatus
Setzen Sie den Adapter Aktiv, um ihn für den Message-Austausch einzusetzen.