XSD Restrictions / Facettes
Les restrictions sont utilisées pour définir les valeurs acceptables pour les éléments ou attributs XML. Les restrictions sur les éléments XML sont appelées facettes.
Restrictions sur les valeurs
L'exemple suivant définit un élément nommé "age" avec une restriction. La valeur de age ne peut pas être inférieure à 0 ni supérieure à 120 :
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="120"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Restriction sur un ensemble de valeurs
Pour restreindre le contenu d'un élément XML à un ensemble de valeurs acceptables, nous utilisons la contrainte d'énumération.
L'exemple suivant définit un élément nommé "car" avec une restriction. Les valeurs acceptables sont uniquement : Audi, Golf, BMW :
<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 peut également s'écrire comme suit :
<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>
Remarque :Dans ce cas, le type "carType" peut être utilisé par d'autres éléments parce qu'il ne fait pas partie de l'élément "car".
Restriction sur une série de valeurs
Pour restreindre le contenu d'un élément XML à une série de nombres ou de lettres utilisables, nous utilisons la contrainte de modèle.
L'exemple suivant définit un élément nommé "letter" avec une restriction. Les valeurs acceptables sont uniquement l'une des lettres minuscules a - z :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
L'exemple suivant définit un élément nommé "initials" avec une restriction. Les valeurs acceptables sont trois lettres majuscules parmi A - Z :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][A-Z][A-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
L'exemple suivant définit également un élément nommé "initials" avec une restriction. Les valeurs acceptables sont trois lettres majuscules ou minuscules a - z :
<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>
L'exemple suivant définit un élément nommé "choice" avec une restriction. Les valeurs acceptables sont l'une des lettres x, y ou z :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[xyz]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
L'exemple suivant définit un élément nommé "prodid" avec une restriction. Les valeurs acceptables sont une séquence de cinq chiffres arabes, chaque chiffre allant de 0 à 9 :
<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>
Autres restrictions sur une série de valeurs
L'exemple suivant définit un élément nommé "letter" avec une restriction. Les valeurs acceptables sont zéro ou plusieurs lettres de a à z :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="([a-z])*"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
L'exemple suivant définit un élément nommé "letter" avec une restriction. Les valeurs acceptables sont une ou plusieurs paires de lettres, chaque paire étant constituée d'une lettre minuscule suivie d'une lettre majuscule. Par exemple, "sToP" réussirait la validation de ce motif, mais "Stop", "STOP" ou "stop" ne réussiraient pas la validation :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="([a-z][A-Z])+"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
L'exemple suivant définit un élément nommé "gender" avec une restriction. Les valeurs acceptables sont male ou female :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="male|female"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
L'exemple suivant définit un élément nommé "password" avec une restriction. Les valeurs acceptables sont une ligne de caractères composée de 8 caractères, qui doivent être des lettres majuscules ou minuscules de a à z ou des chiffres de 0 à 9 :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-zA-Z0-9]{8}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Restriction sur les caractères d'espacement
Pour spécifier la façon dont les caractères d'espacement sont gérés, nous devons utiliser la restriction whiteSpace.
L'exemple suivant définit un élément nommé "address" avec une restriction. Cette restriction whiteSpace est définie sur "preserve", ce qui signifie que le processeur XML ne supprimera aucun caractère d'espacement :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="preserve"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Cet exemple définit également un élément nommé "address" avec une restriction. Cette restriction whiteSpace est définie sur "replace", ce qui signifie que le processeur XML supprimera tous les caractères d'espacement (sauts de ligne, retours chariot, espaces et tabulations) :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="replace"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Cet exemple définit également un élément nommé "address" avec une restriction. Cette restriction whiteSpace est définie sur "collapse", ce qui signifie que le processeur XML supprimera tous les caractères d'espacement (les sauts de ligne, les retours chariot, les espaces et les tabulations sont remplacés par des espaces, les espaces de début et de fin sont supprimés, et plusieurs espaces consécutifs sont réduits à un seul espace) :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="collapse"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Restrictions sur la longueur
Pour restreindre la longueur d'une valeur dans un élément, nous devons utiliser les restrictions length, maxLength et minLength.
Cet exemple définit un élément nommé "password" avec une restriction. Sa valeur doit comporter exactement 8 caractères :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="8"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Cet exemple définit également un élément nommé "password" avec une restriction. Sa valeur doit comporter au moins 5 caractères et au plus 8 caractères :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="5"/>
<xs:maxLength value="8"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
Restrictions des types de données
| Restriction | Description |
|---|---|
| enumeration | Définit une liste de valeurs acceptables |
| fractionDigits | Définit le nombre maximal de décimales autorisées. Doit être supérieur ou égal à 0. |
| longueur | Définit le nombre exact de caractères ou d'éléments de liste autorisés. Doit être supérieur ou égal à 0. |
| maxExclusive | Définit la borne supérieure d'une valeur. Les valeurs autorisées doivent être inférieures à cette valeur. |
| maxInclusive | Définit la borne supérieure d'une valeur. Les valeurs autorisées doivent être inférieures ou égales à cette valeur. |
| maxLength | Définit le nombre maximal de caractères ou d'éléments de liste autorisés. Doit être supérieur ou égal à 0. |
| minExclusive | Définit la borne inférieure d'une valeur. Les valeurs autorisées doivent être supérieures à cette valeur. |
| minInclusive | Définit la borne inférieure d'une valeur. Les valeurs autorisées doivent être supérieures ou égales à cette valeur. |
| minLength | Définit le nombre minimal de caractères ou d'éléments de liste autorisés. Doit être supérieur ou égal à 0. |
| pattern | Définit la séquence exacte de caractères acceptables. |
| totalDigits | Définit le nombre exact de chiffres arabes autorisés. Doit être supérieur à 0. |
| whiteSpace | Définit la façon dont les caractères d'espacement (sauts de ligne, retours chariot, espaces et tabulations) sont gérés. |