Restrictions/facettes de XSD

Des restrictions sont employ�es pour d�finir la valeur acceptable pour des �l�ments ou des attributs de XML. Des restrictions aux �l�ments de XML s'appellent les facettes.

Restrictions aux valeurs

L'exemple suivant d�finissent un �l�ment appel� le � �ge � avec une restriction. La valeur de l'�ge ne peut pas �tre 120 plus grands qu'ou inf�rieur 0 :

<xs:element name="age">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="120"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Restrictions � un ensemble de valeurs

Pour limiter la teneur des �l�ments de XML � un ensemble de valeurs acceptables, nous avions l'habitude la contrainte d'�num�ration.

L'exemple ci-dessous d�finissent un �l�ment appel� la � voiture � avec une restriction. Les seules valeurs acceptables sont : Audi, golf, BMW :

<xs:element name="car">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Audi"/>
<xs:enumeration value="Golf"/>
<xs:enumeration value="BMW"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

L'exemple ci-dessus pourrait �galement avoir �t� �crit dedans comme ceci :

<xs:element name="car" type="carType"/>
<xs:simpleType name="carType">
<xs:restriction base="xs:string">
<xs:enumeration value="Audi"/>
<xs:enumeration value="Golf"/>
<xs:enumeration value="BMW"/>
</xs:restriction>
</xs:simpleType>

Note : Dans l'exemple au-dessus du type le � carType � peut �tre employ� par d'autres �l�ments parce que ce n'est pas une partie de l'�l�ment de � voiture �.

Restrictions � une s�rie de valeurs

Pour limiter la teneur d'un �l�ment de XML pour d�finir une s�rie de lettres ou de nombres qui peuvent �tre employ�s, nous avions l'habitude la contrainte de mod�le.

L'exemple ci-dessous d�finissent un �l�ment appel� la � lettre � avec une restriction. La seule valeur acceptable est UNE de la lettre MINUSCULE d'a � z :

<xs:element name="letter">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Le prochain exemple d�finissent un �l�ment appel� les � initiales � avec une restriction. La seule valeur acceptable est TROIS de la lettre MAJUSCULE d'a � z :

<xs:element name="initials">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][A-Z][A-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Le prochain exemple d�finissent �galement un �l�ment appel� les � initiales � avec une restriction. La seule valeur acceptable est TROIS de la lettre MINUSCULE OU MAJUSCULE d'a � z :

<xs:element name="initials">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-zA-Z][a-zA-Z][a-zA-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Le prochain exemple d�finissent un �l�ment appel� le � choix � avec une restriction. La seule valeur acceptable est UNE de la lettre suivante : X, y, OU z :

<xs:element name="choice">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[xyz]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Le prochain exemple d�finissent un �l�ment appel� le � prodid � avec une restriction. La seule valeur acceptable est CINQ chiffres dans un ordre, et chaque chiffre doit �tre dans la gamme de 0 � 9 :

<xs:element name="prodid">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:pattern value="[0-9][0-9][0-9][0-9][0-9]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Restrictions aux caract�res de Whitespace

Pour indiquer comment des caract�res de whitespace devraient �tre manipul�s, nous avions l'habitude les contraintes de whiteSpace.

Cet exemple d�finissent un �l�ment appel� la � adresse � avec une restriction. La contrainte de whiteSpace est plac�e � la � conserve �, qui signifie que le processeur de XML n'enl�vera aucun caract�re d'espace blanc

<xs:element name="address">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="preserve"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Cet exemple d�finissent �galement un �l�ment appel� la � adresse � avec une restriction. La contrainte de whiteSpace est plac�e � � remplacent �, qui signifient que le processeur de XML REMPLACERA tous les caract�res d'espace blancs (retour � la ligne, �tiquettes, espaces, et retours chariot) avec les espaces :

<xs:element name="address">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="replace"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Cet exemple d�finissent �galement un �l�ment appel� la � adresse � avec une restriction. La contrainte de whiteSpace est plac�e au � effondrement �, qui signifie que le processeur de XML ENL�VERA tout le caract�re d'espace blanc (retour � la ligne, des �tiquettes, les espaces, des retours chariot sont remplac�s avec les espaces, menant et les espaces de remorquage sont enlev�s, et les espaces multiples sont r�duits � l'espace simple) :

<xs:element name="address">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="collapse"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Restrictions � la longueur

Pour limiter la longueur d'une valeur dedans � un �l�ment, nous avions l'habitude la longueur, le maxLength, et les contraintes de minLength.

Cet exemple d�finissent un �l�ment appel� le � mot de passe � avec une restriction. La valeur doit �tre exactement huit caract�res :

<xs:element name="password">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="8"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Cet exemple d�finissent un autre �l�ment appel� le � mot de passe � avec une restriction. La valeur doit �tre les huit caract�res maximum et les caract�res du minimum cinq :

<xs:element name="password">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="5"/>
<xs:maxLength value="8"/>
</xs:restriction>
</xs:simpleType>
</xs:element>

Restrictions pour Datatypes

Constraint	Description
enumeration	Defines a list of acceptable values
fractionDigits	Specifies the maximum number of decimal places allowed. Must be equal to or greater than zero
length	Specifies the exact number of characters or list items allowed. Must be equal to or greater than zero
maxExclusive	Specifies the upper bounds for numeric values (the value must be less than this value)
maxInclusive	Specifies the upper bounds for numeric values (the value must be less than or equal to this value)
maxLength	Specifies the maximum number of characters or list items allowed. Must be equal to or greater than zero
minExclusive	Specifies the lower bounds for numeric values (the value must be greater than this value)
minInclusive	Specifies the lower bounds for numeric values (the value must be greater than or equal to this value)
minLength	Specifies the minimum number of characters or list items allowed. Must be equal to or greater than zero
pattern	Defines the exact sequence of characters that are acceptable
totalDigits	Specifies the exact number of digits allowed. Must be greater than zero
whiteSpace	Specifies how white space (line feeds, tabs, spaces, and carriage returns) is handled