Die Validieren-Aktion im JSON-Paket ermöglicht es Ihnen, den Inhalt einer JSON-Datenquelle zu validieren. Sie können diese Aktion verwenden, um die Syntax, Struktur und das Schema jeder JSON-Quelle zu validieren.

Übersicht

Die Validieren-Aktion ermöglicht es Ihnen, potenzielle Fehler in der JSON-Datenquelle zu überprüfen, bevor Sie sie an nachgelagerte Aktionen weitergeben. Diese Maßnahme verbessert die Zuverlässigkeit der Automatisierung, indem sie Laufzeitfehler verhindert und die Debugging-Zeit reduziert. Sie können die JSON-Datenquelle angeben, die Validierungsstufen festlegen und die Validierungsergebnisse in mehreren Variablen oder einer einzelnen Wörterbuchvariablen speichern.

Die Validieren-Aktion unterstützt die Dateistream-Funktionalität. Sie können beliebige dateistreamfähige Aktionen verwenden, um eine Dateivariable zu erstellen, die den Dateistream enthält, und die Dateivariable als JSON-Datenquelle verwenden.

Validierungsstufen

Die folgenden Validierungsstufen sind in dieser Aktion verfügbar:

Format
Die Option Format überprüft die JSON-Datenquelle auf Syntaxregeln wie Format und Grammatik. Diese Option ermöglicht es Ihnen, die korrekte Verwendung der JSON-Grammatikregeln wie geschweifte Klammern {}, eckige Klammern [], Doppelpunkt :, Kommas ,, doppelte Anführungszeichen für Zeichenfolgen und JSON-Literale wie true, false und null zu überprüfen.
Diese Validierungsstufe ist nicht verfügbar, wenn Sie eine Wörterbuch-Variable als Datenquelle auswählen.
Knoten
Die Option Knoten validiert die JSON-Datenquelle hinsichtlich Strukturregeln wie dem Vorhandensein eines bestimmten Knotens und dessen korrektem Datentyp. Diese Option ermöglicht es Ihnen, das Vorhandensein eines Knotens zu überprüfen, indem Sie den Knotenschlüssel oder den Knotenpfad angeben. Sie müssen außerdem den erwarteten Datentyp des angegebenen Knotens im Werttyp-Dropdown-Menü angeben.
Schema
Die Schema-Option überprüft, ob die JSON-Datenquelle der angegebenen Schemadefinition entspricht. Diese Option umfasst sowohl die Format- als auch die Knoten-Optionen, da das JSON-Schema die JSON-Grammatik, Knoten, Datentypen, erforderliche/Optional-Felder, Enum-Werte sowie Maximal- und Minimalwerte definiert.
Anmerkung: Achten Sie darauf, dass Sie die JSON-Schema-Entwurfsversion in der Schema-Definitionsdatei-Variable oder der Zeichenfolge angeben. Wenn Sie die Version nicht angeben, verwendet die Aktion Validieren standardmäßig die Spezifikation JSON schema draft 2020-12, um die JSON-Datenquelle zu validieren.

Validierungsergebnisse

Die Validieren-Aktion ermöglicht es Ihnen, die Validierungsergebnisse als einzelne Variablen oder als eine einzelne Wörterbuchvariable zu speichern. Die Ausführung der Automatisierung schlägt nur fehl, wenn ein Plattformfehler vorliegt, wie zum Beispiel das Vorhandensein des Wertes Null in der JSON-Datenquelle. Die Validierungsergebnisse werden unter den folgenden Schlüsseln gespeichert:

isvalid
Der isvalid-Schlüssel enthält das Validierungsergebnis der JSON-Quelle. Die folgenden Werte sind möglich:
  • true: Wenn die Validierung erfolgreich ist.
  • false: Falls die Validierung fehlschlägt.
validationlevel
Der Schlüssel validationlevel enthält die Validierungsstufe, die Sie beim Konfigurieren der Aktion festgelegt haben. Die folgenden Werte sind möglich:
  • Syntax: Wenn die Validierungsstufe auf Format gesetzt ist.
  • structure: Wenn die Validierungsstufe auf Knoten festgelegt ist.
  • schema: Wenn die Validierungsstufe auf Schema festgelegt ist.
errorpath
Der errorpath Schlüssel enthält den Pfad in der JSON-Datenquelle, an dem der Fehler vorhanden ist.
error message
Der error message-Schlüssel enthält die Fehlermeldung. Wenn das JSON-Schema beispielsweise eine Zahl definiert, aber die JSON-Datenquelle an derselben Stelle eine Zeichenkette bereitstellt, speichert der Schlüssel error message diese Fehlermeldung string found, integer expected als seinen Wert.