Indicador de tipo compuesto de XSD

A través del indicador, podemos controlar la forma en que se utilizan los elementos en el documento.

Indicador

Hay siete tipos de indicadores:

Indicador de orden:

  • Todo
  • Elección
  • Secuencia

Indicador de ocurrencia:

  • maxOccurs
  • minOccurs

Indicador de grupo:

  • Group name
  • attributeGroup name

Indicador de orden

El indicador de orden se utiliza para definir el orden de los elementos.

Indicador de todos

<all> Indicador que establece que los elementos secundarios pueden aparecer en cualquier orden y que cada elemento secundario debe aparecer solo una vez:

<xs:element name="person">
  <xs:complexType>
    <xs:all>
      <xs:element name="firstname" type="xs:string"/>
      <xs:element name="lastname" type="xs:string"/>
    </xs:all>
  </xs:complexType>
</xs:element>

Notas:Al usar el indicador <all>, puede establecer <minOccurs> en 0 o 1, y solo puede establecer el indicador <maxOccurs> en 1 (se explicará más adelante <minOccurs> y <maxOccurs>).

Indicador de elección

<choice> Indicador que establece que puede aparecer un subelemento o puede aparecer otro subelemento (o uno u otro):

<xs:element name="person">
  <xs:complexType>
    <xs:choice>
      <xs:element name="employee" type="employee"/>
      <xs:element name="member" type="member"/>
    </xs:choice>
  </xs:complexType>
</xs:element>

Consejo:Para establecer que los elementos secundarios puedan aparecer cualquier número de veces, configure <maxOccurs> (se explicará más adelante) como unbounded (sin límite).

Indicador de secuencia

<sequence> Define que los elementos secundarios deben aparecer en un orden específico:

<xs:element name="person">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="firstname" type="xs:string"/>
      <xs:element name="lastname" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>
</xs:element>

Indicador de ocurrencia

El indicador de ocurrencia se utiliza para definir la frecuencia de aparición de un elemento.

Notas:Para todos los indicadores "Order" y "Group" (any, all, choice, sequence, nombre de grupo y referencia de grupo), los valores predeterminados de maxOccurs y minOccurs son 1.

Indicador maxOccurs

<maxOccurs> Indicador que establece la cantidad máxima de veces que puede aparecer un elemento:

<xs:element name="person">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="full_name" type="xs:string"/>
      <xs:element name="child_name" type="xs:string"> maxOccurs="10"/>
    </xs:sequence>
  </xs:complexType>
</xs:element>

Los ejemplos anteriores indican que el elemento "child_name" puede aparecer en el elemento "person" al menos una vez (donde el valor predeterminado de minOccurs es 1) y hasta 10 veces.

Indicador minOccurs

<minOccurs> Indicador que establece la cantidad mínima de veces que puede aparecer un elemento:

<xs:element name="person">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="full_name" type="xs:string"/>
      <xs:element name="child_name" type="xs:string">
      maxOccurs="10" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
</xs:element>

Los ejemplos anteriores indican que el elemento "child_name" puede aparecer en el elemento "person" al menos 0 veces y hasta 10 veces.

Consejo:Para que la aparición de un elemento no esté limitada, utilice la declaración maxOccurs="unbounded":

Un ejemplo real:

El archivo XML llamado "Myfamily.xml":

<?xml version="1.0" encoding="ISO-8859-1"?>
<persons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
xsi:noNamespaceSchemaLocation="family.xsd">
<person>
<full_name>Tony Smith</full_name>
<child_name>Cecilie</child_name>
</person>
<person>
<full_name>David Smith</full_name>
<child_name>Jogn</child_name>
<child_name>mike</child_name>
<child_name>kyle</child_name>
<child_name>mary</child_name>
</person>
<person>
<full_name>Michael Smith</full_name>
</person>
</persons>

Este archivo XML contiene un elemento raíz llamado "persons" en el interior del cual definimos tres elementos "person". Cada elemento "person" debe contener un elemento "full_name", y puede contener hasta 5 elementos "child_name".

Este es el archivo de esquema "family.xsd":

<?xml version="1.0" encoding="ISO-8859-1"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
elementFormDefault="qualified">
<xs:element name="persons">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="person" maxOccurs="unbounded">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="full_name" type="xs:string"/>
            <xs:element name="child_name" type="xs:string">
            minOccurs="0" maxOccurs="5"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>
</xs:element>
</xs:schema>

Indicador de grupo

El indicador de grupo se utiliza para definir un grupo de elementos relacionados.

Grupo de elementos

El grupo de elementos se define mediante la declaración group:

<xs:group name="组名称">
  ...
</xs:group>

Debe definir un elemento all, choice o sequence dentro de la declaración group. Este ejemplo define un grupo llamado "persongroup", que define un grupo de elementos que deben aparecer en un orden estricto:

<xs:group name="persongroup">
  <xs:sequence>
    <xs:element name="firstname" type="xs:string"/>
    <xs:element name="lastname" type="xs:string"/>
    <xs:element name="birthday" type="xs:date"/>
  </xs:sequence>
</xs:group>

Después de que haya definido completamente el grupo, puede referenciarlo en otra definición:

<xs:group name="persongroup">
  <xs:sequence>
    <xs:element name="firstname" type="xs:string"/>
    <xs:element name="lastname" type="xs:string"/>
    <xs:element name="birthday" type="xs:date"/>
  </xs:sequence>
</xs:group>
<xs:element name="person" type="personinfo"/>
<xs:complexType name="personinfo">
  <xs:sequence>
    <xs:group ref="persongroup"/>
    <xs:element name="country" type="xs:string"/>
  </xs:sequence>
</xs:complexType>

Grupo de atributos

El grupo de atributos se define mediante la declaración attributeGroup:

<xs:attributeGroup name="组名称">
  ...
</xs:attributeGroup>

Este ejemplo define un grupo de atributos llamado "personattrgroup":

<xs:attributeGroup name="personattrgroup">
  <xs:attribute name="firstname" type="xs:string"/>
  <xs:attribute name="lastname" type="xs:string"/>
  <xs:attribute name="birthday" type="xs:date"/>
</xs:attributeGroup>

Después de que haya definido completamente el grupo de atributos, puede referenciarlo en otra definición, como en este ejemplo:

<xs:attributeGroup name="personattrgroup">
  <xs:attribute name="firstname" type="xs:string"/>
  <xs:attribute name="lastname" type="xs:string"/>
  <xs:attribute name="birthday" type="xs:date"/>
</xs:attributeGroup>
<xs:element name="person">
  <xs:complexType>
    <xs:attributeGroup ref="personattrgroup"/>
  </xs:complexType>
</xs:element>