Definiciones globales y locales
Las definiciones del esquema JSON se pueden crear global o localmente:
•Las definiciones globales se crean en la Cuadrícula de definiciones de la ventana principal añadiendo una definición y especificando sus propiedades. A una definición global se puede hacer referencia desde otras definiciones del mismo esquema o desde definiciones de otros esquemas. Esto permite reutilizar definiciones en todo el proyecto. Todas las definiciones globales del esquema actual aparecen en la Cuadrícula de definiciones. Para poder reutilizar definiciones globales de otros esquemas basta con añadir los esquemas externos al ayudante de entrada Vista general.
•Las definiciones locales se crean dentro de definiciones globales. Esto se hace añadiendo definiciones de un nivel inferior o del mismo nivel a la definición global.
Referencias a una definición global
Si quiere hacer referencia a una definición global desde otra definición tiene dos opciones:
•En la vista Diseño arrastre la definición global desde el ayudante de entrada Vista general hasta la definición donde quiere usarla.
•En la vista Diseño haga clic con el botón derecho en la definición para la que quiere hacer referencia a una definición global y seleccione Editar referencia. (También puede, habiendo seleccionado la definición en la vista Diseño, ir al ayudante de entrada Detalles y hacer clic en el botón Otro cuadro de diálogo del campo Referencia.) En el cuadro de diálogo Editar referencia que aparece (imagen siguiente) seleccione la referencia global que necesita. Si agrega un esquema externo puede elegir si la referencia a este se deberá introducir como ruta de acceso absoluta o relativa a su esquema JSON.
| Nota: | una definición puede (i) hacer referencia a una definición global y no contener ninguna definición local o restricción local o (ii) hacer referencia a una definición global y también contener definiciones/restricciones locales (de las versiones draft-2019-09 y posteriores). En el segundo caso, la referencia se conoce como referencia ampliada. En el cuadro de diálogo Editar referencia puede crear una referencia a una definición global como referencia ampliada si marca la casilla Referencia ampliada. Las definiciones globales que se crean como referencias ampliadas siempre aparecen como último elemento en la lista de definiciones de componentes de referencia. Si se ha definido un valor para la palabra clave description del componente de referencia, ese valor aparece bajo el componente de referencia. |
| Nota: | si cambia el nombre de una definición global después de hacerle referencia desde otra definición del mismo esquema, el nombre también cambiará en la referencia. Sin embargo, las referencias desde otros esquemas deberán editarse manualmente para que sean correctas. |
Convertir definiciones locales en globales
Haga clic con el botón derecho en una definición local en la Vista de diseño y seleccione Convertir en global. Esto crea una definición global e inserta una referencia a ella en la definición local. El nombre de la definición global se genera de forma automática, pero si lo edita el cambio se pasa automáticamente a la referencia de la definición local.
Cambiar referencias a una definición global por una definición local
Una referencia a una definición global puede darse tanto en definiciones locales como globales. Para quitar la referencia y hacer que sus propiedades sean locales, haga clic con el botón derecho en la definición (local o global) en la Vista de diseño y seleccione Convertir en local. Las propiedades de la definición global se crean de forma local en la definición.