Subida de esquemas XML incluidos

Un esquema XML o documento WSDL puede incluir otros esquemas XML en el documento principal utilizando Inclusión de esquema, Inclusión de esquema con redefinición o Importación de un espacio de nombres.

Acerca de esta tarea

Inclusión de esquema
Puede incluir otros fragmentos de esquema XML en el esquema XML o WSDL principal utilizando el elemento de inclusión tal como se muestra en el siguiente ejemplo: <xsd:include schemaLocation="myTypes.xsd"/>
Inclusión de esquema con redefinición
La especificación de esquema XML admite la redefinición de definiciones incluidas por otros fragmentos de esquema XML en el esquema XML o WSDL actual. Por ejemplo, el fragmento de esquema XML myTypes.xsd define un tipo complejo denominado PurchaseOrderType. Otro esquema XML denominado PurchaseOrder.xsd incluye el fragmento de esquema XML myTypes.xsd utilizando el elemento de redefinición y vuelve a definir el tipo complejo denominado PurchaseOrderType.
Puede incluir otros fragmentos de esquema XML en el esquema XML o WSDL principal utilizando el elemento redefine tal como se muestra en el siguiente ejemplo: <xsd:redefine schemaLocation="myTypes.xsd"/>
Importación de un espacio de nombres
Puede incluir un espacio de nombres en el documento actual utilizando el elemento import tal como se muestra en el siguiente ejemplo: <xs:import namespace="http://acme.com/ns/example schemaLocation="mySchema.xsd" /> 

Cuando se añade o sube el esquema XML o WSDL principal al proyecto utilizando el recuadro de diálogo Añadir documento, el sistema solicita que ubique todos los esquemas XML incluidos en el proyecto, tal como se detalla en el siguiente procedimiento. Todos los esquemas XML incluidos deben estar ubicados antes de que el esquema XML o el documento WSDL principales aparezcan en el separador Proyecto y pueda utilizarse en el proyecto.

Procedimiento

  1. Cargue un esquema XML o un documento WSDL en el proyecto actual. Si el esquema XML o el documento WSDL incluye otros esquemas XML, aparece el recuadro de diálogo subida de esquemas XML incluidos listando todos los esquemas XML incluidos tal como aparece en Figura 1.
    Figura 1. Subida de esquemas XML incluidosCargar de un subida
    Si el esquema XML incluido se ubica automáticamente, el icono de marca de selección icono de marca de selección aparece al lado del esquema XML en el recuadro de diálogo Subida de esquemas XML incluidos tal como aparece para el esquema XML commonTypes.xsd en la figura anteriormente expuesta. Si el esquema XML o WSDL principal estaba ubicado en el sistema de archivos local, Studio busca los esquemas XML incluidos en el mismo directorio y los ubica automáticamente; por ejemplo, si ha cargado mySchema.xsd desde el directorio C:\temp y mySchema.xsd incluye el esquema XML commonTypes.xsd, Studio ubica automáticamente el esquema XML commonTypes.xsd en el directorio C:\temp. Si el esquema XML incluido no se ubica automáticamente, el icono de aviso icono de aviso aparece al lado del esquema XML en el recuadro de diálogo Subida de esquemas XML incluidos tal como se muestra para el esquema XML poTypes.xsd en Figura 1.
  2. Repita los siguientes pasos para ubicar todos los esquemas XML no ubicados:
    1. Seleccione el esquema XML en el recuadro de diálogo Subida de esquemas XML incluidos. El esquema XML se resalta en la tabla tal como aparece enFigura 2.
      Figura 2. Subir un esquema XMLSubir un esquema XML
    2. Pulse Ubicar.   Se visualiza el recuadro de diálogo Ubicar el esquema XML seleccionado.
    3. En el campo Ubicación, especifique la ubicación del esquema XML incluido desde una ubicación web externa o desde el sistema de archivos.
    4. Pulse Aceptar Si el esquema XML está ubicado, el icono de marca de selección icono de marca de selección se visualiza al lado del esquema XML en el recuadro de diálogo Subida de esquemas XML incluidos.
  3. De forma predeterminada, el recuadro de selección Almacenar todas las inclusiones en el mismo nodo de proyecto que el documento principal está seleccionado. Cuando este recuadro de selección está seleccionado, los esquemas XML incluidos y el esquema XML o WSDL principal se suben como un único nodo de proyecto. Cuando se borra esta casilla de verificación, todos los esquemas XML incluidos y el esquema XML o WSDL principal se visualizan todos por separado en el separador Proyecto. Aparece un icono de marca de selección al lado de cada esquema XML listado indicando que se han ubicado todos los esquemas XML incluidos.
  4. Pulse Aceptar.

Ejemplo

Si se ha seleccionado el recuadro de selección Almacenar todas las inclusiones en el mismo nodo de proyecto que el documento principal, sólo aparece el esquema XML o WSDL principal en el separador Proyecto tal como se muestra en Figura 3.
Figura 3. EjemploEjemplo

Con el recuadro de selección seleccionado, los esquemas XML incluidos se siguen cargando en el proyecto pero no se muestran en el separador Proyecto, por lo que no se pueden actualizar individualmente en el proyecto tal como se describe en Subida de esquemas XML incluidos.

Si se borra el recuadro de selección Almacenar todas las inclusiones en el mismo nodo de proyecto que el documento principal, se visualiza el esquema XML o WSDL principal y todos los esquemas XML incluidos se suben en el proyecto y aparecen en el separador Proyecto tal como se detalla en Figura 4.
Figura 4. EjemploEjemplo

Con la casilla de verificación borrada, todos los esquemas XML incluidos se pueden actualizar individualmente tal como se describe en Subida de esquemas XML incluidos.

Nota: Si es posible, cargue siempre el esquema XML o WSDL principal con esta casilla de verificación seleccionada (como un nodo de proyecto) para reducir conflictos de dependencia entre esquemas XML. Por ejemplo, si sube el archivo myTypes.xsd principal en el proyecto habiendo borrado la casilla de verificación Almacenar todas las inclusiones en el mismo nodo de proyecto que el documento principal, también se suben los siguientes archivos XSD y aparecen en el separador Proyecto:
  • commonTypes.xsd
  • poTypes.xsd

Si ha creado y subido un tercer archivo XSD llamado myTypesTwo.xsd que también incluía y utilizaba los tipos definidos en el archivo commonTypes.xsd y a continuación ha cambiado los nombres de los tipos definidos en el archivocommonTypes.xsd y utilizados en myTypes.xsd fuera de Studio y ha subido versiones nuevas de estos archivos, el archivo myTypesTwo.xsd en el proyecto seguirá haciendo referencia a los nombres originales de los tipos y ahora no será válido.