Altova StyleVision Server 2024

Bei Ausführung mehrerer Transformationen ins PDF-Format empfiehlt sich vor allem bei großen Dokumenten die Verwendung von AltovaFOPServer, um die Transformation schneller durchführen zu können. Die höhere Geschwindigkeit ist darauf zurückzuführen, dass bei AltovaFOPServer die Java VM- und FOP jar-Dateien im Speicher geladen bleiben, wodurch diese Dateien nicht für jede Transformation erneut geladen werden müssen. AltovaFOPServer wird mit Ihrem StyleVision-Paket installiert. Um AltovaFOPServer für Transformationen verwenden zu können, müssen Sie ihn zuerst über die Befehlszeile starten.

Starten von AltovaFOPServer

Die Befehlssyntax zum Starten von AltovaFOPServer lautet:

java -cp "{classPath}" {className} --pid "{pidFile} --port {portNumbers}

Ein Beispiel für einen CLI-Befehl zum Starten von AltovaFOPServer:

java -cp "C:\Programme\Altova\Common2024\jar\gson\gson.jar;C:\Programme\Altova\Common2024\jar\AltovaFOPServer.jar" com.altova.stylevision.fopserver.Main --pid "C:\Users\user\AppData\Local\Temp\AltovaFopServer.pid" --port 9090-9103,9999

Das Argument classPath muss die Pfade zu den Dateien gson.jar und AltovaFOPServer.jar enthalten. Geben Sie die korrekten Pfade dieser Dateien ein.

Aufrufen von AltovaFOPServer in StyleVision Server

Nachdem der AltovaFOPServer gestartet wurde, können Sie ihn von StyleVision Server mit Hilfe des generate-Befehls entweder mit der Option altova-fopserver-pid-file oder altova-fopserver-port aufrufen (siehe Options unten).

StyleVisionServer unter Windows

stylevisionserver unter Windows und Unix (Linux, Mac)

* Beachten Sie, dass klein geschriebene Befehle (stylevisionserver) auf allen Plattformen (Windows, Linux und Mac) funktionieren, während großgeschriebene Befehle (StyleVisionServer) nur unter Windows und Mac ausgeführt werden.

*Verwenden Sie auf Linux und Mac-Systemen Schrägstriche und auf Windows-Systemen umgekehrte Schrägstriche.

