Nous pouvons contrôler la façon dont les éléments doivent être utilisés dans les documents avec des indicateurs.
Indicateurs
Il y a sept indicateurs:
Ordre des indicateurs:
- All
- Choice
- Sequence
indicateurs d'occurrence:
- maxOccurs
- minOccurs
Les indicateurs du groupe:
- Group name
- attributeGroup name
Ordre Indicateurs
Ordre des indicateurs sont utilisés pour définir l'ordre des éléments.
Tous les indicateurs
Le <all> indicateur spécifie que les éléments enfants peuvent apparaître dans un ordre quelconque, et que chaque élément enfant doit se produire 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>
Note: Lorsque vous utilisez le <all> indicateur vous pouvez régler le <minOccurs> indicateur à 0 ou 1 et le <maxOccurs> indicateur ne peut être défini à 1 (la <minOccurs> et <maxOccurs> sont décrits plus loin).
Choix Indicateur
Le <choice> indicateur spécifie que ce soit un élément de l' enfant ou d'une autre peuvent se produire:
<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 d'ordre
La <sequence> indicateur spécifie que les éléments de l' enfant 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 sur les événements sont utilisés pour définir la fréquence d'un élément peut se produire.
Note: Pour tous "Order" et "Group" indicateurs (tout, tout, choix, séquence, le nom du groupe, et la référence de groupe) , la valeur par défaut pour maxOccurs et minOccurs est 1.
maxOccurs Indicateur
Le <maxOccurs> indicateur spécifie le nombre maximal de fois qu'un élément peut se produire:
<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 le "child_name" élément peut se produire au moins une fois (la valeur par défaut est minOccurs 1) et un maximum de dix fois la "person" élément.
minOccurs Indicateur
Le <minOccurs> indicateur spécifie le nombre minimum de fois un élément peut se produire:
<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 le "child_name" élément peut se produire un minimum de temps zéro et un maximum de dix fois de la "person" élément.
Tip: Pour permettre un élément apparaisse un nombre illimité de fois, utilisez le maxOccurs = instruction "unbounded":
A working example:
Un fichier XML appelé "Myfamily.xml" :
<?xml version="1.0" encoding="UTF-8"?>
<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" . A l' intérieur de cet élément de racine , nous avons défini trois "person" éléments. Chaque "person" élément doit contenir un "full_name" élément et il peut contenir jusqu'à cinq "child_name" éléments.
Voici le fichier de schéma "family.xsd" :
<?xml version="1.0" encoding="UTF-8"?>
<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 du groupe sont utilisés pour définir des ensembles d'éléments connexes.
Groupes element
Groupes d'éléments sont définis par la déclaration du groupe, comme ceci:
<xs:group name="groupname">
...
</xs:group>
Vous devez définir un tout, le choix, ou élément de séquence dans la déclaration du groupe. L'exemple qui suit définit un groupe nommé "persongroup" , qui définit un ensemble d'éléments qui doivent se produire dans une séquence exacte:
<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 un groupe, vous pouvez référencer dans une autre définition, comme ceci:
<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
des groupes d'attributs sont définis par la déclaration de attributeGroup, comme ceci:
<xs:attributeGroup name="groupname">
...
</xs:attributeGroup>
L'exemple suivant définit un groupe d'attribut 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 un groupe d'attributs, vous pouvez référencer 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>