Altova StyleVision Server 2025

Syntax und Beschreibung

Der Befehl generate (Kurzform gen) generiert durch Transformieren der XML-Input-Datei mit Hilfe des/der in der PXF-Input-Datei enthaltenen XSLT-Dokuments/Dokumente eine oder mehrere Ausgabedateien (HTML, PDF, RTF und/oder DOCX).

 

stylevisionserver generate | gen --inputxml=Filename [additional options] InputPXF

 

Die Option --inputxml ist obligatorisch und gibt den Pfad der XML-Datei an.

Das Argument InputPXF definiert den Pfad der PXF-Datei, die das/die zur Generierung des/der Ausgabedokuments/Ausgabedokumente verwendete(n) XSLT-Dokument(e) enthält. PXF-Dateien wird mit der Altova-Applikation StyleVision generiert.

Jedes Ausgabeformat wird durch Definition einer Option für diese Ausgabe (siehe Liste der Optionen unten) generiert. Der Wert jeder Option ist ein Pfad, der definiert, wo die Ausgabe generiert werden soll.

 

Anmerkung:StyleVision Server verwendet Apache FOP, den FO-Prozessor des Apache Project zur Generierung von PDF-Dateien anhand von FO. Apache FOP wird zusammen mit StyleVision Server unter dem folgenden Pfad installiert: Auf Windows-Systemen, ProgramData\Altova\SharedBetweenVersions; auf Linux- und macOS-Systemen in einem Ordner unterhalb des Ordners StyleVisionServer2025. Beachten Sie, dass für Apache FOP Java Runtime Environment 1.8 oder höher auf dem StyleVision Server-Rechner installiert sein muss. Installieren Sie für die 32-Bit-Version von StyleVision Server die Java-32-Bit-Version und für die 64-Bit-Version von StyleVision Server die Java-64-Bit-Version. Nähere Informationen zur Konfiguration von FOP finden Sie im Kapitel FOP-Anforderungen.

 

 

 

Beispiele

Beispiele für den Befehl generate:

 

stylevisionserver generate --inputxml=C:\MyFiles\ExpReport.xml --html=Test.html ExpReport.pxf

stylevisionserver generate --inputxml=C:\ExpReport.pxf|zip\ExpReport.xml --html=Test.html ExpReport.pxf

stylevisionserver generate --inputxml=altova://packagedfile/ExpReport.xml --html=Test.html ExpReport.pxf

stylevisionserver generate --inputxml=ExternalXML.xml --html=Test.html Test.pxf

 

Die obigen Befehle enthalten die obligatorische Option --inputxml, das Argument InputPXF (Test.pxf) sowie mindestens eine Option zur Ausgabeerstellung (--html in allen Beispielen oben).

Die verwendete XML-Input-Datei kann sich innerhalb der PXF-Datei (siehe erstes und drittes Beispiel oben) befinden oder eine externe XML-Datei sein (die sich außerhalb der PXF-Datei befindet; siehe erstes und viertes Beispiel oben).

Der --inputxml Switch wird ignoriert, wenn die Hauptschemaquelle eine Datenbank oder DB-XML ist, muss aber aus syntaktischen Gründen vorhanden sein und Sie sollten z.B. --inputxml=database verwenden.

Wenn die Option --html zur Erstellung des Output wie im Beispiel oben einen relativen Pfad erhält, so wird die Output-Datei unter einem Pfad relativ zum Ordner, in dem sich die PXF-Datei befindet, erstellt.

 

Optionen

 

 

Mit Hilfe der Option --h, --help können Sie Informationen über den Befehl anzeigen.

 

Optionen werden in ihrer kurzen Form (falls verfügbar) und in ihrer langen Form aufgelistet. Für die kurze und die lange Form können ein oder zwei Bindestriche verwendet werden. Eine Option kann, muss aber keinen Wert erhalten. Eine Option, die einen Wert erhält, wird folgendermaßen geschrieben: --option=wert. Werte können außer in zwei Fällen ohne Anführungszeichen definiert werden: (i) wenn der Wertestring Leerzeichen enthält oder (ii) wenn in der Beschreibung der Option explizit erwähnt ist, dass Anführungszeichen zwingend erforderlich sind. Wenn eine Option einen Booleschen Wert erhält und kein Wert definiert ist, so ist der Standardwert der Option TRUE. Mit Hilfe der Option --h, --help können Sie Informationen über den Befehl anzeigen.

 

Kataloge

Wenn Sie den Altova-Katalog-Mechanismus verwenden, finden Sie die entsprechenden Katalogdateien im Ordner etc des StyleVision Server-Applikationsordners. Ausführliche Informationen dazu finden Sie im Abschnitt "Kataloge" des Altova StyleVision-Handbuchs.

 

CustomCatalog.xml kann anhand der Vorlagendatei CustomCatalog_template.xml erstellt werden. Benennen Sie die Vorlagendatei in CustomCatalog.xml um, da dies die Datei ist, die im Katalogmechanismus verwendet wird (und nicht die Vorlagendatei).

 

Beachten Sie dazu Folgendes:

 

Bei einer Neuinstallation derselben Hauptversion (selbe oder unterschiedliche Nebenversion) wird die Vorlagendatei durch eine neue Vorlagendatei ersetzt, wobei CustomCatalog.xml jedoch unverändert bleibt.

Wenn Sie jedoch eine neue Hauptversion über eine vorherige Hauptversion installieren, wird der Ordner der vorherigen Hauptversion zusammen mit seiner CustomCatalog.xml-Datei gelöscht. Wenn Sie also CustomCatalog.xml weiterhin verwenden möchten, müssen Sie CustomCatalog.xml aus dem Ordner der vorherigen Hauptversion in einem anderen Ordner sichern. Nach Installation der neuen Hauptversion können Sie die zuvor gespeicherte Datei CustomCatalog.xml in den Ordner etc der neuen Hauptversion kopieren und dort je nach Bedarf bearbeiten.

 

© 2018-2024 Altova GmbH