Al igual que con los documentos XML, un archivo XSD comienza con la declaración XML estándar, seguida de la declaración del Schema XML

<?xml version="1.0"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

.....

</xs:schema>

El elemento xs:annotation en XML Schema Definition (XSD) se utiliza para agregar metadatos a la definición del esquema, como documentación o comentarios explicativos. A diferencia de los comentarios XML (<!-- comentario -->), que son simplemente ignorados por los procesadores XML y XSD, xs:annotation puede contener información adicional que puede ser utilizada por herramientas que procesan el esquema, como generadores de documentación o IDEs (Entornos de Desarrollo Integrado).

El elemento xs:annotation puede contener dos tipos de elementos hijos:

• xs:documentation: Proporciona información textual sobre el elemento al que pertenece la anotación. Puede ser utilizado para describir la intención, el uso o cualquier otro tipo de guía sobre el elemento del esquema.

• xs:appinfo: Contiene información que puede ser utilizada por aplicaciones específicas. Esto podría incluir configuraciones, reglas o cualquier otro dato que las aplicaciones necesiten para procesar correctamente el XML basado en el esquema.

Ejemplo de Uso de xs:annotation

<?xml version="1.0" encoding="UTF-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="persona">

    <xs:complexType>

      <xs:sequence>

        <xs:element name="nombre" type="xs:string">

          <xs:annotation>

            <xs:documentation>El nombre completo de la persona.</xs:documentation>

          </xs:annotation>

        </xs:element>

 </xs:schema>

<xs:element> en XML Schema (XSD) se utiliza para definir un elemento dentro de un documento XML. Es uno de los componentes fundamentales en la definición de esquemas XML, permitiendo especificar el nombre del elemento, su tipo de datos, y otras restricciones como la cardinalidad (por ejemplo, si es opcional o requerido y cuántas veces puede aparecer). 

Un elemento se define <xs:element name="" type=""/>

Definición de tipo simple  <xs:element>:

• name: El nombre del elemento.

• type: El tipo de dato del elemento, que puede ser un tipo simple (como xs:string, xs:int).

Ejemplo básico:

<xs:element name="titulo" type="xs:string"/>

Este ejemplo define un elemento llamado titulo que contiene datos de tipo cadena (xs:string).

Un <xs:element> de tipo complejo en XML Schema (XSD) se utiliza para definir un elemento que puede contener otros elementos, atributos, o una combinación de ambos. A diferencia de los tipos simples que contienen solo texto y no pueden tener atributos ni elementos anidados, los tipos complejos ofrecen una estructura más rica y versátil para los datos. 

Atributos clave de <xs:element> para tipos complejos:

• name: Especifica el nombre del elemento.

• type: (Opcional si se usa xs:complexType internamente) Define el tipo de datos del elemento. Para un tipo complejo, se puede referir a un xs:complexType definido previamente.
  Si se omite el atributo type y en su lugar se utiliza una definición interna de xs:complexType, esta define directamente la estructura del elemento.

• minOccurs: La cantidad mínima de veces que el elemento debe aparecer. El valor predeterminado es 1.

• maxOccurs: La cantidad máxima de veces que el elemento puede aparecer. El valor predeterminado es 1. Para indicar que el elemento puede aparecer un número ilimitado de veces, se utiliza "unbounded".

Definición interna vs. referencia a tipo complejo

Definición interna de tipo complejo:

Puedes definir la estructura compleja directamente dentro del elemento usando <xs:complexType> sin necesidad de especificar el atributo type.

<xs:element name="libro">

  <xs:complexType>

    <xs:sequence>

      <xs:element name="titulo" type="xs:string"/>

      <xs:element name="autor" type="xs:string"/>

      <!-- Más elementos según se requiera -->

    </xs:sequence>

    <xs:attribute name="isbn" type="xs:string"/>

  </xs:complexType>

</xs:element>

Este ejemplo define un elemento libro que es de tipo complejo, conteniendo subelementos titulo y autor, y un atributo isbn.

Referencia a un tipo complejo definido:

Alternativamente, puedes definir el tipo complejo por separado y luego referenciarlo en el elemento.

<xs:complexType name="TipoLibro">

  <xs:sequence>

    <xs:element name="titulo" type="xs:string"/>

    <xs:element name="autor" type="xs:string"/>

    <!-- Más elementos según se requiera -->

  </xs:sequence>

  <xs:attribute name="isbn" type="xs:string"/>

</xs:complexType>

<xs:element name="libro" type="TipoLibro"/>

Aquí, el tipo complejo TipoLibro se define primero, y luego el elemento libro se define para ser de ese tipo.

Componentes de un tipo complejo:

• xs:sequence: Define que los elementos deben aparecer en un orden específico.

• xs:choice: Permite que solo uno de los elementos contenidos sea presente.

• xs:all: Permite que los elementos aparezcan en cualquier orden, cada uno no más de una vez.

• xs:group: Permite reutilizar definiciones de grupo de elementos.

• xs:attribute: Define un atributo para el elemento.

Los tipos complejos ofrecen una flexibilidad considerable en la definición de estructuras de documentos XML, permitiendo modelar datos de manera precisa y detallada para satisfacer necesidades específicas de información y validación.