Página Definición de esquema

Acerca de esta página

Esta página de formulario permite editar la estructura y las propiedades de los objetos de esquema que constituyen la gramática del esquema editado.

La estructura de los objetos de esquema puede editarse en la sección Elementos de punto de extensión. Esta sección ocupa la parte superior izquierda del área del editor.

Las propiedades de los objetos de esquema se editan en las secciones Detalles de <objeto de esquema>. Estas secciones se activan en la parte superior derecha del área del editor, según el tipo de elemento de esquema seleccionado en la sección Elementos de punto de extensión.

Secciones de la página

Esta página consta de las secciones siguientes:

Sección Elementos de punto de extensión

Esta sección permite realizar lo siguiente:

Puede acceder directamente a esta sección a través de la página del formulario Definición de esquema.

Campos de la sección Elementos de punto de extensión

Utilice el campo del visor de elementos de punto de extensión para hacer lo siguiente:

Este visor contiene los nodos siguientes:

Elementos:

Compositores:

Atributos:

Ejemplo: el elemento extension especifica que se permite una secuencia de uno o varios elementos shortcut como sus hijos legales. Se utiliza una referencia de elemento para representar el elemento shortcut. Un compositor Sequence se utiliza para representar una secuencia de elementos.

Sección 2 de los Elementos de punto de extensión

Ejemplo: el elemento shortcut especifica que se permite un elemento description o category como su hijo legal. Las referencias de elemento se utilizan para representar los elementos description y category. Un compositor Choice se utiliza para representar una elección de elementos.

Sección 1 de los Elementos de punto de extensión

Acciones de sección de elementos de punto de extensión

Pulse el botón Añadir elemento para añadir una declaración de elemento global nueva a la gramática de esquema de punto de extensión. Esta acción está disponible cuando se selecciona cualquier nodo. Nota: el orden de la declaración de elementos no es importante

Pulse el botón Añadir atributo para añadir una declaración de atributo local nueva a un elemento seleccionado en la gramática de esquema de punto de extensión. Esta acción está disponible para todos los nodos de elemento excepto para el nodo de elemento extension. El nodo elemento extension siempre tiene los mismos atributos: id, name, point. Nota: el orden de la declaración de atributos no es importante.

Para suprimir un objeto de esquema de la gramática de esquema de punto de extensión, pulse con el botón derecho sobre un nodo seleccionado y seleccione Suprimir. Esta acción está disponible para todos los nodos seleccionados excepto para el nodo elemento extension. Para esquemas no compartidos, el nodo elemento extension es el elemento raíz especial utilizado para definir el punto de entrada en la gramática del esquema editado. Cualquier extensión definida en el Editor de manifiestos de plug-ins debe utilizar un elemento padre extension para especificar su marcación XML relacionada.

Para especificar que el hijo de un elemento está compuesto por una secuencia o una elección de otros elementos en la gramática de esquema de punto de extensión, haga lo siguiente:

  1. Seleccione y pulse con el botón derecho el nodo elemento que desea designar como el elemento padre.
  2. Seleccione Nuevo > Compositor > Secuencia para definir una secuencia de elementos. Seleccione Nuevo > Compositor > Elección para definir una elección de elementos.
  3. Seleccione y pulse con el botón derecho sobre el nodo compositor.
  4. Seleccione el elemento para el submenú Nuevo > Referencia que desea designar como hijo del elemento padre. El submenú Referencia está poblado con todos los elementos que se declaran globalmente en la gramática del esquema de punto de extensión.
  5. Repita los pasos (3) y (4) para especificar elementos hijo adicionales. Si se especificó un compositor Secuencia, esto equivale a especificar elementos adicionales en la secuencia. Si se especificó un compositor Elección, esto equivale a especificar elecciones de elemento adicionales.

