Altova XMLSpy 2027 Professional Edition

Validieren von YAML-Dokumenten

Zur Startseite Zurück Nach oben Weiter

XMLSpy enthält einen YAML-Validierungsprozessor, mit dem folgende Validierungen durchgeführt werden können:

 

•Wenn ein JSON-Schema im YAML-Format das aktive Dokument ist: Validiert das JSON-Schema anhand der referenzierten JSON-Schema-Spezifikation; die Schema-Version wird durch das Schlüsselwort $schema angegeben; die Validierung kann in jeder der folgenden drei Ansichten durchgeführt werden: Text, Grid oder YAML-Schema).

•Wenn ein YAML-Instanzdokument das aktive Dokument ist: Validiert das JSON-Instanzdokument anhand eines JSON-Schemas (im JSON- oder YAML-Format). Das Schema wird der YAML-Instanz, wie unten beschrieben, zugewiesen. Die JSON-Instanzvalidierung kann in der Text- oder der Grid-Ansicht erfolgen.

 

Zuweisen eines JSON-Schemas zu einer YAML-Instanz

YAML-Instanzdokumente können anhand eines JSON-Schemas validiert werden. Das JSON-Schema kann im JSON- oder YAML-Format sein.

 

Um das JSON-Schema zu definieren, anhand dessen ein JSON/YAML-Dokument validiert werden soll, gehen Sie folgendermaßen vor:

 

1.Machen Sie das JSON/YAML-Dokument zum aktiven Dokument.

2.Klicken Sie im Info-Fenster auf dem Register "JSON" (Abbildung unten) auf das Pfeilsymbol neben Validierung anhand von Schema und wählen Sie im daraufhin angezeigten Dropdown-Menü den Befehl JSON-Schema auswählen. Beachten Sie, dass Avro-Unterstützung nur in der XMLSpy Enterprise Edition verfügbar ist. Um YAML-Dokumente zu validieren, können Sie ein JSON-Schema auswählen, das entweder im JSON- oder YAML-Format geschrieben ist, nicht aber ein Avro-Schema.

JSONInfoWindow

3.Daraufhin wird das Dialogfeld "Schema auswählen" angezeigt (Abbildung unten). Sie sehen darin die benannten Schema-Definitionen des Schemas und seine Root. Wählen Sie das Root-Schema oder eine der benannten Schema-Definitionen aus, um eine Schemazuweisung vorzunehmen.

XSOpenAPISelectSchemaDef02

 

Beachten Sie, dass die JSON-Schemazuweisung nicht in das JSON- oder YAML-Dokument geschrieben wird, sondern in das Infofenster eingegeben wird (siehe Abbildung in Schritt 2 oben) und für die Validierung in XMLSpy verwendet wird.

 

Um die Zuweisung zu entfernen, wählen Sie im selben Menü den Befehl Schema entfernen (siehe Abbildung in Schritt 2 oben).

 

Anmerkung: Wenn die JSON- oder YAML-Datei Teil eines XMLSpy-Projekts ist, kann das JSON-Schema für die Validierung auch über das Dialogfeld Projekteigenschaften zugewiesen werden (Option Validieren mit). Wenn Sie einen Projektordner anschließend validieren, werden alle JSON- und YAML-Dateien im Projektordner anhand des JSON-Schemas validiert. Wenn Sie die JSON- und YAML-Validierung separat durchführen möchten, wird empfohlen die einzelnen Dokumenttypen in separaten Projektunterordnern abzulegen.

 

Informationen zum Generieren eines JSON-Schemas anhand einer YAML-Instanz finden Sie im Abschnitt Generieren eines JSON-Schemas anhand einer JSON/YAML-Instanz.

 

Validieren von Instanz- und Schemadokumenten

Wählen Sie den Befehl XML | XML validieren (F8) oder klicken Sie auf die Symbolleisten-Schaltfläche Validieren (F8) ic_validate, um die aktive YAML-Instanz oder das aktive JSON-Schema zu validieren. Wenn ein Instanzdokument validiert wird, muss diesem ein Schema-Dokument zugewiesen sein (siehe oben). Die Validierungsergebnisse werden im Fenster "Meldungen" angezeigt. Fehler werden in der Zeilennummernleiste markiert

 

Anmerkung: Die oben beschriebenen Validierungsfehlermarkierungen und Smart Fix-Vorschläge, werden erst bei Ausführung des Befehls XML | Validieren (F8) aktualisiert; sie werden nicht im Hintergrund aktualisiert. Sie müssen den Befehl Validieren (F8) erneut ausführen, um zu überprüfen, ob der Fehler wirklich behoben wurde.

 

Um vom Instanzdokument aus zum Schema-Dokument zu springen, doppelklicken Sie im Fenster "Info" auf das Schema (siehe Abbildung oben) oder wählen Sie den Befehl DTD/Schema | Gehe zu Schema. Um direkt zur Schema-Definition eins JSON/YAML-Schlüsselworts oder -Objekts zu gehen, wählen Sie das Schlüsselwort oder Objekt im Instanzdokument aus und wählen Sie DTD/Schema | Gehe zu Definition.

 

Sie können mit dem Befehl Validieren auch einen Projektordner mit JSON-Dateien validieren.

 

Bei Änderung validieren

Der Bei Bearbeitung validieren-Modus ist standardmäßig aktiviert. Wenn dieser Modus aktiv ist, werden Wohlgeformtheits- und Validierungsüberprüfungen durchgeführt, während Sie ein Dokument in der Text- oder Grid-Ansicht bearbeiten. Damit ein JSON/YAML-Dokument (nicht nur auf Wohlgeformtheit geprüft, sondern auch) validiert werden kann, muss dem Dokument ein JSON-Schema zugewiesen sein. Fehler im Text werden rot angezeigt. Die Stelle im Dokument wird durch ein rotes Ausrufezeichen markiert. Nähere Informationen dazu finden Sie unter Validieren von JSON-Dokumenten und Validieren von YAML-Dokumenten.

 

Der Bei Bearbeitung validieren-Modus kann entweder (i) über den Menübefehl XML | Bei Bearbeitung validieren, (ii) die Symbolleisten-Schaltfläche Bei Bearbeitung validieren oder (iii) die Option Bei Bearbeitung der Validierungseinstellungen des Dialogfelds "Optionen" aktiviert bzw. deaktiviert werden.

 

© 2020-2026 Altova GmbH