L\'action Valider dans le package JSON vous permet de valider le contenu d\'une source de données JSON. Vous pouvez utiliser cette action pour valider la syntaxe, la structure et le schéma de toute source JSON.

Présentation

L\'action Valider vous permet de vérifier la présence d\'éventuelles erreurs dans la source de données JSON avant de la transmettre à toute action en aval. Cette action améliore la fiabilité de l\'automatisation en prévenant les échecs d\'exécution et en réduisant le temps de débogage. Vous pouvez spécifier la source de données JSON, définir les niveaux de validation et enregistrer les résultats de validation dans plusieurs variables ou dans une seule variable de dictionnaire.

L\'action Valider prend en charge la capacité de streaming de fichiers. Vous pouvez utiliser toutes les actions compatibles avec les flux de fichiers pour créer une variable de fichier qui contient le flux de fichiers et utiliser la variable de fichier comme source de données JSON.

Niveaux de validation

Les niveaux de validation suivants sont disponibles dans cette action :

Format
L\'option Format valide la source de données JSON selon les règles de syntaxe telles que le format et la grammaire. Cette option vous permet de vérifier la bonne utilisation des règles de grammaire JSON telles que les accolades {}, les crochets [], les deux-points :, les virgules ,, les guillemets doubles pour les chaînes de caractères, et les littéraux JSON comme true, false et null.
Ce niveau de validation n\'est pas disponible lorsque vous sélectionnez une variable de Dictionnaire comme source de données.
Nœud
L\'option Nœud valide la source de données JSON selon des règles de structure telles que l\'existence d\'un nœud spécifique et son type de données correct. Cette option vous permet de vérifier l\'existence d\'un nœud en spécifiant la clé du nœud ou le chemin du nœud. Vous devez également spécifier le type de données attendu du nœud indiqué dans la liste déroulante Type de valeur.
Schéma
L\'option Schéma valide si la source de données JSON respecte la définition du schéma spécifiée. Cette option englobe à la fois les options Format et Nœud, car le schéma JSON définit la grammaire JSON, les nœuds, les types de données, les champs obligatoires/facultatifs, les valeurs d\'énumération, ainsi que les valeurs maximales et minimales.
Remarque : Assurez-vous de spécifier la version du brouillon du schéma JSON dans la variable ou la chaîne du fichier de définition du schéma. Si vous ne spécifiez pas la version, l\'action Valider utilise la spécification JSON schema draft 2020-12 comme option par défaut pour valider la source de données JSON.

Résultats de validation

L\'action Valider vous permet d\'enregistrer les résultats de la validation en tant que variables individuelles ou comme une seule variable de dictionnaire. L\'exécution de l\'automatisation échoue uniquement en cas de défaillance de la plateforme, telle que l\'existence de la valeur Null dans la source de données JSON. Les résultats de validation sont enregistrés dans les clés suivantes :

isvalid
La clé isvalid contient le résultat de la validation de la source JSON. Les valeurs potentielles sont les suivantes :
  • true : Si la validation est réussie.
  • false : Si la validation échoue.
validationlevel
La clé validationlevel contient le niveau de validation que vous avez défini lors de la configuration de l\'action. Les valeurs potentielles sont les suivantes :
  • syntax : Si le niveau de validation est défini comme Format.
  • structure : Si le niveau de validation est défini comme Nœud.
  • schema : Si le niveau de validation est défini comme Schéma.
errorpath
La clé errorpath contient le chemin dans la source de données JSON où l\'erreur est présente.
error message
La clé error message contient le message d\'erreur. Par exemple, si le schéma JSON définit un nombre mais que la source de données JSON fournit une chaîne à cet emplacement, la clé error message stocke ce message d\'erreur string found, integer expected comme sa valeur.