Nota: para especificar que un elemento es el hijo de otro elemento, el elemento padre debe utilizar siempre un compositor Secuencia o Elección intermedio. Los nodos de compositor son nodos de conector, mientras que los nodos de referencia de elemento son nodos de hoja. Por lo tanto, los nodos de compositor deben especificar siempre al menos un nodo de referencia de elemento hijo.

Nota: los compositores Secuencia y Elección pueden anidarse un número indefinido de veces para crear gramáticas más complejas.

Nota: una gramática no debe contener ciclos autoreferentes. La forma más básica de un ciclo prohibido se produce cuando el Elemento A necesita el Elemento B como hijo y el Elemento B necesita el Elemento A como hijo.

Para especificar que un elemento no tiene hijos y que permite especificar texto en sus códigos XML de inicio y final (contenido de carácter), simplemente deje la estructura del elemento tal cual sin añadirle atributos, compositores ni referencias de elemento (contenido de elemento). Nota: un elemento no puede especificar contenido mixto (contenido de caracteres y contenido de elementos).

Sección Descripción

Esta sección permite proporcionar una descripción breve para cualquier elemento, atributo o compositor dentro de la gramática del esquema editado.

Puede acceder directamente a esta sección a través de la página del formulario Definición de esquema.

Sección Descripción

Campos de la sección Descripción

Edite el campo de texto de descripción para proporcionar una descripción breve del nodo elemento, atributo o compositor seleccionado en la sección Elementos de punto de extensión. Puede utilizar marcación HTML válida en este campo según sea necesario.

Nota: al actualizar una descripción de referencia de elemento también se actualiza la descripción de la declaración de elemento global a la que hace referencia y viceversa.

Sección Detalles de elemento

Esta sección permite editar las propiedades de un elemento. Hay dos especies de elementos: elemento de extensión y elemento no de extensión. Un elemento de extensión es la declaración de elemento raíz especial utilizada para definir el punto de entrada a la gramática del esquema editado. Un elemento no de extensión es una declaración de elemento global utilizada como bloque de construcción estructural en la gramática del esquema editado.

Esta sección está activada seleccionando un nodo elemento extension o un nodo elemento no de extensión en la sección Elementos de punto de extensión.

La sección Detalles de elemento para un elemento extension.

Sección 1 de Detalles de elemento

La sección Detalles de elemento para un elemento no de extensión.

Sección 2 Detalles de elemento

Campos de la sección Detalles de elemento

Edite el campo Nombre para especificar el nombre del elemento.

Pulse el botón true o false dentro del campo Interno para indicar si el elemento es interno o no. El Editor de manifiestos de plug-in marcará cualquier marcación XML de extensión que sea interna con un aviso (de forma predeterminada). Este campo es análogo al atributo x-internal de los paquetes exportados.

Pulse el botón true o false dentro del campo En desuso para indicar si el elemento está en desuso o no. El Editor de manifiestos de plug-in marcará cualquier marcación XML de extensión que esté en desuso con un aviso (de forma predeterminada). Este campo es análogo al código Javadoc @deprecated de Java.

Si un elemento de extensión se marca como en desuso, edite el campo Sustitución para especificar el punto de extensión no en desuso que el usuario debe utilizar en su lugar para conseguir la misma funcionalidad.

Seleccione uno de los atributos definido del elemento del campo Propiedad de etiqueta para especificar el valor del atributo para utilizarlo como la etiqueta del elemento en el Editor de manifiestos de plug-ins. Por ejemplo, si se selecciona un valor, la etiqueta del nodo del elemento en la sección Todas las extensiones de la página Extensiones en el Editor de manifiestos del plug-in será la siguiente: valor de atributo seleccionado (nombre de elemento). De lo contrario, si no se selecciona ningún valor, la etiqueta del nodo del elemento será la siguiente: (nombre de elemento).

Seleccione uno de los atributos de tipo de recurso definidos del elemento en el campo Icono para especificar el recurso de icono a utilizar para representar el nodo del elemento en el Editor de manifiestos de plug-in. Para que el icono del nodo del elemento se muestre correctamente en la sección Todas las extensiones de la página Extensiones en el Editor de manifiestos de plug-in, deben cumplirse las condiciones siguientes:

