Validar documentos YAML
XMLSpy incluye un motor de validación YAML que se puede invocar de dos maneras:
•Si el documento activo es un esquema JSON en formato YAML: valida el esquema JSON con la especificación JSON Schema referenciada. La versión del esquema viene indicada por la palabra clave $schema. La validación puede realizarse desde cualquiera de las vistas de edición (Texto, Cuadrícula o Esquema YAML).
•Si el documento activo es una instancia YAML: valida la instancia YAML con a un esquema JSON (en formato JSON o YAML). El esquema se asigna a la instancia YAML tal y como se explica más abajo. La validación de instancias JSON se puede realizar tanto en la vista Texto como en la vista Cuadrícula.
Asignar un esquema JSON a una instancia YAML
Los documentos de instancia YAML se pueden validar con esquemas JSON. El esquema JSON puede estar en formato JSON o formato YAML.
Para definir el esquema JSON con el que desea validar un documento JSON o YAML, haga lo siguiente:
1.El documento activo debe ser el documento JSON/YAML.
2.En la pestaña JSON de la ventana Información (imagen siguiente), haga clic en el icono en forma de flecha situado junto a Validación con esquema y, en el menú que aparece, haga clic en Seleccionar esquema JSON. Para validar documentos YAML, puedes seleccionar un esquema JSON que esté escrito en formato JSON o en formato YAML, pero no un esquema Avro.
Tenga en cuenta que la asignación del esquema JSON no se escribe en el documento JSON o YAML, sino que se introduce en la ventana Información (imagen anterior) y se utiliza para la validación en XMLSpy.
Para eliminar la asignación, seleccione el comando Quitar esquema del mismo menú (imagen anterior).
Nota: | Si el archivo JSON o YAML forma parte de un proyecto XMLSpy, también puede asignar el esquema JSON o Avro para la validación a través del cuadro de diálogo Propiedades del proyecto (utilice la opción Validar con de este cuadro de diálogo). Si ahora, tras la asignación del esquema, valida una carpeta de proyecto, todos los archivos JSON y YAML de la carpeta de proyecto se validarán con el esquema JSON. Si desea ejecutar las validaciones de JSON y YAML por separado, le recomendamos que guarde cada tipo de documento en una subcarpeta distinta del proyecto. |
Para aprender a generar un esquema JSON a partir de una instancia YAML, consulte el apartado Generar esquemas JSON a partir de instancias JSON/YAML.
Validar documentos de instancia y documentos de esquema
Para validar la instancia YAML activa o el esquema JSON activo, seleccione el comando XML | Validar XML (F8) o haga clic en el icono Validar (F8) de la barra de herramientas. Si se trata de un documento de instancia, debe tener asignado un esquema (ver más arriba). Los resultados de la validación aparecen en la ventana Mensajes. Los errores también se señalan en el margen de numeración de líneas.
Nota: | Los indicadores de errores de validación y las soluciones rápidas que se describen más arriba sólo se actualizan si se ejecuta el comando XML | Validar (F8), pero no se actualizan en segundo plano. Es decir, tras corregir un error de validación, vuelva a ejecutar el comando Validar (F8) para asegurarse de que el error está solucionado. |
Para ir al documento de esquema desde el documento de instancia, haga doble clic en el esquema en la ventana Información (ver imagen anterior) o seleccione el comando DTD/Esquema| Ir al esquema. Para ir a la definición de esquema de una palabra clave o de un objeto JSON/YAML directamente, seleccione el elemento en el documento de instancia y haga clic en el comando DTD/Esquema | Ir a la definición.
También puede validar una carpeta de proyecto que contenga archivos JSON con solo ejecutar el comando Validar.
Validar al modificar
El modo Validar al editar, está activado por defecto, permite validar un documento y comprobar si su formato es el correcto mientras lo modifica en la vista Texto o Cuadrícula. Para validar un documento JSON/YAML (además de comprobar su formato) debe asignar un esquema JSON a ese documento. Si hay errores, el texto que los contiene aparece en rojo y el lugar del error se marca con un signo rojo de exclamación. Para más información consulte Validar documentos JSON y Validar documentos.
El modo Validar al editar se puede activar y desactivar (i) con el comando de menú XML | Validar al editar, (ii) el botón Validar al editar de la barra de herramientas o (iii) con la opción Al editarlos de las las opciones de validación del cuadro de diálogo "Opciones".