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:element name="age">
  <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: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 peut également s'écrire comme suit :

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

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:element name="letter">
  <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: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>

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

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:element name="choice">
  <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: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>


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:element name="letter">
  <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:element name="letter">
  <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:element name="gender">
  <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:element name="password">
  <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:element name="address">
  <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:element name="address">
  <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:element name="address">
  <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:element name="password">
  <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: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 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.
Autres extensions