AltovaXML – Optionen für die Kommandozeile

(Auszug aus "XSLT 2.0 & XPath 2.0" von Frank Bongers)

Der AltovaXML-Prozessor kann wahlweise zum Test einer XML-Datei eingesetzt werden oder XSLT-Transformationen durchführen. Hierbei muss jedoch explizit entweder eine Transformation nach XSLT 1.0 oder nach XSLT 2.0 angestoßen werden. Dies geschieht über Optionen der Kommandozeile.

-?, -help, -h

Option	Aufgabe
-?, -help, -h	Syntaxhilfe

Hilfe:

Die Optionen -?, -help und -h (siehe folgende Abbildung) geben Auskunft über die Kommandozeilensyntax von AltovaXML, inklusive einer Beschreibung der einsetzbaren Optionen. Da keine Transformation eingeleitet wird, brauchen keine weiteren Angaben, wie die eines Quelldokuments oder Stylesheets, zu erfolgen.

Abbildung: AltovaXML über die Kommandozeile mit Option -help

nach oben

-version, -ver

Option	Aufgabe
-version, -ver	Versionsnummer ausgeben

Information:

Zeigt die Version des Prozessors an.

nach oben

-wellformed, -w

Option	Aufgabe
-wellformed, -w	Prüft auf Wohlgeformtheit

Prüfung:

Diese Option veranlasst AltovaXML, die übergebene XML-Datei auf Wohlgeformtheit zu prüfen.

Beispiel:

AltovaXML -wellformed beispiel.xml

nach oben

-validate, -v

Option	Aufgabe
-validate, -v	Validierungsfunktion aktivieren

Validierung:

Diese Option startet AltovaXML als validierenden XML-Parser und validiert die übergebene XML-Datei.

Beispiel:

AltovaXML -validate beispiel.xml

Hinweis:

Enthält die XML-Datei kein internes Schema oder keine interne DTD, muss entweder über die Option -dtd oder die Option -schema eine der Validierung zugrunde liegende DTD- oder XML Schema-Datei genannt werden.

nach oben

-schema, -s

Option	Aufgabe
-schema, -s	Validierung anhand eines Schemas

Validierung:

Diese Option startet AltovaXML als validierenden XML-Parser und validiert die übergebene XML-Datei. Zusätzlich muss entweder die Option -dtd oder die Option -schema zusammen mit einer der Validierung zugrunde liegenden DTD oder einem XML Schema eingesetzt werden.

Beispiel:

AltovaXML -validate beispiel.xml -schema beispiel.xsd

Hinweis:

Besitzt die XML-Datei zusätzlich eine interne Schema-Referenz, so hat die per Option genannte Schema-Datei Vorrang.

nach oben

-dtd, -d

Option	Aufgabe
-dtd, -d	Validierung anhand einer DTD

Validierung:

Diese Option startet AltovaXML als validierenden XML-Parser und validiert die übergebene XML-Datei. Zusätzlich muss entweder die Option -dtd oder die Option -schema zusammen mit einer der Validierung zugrunde liegenden DTD oder einem XML Schema eingesetzt werden.

Beispiel:

AltovaXML -validate beispiel.xml -dtd beispiel.dtd

Hinweis:

Besitzt die XML-Datei zusätzlich eine interne DTD, so hat die per Option genannte DTD Vorrang.

nach oben

-in

Option	Aufgabe
-in	Quelldokument der Transformation

Steuerung der Verarbeitung:

Mit der Option -in erfolgt die obligatorische Nennung eines Quelldokuments für die Transformation. Es wird eine Pfadangabe und ein Dateiname übergeben.

Beispiel:

AltovaXML -xslt2 beispiel.xslt -in eingabe.xml -out ergebnis.xml

nach oben

-out

Option	Aufgabe
-out	Ergebnisdokument der Transformation

Steuerung der Verarbeitung:

Mit -out können optional Pfad und Name einer Datei übergeben werden, in die das Ergebnis der Transformation ausgegeben werden soll. Ansonsten erfolgt die Ausgabe nach Standard-Out.

Beispiel:

AltovaXML -xslt2 beispiel.xslt -in eingabe.xml -out ergebnis.xml

nach oben

-xslt1

Option	Aufgabe
-xslt1	Transformation gemäß XSLT 1.0

Steuerung der Verarbeitung:

Schaltet AltovaXML in den Transformationsmodus gemäß XSLT 1.0 und übergibt ein XSLT-Stylesheet. Mit der Option -in muss ein Quelldokument bezeichnet werden.

Beispiel:

AltovaXML -xslt1 beispiel.xslt -in eingabe.xml -out ergebnis.xml

Hinweis:

Die Übergabe eines Pfades für ein Ergebnisdokument mit -out ist optional. In diesem Fall erfolgt eine Ausgabe nach Standard-Out.

nach oben

-xslt2

Option	Aufgabe
-xslt2	Transformation gemäß XSLT 2.0

Steuerung der Verarbeitung:

Schaltet AltovaXML in den Transformationsmodus gemäß XSLT 2.0 und übergibt ein XSLT-Stylesheet. Mit der Option -in muss ein Quelldokument bezeichnet werden.

Beispiel:

AltovaXML -xslt2 beispiel.xslt -in eingabe.xml -out ergebnis.xml

Hinweis:

Die Übergabe eines Pfades für ein Ergebnisdokument mit -out ist optional. Die Ausgabe erfolgt dann an Standard-Out (siehe folgende Abbildung).

Abbildung: AltovaXML gibt an den Standard-Out aus

nach oben

-param

Option	Aufgabe
-param	Leitet die Übergabe eines Parameters ein

Steuerung der Verarbeitung:

Der Schalter -param muss vor jeder Übergabe eines Parameters an das Stylesheet gesetzt werden. Im Anschluss wird die Nennung von Name und Wert eines Parameters erwartet.

Beispiel:

-param test='beispielzeichenkette'

Hinweis:

Stringwerte werden generell in einfache Anführungszeichen gesetzt, müssen aber zusätzlich mit doppelten Anführungszeichen umgeben werden, wenn sie Leerzeichen enthalten.

Beispiel:

-param test="'beispiel einer anderen zeichenkette'"

Ebenfalls in doppelten Anführungszeichen stehen XPath-Ausdrücke, die Leerzeichen enthalten:

Beispiel:

-param date="//node/@att1 | //node/@att2"

nach oben

-xslstack

Option	Aufgabe
-xslstack	Begrenzt den Verarbeitungs-Stack

Steuerung der Verarbeitung:

Der Schalter -xslstack steuert die Tiefe der Transformation durch Begrenzung der Stackgröße. Der Default-Wert ist 1000, der Mindestwert 100. Bei Überschreitung der Stackgröße erfolgt eine Fehlermeldung.

nach oben

  

<< zurück

vor >>