La commande valyaml | yaml valide un ou plusieurs documents d’instance YAML par rapport au schéma JSON fourni avec l’option --schema (--jsonschema).
raptorxml valyaml | yaml [options] --jsonschema=File InputFile |
•L'argument InputFile est le document d'instance YAML à valider.
•Pour valider de multiples documents, soit : (i) lister les fichiers à valider sur la CLI, chaque fichier étant séparé du suivant par un espace ; ou (ii) lister les fichiers à valider dans un fichier texte (fichier .txt), avec un nom de fichier par ligne, et fournir ce fichier de texte en tant que l'argument InputFile avec l'option --listfile définie sur true (voir la liste des Options ci-dessous).).
Exemples
Exemples de la commande valyaml :
•raptorxml valyaml --jsonschema=c:\MyJSONSchema.json c:\MyYAMLInstance.yaml
•raptorxml yaml --jsonschema=c:\MyJSONSchema.json c:\MyYAMLInstance-01.yaml c:\MyYAMLInstance-02.yaml
•raptorxml yaml --jsonschema=c:\MyJSONSchema.json --listfile=true c:\FileList.txt
RaptorXML( et RaptorXMLServer pour des commandes d'administration) sur Windows raptorxml( et raptorxmlserver pour des commandes d'administration) sur Windows et Unix (Linux, Mac) * Veuillez noter que la casse minuscule (raptorxml et raptorxmlserver) fonctionne sur toutes les plate-formes (Windows, Linux et Mac), alors que la casse majuscule (RaptorXML) fonctionne uniquement sur Windows et Mac. * Utiliser des barres obliques basculée vers l'avant sur Linux et Mac, des barres obliques basculées vers l'arrière sur Windows. |
Dans les systèmes Windows : lorsque des espaces se produisent (par exemple, dans les noms de fichier ou de dossier, ou les noms d'entreprise, de personne ou de produit), utiliser des guillemets : par exemple, "My File". Veuillez noter, néanmoins qu'une barre oblique inversée suivie par un double guillemet (par exemple, "C:\My directory\") peut ne pas être lue correctement. Cela est dû au fait que le caractère de barre oblique inversée est également utilisé pour indiquer le début d'une séquence d'échappement, et la séquence d'échappement \" représente le caractère de marque de double guillemet. Si vous souhaitez échapper cette séquence des caractères, utiliser une barre oblique inversée précédente comme ceci : \\". Pour résumer : Si vous souhaitez écrire un chemin de fichier qui contient des espaces et des barre oblique inversée de fin, l'écrire comme ceci : "C:\My Directory\\". |
Options
Les options sont recensées dans la forme abrégée (si disponible) et dans la forme longue. Vous pouvez utiliser un ou deux tirets pour les formes abrégées et longues. Une option peut ou ne peut pas prendre une valeur. Si elle prend une valeur, elle est écrite comme ceci : --option=value. Des valeurs peuvent être spécifiées sans guillemets sauf dans deux cas : (i) si le string valeur contient des espace, ou (ii) s'il est explicitement indiqué dans la description que des guillemets sont exigés. Si une option prend une valeur booléenne et qu'aucune valeur n'est spécifiée, alors la valeur par défaut de l'option est TRUE. Utiliser l'option --h, --help pour afficher des informations à propos de la commande.
.
--schema = FILE, --jsonschema = FILE Spécifie le chemin vers le document de schéma JSON pour utiliser la validation des documents d’instance JSON. |
--jsonschema-format = json|yaml Spécifie le format dans lequel le schéma JSON est écrit : JSON ou YAML. Le défaut est json. |
--jsonschema-version = draft04|draft06|draft07|2019-09|2020-12|oas-3.1|latest|detect Spécifie quelle version du projet de version de la spécification du schéma JSON à utiliser. Le défaut est detect. |
--listfile = true|false Si true, traiter l'argument InputFile de la commande en tant que fichier de texte contenant un nom de fichier par ligne. La valeur par défaut est false. (Une alternative est de lister les fichiers sur la CLI avec un espace en tant que séparateur. Veuillez noter, néanmoins, que les CLI ont une limitation de caractères maximum.) Veuillez noter que l'option --listfile s'applique uniquement aux arguments, et non pas aux options. Note : les valeurs d'option booléennes sont configurées sur true si l'option est spécifiée sans une valeur. |
--additional-schema = FILE Spécifie des URIs d'un document de schéma supplémentaire. Le schéma supplémentaire sera chargé par le schéma principal et peut être référencé depuis le schéma principal par des schémas supplémentaires id ou de propriété $id. |
--recurse = true|false Utilisé pour sélectionner des fichiers dans le cadre de sous-répertoires, y compris des archives ZIP. Si true, l'argument InputFile de la commande sélectionnera aussi le fichier spécifié dans les sous-répertoires. Par exemple : "test.zip|zip\test.xml" sélectionnera des fichiers nommés test.xml à tous les niveaux de dossier du dossier zip. Les références aux fichiers ZIP doivent être indiquées entre guillemets. Les caractères génériques * et ? peuvent être utilisés. Donc, *.xml sélectionnera tous les fichiers .xml dans le dossier (zip). La valeur par défaut de l'option est false. Note : les valeurs d'option booléennes sont configurées sur true si l'option est spécifiée sans une valeur. |
--disable-format-checks = true|false Désactive la validation sémantique imposée par l'attribut de format. La valeur par défaut est false. Note : les valeurs d'option booléennes sont configurées sur true si l'option est spécifiée sans une valeur. |
--strict-integer-checks = true|false Spécifie si des vérifications d'entier plus strictes de draft-04 devraient être utilisées avec des schémas ultérieurs - là où les vérifications d'entier sont moins strictes. Par exemple, 1.0 n'est pas un entier valide dans draft-04, mais est un entier valide dans des drafts ultérieurs. Cette option n'a pas d'effet pour les schémas draft-04. La valeur par défaut de l'option est false. Note : les valeurs d'option booléennes sont configurées sur true si l'option est spécifiée sans une valeur. |
|
--catalog = FILE Spécifie le chemin absolu vers un fichier de catalogue root qui n'est pas le fichier catalogue root installé. La valeur par défaut est le chemin absolu vers le fichier de catalogue root installé (<installation-folder>\Altova\RaptorXMLServer2025\etc\RootCatalog.xml). Voir la section, Catalogues XML, pour plus d'informations à propos du travail avec les catalogues. |
--user-catalog = FILE Spécifie le chemin absolu vers un catalogue XML à utiliser en plus du catalogue root. Voir la section, Catalogues XML, pour plus d'informations concernant le travail avec des catalogues. |
--enable-globalresources = true|false Active les ressources globales. La valeur par défaut est false. Note : les valeurs d'option booléennes sont configurées sur true si l'option est spécifiée sans une valeur. |
|
--error-format = text|shortxml|longxml Spécifie le format de la sortie d'erreur. La valeur par défaut est text. Les autres options génèrent des formats XML, avec longxml générant plus de détails. |
--error-limit = N | unlimited Spécifie la limite d'erreur avec une plage de valeur de 1 à 999 ou unlimited. La valeur par défaut est 100. Le traitement s'arrête lorsque la limite d'erreur est atteinte. Utile pour limiter l'utilisation du processeur pendant la validation/transformation. |
--info-limit = N | unlimited Spécifie la limite de message d'information dans la plage 1-65535 ou unlimited. Le traitement continue si la limite d'info spécifiée est atteinte, mais les messages ultérieurs ne sont pas rapportés. La valeur par défaut est 100. |
--help Affiche le texte d'aide pour la commande. Par exemple, valany --h. (en alternative, la commande help peut être utilisée avec un argument. Par exemple : help valany.) |
--log-output = FILE Écrit la sortie de log dans l'URL de fichier spécifié. Veuillez vous assurer que la CLI a une permission d'écriture dans l'emplacement de la sortie. |
--network-timeout = VALEUR Spécifie le timeout en secondes pour les opérations I/O à distance. La valeur par défaut est : 40000. |
--verbose = true|false Une valeur de true permet la sortie d'informations supplémentaires pendant la validation. La valeur par défaut est false. Note : les valeurs d'option booléennes sont configurées sur true si l'option est spécifiée sans une valeur. |
--verbose-output = FILE Écrit la sortie verbeuse sur FILE. |
--version Affiche la version de RaptorXML Server. Si utilisé avec une commande, placer --version avant la commande. |
--warning-limit = N | unlimited Spécifie la limite d'avertissement dans la plage 1-65535 ou unlimited. Le traitement se poursuit si cette limite a été atteinte, mais d'autres avertissements ne sont pas rapportés. La valeur par défaut est 100. |
|
