Message-Mappings 

Verwendung

Ein Message-Mapping ist ein Mapping von Messages und wird durch einen graphischen Mapping-Editor unterstützt. Der Editor erlaubt das Design eines Struktur-Mappings zwischen zwei beliebigen XML-Strukturen und den Anschluss an ein Werte-Mapping.

Das Mapping-Tool generiert aus der graphischen Mapping-Beschreibung Java-Quellcode, der dann übersetzt und in einer Jar-Datei gepackt von der Integration Engine zur Laufzeit ausgeführt werden kann.

Funktionsumfang

Der Mapping-Editor kann folgende Schemata in die Strukturübersicht laden:

·        Ein Schema aus dem Integration Repository: (Fault-)Message-Typen, IDocs, der Request-, Response- oder Fault-Teil von RFCs, und Message-Strukturen aus externen Definitionen. Letztere sind Message-Strukturen aus WSDL-, XSD- oder DTD-Dokumenten.

·        XML Schema Definitionen (XSD) oder XML-Dateien aus einer lokalen Datei.

Im Falle von XSD-Dateien (die Repository-Schemas verwenden ebenfalls dieses Format) erzeugt der Mapping-Editor jeweils eine XML-Repräsentation für die Ausgangsstruktur und die Zielstruktur. Enthält die XSD-Datei mehrere globale Elemente, wählen Sie über einen Dialog ein globales Element als Wurzelelement aus.

Wenn Sie mehrere XSD-Dateien hochladen wollen, die über die XSD-Anweisungen importund include aufeinander verweisen, müssen Sie die Dateien vorher in einer ZIP-Datei packen. Auch hier wählen Sie ein globales Element als Wurzelelement aus, falls mehrere in den Dateien vorkommen.

Hauptfunktionsbereiche im Mapping-Editor

Nach dem Anlegen eines Message-Mappings befinden Sie sich auf der Registerkarte Design des Mapping-Editors. Die folgende Grafik stellt die Bildbereiche des Mapping-Editors da (die Registerkarte wurde vorher aus dem Integration Builder losgelöst):

Bei der Definition eines Message-Mappings haben Sie folgende Möglichkeiten:

·         Funktionen der Objekt-Drucktastenleiste beziehen sich auf das gesamte Mapping. Sie können dort beispielsweise Ihr Mapping speichern oder automatisch gleichnamige Felder einander zuordnen.

·         Beim Anlegen eines neuen Message-Mappings ist die Strukturübersicht im Mapping-Editor zunächst leer. Dort müssen Sie jeweils für die Ausgangsstruktur und die Zielstruktur ein Repository-Schema angeben beziehungsweise eine XML- oder XSD-Datei importieren. Der Mapping-Editor liest die Daten ein und zeigt eine auf das Mapping ausgerichtete XML-Repräsentation in der Strukturübersicht an: Auf der linken Seite die Ausgangsstruktur, dessen Felder auf Felder der Zielstruktur (rechte Seite) abgebildet werden sollen. Für Ausgangs- und Zielstruktur können Sie verschiedene Ansichten auswählen (Baumansicht, Tabellarische Baumansicht, Anzeige als Text-Dokument oder Anzeige im Browser).

·         Die Strukturübersicht ist eng an den Datenfluss-Editor gekoppelt, mit dem Sie das Mapping eines oder mehrerer Ausgangsfelder auf ein Zielfeld beschreiben können. So ein Mapping nennt man auch Zielfeld-Mapping. Gibt es schon ein Mapping auf ein Feld in der Zielstruktur, können Sie zum zugehörigen Mapping navigieren indem Sie auf das entsprechende Zielfeld in der Stukturübersicht doppelklicken.

Ein Message-Mapping setzt sich also aus verschiedenen Zielfeld-Mappings zusammen.Wenn Sie für jedes nicht-optionale Zielfeld ein Mapping definiert haben, ist Ihr Message-Mapping vollständig. Sie können es dann testen indem Sie auf die Registerkarte Test wechseln (siehe: Testumgebung).

