XSD Indicateurs


Grâce aux indicateurs, nous pouvons contrôler la façon dont les éléments sont utilisés dans un document.


Indicateurs

Il existe sept types d'indicateurs :

Indicateurs d'ordre :

  • Tous
  • Choice
  • Séquence

Indicateurs d'occurrence :

  • maxOccurs
  • minOccurs

Indicateurs de groupe :

  • Nom du groupe
  • Nom d'attributeGroup

Indicateurs d'ordre

Les indicateurs d'ordre sont utilisés pour définir l'ordre des éléments.

Indicateur All

L'indicateur <all> spécifie que les éléments enfants peuvent apparaître dans n'importe quel ordre, et chaque élément enfant ne doit apparaître qu'une seule fois :

<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>

Remarque :Lors de l'utilisation de l'indicateur <all>, vous pouvez définir <minOccurs> sur 0 ou 1, et vous pouvez uniquement définir l'indicateur <maxOccurs> sur 1 (<minOccurs> et <maxOccurs> seront expliqués plus tard).

Indicateur de choix

L'indicateur <choice> spécifie que soit un élément enfant, soit un autre élément enfant peut apparaître (soit/soit) :

<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>

Indicateur de séquence

<sequence> spécifie que les éléments enfants doivent apparaître dans un ordre spécifique :

<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>


Indicateurs d'occurrence

Les indicateurs d'occurrence sont utilisés pour définir combien de fois un élément peut apparaître.

Remarque :Pour tous les indicateurs « Order » et « Group » (any, all, choice, sequence, group name, and group reference), les valeurs par défaut de maxOccurs et minOccurs sont toutes deux 1.

Indicateur maxOccurs

L'indicateur <maxOccurs> peut spécifier le nombre maximal de fois qu'un élément peut apparaître :

<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>

L'exemple ci-dessus indique que l'élément enfant "child_name" peut apparaître au moins une fois dans l'élément "person" (où la valeur par défaut de minOccurs est 1) et au plus 10 fois.

Indicateur minOccurs

L'indicateur <minOccurs> peut spécifier le nombre minimum de fois qu'un élément peut apparaître :

<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>

L'exemple ci-dessus indique que l'élément enfant "child_name" peut apparaître au moins 0 fois et au plus 10 fois dans l'élément "person".

Astuce :Si vous souhaitez qu'un élément ait un nombre illimité d'occurrences, utilisez la déclaration maxOccurs="unbounded" :

Un exemple pratique :

Un fichier XML nommé "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>Hege Refsnes</full_name>
  <child_name>Cecilie</child_name>
</person>

<person>
  <full_name>Tove Refsnes</full_name>
  <child_name>Hege</child_name>
  <child_name>Stale</child_name>
  <child_name>Jim</child_name>
  <child_name>Borge</child_name>
</person>

<person>
  <full_name>Stale Refsnes</full_name>
</person>

</persons>

Le fichier XML ci-dessus contient un élément racine nommé "persons". À l'intérieur de cet élément racine, nous définissons trois éléments "person". Chaque élément "person" doit contenir un élément "full_name", et il peut contenir jusqu'à 5 éléments "child_name".

Ceci est le fichier de schéma "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>


Indicateurs de groupe

Les indicateurs de groupe sont utilisés pour définir des ensembles d'éléments associés.

Groupes d'éléments

Les groupes d'éléments sont définis à l'aide de la déclaration de groupe :

<xs:group name="groupname">
...
</xs:group>

Vous devez définir un élément all, choice ou sequence à l'intérieur de la déclaration de groupe. L'exemple suivant définit un groupe nommé "persongroup", qui définit un ensemble d'éléments qui doivent apparaître dans un ordre exact :

<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>

Après avoir défini le groupe, vous pouvez y faire référence dans une autre définition :

<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>

Groupes d'attributs

Les groupes d'attributs sont définis à l'aide de la déclaration attributeGroup :

<xs:attributeGroup name="groupname">
...
</xs:attributeGroup>

L'exemple suivant définit un groupe d'attributs nommé "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>

Après avoir défini le groupe d'attributs, vous pouvez y faire référence dans une autre définition, comme ceci :

<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>
Autres extensions