Esquemas JSON

www.altova.com Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  Guía y referencia del usuario > JSON y esquemas JSON >

Esquemas JSON

Al igual que los esquemas XML especifican la estructura y el contenido de un documento XML, los esquemas JSON especifican cómo se organizan los datos JSON en un documento JSON. Es decir, especifica qué campos de datos deben aparecer y cómo se representan lo valores. Aquí puede consultar la especificación JSON Schema y obtener más información sobre la misma.

 

Un esquema JSON es un objeto JSON en sí mismo. El esquema entero está entre llaves, que son lo delimitadores de los objetos JSON. Los esquemas están escritos en sintaxis JSON y se suele guardar con la extensión de archivo .json. Además, se sabe que es un esquema JSON porque la primera palabra clave del objeto de nivel superior del documento es $schema, que además debe tener el valor "http://json-schema.org/draft-N/schema#", donde N es el número de la versión. A continuación se muestra un ejemplo de cómo se usa la palabra clave $schema.

 

{

   "$schema": "http://json-schema.org/draft-07/schema#",

   ...

}

 

Nota:aunque la palabra clave $schema puede tener el valor "http://json-schema.org/schema#", que especifica la última versión del esquema, es mejor utilizar una URL que identifique la versión concreta. Para más información consulte el apartado Versión del esquema JSON.

 

 

En XMLSpy puede crear esquemas JSON de forma gráfica en la vista Esquema JSON, tal y como explicamos en la sección Vista Esquema JSON de este manual. Además de múltiples funciones de edición, la vista Esquema JSON ofrece estas funciones para trabajar con esquemas:

 

Validación con el validador JSON de XMLSpy: asigne un esquema JSON al documento de instancia y compruebe su validez desde XMLSpy. Consulte el apartado Validar documentos JSON para obtener más información.
Generación de esquemas JSON a partir de instancias JSON: si ya tiene un documento de instancia JSON, puede usarlo para generar un esquema JSON.
Conversión de datos JSON en XML y viceversa.

 

Terminología

A continuación puede consultar la definición de los términos de esquemas JSON más utilizados en la interfaz gráfica y en este manual.

 

Término

Definición

Esquema

Objeto de esquema de nivel superior del documento de esquema JSON. El archivo de esquema.

Objeto

Un tipo JSON que contiene cero o más propiedades.

Propiedad

Un par clave:valor de un objeto. Su valor puede ser cualquier tipo de datos JSON.

Palabra clave

La parte clave del par clave:valor de un objeto. Siempre es una cadena de texto.

Subesquema

Un objeto secundario de un operador o una dependencia.

Definición

Descripción completa de cualquier tipo JSON. Las definiciones pueden ser globales o locales.

Matriz

Una lista ordenada y separada por comas de cero o más ítems de cualquier tipo de datos JSON.

Tipos atómicos

Los tipos de datos JSON string, number, integer, boolean y null

Selectores de tipo

Los tipos any y multiple, que seleccionan cualquier tipo o varios tipos respectivamente.

Operadores

Selectores de repetición que se pueden añadir como secundarios de las definiciones. Consulte el apartado Operadores para obtener más información.

 

Tipos de datos JSON

Los ítems de las matrices y los valores de las propiedades de los objetos pueden tener estos tipos:

 

string (cadena, que debe ir entre comillas). Además las cadenas pueden tener un formato concreto, como el formato date-time o email
number: un número con una parte fraccionaria. Incluye números enteros
integer: un número sin parte fraccionaria. Se trata de un subconjunto del tipo number
boolean (true/false, no debe ir entre comillas)
object: si se utiliza dentro de otro objeto, este tipo permite anidar datos
array: permite generar estructuras más complejas de las que permiten los objetos
null (null, no debe ir entre comillas)

 


© 2019 Altova GmbH