Generación de un fragmento XML a partir de un esquema XML

  • Artículo

Con el Editor XML es posible generar fragmentos XML a partir de un esquema de lenguaje de definición de esquema XML (XSD). Por ejemplo, durante la creación de un archivo XML, mientras se coloca junto al nombre del elemento puede presionar la tecla Tab para rellenar el elemento con los datos XML generados a partir de la información de esquema de ese elemento.

Esta característica solamente está disponible en elementos. Además, se aplican las siguientes reglas:

  • El elemento debe tener asociado un tipo de esquema, es decir, el elemento debe ser válido de acuerdo con algún esquema asociado. El tipo de esquema no puede ser abstracto y debe contener los atributos y/o elementos secundarios necesarios.

  • El elemento actual del editor debe estar vacío, sin atributos. Por ejemplo, todo lo siguiente es válido

    • <Account

    • <Account>

    • <Account></Account>

  • El cursor debe estar situado inmediatamente a la derecha del nombre del elemento.

El fragmento generado contiene todos los atributos y elementos necesarios. Si minOccurs es mayor que uno, en el fragmento se incluye el número mínimo de instancias necesarias de ese elemento, hasta un máximo de 100 instancias. Todos los valores fijos hallados en el esquema dan como resultado valores fijos en el fragmento de código. Los elementos xsd:any y xsd:anyAttribute se omiten y, como consecuencia, no se construyen más fragmentos.

Los valores predeterminados se generan e indican como valores editables. Si el esquema especifica un valor predeterminado, se utiliza este valor predeterminado. No obstante, si el valor predeterminado del esquema es una cadena vacía, el editor genera los valores predeterminados de la siguiente manera:

  • Si el tipo de esquema contiene facetas de enumeración, por medio directo o indirecto de cualquiera de los miembros de un tipo de unión, el primer valor enumerado hallado en el modelo de objeto de esquema se utiliza como predeterminado.

  • Si el tipo de esquema es un tipo atómico, el editor obtiene el tipo atómico e inserta el nombre de dicho tipo. En un tipo simple derivado, se utiliza el tipo simple base. En un tipo de lista, el tipo atómico es el itemType. En una unión, el tipo atómico es el tipo atómico del primer memberType.

Ejemplo

Los pasos de esta sección muestran cómo utilizar la característica del Editor XML de fragmento de XML generado por esquema.

Nota

Antes de comenzar estos procedimientos, guarde el archivo de esquema en el equipo local.

Para crear un nuevo archivo XML y asociarlo con un esquema XML

  1. En el menú Archivo, seleccione Nuevo y haga clic en Archivo.

  2. Seleccione Archivo XML en el panel Plantillas y haga clic en Abrir.

    Se abre un nuevo archivo en el editor. El archivo contiene una declaración XML predeterminada, <?xml version="1.0" encoding="utf-8">.

  3. En la ventana Propiedades del documento, haga clic en el botón Examinar ( … ) en el campo Esquemas.

    Aparece el cuadro de diálogo Esquemas XSD.

  4. Haga clic en Agregar.

    Aparece el cuadro de diálogo Abrir esquema XSD.

  5. Seleccione el archivo de esquema y haga clic en Abrir.

  6. Haga clic en Aceptar.

    El esquema XML está ahora asociado con el documento XML.

Para generar un fragmento de código XML

  1. Escriba < en el panel del editor.

  2. La lista de miembros muestra los elementos posibles:

    !-- para agregar un comentario.

    !DOCTYPE para agregar un tipo de documento.

    ? para agregar una instrucción de procesamiento.

    Contact para agregar el elemento raíz.

  3. Seleccione Contact en la lista de miembros y presione ENTRAR.

    El editor agrega la etiqueta de apertura <Contact y coloca el cursor después del nombre del elemento.

  4. Presione la tecla Tab para generar datos XML para el elemento Contact en función de su información de esquema.

Entrada

El tutorial utiliza el siguiente archivo de esquema.

<?xml version="1.0" encoding="utf-8" ?>
<xs:schema elementFormDefault="qualified"
           xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:simpleType name="phoneType">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Voice"/>
      <xs:enumeration value="Fax"/>
      <xs:enumeration value="Pager"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:element name="Contact">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Name">
          <xs:simpleType>
            <xs:restriction base="xs:string"></xs:restriction>
          </xs:simpleType>
        </xs:element>
        <xs:element name="Title"
                    type="xs:string" />
        <xs:element name="Phone"
                    minOccurs="1"
                    maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Number"
                          minOccurs="1">
                <xs:simpleType>
                  <xs:restriction base="xs:string"></xs:restriction>
                </xs:simpleType>
              </xs:element>
              <xs:element name="Type"
                          default="Voice"
                          minOccurs="1"
                          type="phoneType"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Salida

Estos son los datos XML que se generan en función de la información de esquema asociada con el elemento Contact. Los elementos marcados como bold designan campos editables en el fragmento XML.

<Contact>
  <Name>name</Name>
  <Title>title</Title>
  <Phone>
    <Number>number</Number>
    <Type>Voice</Type>
  </Phone>
</Contact>

Contenido relacionado