Pulse el botón true o el botón false en el campo Traducible para indicar si el contenido de caracteres del elemento es traducible o no. Este campo sólo es aplicable para elementos que no tengan hijos (contenido de elemento) o atributos especificados y que permitan especificar texto entre sus códigos XML iniciales y finales (contenido de caracteres). Si el contenido de caracteres de un elemento se marca como traducible, las herramientas de PDE pueden utilizarse en la marcación XML de extensión aportada para externalizar el contenido en un archivo de propiedades para el soporte de varios idiomas.

Utilice el campo Aproximación DTD para ver una correlación de uno a uno aproximada de la gramática de esquema de elemento con la gramática DTD de elemento equivalente. Una DTD (Definición de tipo de documento) es una alternativa más fácil de leer y menos potente al Esquema XML para especificar la gramática formal de un documento XML. La notación siguiente se utiliza para especificar la aproximación de DTD:

Sección Detalles de compositor

Esta sección permite editar las propiedades de un compositor. Hay dos tipos de compositores: compositor de secuencia, compositor de elección. Un compositor de secuencias permite especificar que el hijo de un elemento está compuesto de una secuencia de otros elementos en la gramática del esquema editado. El compositor de una opción permite especificar que el hijo de un elemento está compuesto de una elección de otros elementos en la gramática del esquema editado.

Esta sección se activa seleccionando un nodo Secuencia u Elección en la sección Elementos de punto de extensión.

Sección Detalles de compositor

Campos de la sección Detalles de compositor

Edite el campo Número mínimo de apariciones para especificar el número mínimo de apariciones permitido de este compositor de otros elementos y / o compositores en la marcación XML de extensión aportada. El valor de este campo lo utiliza PDE para validar las restricciones de multiplicidad en el Editor de manifiestos de plug-ins. Si el Elemento A necesita exactamente un Elemento B o Elemento C como su hijo y utiliza un compositor Elección que especifica un número mínimo de 2 apariciones, deben definirse 2 instancias del Elemento B en combinación con el Elemento C en la marcación XML de ampliación aportada para que sea válida.

Edite el campo Número máximo de apariciones para especificar el número máximo de apariciones permitido de este compositor de otros elementos y / o compositores en la marcación XML de ampliación aportada. El valor de este campo lo utiliza PDE para validar las restricciones de multiplicidad en el Editor de manifiestos de plug-ins. Si el Elemento A necesita exactamente un Elemento B o Elemento C como su hijo y utiliza un compositor Elección que especifique un número máximo de 2 apariciones, no pueden definirse más de 2 instancias del Elemento B en combinación con el Elemento C en la marcación XML de extensión aportada para que sea válida.

Marque el campo No enlazado para especificar que no hay restricciones en el número máximo de apariciones permitidas de este compositor en la marcación XML de extensión aportada.

Seleccione un valor en el campo Tipo para especificar si este compositor es una secuencia o una opción.

Utilice el campo Aproximación DTD para ver una correlación de uno a uno aproximada de la gramática de compositor de elemento con la gramática DTD de compositor equivalente. La notación utilizada para especificar la aproximación de DTD se describe bajo la cabecera Campos de la sección Detalles de elemento en este documento.

Sección Detalles de referencia de elemento

Esta sección permite editar las propiedades de una referencia de elemento. Una referencia de elemento es una referencia a una declaración de elemento global en la gramática del esquema editado. Los compositores utilizan las referencias de elemento como bloques de construcción elementales para definir la gramática para declaraciones de elemento globales.

Esta sección se activa seleccionando un nodo referencia de elemento en la sección Elementos de punto de ampliación.

Sección Detalles de referencia de elemento

Campos de la sección Detalles de referencia