Funktionen der Objekt-Drucktastenleiste

Funktion	Verwendung
Messages auswählen	Laden von Schemata für Ausgangs- und Ziel-Message in die Strukturübersicht.
Markierte Felder und Unterstrukturen mit gleichem Namen zuordnen	Bevor Sie diese Funktion ausführen, markieren Sie jeweils einen Knoten in der Ausgangs- und Zielstruktur, die zueinander gehören. Unterknoten, die exakt den gleichen Namen haben (Groß-/Kleinschreibung beachten!) können Sie dann automatisch zuordnen. Diese Funktion ist vor allem für einfache Mappings hilfreich, zum Beispiel von RFC-XML auf Proxy-XML.
Mappping löschen	Alle Zielfeld-Mappings werden gelöscht.
Datenfluss-Editor	Mit diesen Drucktasten schalten Sie zwischen Datenfluss-Editor, Text-Vorschau und angewendeten Mapping-Vorlagen im unteren Bereich des Mapping-Editors um: ·        Im Datenfluss-Editor bearbeiten Sie ein Zielfeld-Mapping. ·        Die Text-Vorschau zeigt alle Zielfeld-Mappings mit den dabei verwendeten Funktionen als Text an. Zeilen in roter Schrift weisen auf noch fehlende Zielfeld-Mappings hin. Zusätzlich gibt die Quickinfo eines grünen Zielfeldes das zugehörige Mapping aus. ·        Ein Message-Mapping kann Mapping-Vorlagen (für Datentyp-Mappings) wiederverwenden. Mit Hilfe der Funktion Angewendete Mapping-Vorlagen anzeigen zeigen Sie die bisher verwendeten Mapping-Vorlagen im unteren Bereich des Mapping-Editors an. Beachten Sie, dass sich die Zielfeld-Mappings von angewendeten Mapping-Vorlagen von denen im aktuellen Message-Mapping unterscheiden können.
Text-Vorschau
Angewendete Mapping-Vorlagen anzeigen
Abhängigkeiten (Anzeigen, Alle Anzeigen, Alle ausblenden)	Mit dieser Funktion können Sie sich graphisch in der Strukturübersich anzeigen lassen, welche Ausgangsfelder welchen Zielfeldern zugeordnet sind (Entweder nur für ein markiertes Knotenpaar oder für alle). Die Farben haben folgende Bedeutung: ·        Rot: Das Ausgangsfeld ist dem Zielfeld direkt zugeordnet ·        Grün: Ein Unterknoten des Ausgangsfeldes ist dem Zielfeld zugeordnet ·        Blau: Das Ausgangsfeld ist einem Unterknoten des Zielfeldes Zugeordnet ·        Schwarz: Ein Unterknoten des Ausgangfeldes ist einem Unterknoten des Zielfeldes zugeordnet.
Geeignete Vorlagen einblenden	Mit dieser Funktion können Sie ein vorher gespeicherte Mapping-Vorlage zu einem Elementpaar als Kopie laden.
Vorlage auf Grundlage des Mapping anlegen	Mit dieser Funktionen können Sie eine Mapping-Vorlage zu einem Elementpaar erstellen, die auf einen Datentyp oder eine Message-Struktur verweisen. Die jeweiligen Element müssen markiert sein.
Abhängigkeiten (Anzeigen, Alle Anzeigen, Alle ausblenden)	Mit dieser Funktion können Sie sich graphisch in der Strukturübersicht anzeigen lassen, welche Ausgangsfelder welchen Zielfeldern zugeordnet sind (Entweder nur für ein markiertes Knotenpaar oder für alle). Die Farben haben folgende Bedeutung: ·        Rot: Das Ausgangsfeld ist dem Zielfeld direkt zugeordnet ·        Grün: Ein Unterknoten des Ausgangsfeldes ist dem Zielfeld zugeordnet ·        Blau: Das Ausgangsfeld ist einem Unterknoten des Zielfeldes Zugeordnet ·        Schwarz: Ein Unterknoten des Ausgangfeldes ist einem Unterknoten des Zielfeldes zugeordnet.
Java-Abschnitte bearbeiten	Mit dieser Funktion legen Sie globale Variablen und zusätzliche Java-Abschnitte für alle Java-Funktionen fest. Zunächst inkludiert die Mapping-Laufzeit die unter Importe angegebenen Java-Pakete. Sie können hier die gleichen Pakete wie bei einer benutzerdefinierten Funktion angeben. Danach deklariert die Mapping-Laufzeit die unter Globale Variablen angegebenen Variablen und führt die Abschnitte in der folgenden Reihenfolge aus: ...        1.      Initialisierungsabschnitt        2.      Message-Mapping        3.      Bereinigungsabschnitt

