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