Auf Windows-Systemen: Verwenden Sie bei Vorhandensein von Leerzeichen oder Sonerzeichen in Strings (z.B. in Datei- oder Ordnernamen oder Firmen-, Personen- oder Produktnamen) Anführungszeichen: z.B., "Meine Datei". Beachten Sie jedoch, dass ein von einem doppelten Anführungszeichen gefolgter umgekehrter Schrägstrich (z.B: "C:\Mein Verzeichnis\") eventuell nicht korrekt gelesen wird, da der umgekehrte Schrägstrich auch den Beginn einer Escape-Sequenz markiert und die Escape-Sequenz \" für ein doppeltes Anführungszeichen steht. Wenn Sie diese Zeichensequenz mit einem Escape versehen wollen, verwenden Sie einen vorangestellten umgekehrten Schrägstrich, wie den folgenden: \\".  Einfacher ausgedrückt: Wenn Sie einen Dateipfad, der Leerzeichen oder einen umgekehrten Schrägstrich am Ende enthält, schreiben müssen, so schreiben Sie diesen folgendermaßen: "C:\Mein Verzeichnis\\".

--xml, --inputxml = PathToXMLFile

Diese Option ist obligatorisch. Sie definiert den Pfad zu der zu verarbeitenden XML-Datei. Die XML-Datei kann sich innerhalb oder außerhalb der PXF-Datei befinden. Um als Ziel XML-Dateien innerhalb einer PXF-Datei zu definieren, verwenden Sie den Lokator |zip (siehe markierter Teil in den Beispielen oben). Die Option --inputxml wird ignoriert, wenn es sich bei der Hauptschemaquelle der Input-PXF-Datei um eine Datenbank oder eine DB-XML-Quelldatei handelt.

--dbw, --dbwhere = WHEREClause

Eine SQL-WHERE-Klausel, die festlegt, welche Zeilen einer DB-XML-Quelldatei verarbeitet werden sollen.

--p, --param = $ParamName:ParamValue

Weist einem in der PXF-Datei definierten Parameter einen Wert zu. Vor jedem Parameter muss die Option --param verwendet werden. Verwenden Sie Anführungszeichen, wenn ParamName oder ParamValue ein Leerzeichen enthält. Beispiel: --p=$company:"Nanonull Inc"

--prohibit-output-outside-target-folder = true|false

Die Werte sind true|false. Bei Auswahl von true können Ausgabedokumente nur in dem Ordner erstellt werden, in dem die Hauptausgabedatei (HTML, PDF, RTF, DOCX, FO) erstellt wird. Dadurch werden andere Ordner, falls nötig, geschützt. Der Standardwert ist false.

--html, --outhtml = FilePath

Pfad zur zu generierenden HTML-Datei

--pdf, --outpdf = FilePath

Pfad zur zu generierenden PDF-Datei

--rtf, --outrtf = FilePath

Pfad zur zu generierenden RTF-Datei

--docx, --outdocx = FilePath

Pfad zur zu generierenden DOCX-Datei

--text, --outtext = FilePath

Pfad zur zu generierenden Textdatei.

--fo, --outfo = FilePath

Pfad zur zu generierenden FO-Datei

--generate-html-output-as-mime = true|false

Die Werte sind true|false. Wenn die Option nicht definiert ist, ist der Standardwert false. Wenn die Option ohne Wert definiert ist, so ist er true. Bei true wird die HTML-Ausgabe als Mime-Stream generiert.

--altova-fopserver-pid-file = PathToFile

Der Pfad zum PID-Datei, die für die Verbindung mit einem laufenden AltovaFOPServer verwendet werden soll. Sie können die Verbindung zu AltovaFOPServer entweder über die PID-Datei oder einen Port des Servers herstellen. Diese PID-Option ist eine Alternative zur Port-Option (siehe nächste Option). Nähere Informationen zur Verwendung von AltovaFOPServer finden Sie unter der allgemeinen Beschreibung des Befehls generate oben.

--altova-fopserver-port = Value

Eine Port-Nummer oder eine Liste von Port-Nummern, die für die Verbindung zu einem laufenden AltovaFOPServer verwendet werden soll. Die Port-Nummern in einer Liste werden durch Kommas getrennt. Anstelle einer einzigen Nummer kann in der Liste ein Bereich verwendet werden. Daher können Sie als Wert dieser Option 9090-9100,9999 angeben. Beachten Sie, dass Sie die Verbindung zu AltovaFOPServer entweder über die PID-Datei des AltovaFOPServers oder einen Port herstellen können. Diese Port-Option ist eine Alternative zur PID-Option (siehe vorherige Option). Nähere Informationen zur Verwendung von AltovaFOPServer finden Sie unter der allgemeinen Beschreibung des Befehls generate oben.

--taxonomy-package = FilePath

Pfad zu einem zusätzlichen Taxonomiepaket. Fügen Sie die Option mehrmals hinzu, um mehr als ein Taxonomiepaket zu definieren.

--taxonomy-packages-config-file = FilePath

Pfad zur TaxonomyPackagesConfig.json-Datei, einer gemeinsam von den Altova-Produkten XMLSpy, MapForce und StyleVision verwendeten Datei, zum Konfigurieren der XBRL-Taxonomien, die allen diesen Produkten zur Verfügung gestellt werden.

--v, --verbose = true|false

Die Werte sind true|false. Aktiviert bzw. deaktiviert Anzeige aller Meldungen. Der Standardwert ist false, wenn die Option nicht angegeben wird, true, wenn die Option ohne einen Wert angegeben wird.

--l, --lang = en|de|es|fr|ja

Die zur Anzeige der Meldung verwendete Sprache.