Funktionen im Objektmenü Message-Mapping

Funktion	Verwendung
Auffrischen	Wenn Sie ein Repository-Schema in den Mapping-Editor geladen haben, das nachträglich im Repository geändert worden ist, ist diese Änderung nicht automatisch im Mapping-Editor sichtbar. Mit der Funktion Aktualisieren können Sie solche Änderungen in die Ausgangs- und Zielstruktur übernehmen.
Löschen	Löschen des Message-Mapping-Objektes

Weitere Funktionen

Innerhalb der Strukturübersicht und im Datenfluss-Editor können Sie Funktionen über das Kontext-Menü aufrufen. Für alle Felder (im Datenfluss-Editor, der Strukturübersicht der Registerkarte Design und Test) lässt sich der Pfad eines Feldes über das Kontext-Menü Pfad kopieren in die Zwischenablage kopieren.

Aktivitäten

Um ein Mapping zwischen zwei XML-Strukturen zu definieren gehen Sie folgendermaßen vor:

...

       1.      Legen Sie in der Design-Pflege des Integration Builder ein Message-Mapping an (siehe: Anlegen eines Objektes).

       2.      Laden Sie eine Ausgangs- und eine Zielstruktur in den Mapping-Editor, indem Sie entweder die Suchhilfe verwenden oder die Objekte per Drag & Drop aus dem Navigationsbaum auf die entsprechende Hand ziehen.

Beachten Sie für Messages aus externen Definitionen, dass der Mapping-Editor nicht den gesamten Sprachumfang von XSD unterstützt. Weitere Informationen finden Sie auf dem SAP Service Marketplace unter der Internetadresse service.sap.com/xi ® Media Library ® Documentation: SAP XI 3.0 (SP11) – Supported XML Schema and WSDL (EN).

       3.      Ordnen Sie mit Hilfe der Strukturansicht und des Datenfluss-Editors ein oder mehrere Ausgangsfelder einem Zielfeld zu Ein solches Mapping nennt man auch Zielfeld-Mapping. Sie können auch ein Ausgangsfeld mehreren Zielfeldern zuordnen (siehe: Zuordnung von Feldern).

       4.      Wenn nötig, erweitern Sie das Zielfeld-Mapping im Datenfluss-Editor, indem Sie die Ausgangsfelder über Standardfunktionen im Mapping-Tool mit dem Zielfeld verknüpfen. Sie können im Mapping-Tool auch benutzerdefinierte Funktionen in Java anlegen, die Sie dann zusätzlich im Datenfluss-Editor verwenden können (siehe auch: Datenfluss-Editor).

       5.      Führen Sie die letzten beiden Schritte mindestens für alle nicht-optionalen Zielfelder durch.

Ergebnis

Wenn es in der Zielstruktur nur noch Felder mit grünen oder weißen Symbolen gibt, ist Ihr Mapping vollständig und Sie können es testen. Gelbe Symbole weisen auf unvollständige Mappings von Zielfeldern hin, rote Symbole auf noch gar nicht zugewiesene Zielfelder.