Einfache Output-Komponente
Eine Output-Komponente (oder "einfacher Output") ist eine MapForce Komponente, über die ein String-Wert aus dem Mapping zurückgegeben wird. Output-Komponenten sind nur eine mögliche Art von Zielkomponenten, sind aber nicht damit zu verwechseln. Verwenden Sie eine einfache Output-Komponente, wenn Sie einen String-Wert anhand des Mappings zurückgeben möchten. Einfache Output-Komponenten spielen im Mapping-Bereich die Rolle einer Zielkomponente mit einem String-Datentyp anstelle einer Struktur von Datenelementen und Sequenzen. Infolgedessen können Sie anstelle (oder zusätzlich zu) einer dateibasierten Zielkomponente eine einfache Output-Komponente erstellen. So können Sie eine einfache Output-Komponente z.B. verwenden, um die Ausgabe einer Funktion schnell zu testen und eine Vorschau des Ergebnisses anzuzeigen (siehe Beispiel: Testen der Funktionsausgabe).
Einfache Output-Komponenten sollten nicht mit Output-Parametern in benutzerdefinierten Funktionen verwechselt werden (siehe Benutzerdefinierte Funktionen). Die beiden Parameterarten weisen die folgenden Ähnlichkeiten und Unterschiede auf:
Output-Komponenten | Output-Parameter von benutzerdefinierten Funktionen |
|---|---|
Werden über das Menü Funktion | Output-Komponente einfügen hinzugefügt. | Werden über das Menü Funktion | Output-Komponente einfügen hinzugefügt. |
Haben "string" als Datentyp. | Können sowohl einfache als auch komplexe Datentypen haben. |
Anwendbar auf das gesamte Mapping. | Können nur im Kontext der Funktion, in der sie definiert wurden, angewendet werden. |
Bei Bedarf können Sie mehrere einfache Output-Komponenten zu einem Mapping hinzufügen. Sie können einfache Output-Komponenten auch in Kombination mit dateibasierten Zielkomponenten verwenden. Wenn Ihr Mapping mehrere Zielkomponenten enthält, können Sie eine Vorschau der von einer bestimmten Komponenten zurückgegebenen Daten anzeigen, indem Sie in der Titelleiste der Komponente auf die Schaltfläche Vorschau ( 
) klicken und anschließend im Mapping-Fenster auf das Fenster Ausgabe klicken.
Sie können einfache Output-Komponenten folgendermaßen in MapForce-Transformationssprachen verwenden:
Sprache | Funktionsweise | |
|---|---|---|
XSLT 1.0, XSLT 2.0, XSLT 3.0 | Wenn Sie XSLT-Dateien generieren, wird eine im Mapping definierte einfache Output-Komponente zur Ausgabe der XSLT-Transformation.
Wenn Sie RaptorXML Server verwenden, können Sie RaptorXML Server anweisen, die Mapping-Ausgabe in die Datei zu schreiben, die als Wert an den Parameter --output übergeben wird.
Um die Ausgabe in eine Datei zu schreiben, fügen Sie in der Datei DoTransform.bat den Parameter --output hinzu oder bearbeiten Sie ihn. Die folgende Datei DoTransform.bat wurde z.B. so bearbeitet, dass sie die Mapping-Ausgabe in die Datei Output.txt schreibt (siehe markierter Text).
Wenn kein --output Parameter definiert ist, wird die Mapping-Ausgabe bei Ausführung des Mappings in den Output-Standard-Stream (stdout) geschrieben. |
Wenn Sie (mit dem Menübefehl Extras | Umgekehrtes Mapping erstellen) ein umgekehrtes Mapping erstellen, wird eine einfache Output-Komponente zu einer einfachen Input-Komponente.