Adapterspezifische Attribute im Message-Header verwenden
Kontext
Einige Adapter der Adapter-Engine unterstützen spezifische Attribute, die zusätzliche Informationen zur Message enthalten. Diese Informationen sind nicht in der Payload der Message, sondern in zusätzlichen Message-Header-Feldern enthalten.
Jeder Adapter hat einen definierten Satz solcher Attribute, die für jeden Adaptertyp in der Adapter-Konfiguration beschrieben sind. Im Sender-Adapter können Sie die Attribute setzen und im Empfänger-Adapter können Sie die Attribute verwenden.
Die Länge der Attributwerte ist durch das XI-Message-Protokoll vorgegeben. Die Werte dürfen maximal 200 Zeichen lang sein. Weisen Sie beispielsweise im Mapping oder in Adaptermodulen längere Werte zu, führt dies zur Laufzeit zu einem Verarbeitungsfehler oder die Werte werden auf 200 Zeichen gekürzt. Die Kürzung der Werte kann auch zu einem Verarbeitungsfehler führen. Der auftretende Verarbeitungsfehler ist von den Komponenten abhängig, die auf die Attribute zugreifen.
Im Routing und Mapping können Sie über den Attribut-Namensraum und den technischen Namen des Attributs auf diese Attribute zugreifen.
Der Attribut-Namensraum ergibt sich aus dem Namensraum im Enterprise Services Repository, in dem die Adaptermetadaten des Adapters abgelegt sind und dem Namen des Adaptermetadaten-Objekts.
Die Adapter-Namensräume der von SAP ausgelieferten Adapter haben also folgende Form:
http://sap.com/xi/XI/System/<Adaptermetadaten-Objektname des Adapters>
Die Adaptermetadaten-Objekte befinden sich im Namensraum http://sap.com/xi/XI/System der Software-Komponente SAP BASIS .
Vorgehensweise
-
Wählen Sie im Sender- Adapter Adapterspezifische Message-Attribute setzen und wählen Sie die Attribute, die Sie in den Message-Header übernehmen wollen.
Weitere Informationen finden Sie jeweils unter Adapterspezifische Message-Attribute :
Konfiguration des RFC-Sender-Adapters
Plain-HTTP-Sender-Adapter im Integration Directory konfigurieren
File-Sender-Adapter konfigurieren
FTP-Sender-Adapter konfigurieren
JMS-Sender-Adapter konfigurieren
SOAP-Sender-Adapter konfigurieren
Mail-Sender-Adapter konfigurieren
RNIF 1,1 Sender-Adapter für Anfragen konfigurieren
-
Verwenden Sie die gesetzten Attribute im Routing, Mapping oder im Empfänger-Adapter des gleichen Typs:
-
Geben Sie bei der Formulierung einer Routing-Bedingung im Ausdruckseditor ein adapterspezifisches Attribut als Kontextobjekt an.
Weitere Informationen finden Sie unter Ausdrucksseditor .
Zur Laufzeit wird zur Auswertung der Routing-Bedingung der aktuelle Wert dieses Attributes aus dem Message-Header gelesen.
Das Routing steht im PCK nicht zur Verfügung.
-
Im Mapping können Sie über Java-Funktionen auf die Attribute lesend und schreibend zugreifen.
Weitere Informationen finden Sie unter Java-Mapping von adapterspezifischen Attributen.
-
Wählen Sie die adapterspezifischen Message-Attribute im Empfänger-Adapter aus.
Die Attribute werden aus einer Message auslesen und anstelle eines statischen Parameters aus der Adapter-Konfiguration verwendet
Weitere Informationen finden Sie jeweils unter Adapterspezifische Message-Attribute :
Plain-HTTP-Empfänger-Adapter im Integration Directory konfigurieren
File-Empfänger-Adapter konfigurieren
FTP-Empfänger-Adapter konfigurieren
JMS-Empfänger-Adapter konfigurieren
SOAP-Empfänger-Adapter konfigurieren
Mail-Empfänger-Adapter konfigurieren
-
-
Sie finden Message-Attribute im Message-Monitoring im Message-Header DynamicConfiguration aufgelistet.
Weitere Informationen für das Monitoring auf der Integration-Engine: Versionen von XML-Messages anzeigen .