Edite el campo Número mínimo de apariciones para especificar el número mínimo de apariciones permitido de este elemento en la codificación XML de extensión aportada. El valor de este campo lo utiliza PDE para validar las restricciones de multiplicidad en el Editor de manifiestos de plug-ins. Si el Elemento A especifica un número mínimo de 2 apariciones, deben definirse 2 instancias del Elemento A en la marcación XML de extensión aportada para que sea válida.

Edite el campo Número máximo de apariciones para especificar el número máximo de apariciones que el elemento puede aparecer en la marcación XML de extensión aportada. El valor de este campo lo utiliza PDE para validar las restricciones de multiplicidad en el Editor de manifiestos de plug-ins. Si el Elemento A especifica un número máximo de 2 apariciones, no pueden definirse más de 2 instancias del Elemento A en la marcación XML de extensión aportada para que sea válida.

Marque el campo No enlazado para especificar que no hay restricciones en el número máximo de apariciones permitidas de este elemento en la marcación XML de extensión aportada.

Utilice el campo Aproximación DTD para ver una correlación de uno a uno aproximada de la gramática de esquema de elemento con la gramática DTD de elemento equivalente. La notación utilizada para especificar la aproximación de DTD se describe bajo la cabecera Campos de la sección Detalles de elemento en este documento.

Acciones de la sección Detalles de referencia de elemento

Pulse el hiperenlace nombre de elemento en el campo Referencia para editar las propiedades de la declaración de elemento global a la que hace referencia este elemento local. Cuando finaliza esta acción, el nodo elemento está seleccionado en la sección Elementos de punto de extensión y la sección Detalles de elemento está activada.

Sección Detalles de atributo

Esta sección permite editar las propiedades de un atributo. Los atributos se utilizan para proporcionar información adicional sobre los elementos.

Esta sección se activa seleccionando un atributo necesario, un atributo opcional, un atributo de clase o un nodo atributo de recurso en la sección Elementos de punto de extensión.

La sección Detalles de atributo para un atributo necesario del tipo serie que especifica una restricción de enumeración.

Sección 1 de Detalles de atributo

La sección Detalles de atributo de un atributo opcional de tipo booleano que especifica un valor predeterminado.

Sección 2 de Detalles de atributo

La sección Detalles de atributo para un atributo de clase que indica que la clase representada por el valor de atributo debe ampliar la clase especificada y /o implementar la interfaz especificada.

Sección 3 Detalles de atributo

La sección Detalles de atributo para un atributo de recurso.

Sección 4 de Detalles de atributo

Utilizar el atributo de identificador de esquema

Los autores de puntos de extensión pueden definir atributos que hacen referencia a otros atributos. Esto se realiza definiendo el atributo de punto de extensión como de tipo identificador y seleccionando el atributo al que hace referencia. Un ejemplo de esto sería el punto de extensión org.eclipse.ui.handlers. El atributo commandId hace referencia a mandatos definidos en el punto de extensión org.eclipse.ui.commands.

Utilización de identificador de esquema

Los desarrolladores de extensiones que añaden un manejador pueden entonces seleccionar de entre todos los identificadores válidos para el atributo commandId. Se emiten avisos para los identificadores que no existen para evitar el error habitual de un identificador mal escrito.

Campos de la sección Detalles de atributo

Edite el campo Nombre para especificar el nombre de atributo.

Pulse el botón true o false dentro del campo En desuso para indicar si el atributo está en desuso o no. El Editor de manifiestos de plug-in marcará cualquier marcación XML de extensión que esté en desuso con un aviso (de forma predeterminada). Este campo es análogo al código Javadoc @deprecated de Java.

Seleccione un valor en el campo Utilizar para indicar si el atributo debe especificarse en su elemento de definición dentro de la marcación XML de extensión aportada. Están disponibles las selecciones siguientes:

Edite el campo Valor predeterminado para especificar el valor predeterminado a utilizar para un atributo cuando no se especifica en su elemento de definición dentro de la marcación XML de extensión aportada. Este campo sólo es aplicable cuando se selecciona el valor predeterminado en el campo Utilización.

