valjson (json)

www.altova.com Alle erweitern/reduzieren Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  Befehlszeilenschnittstelle (CLI) > JSON/Avro-Befehle >

valjson (json)

Der Befehl valjson | json validiert ein oder mehrere JSON-Instanzdokumente anhand des mit der Option --schema bereitgestellten JSON-Schemas.

 

Windows

RaptorXML valjson | json [options] --jsonschema=File InputFile

Linux

raptorxml valjson | json [options] --jsonschema=File InputFile

Mac

raptorxml valjson | json [options] --jsonschema=File InputFile

 

 

Beim Argument InputFile handelt es sich um das zu validierende JSON-Instanzdokument. Um mehrere Dokumente zu validieren, (i) listen Sie die zu validierenden Dateien entweder in der Befehlszeilenschnittstelle auf, wobei die einzelnen Dateien durch ein Leerzeichen voneinander getrennt sein müssen oder (ii) listen Sie die zu validierenden Dateien in einer Textdatei (.txt-Datei) auf und zwar einen Dateinamen pro Zeile und geben Sie den Namen dieser Textdatei zusammen mit der auf true gesetzten Option --listfile als InputFile-Argument an (siehe Liste der Optionen unten).

 

 

Beispiele

 

raptorxml valjson --jsonschema=c:\MyJSONSchema.json c:\MyJSONInstance.json
raptorxml json --jsonschema=c:\MyJSONSchema.json c:\MyJSONInstance-01.json c:\MyJSONInstance-02.json
raptorxml json --jsonschema=c:\MyJSONSchema.json --listfile=true c:\FileList.txt

 

Click to expand/collapseGroß- und Kleinschreibung und Schrägstriche in der Befehlszeile

RaptorXML unter Windows

raptorxml unter Unix (Linux, Mac)

 

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

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

 

Optionen

Die Optionen des Befehls sind unterhalb nach Gruppen geordnet aufgelistet. Die Werte aller Optionen können ohne Anführungszeichen angegeben werden. Eine Ausnahme bilden die beiden folgenden Fälle: (i) wenn der Wertstring Leerzeichen enthält oder (ii) wenn in der Beschreibung der Option ausdrücklich angegeben ist, dass Anführungszeichen benötigt werden.

 

Click to expand/collapseValidierung und Verarbeitung
Click to expand/collapseschema, jsonschema

--schema = FILE, --jsonschema = FILE

Definiert den Pfad zu dem JSON-Schema-Dokument, anhand dessen die JSON-Instanzdokumente validiert werden sollen.

 

--listfile = true|false

Bei true wird das Argument InputFile des Befehls als Textdatei behandelt, die einen Dateinamen pro Zeile enthält. Der Standardwert ist false. (Als Alternative können die Dateien im CLI getrennt durch ein Leerzeichen aufgelistet werden. Beachten Sie allerdings, dass CLIs eine maximale Zeichenanzahl haben.) Beachten Sie, dass die Option --listfile nur auf Argumente, nicht aber auf Optionen angewendet wird.

Hinweis:   Die Booleschen Optionswerte werden auf true gesetzt, wenn die Option ohne einen Wert definiert wird.

 

--recurse = true|false

Dient zur Auswahl von Dateien innerhalb von Unterverzeichnissen einschließlich ZIP-Archiven. Bei true wählt das Argument InputFile des Befehls die angegebene Datei auch in den Unterverzeichnissen aus. Beispiel: test.zip|zip\test.xml wählt Dateien mit dem Namen test.xml auf allen Ordnerebenen des ZIP-Ordners aus. Es können die Platzhalter * und ? verwendet werden. Mit *.xml werden folglich alle .xml Dateien im (ZIP-)Ordner ausgewählt. Der Standardwert der Option ist false.

Hinweis:   Die Booleschen Optionswerte werden auf true gesetzt, wenn die Option ohne einen Wert definiert wird.

 

--json5 = true|false

Aktiviert die JSON5-Unterstützung. Der Standardwert ist false.

