Konfiguration des
Plain-HTTP-Empfänger-Adapters
Verwendung
Der Plain-HTTP-Ausgang ist ein Service der Integration Engine. Er wird angesprochen, wenn das technische Routing für den logischen Empfänger aus dem logischen Routing einen entsprechenden Kommunikationskanal ermittelt. Die Payload der Message wird per HTTP an eine HTTP-Adresse gesendet, ohne dass sie um einen Umschlag angereichert wird.
Integration
Die Adapterkonfiguration ist Teil der Festlegung eines Kommunikationskanals im Integration Server und wird auf der Registerkarte Parameter vorgenommen.
Aktivitäten
Der Plain-HTTP-Adapter gibt dem Empfängersystem folgende Angaben mit:
Transport-Protokoll
HTTP 1.0
Message-Protokoll
XI-Payload im HTTP-Body
Adapter-Engine
Integration Server
Adressierungsart
URL-Adresse |
HTTP-Destination |
Geben Sie die Zielmaschine, Servicenummer, und Pfadpräfix inklusive Query-String an: http://<hostname:port>/<path>?<query-string> Die Zielmaschine (HTTP-Port) eines SAP
Web Application Server kann über den
Host und Port des HTTP-Proxy (optional, falls sich zwischen Plain-HTTP-Adapter und Empfängersystem eine Firewall befindet) Authentifizierungsdaten für das Empfängersystem, siehe auch: Transaktion Anzeige und Pflege von RFC-Destinationen (SM59) |
Geben Sie die HTTP-Destination an |
ICM MonitorParameter aus dem Kommunikationskanal für das technische Routing
● Content Type (standardmäßig wird hier der Eintrag text/XML erwartet)
Gibt an, welches Format der Inhalt (die Payload) der Message haben soll.
● (Optionale) Header-Felder für das empfängerspezifische Protokoll
● Wählen Sie Zusätzliche Query-String-Attribute:
○ Sender-Partner
○ Sender-Service
○ Empfänger-Interface
○ Message-ID
○ Quality-of-Service
○ Queue-ID
Die Queue-ID ist nur für Quality-of-Service EOIO erforderlich.
● Angaben zur Manipulation der Payload
○ XML-Codierung (Voreinstellung UTF-8)
Gibt den Zeichensatz des Inhalts an.
○ URL-Escaping
Dient einer URL-fähigen Präsentation des XML.
Sonderzeichen, die als Steuerzeichen interpretiert werden könnten, werden mit Escape-Zeichen versehen (maskiert).
○ Vorspann (Prolog)
Dient dem Anreichern der Payload für bestimmte Server (optional; siehe unten).
○ Nachspann (Epilog)
Dient dem Anreichern der Payload für bestimmte Server (optional; siehe unten).
Adapterspezifische Message-Attribute
● Um Adapterattribute im Message-Header der XI-Message auszuwerten, wählen Sie Adapterspezifische Message-Attribute verwenden.
● Soll das Fehlen von Message-Attributen zu einer Fehlermeldung führen, wählen Sie Fehlerausgabe beim Fehlen adapterspezifischer Message-Attribute.
Ist das Kennzeichen gesetzt und in der Message fehlt der Header für adapterspezifische Message-Attribute oder eines der gesetzten Attribute, führt dies zu einem Systemfehler (rote Flagge).
Setzen Sie das Kennzeichen nicht, und es fehlen Message-Attribute, dann greift der Adapter auf Informationen aus der Adapterkonfiguration zu.
● Wollen Sie eine durch das Mapping gesetzte HTTP-Destination oder URL verwenden, wählen Sie URL oder HTTP-Destination.
(Je nachdem welche Adressierungsart Sie weiter oben gewählt haben, erscheint das entsprechende Kennzeichen.) Ist das Kennzeichen gesetzt, wird die dynamisch gesetzte URL oder die HTTP-Destination per HTTP gerufen.
Ist die URL oder die HTTP-Destination nicht im Message-Header vorhanden, wird bei gesetztem Kennzeichen Fehlerausgabe beim Fehlen adapterspezifischer Message-Attribute die XI-Message in den Status Systemfehler gesetzt.
Bei nicht gesetztem Kennzeichen wird die statisch im Kommunikationskanal festgelegte URL oder HTTP-Destination verwendet.
Die technischen Namen der Felder sind:
○ URL: TargetURL
○ HTTP-Destination: HTTPDest
● Wollen Sie HTTP-Header-Felder übernehmen, wählen Sie HTTP-Header-Felder übernehmen und geben Sie in Feld 1 bis Feld 6 die Felder an.
Unter diesen hier eingegebenen Bezeichnungen werden die Felder in den HTTP-Request eingebettet.
Die technischen Namen der Felder sind HeaderFieldOne, .... HeaderFieldSix.
● Wollen Sie URL-Parameter übernehmen, wählen Sie URL-Parameter übernehmen und geben Sie unter Parameter 1 bis Parameter 6 die Parameter an.
Unter diesen hier eingegebenen Bezeichnungen werden die Parameter in den HTTP Request übernommen.
Die technischen Namen der Felder sind URLParamOne, …, URLParamSix.
● Wollen Sie HTTP-Header-Felder aus der synchronen Response im XI-Message-Header ablegen, wählen Sie HTTP-Header-Felder (synchrone Response) und geben Sie unter Feld 1 bis Feld 6 die Felder an.
Die Bezeichnung der Felder muss der Bezeichnung der Felder, die zusätzlich in der HTTP-Response versendet werden sollen, entsprechen.
Die technischen Namen der Felder sind HeaderFieldOne,...,HeaderFieldSix.
Der Attributnamensraum für den Adapter ist: http://sap.com/xi/XI/System/HTTP.