El comando valyaml | yaml valida uno o varios documentos de instancia YAML con el esquema JSON facilitado con la opción --schema (--jsonschema).
raptorxml valyaml | yaml [opciones] --jsonschema=Archivo ArchivoDeEntrada |
•El argumento ArchivoDeEntrada es el documento de instancia YAML que se quiere validar.
•Para validar varios documentos, puede: (i) enumerar en la línea de comandos los archivos que quiere validar separando los archivos con un espacio, o (ii) enumerar en un archivo de texto (.txt) los archivos que quiere validar, escribiendo un nombre de archivo por línea, y dar este archivo de texto como argumento ArchivoDeEntrada junto con la opción --listfile, que debe establecer en true (ver la lista de opciones más abajo).
Ejemplos
Ejemplos de uso del comando valyaml:
•raptorxml valyaml --jsonschema=c:\MiEsquemaJSON.json c:\MiInstanciaYAML.yaml
•raptorxml yaml --jsonschema=c:\MiEsquemaJSON.json c:\MiInstanciaYAML-01.yaml c:\MiInstanciaYAML-02.yaml
•raptorxml yaml --jsonschema=c:\MiEsquemaJSON.json --listfile=true c:\ListaDeArchivos.txt
RaptorXML (y RaptorXMLServer para comandos administrativos) en Windows raptorxml (y raptorxmlserver para comandos administrativos) en Windows y Unix (Linux, Mac) * Las minúsculas (raptorxml y raptorxmlserver) funcionan en todas las plataformas (Windows, Linux y Mac), mientras que las mayúsculas (RaptorXML) funcionan solamente en Windows y Mac. * Use la barra diagonal en Linux y Mac y la barra diagonal inversa en Windows. |
En sistemas Windows: si hay espacios o caracteres especiales (por ejemplo en los nombres de archivos o de carpetas, empresas, personas o productos) debe usar comillas: por ejemplo, "Mi archivo". Sin embargo, debe tener en cuenta que una barra diagonal inversa seguida de comillas dobles (por ejemplo, "C:\Mi Directorio\") es posible que no se lea correctamente. Esto se debe a que la barra diagonal inversa también se usa para empezar secuencias de escape y la secuencia de escape \" también usa las comillas dobles. Para evitar secuencia de caracteres puede añadir otra barra diagonal inversa: \\". En resumen: si necesita escribir una ruta que contenga espacios y una barra diagonal inversa, esta es la mejor forma de hacerlo: "C:\Mi Directorio\\". |
Opciones
Las opciones del comando aparecen más abajo divididas en grupos. Los valores se pueden dar sin comillas excepto en estos dos casos: (i) cuando la cadena de valor contiene espacios y (ii) cuando en la descripción de la opción se indique explícitamente que es necesario el uso de comillas. Si una opción toma un valor booleano y no se indica ningún valor, entonces el valor predeterminado de la opción es TRUE. Use la opción --h, --help para ver información sobre el comando.
--schema = ARCHIVO, --jsonschema = ARCHIVO Indica la ruta de acceso del documento de esquema JSON que se utilizará para la validación de los documentos de instancia JSON. |
--jsonschema-format = json|yaml Especifica el formato en el que se escribe el esquema JSON: JSON o YAML. El valor predeterminado es json. |
--jsonschema-version = draft04|draft06|draft07|2019-09|2020-12|oas-3.1|latest|detect Indica qué versión del borrador de la especificación del esquema JSON debe utilizarse. El valor predeterminado es detect. |
--listfile = true|false Si el valor es true, el argumento ArchivoEntrada del comando se entiende como un archivo de texto que contiene un nombre de archivo por línea. Otra opción es enumerar los archivos en la ILC, separados por un espacio. No obstante, recuerde que las ILC tienen un límite de caracteres. Además, no olvide que la opción --listfile solamente afecta a los argumentos y no a las opciones. Valor predeterminado: false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--additional-schema = FILE Indica los URIs de un documento de esquema suplementario. El esquema suplementario se carga desde el principal y se puede hacer referencia a él también desde el esquema principal con la propiedad id o $id del esquema suplementario. |
--recurse = true|false Esta opción se utiliza para seleccionar ficheros dentro de subdirectorios (incluso en archivos ZIP). Si el valor es true, el argumento ArchivoEntrada del comando seleccionará el fichero seleccionado también en los subdirectorios. Por ejemplo: "test.zip|zip\test.xml" seleccionará los ficheros llamados test.xml en todos los subdirectorios de la carpeta ZIP. Si quiere puede usar los caracteres comodín * y ?. Por ejemplo: *.xml seleccionaría todos los ficheros de la carpeta ZIP que tengan la extensión .xml. Valor predeterminado: false Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--disable-format-checks = true|false Deshabilita la validación semántica impuesta por el atributo de formato. El valor predeterminado es false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--strict-integer-checks = true|false Indica si se debe usar la comprobación estricta de números enteros del borrador draft-04 con esquemas posteriores donde las comprobaciones de números enteros son más laxas. Por ejemplo, 1.0 no es un número entero válido en draft-04 pero sí en borradores posteriores. Esta opción no afecta a los esquemas de draft-04. El valor predeterminado de esta opción es false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
|
--catalog = ARCHIVO Especifica la ruta de acceso absoluta a un archivo de catálogo que no está en el archivo de catálogo raíz instalado. El valor predeterminado es la ruta de acceso absoluta del archivo de catálogo raíz instalado (<carpeta-instalación>\Altova\RaptorXMLServer2025\etc\RootCatalog.xml). Consulte el apartado Catálogos XML para obtener más información. |
--user-catalog = ARCHIVO Especifica la ruta de acceso absoluta a un catálogo XML que debe utilizarse junto con el catálogo raíz. Consulte el apartado Catálogos XML para obtener más información. |
--enable-globalresources = true|false Habilita la función de recursos globales. Valor predeterminado: false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
|
--error-format = text|shortxml|longxml Especifica el formato de la salida de error. Los valores posibles son formatos de texto, XML y XML detallado (longxml). Valor predeterminado: text. |
--error-limit = N | unlimited Especifica el límite de errores con un valor comprendido entre 1 y 9999 o unlimited (ilimitado). El valor predeterminado es 100. Cuando se alcanza el límite de error, se detiene la validación. Esta opción es muy práctica a la hora de limitar el uso del procesador durante la validación o transformación. |
--info-limit = N | unlimited Indica el límite del mensaje de información dentro del rango 1-65535 or unlimited. Si se alcanza el límite de información indicado, el procesamiento continúa pero ya no se informa de más mensajes. El valor predeterminado es 100. |
--help Muestra el texto de ayuda para el comando. Por ejemplo valany --h. (Otra opción es usar el comando help con un argumento. Por ejemplo: help valany). |
--listfile = true|false Si el valor es true, el argumento ArchivoEntrada del comando se entiende como un archivo de texto que contiene un nombre de archivo por línea. Otra opción es enumerar los archivos en la ILC, separados por un espacio. No obstante, recuerde que las ILC tienen un límite de caracteres. Además, no olvide que la opción --listfile solamente afecta a los argumentos y no a las opciones. Valor predeterminado: false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--log-output = ARCHIVO Escribe el registro de salida en la URL de archivo indicada. Compruebe que la ILC tiene permiso de escritura en la ubicación de destino. |
--network-timeout = VALOR Indica el tiempo de espera en milisegundos para operaciones remotas de entrada y salida. Valor predeterminado: 40000. |
--recurse = true|false Esta opción se utiliza para seleccionar ficheros dentro de subdirectorios (incluso en archivos ZIP). Si el valor es true, el argumento ArchivoEntrada del comando seleccionará el fichero seleccionado también en los subdirectorios. Por ejemplo: "test.zip|zip\test.xml" seleccionará los ficheros llamados test.xml en todos los subdirectorios de la carpeta ZIP. Si quiere puede usar los caracteres comodín * y ?. Por ejemplo: *.xml seleccionaría todos los ficheros de la carpeta ZIP que tengan la extensión .xml. Valor predeterminado: false Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--verbose = true|false Si el valor es true, se genera información adicional durante la validación. Valor predeterminado es false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--verbose-output = ARCHIVO Escribe el resultado detallado en el ARCHIVO indicado. |
--version Muestra el número de versión de RaptorXML Server. Si se utiliza con un comando, escriba la opción --version antes del comando. |
--warning-limit = N | unlimited Especifica el límite de advertencia en el rango 1-65535 o unlimited (ilimitado). El procesamiento continua si se alcanza el límite pero no se registrarán más advertencias. El valor por defecto es 100. |
|
