En XMLSpy puede generar un esquema JSON a partir de un documento YAML. Esta función es muy útil ya que proporciona rápidamente un esquema JSON basado en un documento YAML que ya existe. Por lo tanto, ya no es necesario crear el esquema a mano y desde cero. Tras generar el esquema, podrá modificarlo o ampliarlo según sus requisitos.

Generar el esquema JSON

Hay varias maneras de generar un esquema JSON a partir de un documento YAML:

•Menú DTD/Esquema: El documento activo debe ser el documento YAML. Seleccione el comando de menú DTD/Esquema | Generar DTD o esquema.

•Ventana Información JSON: El documento activo debe ser el documento YAML. 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ú desplegable que aparece, seleccione Generar esquema JSON.

En ambos casos aparece el cuadro de diálogo Generar esquema JSON (ver imagen en la siguiente sección). Ahora siga estos pasos:

1.Aquí puede configurar cómo se lleva a cabo la generación (ver detalles a continuación) y haga clic en Aceptar para terminar.

2.La aplicación solicita una ruta de acceso y nombre de archivo para el esquema JSON que se generará. Introduzca esos datos.

3.Cuando haga clic en Guardar el esquema JSON se generará y será el documento activo de la vista.

El archivo de esquema generado se asignará al archivo de instancia YAML para su validación (ver la ventana Información en la imagen interior), sobrescribiendo cualquier asignación realizada con anterioridad. Para cambiar la asignación, haga clic en el comando Seleccionar esquema JSON del menú desplegable de la ventana de información JSON (imagen anterior). Para más información sobre cómo validar los documentos YAML, consulte el apartado Validar documentos YAML.

Convertir esquemas JSON en formato YAML

Si desea convertir un esquema JSON (que está en formato JSON) en YAML, utilice el comando de menú Conversión | Convertir JSON en YAML y viceversa.

Configuración para generar el esquema JSON

Puede configurar las opciones de generación de esquemas JSON en el cuadro de diálogo "Generar esquema JSON" (imagen siguiente). Consulte la sección previa para más información sobre cómo acceder a este cuadro de diálogo.

Detectar tuplas de matriz

Una tupla de matriz es la secuencia de elementos de una matriz. Por ejemplo, esta matriz tiene una tupla de tres elementos: [ 1, 2, "abc" ]. Para la validación de matrices el esquema puede especificar si debe tenerse en cuenta o no el orden y el tipo de datos de los elementos de las matrices (tuplas). Si marca la casilla Detectar tuplas de matriz (ver imagen anterior), entonces se tendrá en cuenta el orden y el tipo de datos de los elementos. Dependiendo de lo que se detecte, se creará una definición en el esquema. Esta definición puede configurarse con estas opciones:

•Número de elementos de la tupla: puede especificar un máximo y un mínimo de elementos de tupla. Si una tupla de la instancia tiene un número de elementos comprendido entre este máximo y mínimo, la matriz se detecta y se define.

•Limitar detección a tipos simples: solamente se tendrán en cuenta las tuplas que tengan ítems de tipo simple (tipos atómicos string, number, integer, boolean y null).

•Limitar detección a matrices que tengan el mismo nombre: solamente se tendrán en cuenta las matrices que se definan como valores de propiedades que tengan el mismo nombre. Por ejemplo, en este fragmento de datos JSON, las matrices marcadas en rojo son valores de propiedades llamadas a1 (marcadas con fondo azul): {"object1": [ { "a1": [ 1, 2, "abc" ] },  { "a1": [ 3, 4, "def" ] }, { "a1": [ 5, 6, "ghi" ] } ] }.

•Número mínimo de matrices: puede especificar el número mínimo de matrices necesarias para la detección de matrices.

Otras opciones

•Omitir el orden de los nombres de propiedad de los objetos: si no marca esta opción, se comprueba el orden de las propiedades de los objetos y se recrea de la forma lo más exacta posible. De lo contrario, no se comprueba el orden.

•Intentar que el formato de cadena coincida: el esquema puede especificar que los tipos de datos string tengan un formato concreto. Si marca esta opción, XMLSpy intentará detectar el formato de cadena y en la medida de lo posible añadirá una definición de formato a las cadenas.

•Convertir matrices simples en locales: una matriz simple es aquella cuyos elementos tienen el mismo tipo de datos simple. Si marca esta opción, todas las matrices simples se definirán localmente en el esquema, en lugar de usar definiciones globales a las que se hace referencia localmente.

•Convertir objetos simples en locales: un objeto simple es aquél cuyos valores de propiedades tienen el mismo tipo de datos simple. Si marca esta opción, todos los objetos simples se definirán localmente en el esquema, en lugar de usar definiciones globales a las que se hace referencia localmente.