Testumgebung für Operation-Mappings 

Verwendung

Um zu überprüfen, ob nach der Definition eines Operation-Mappings dieses wie gewünscht zur Laufzeit funktioniert, können Sie das Operation-Mapping auf der Registerkarte Test testen. Es gibt folgende Einschränkungen:

·        Der ES Builder kann zum Design-Zeitpunkt noch nicht auf die Wertemapping-Tabelle zugreifen. Solche Zugriffe werden im Testergebnis nur über eine Textausgabe angedeutet.

·        Die Laufzeit-Konstanten der Mapping-Laufzeit werden nicht gesetzt beziehungsweise auf Konstante dummy-Werte.

Sie können in einem Testlauf entweder das Mapping für die Request-, die Response- oder die Fault-Message teste.

Voraussetzungen

Die zu testenden Mapping-Programme müssen im ES Repository vorhanden sein.

Message-Mappings müssen vollständig sein, so dass der generierte Java-Quellkode kompiliert werden kann.

Ein Benutzer benötigt für das Testen von Mapping-Programmen im Repository die Rolle SAP_XI_ADMINISTRATOR_J2EE, SAP_XI_CONTENT_ORGANIZER_J2EE, SAP_XI_CONFIGURATOR_J2EE, oder SAP_XI_DEVELOPER_J2EE.

Funktionsumfang

Bis auf die Verwaltung von Testfällen ist der Funktionsumfang der Testumgebung der gleiche wie bei der Testumgebung für Message-Mappings.

Test-Instanzen

Zur Ausführung eines Message-Mappings benötigen Sie eine Test-Instanz in XML, die laut Ihrer Beschreibung der Ausgangsstruktur (in XSD oder XML) gültig ist. Beim ersten Wechsel auf die Registerkarte Test generiert der Mapping-Editor diese Test-Instanz automatisch.

Allgemeine Funktionen für Test-Instanzen

Funktion	Verwendung
(XML-Instanz laden)	Laden einer XML-Instanz aus einer lokalen Datei
(Pretty-Print)	Formatiert das XML-Dokument (Einrückungen, Zeilenumbrüche)

Sie können XML-Instanzen bearbeiten, um verschiedene Testfälle durchzuspielen:

·        Über den Editor der Text-Ansicht. Sie können Elemente und Attribute beziehungsweise deren Werte dort manuell bearbeiten. Verwenden Sie STRG-C, STRG-X und STRG-V, um über Copy&Paste Teile einer XML-Instanz zu verschieben beziehungsweise zu kopieren.

·        Über das Kontext-Menü in der (tabellarischen) Baumansicht. Sie können Teilbäume kopieren, Knoten löschen und Elemente oder Attribute hinzufügen. In der tabellarischen Baumansicht können Sie in der Spalte Wert auch die Werte für Felder erfassen.

Trace-Level

Zur Laufzeit eines Message-Mappings können Sie in benutzerdefinierten Funktionen Meldungen für einen Trace ausgeben (siehe: Das AbstractTrace-Objekt). Außerdem schreibt die Laufzeit eines Message-Mappings Informationen zur Fehleranalyse in den Trace, wenn der Trace-Level Debug eingestellt ist. Trace-Meldungen können Sie sich in der Testumgebung im Textfenster für die Statusmeldungen ausgeben lassen, indem Sie vor dem Test einen Trace-Level auswählen.

Trace-Level	Ausgabe
No Trace	Es werden keine Informationen des Trace ausgegeben.
Warning	Es werden Trace-Meldungen ausgegeben, die Sie mit der Methode addWarning() in den Trace geschrieben haben.
Info	Es werden Trace-Meldungen ausgegeben, die Sie mit der Methode addInfo() in den Trace geschrieben haben.
Debug	Es werden Trace-Meldungen der Mapping-Laufzeit und solche ausgegeben, die Sie mit der Methode addDebugMessage() in den Trace geschrieben haben.

Aktivitäten

...

       1.      Wechseln Sie auf die Registerkarte Test.

Auf der Registerkarte Testen dient die linke Seite zur Ansicht der Ausgangs XML-Instanz und die rechte Seite zur Ansicht des Transformations-Ergebnisses, also der Ziel XML-Instanz. Die Möglichkeiten zur Darstellung entsprechen denen der Strukturübersicht im Message-Mapping-Editor.

       2.      Wenn mehrere Richtungen vorhanden sind, wählen Sie eine über die Listbox Richtung aus (Request, Response oder Fault). Wenn es in der Fault-Richtung mehrere Ausgangs-Messages gibt, wählen Sie eine über die Listbox Ausgangs-Message aus.

       3.      Erzeugen oder laden Sie eine Ausgangsinstanz beziehungsweise geben Sie eine in den Editor ein und nutzen Sie die oben beschriebenen Funktionen, um die Instanz weiter auszubauen.

Wenn Sie eine XML-Instanz in den Editor geladen haben arbeiten Sie im Editor mit einer Kopie der Datei.

       4.      Wählen Sie einen Trace-Level. Sie können die Trace-Ausgaben von Mapping-Programmen von denen der Mapping-Laufzeit über die Ausgaben *** START APPLICATION TRACE *** und *** END APPLICATION TRACE ***unterschieden.

       5.      Um Ihr Mapping mit der XML-Instanz zu testen, klicken Sie auf die Drucktaste Mapping ausführen (). Wenn Sie Message-Mapping-Programme das erste mal testen oder es seit dem letzten Test modifiziert haben, kompiliert der Integration Builder vor dem Test den generierten Java-Quellkode.

Ergebnis

Das Transformations-Ergebnis wird auf der rechten Seite angezeigt. Je nach Trace-Level zeigt der Textrahmen für die Statusmeldungen die Ausgaben des Trace und den Status der Transformation an. Rufen Sie das Kontext-Menü Meldungen löschen im Textrahmen auf, um alle Statusmeldungen zu löschen.