Seleccione un valor del campo Tipo para especificar el tipo de valor de atributo. Están disponibles las selecciones siguientes:

Pulse el botón true o false en el campo Traducible para indicar si el valor del atributo es traducible o no. Este campo sólo es aplicable cuando se selecciona el valor serie del campo Tipo. Si un valor del atributo se marca como traducible, las herramientas de PDE pueden utilizarse en la marcación XML de extensión aportada para externalizar estos valores en un archivo de propiedades para el soporte de varios idiomas.

Utilice el campo Restricciones para ver una lista de valores de serie que el atributo no puede utilizar como su propio valor. Si el campo no contiene valores, no hay restricciones sobre el valor del atributo. Este campo sólo es aplicable cuando se selecciona el valor serie del campo Tipo. Nota: una restricción de enumeración sobre el tipo base de serie se utiliza en la gramática del esquema editado para cumplir esta funcionalidad.

Edite el campo Extiende para especificar un nombre de clase totalmente calificado en la vía de acceso de clases de la plataforma (p.ej. org.eclipse.ui.part.EditorPart) que debe ser subclase de la clase especificada como el valor del atributo. PDE validará el valor del atributo de clase en la marcación XML de extensión aportada para asegurarse de que extienda la superclase. Este campo sólo es aplicable cuando se selecciona el valor java del campo Tipo.

Edite el campo Implementa para especificar un nombre de interfaz totalmente calificado en la vía de acceso de clases de la plataforma destino (p.ej. org.eclipse.ui.IEditorPart) que debe implementar la clase especificada como el valor del atributo. PDE validará el valor del atributo de clase en la marcación XML de extensión aportada para asegurarse de que implemente la interfaz. Este campo sólo es aplicable cuando se selecciona el valor java del campo Tipo.

Acciones de la sección Detalles de atributo

Pulse el botón Añadir... en el campo Restricciones para abrir el diálogo Restricción nueva para añadir una restricción nueva al valor del atributo. Una vez completado el diálogo, la restricción nueva se añade a la lista de valores de serie que el atributo no puede utilizar como su propio valor. Esta acción sólo está disponible cuando el valor serie del campo Tipo está seleccionado.

Seleccione un valor de serie en el campo Restricciones y pulse el botón Eliminar para eliminar una restricción de la lista de valores de serie que el atributo no puede utilizar como su propio valor. Esta acción sólo está disponible cuando el valor serie del campo Tipo está seleccionado.

Si el valor especificado en el campo Extiende hace referencia a un nombre de clase totalmente calificado en la vía de acceso de clases de la plataforma destino, al pulsar sobre el hiperenlace Extiende se abrirá esa clase en un editor fuente Java nuevo. De lo contrario, al pulsar el hiperenlace Extiende se abrirá el asistente Clase Java nueva lo que permite crear la clase nueva. Esta acción sólo está disponible cuando se selecciona el valor java del campo Tipo.

Si el valor especificado en el campo Implementa hace referencia a un nombre de interfaz totalmente calificado en la vía de acceso de clases de la plataforma destino, al pulsar sobre el hiperenlace Implementa se abrirá esa interfaz en un editor fuente Java nuevo. De lo contrario, al pulsar el hiperenlace Implementa se abrirá el asistente Clase Java nueva lo que permite crear la interfaz nueva. Esta acción sólo está disponible cuando se selecciona el valor java del campo Tipo.

Pulse el botón Examinar... para abrir el diálogo Seleccionar tipo para seleccionar una clase existente en la vía de acceso de clases de la plataforma para utilizarla como el valor del campo Extiende. Esta acción sólo está disponible cuando se selecciona el valor java del campo Tipo.

Pulse el botón Examinar... para abrir el diálogo Seleccionar tipo para seleccionar una interfaz existente en la vía de acceso de clases de la plataforma para utilizarla como el valor del campo Implementa. Esta acción sólo está disponible cuando se selecciona el valor java del campo Tipo.

Enlaces relevantes