Adapterspezifische Attribute im
Message-Header
Verwendung
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 dieser Adapter hat einen definierten Satz solcher Attribute, die im Einzelnen bei der Adapter-Konfiguration beschrieben sind.
Über den Attribut-Namensraum und den technischen Namen des Attributs kann im Routing und Mapping auf diese Attribute zugegriffen werden. Der Attribut-Namensraum ergibt sich aus dem Namensraum im Integration 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 SAP Adaptermetadaten-Objekte befinden sich im Namensraum http://sap.com/xi/XI/System der Software-Komponente SAP BASIS.
Funktionsumfang
Sender Adapter
Sender-Adapter, die spezifische Message-Attribute unterstützen, können optional solche Attribute einer Message hinzufügen.
Sie müssen diese Attribute explizit in der Adapter-Konfiguration aktivieren. Informationen zu den jeweiligen Sender-Adaptern finden Sie unter Adapterspezifische Message-Attribute:
● Konfiguration des RFC-Sender-Adapters
● Konfiguration des Plain-HTTP-Sender-Adapters
● Konfiguration des File/FTP-Sender-Adapters
● Konfiguration des JMS-Sender-Adapters
● Konfiguration des SOAP-Sender-Adapters
● Konfiguration des Mail-Sender-Adapters
Die erzeugten Attribute können im Routing, Mapping oder auch im Empfänger-Adapter des gleichen Typs verwendet werden.
Empfänger-Adapter
Empfänger-Adapter, die spezifische Message-Attribute unterstützen, können optional solche Attribute aus einer Message auslesen und anstelle eines statischen Parameters aus der Adapter-Konfiguration verwenden.
Sie müssen diese Attribute explizit in der Adapter-Konfiguration aktivieren. Informationen zu den jeweiligen Empfänger-Adaptern finden Sie unter Adapterspezifische Message-Attribute:
● Konfiguration des Plain-HTTP-Empfänger-Adapters
● Konfiguration des File/FTP-Empfänger-Adapters
● Konfiguration des JMS-Empfänger-Adapters
● Konfiguration des SOAP-Empfänger-Adapters
● Konfiguration des Mail-Empfänger-Adapters
Solche Attribute können entweder im Mapping erzeugt werden oder in einigen Fällen vom Sender-Adapter des gleichen Typs verschickt werden.
Industriespezifische Adapter
Informationen zu Adapterspezifischen Message-Attributen in den industriespezifischen Adaptern finden Sie unter:
● RNIF-Adapter-Konfiguration (RNIF 1.1)
● RNIF-Adapter konfigurieren (RNIF 2.0)
Routing
Bei der Konfiguration des logischen Routing (Empfängerermittlung und Interface-Ermittlung) können Sie adapterspezifische Attribute berücksichtigen. Wenn Sie eine Routing-Bedingung formulieren, können Sie im Ausdruckseditor ein adapterspezifisches Attribut als Kontextobjekt angeben. 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.
Mapping
Im Mapping können Sie über Java-Funktionen auf Message Attribute lesend und schreibend zugreifen. Siehe auch: Java-Mapping von adapterspezifischen Attributen
Monitoring
Message-Attribute sind im Message-Monitoring im Message-Header DynamicConfiguration aufgelistet. Siehe auch für das Monitoring auf der Integration-Engine: Versionen von XML-Messages anzeigen