Message-Mappings
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.
Der Mapping-Editor kann folgende Schemata in die Strukturübersicht laden:
-
in Schema aus dem Enterprise Services 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 import und 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 dar:
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 und auf der rechten Seite die Zielstruktur. Die Felder der Ausgangsstruktur sollen dann auf Feldern der Zielstruktur abgebildet werden. 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:
|
|
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:
|
|
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ü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:
|
Funktionen im Objektmenü Message-Mapping
|
Funktion |
Verwendung |
|
Aktualisieren |
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 Testen ) lässt sich der Pfad eines Feldes über das Kontext-Menü Pfad kopieren in die Zwischenablage kopieren.
Um ein Mapping zwischen zwei XML-Strukturen zu definieren gehen Sie folgendermaßen vor:
-
Legen Sie ein Message-Mapping an.
-
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 im SAP Developer Network (SDN) unter der Internetadresse http://www.sdn.sap.com/irj/sdn
SOA Middleware 
Repository-Based Modeling and Design 
. Im Knowledge Center auf der Seite
Repository-Based Modeling and Design wählen Sie
SOA Business Content . Wählen Sie auf der nächsten Seite das Dokument
Supported XML Schema and WSDL . -
Ordnen Sie mit Hilfe der Strukturansicht und des Datenfluss-Editors ein oder mehrere Ausgangsfelder einem Zielfeld zu. So ein Mapping nennt man auch Zielfeld-Mapping . Sie können auch ein Ausgangsfeld mehreren Zielfeldern zuordnen (siehe: Zuordnen von Feldern ).
-
Wenn nötig, erweitern Sie das Zielfeld-Mapping im Datenfluss-Editor. Dazu verknüpfen Sie im Mapping-Tool die Ausgangsfelder über Standardfunktionen mit dem Zielfeld. 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 ).
-
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.