Hinweis:   Die Booleschen Optionswerte werden auf true gesetzt, wenn die Option ohne einen Wert definiert wird.

 

--jsonschema-version = draft04|draft06|draft07|latest|detect

Definiert, welche Version der JSON-Schema-Draft-Spezifikation verwendet werden soll. Der Standardwert ist detect.

 

--disable-format-checks = true|false

Deaktiviert die durch das Format-Attribut erzwungene semantische Validierung. Der Standardwert ist false.

Hinweis:   Die Booleschen Optionswerte werden auf true gesetzt, wenn die Option ohne einen Wert definiert wird.

 

 

Click to expand/collapseKataloge und globale Ressourcen

--catalog = FILE

Gibt den absoluten Pfad zu einer Root-Katalog-Datei an, die nicht die installierte Root-Katalog-Datei ist. Der Standardwert ist der absolute Pfad zur installierten Root-Katalog-Datei.  (<installationsordner>\Altova\RaptorXMLServer2019\etc\RootCatalog.xml). Informationen zum Arbeiten mit Katalogen finden Sie im Abschnitt XML-Kataloge.

 

--user-catalog = FILE

Definiert den absoluten Pfad zu einem XML-Katalog, der zusätzlich zum Root-Katalog verwendet werden soll.  Informationen zum Arbeiten mit Katalogen finden Sie im Abschnitt XML-Kataloge.

 

--enable-globalresources = true|false

Aktiviert die globalen Ressourcen. Standardwert ist false.

Hinweis:   Die Booleschen Optionswerte werden auf true gesetzt, wenn die Option ohne einen Wert definiert wird.

 

--gc | --globalresourceconfig = VALUE

Definiert die aktive Konfiguration der globalen Ressource (und aktiviert globale Ressourcen).

 

--gr | --globalresourcefile = FILE

Definiert die globale Ressourcendatei (und aktiviert globale Ressourcen).

 

 

Click to expand/collapseMeldungen, Fehler, Hilfe, Timeout, Version

--error-format = text|shortxml|longxml

Definiert das Format der Fehlerausgabe. Der Standardwert ist text. Mit den anderen Optionen werden XML-Formate generiert, wobei mit longxml mehr Details generiert werden.

 

 

--error-limit = N | unlimited

Definiert das Fehlerlimit mit einem Wertebereich von 1 bis 9999 oder unbegrenzt. Der Standardwert ist 100. Bei Erreichung des Fehlerlimits wird die Validierung gestoppt. Dient dazu, die Prozessorverwendung während der Validierung/Transformation einzuschränken.

 

--help

Zeigt den Hilfetext zum Befehl an. Beispiel: valany --h. (Alternativ dazu kann der Befehl help zusammen mit einem Argument verwendet werden. Beispiel: help valany.)

 

--log-output = FILE

Schreibt die Meldungsausgabe in die angegebene URL. Stellen Sie sicher, dass das CLI Schreibrechte für den Ausgabepfad hat.

 

--network-timeout = VALUE

Definiert das Timeout in Sekunden für entfernte I/O-Operationen. Der Standardwert ist: 40.

 

--verbose = true|false

Mit dem Wert true wird die Ausgabe zusätzlicher Informationen bei der Validierung aktiviert. Der Standardwert ist false.

Hinweis:   Die Booleschen Optionswerte werden auf true gesetzt, wenn die Option ohne einen Wert definiert wird.

 

--verbose-output = FILE

Schreibt die ausführliche Ausgabe in FILE.

 

--version

Zeigt die Version von RaptorXML Server an. Setzen Sie --version bei Verwendung mit einem Befehl vor den Befehl.

 

--warning-limit = N | unlimited

Definiert das Warnungslimit im Bereich von 1-65535 oder unbegrenzt. Bei Erreichen dieses Limits wird die Verarbeitung fortgesetzt, doch werden keine weiteren Warnungen mehr ausgegeben. Der Standardwert ist 100.

 

 


© 2019 Altova GmbH