Das MappingTrace-Objekt 

Verwendung

Mit diesem Objekt können Sie Meldungen an den Mapping-Trace übergeben. Wenn der Trace-Level entsprechend eingestellt ist (siehe Konfigurationsdaten anzeigen/ändern), ist der Trace im Message-Monitoring (Transaktion SXMB_MONI) sichtbar. Wenn Sie Einträge in den Trace schreiben, wird die Ausführung des Mappings nicht unterbrochen.

Integration

Um ein MappingTrace-Objekt zu bekommen, rufen Sie die Methode getTrace() des Container-Objektes auf.

Funktionsumfang

Ursprünglich waren alle Methoden für die Trace-Ausgabe in der Klasse MappingTrace gekapselt. Später wurde eine Klasse AbstractTrace eingeführt, die alle Methoden der Klasse MappingTrace erbt und zusätzlich die Methode addDebugMessage() einführt. Sie sollten die Klasse AbstractTrace verwenden, um alle unten aufgeführten Methoden aufrufen zu können. Unabhängig von dieser Unterscheidung sprechen wir in dieser Dokumentation vom MappingTrace-Objekt.

Sie können Meldungen für zwei verschiedenen Trace-Level übergeben:

Methoden des Objekts AbstractTrace

Methode	Verwendung
void addInfo(String message);	Hinzufügen einer Meldung message zum Mapping-Trace mit Trace-Level info.
void addWarning (String message);	Hinzufügen einer Meldung message zum Mapping-Trace mit Trace-Level warning.
void addDebugMessage (String message);	Hinzufügen einer Meldung message zum Mapping-Trace mit Trace-Level debug.

Die Meldungen, die Sie mit diesen Methoden in den Trace schreiben, können Sie sich beispielsweise in der Testumgebung anzeigen lassen. Außerdem können Sie einen Trace-Level für jede Pipeline der Integration Engine einstellen (siehe dazu: Konfigurationsdaten anzeigen/ändern), so dass die Trace-Meldungen zur Laufzeit in den Trace-Header der Message geschrieben werden. Die Trace-Level 0 bis 3 hängen dabei folgendermaßen mit den hier angegebenen Trace-Leveln info, warning und debug zusammen:

Trace-Level der Pipeline und des Mapping-Trace

Pipeline	Mapping Trace
0	kein Trace
1	addWarning()-Einträge werden in den Trace geschrieben
2	addWarning()- und addInfo()-Einträge werden in den Trace geschrieben
3	addWarning()- und addInfo() und addDebugMessage()-Einträge werden in den Trace geschrieben.

Wenn der Trace-Level der Pipeline beispielsweise auf 0 gesetzt ist, werden also zur Laufzeit keine Meldungen in den Trace-Header der Message geschrieben, und zwar selbst dann nicht, wenn Sie im Mapping-Programm über die Methode addWarning() Text an die Mapping-Laufzeit übergeben.