La commande valxsd | xsd valide un ou plusieurs documents de Schéma XML (documents XSD) conformément à la spécification de langue de définition de Schéma XML W3C (XSD) 1.0 ou 1.1. Veuillez noter que c'est le schéma lui-même qui est validé par rapport à la spécification de Schéma XML, et non pas un document d'instance XML par rapport à un Schéma XML.
raptorxml valxsd | xsd [options] InputFile |
•L'argument InputFile est le document de Schéma XML à valider. L'option --xsd-version=1.0|1.1|detect spécifie la version XSD par rapport à laquelle valider, le défaut étant 1.0.
•Pour valider de multiples documents, soit : (i) recensez les fichiers à valider dans le CLI, avec chaque fichier séparé du prochain par un espace ; ou (ii) recensez les fichiers à valider dans un fichier texte (fichier .txt), avec un nom de fichier par ligne, et fournissez ce fichier texte en tant qu'argument InputFile ensemble avec l'option --listfile définie comme true (voir les Options dans la liste ci-dessous).
Exemples
Exemples de la commande valxsd
•raptorxml valxsd c:\Test.xsd
•raptorxml xsd --verbose=true c:\Test.xsd
•raptorxml xsd --listfile=true c:\FileList.txt
RaptorXML (and RaptorXMLServer for administration commands) on Windows raptorxml (and raptorxmlserver for administration commands) on Windows and Unix (Linux, Mac) * Note that lowercase (raptorxml and raptorxmlserver) works on all platforms (Windows, Linux, and Mac), while upper-lower (RaptorXML) works only on Windows and Mac. * Use forward slashes on Linux and Mac, backslashes on Windows. |
On Windows systems: When spaces or special characters occur in strings (for example in file or folder names, or company, person or product names), use quotes: for example, "My File". Note, however, that a backslash followed by a double-quotation mark (for example, "C:\My directory\") might not be read correctly. This is because the backslash character is also used to indicate the start of an escape sequence, and the escape sequence \" stands for the double-quotation mark character. If you want to escape this sequence of characters, use a preceding backslash, like this: \\". To summarize: If you need to write a file path that contains spaces or an end backslash, write it like this: "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.
.
--ct-restrict-mode = 1.0|1.1|default Spécifie comment contrôler les restrictions de type complexes. Une valeur de 1.0 contrôles les restrictions de type complexes telles que définies dans la spécification XSD 1.0 — même dans le mode de validation XSD 1.1. Une valeur de 1.1 contrôles les restrictions de type complexe telles que définies dans la spécification XSD 1.1 — même dans le mode de validation XSD 1.0. Une valeur de default contrôle les restrictions de type complexes telles que définies dans la spécification XSD du mode de validation actuel (1.0 ou 1.1). La valeur par défaut est default. |
--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. |
--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. |
--report-import-namespace-mismatch-as-warning = true|false Réduit des erreurs de non-correspondance d'espace de noms ou d'espace de noms cible lors de l'importation de schémas avec xs:import et les fait passer d'erreurs à des avertissements. 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. |
--schema-imports = load-by-schemalocation | load-preferring-schemalocation | load-by-namespace | load-combining-both | license-namespace-only Spécifie le comportement des éléments xs:import, chacun d'entre eux ayant un attribut namespace optionnel et un attribut schemaLocation optionnel : <import namespace="someNS" schemaLocation="someURL">. L'option spécifie s'il faut charger un document de schéma ou juste mettre un espace de noms sous licence, et, si un document de schéma doit être chargé, quelle information doit être utilisée pour le trouver. Défaut : load-preferring-schemalocation. Le comportement est le suivant : •load-by-schemalocation: La valeur de l'attribut schemaLocation est utilisée pour situer le schéma, en prenant en compte les mappages de catalogue. Si l'attribut de l'espace de nom est présent, l'espace de noms est importé (licencé). •load-preferring-schemalocation: Si l'attribut schemaLocation est présent, il est utilisé en prenant en compte les mappages de catalogue. Si l'attribut schemaLocation est présent, la valeur de l'attribut namespace est utilisée via un mappage de catalogue. C'est la valeur par défaut. •load-by-namespace: La valeur de l'attribut namespace est utilisée pour situer le schéma via un mappage de catalogue. •load-combining-both: Si soit l'Attribut namespace ou l'attribut schemaLocation a un mappage de catalogue, le mappage est utilisé. Si les deux ont des mappages de catalogue, alors la valeur de l'option --schema-mapping (option XML/XSD) décide de quel mappage utiliser. Si aucun mappage de catalogue n'est présent, l'attribut schemaLocation est utilisé. •license-namespace-only: Le nom d'espace est importé. Aucun document de schéma n'est importé. |
--schemalocation-hints = load-by-schemalocation | load-by-namespace | load-combining-both | ignore Spécifie le comportement des attributs xsi:schemaLocation et xsi:noNamespaceSchemaLocation : S'il faut charger un document de schéma et, si oui, quelle information doit être utilisée pour la trouver. Défaut : load-by-schemalocation. •La valeur load-by-schemalocation utilise l'URL de l'emplacement de schéma dans les attributs xsi:schemaLocation et xsi:noNamespaceSchemaLocation dans les documents d'instance XML. Il s'agit de la valeur par défaut. •La valeur load-by-namespace prend la part d'espace de nom xsi:schemaLocation et un string vide dans le cas de xsi:noNamespaceSchemaLocation et localise le schéma par le biais d'un mappage de catalogue. •Si load-combining-both est utilisé et si soit la partie espace de noms ou la partie URL a un mappage de catalogue, alors le mappage de catalogue est utilisé. Si tous deux ont des mappages de catalogue, alors la valeur de l'option de --schema-mapping (option XML/XSD) de quel mappage utiliser. Si ni l'espace de noms ni l'URL n'a un mappage de catalogue, l'URL est utilisée. •Si la valeur de l'option est ignore, les attributs xsi:schemaLocation et xsi:noNamespaceSchemaLocation seront ignorés tous les deux. |
--schema-mapping = prefer-schemalocation | prefer-namespace Si l'emplacement de schéma et l'espace de noms sont tous les deux utilisés pour trouver un document de schéma, spécifie lequel des deux doit être utilisé pendant la consultation du catalogue. (Si soit l'option --schemalocation-hints ou l'option --schema-imports a une valeur de load-combining-both, et si les parties d'espace de noms et d'URL impliquées ont toutes les deux des mappages de catalogue, alors la valeur de cette option spécifie lequel des deux mappages utiliser (mappage d'espace de noms ou mappage URL ; la valeur prefer-schemalocation réfère au mappage URL).) Défaut : prefer-schemalocation. |
--script = FILE Exécute le script Python dans le fichier soumis une fois que la validation a été terminée. Ajouter l'option plusieurs fois pour spécifier plus d'un seul script. |
--api, --script-api-version = 1; 2; 2.1; 2.2; 2.3; 2.4; 2.4.1; 2.5; 2.6; 2.7; 2.8; 2.8.1; 2.8.22.8.6 Spécifie la version API Python à utiliser pour le script. La valeur par défaut est la dernière version, actuellement 2.8.6. À la place des valeurs entières 1 et 2, vous pouvez aussi utiliser les valeurs correspondantes 1.0 et 2.0. De la même manière, vous pouvez utiliser les trois chiffres 2.5.0 pour les deux 2.5. Voir aussi le chapitre Versions Python API. |
--script-output = FILE Rédige la sortie standard du script dans le fichier nommé dans FILE. |
--script-param = KEY:VALUE Des paramètres spécifiés par l'utilisateur supplémentaires qui peuvent être accédés au cours de l'exécution des scripts Python. Ajouter l'option plusieurs fois pour spécifier plus d'un paramètre de script. |
--xinclude = true|false Active la prise en charge de XML Inclusions (XInclude). La valeur par défaut est false. Si false, les élément include d'XInclude sont ignorés. Note : les valeurs d'option booléennes sont configurées sur true si l'option est spécifiée sans une valeur. |
--xml-mode-for-schemas = wf|id|valid Spécifie le mode de traitement XML à utiliser pour les documents de schéma XML : wf=vérification de la bonne formation ; id=contrôles de la bonne formation avec ID/IDREF ; valid=validation. La valeur par défaut est wf. Veuillez noter qu'une valeur de valid exige que chaque document de schéma chargé pendant le traitement référence un DTD. Si aucun DTD n'existe, une erreur est rapportée. |
--xsd-version = 1.0|1.1|detect Spécifie la version du langage de définition de Schéma W3C (XSD) à utiliser. Le défaut est 1.0. Cette option peut être utile pour découvrir comment un schéma compatible à 1.0 n'est pas compatible à 1.1. L'option detect est une fonction spécifique à Altova. Elle permet la détection de la version du document de Schéma XML (1.0 ou 1.1) en lisant la valeur de l'attribut vc:minVersion de l'élément du document <xs:schema>. Si la valeur de l'attribut @vc:minVersion est 1.1, le schéma est détecté comme étant de version 1.1. Pour toute autre valeur, ou si l'attribut @vc:minVersion est absent, le schéma est détecté comme étant de version 1.0. |
|
--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\RaptorXMLServer2024\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. |
|
