XSD Restricciones / Facets


Las restricciones (restriction) se utilizan para definir valores aceptables para elementos o atributos XML. Las restricciones sobre elementos XML se denominan facets.


Restricciones sobre valores

El siguiente ejemplo define un elemento llamado "age" con una restricción. El valor de age no puede ser inferior a 0 ni superior a 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>


Restricciones sobre un conjunto de valores

Para restringir el contenido de un elemento XML a un conjunto de valores aceptables, utilizamos una restricción de enumeración (enumeration constraint).

El siguiente ejemplo define un elemento llamado "car" con una restricción. Los únicos valores aceptables son: 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>

El ejemplo anterior también puede escribirse como:

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

Nota:En este caso, el tipo "carType" puede ser utilizado por otros elementos porque no forma parte del elemento "car".


Restricciones sobre una serie de valores

Para restringir el contenido de un elemento XML a una serie de números o letras utilizables, utilizamos una restricción de patrón (pattern constraint).

El siguiente ejemplo define un elemento llamado "letter" con una restricción. El único valor aceptable es una de las letras minúsculas a - z:

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

El siguiente ejemplo define un elemento llamado "initials" con una restricción. Los valores aceptables son tres de las letras mayúsculas 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>

El siguiente ejemplo también define un elemento llamado "initials" con una restricción. Los valores aceptables son tres de las letras mayúsculas o minúsculas 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>

El siguiente ejemplo define un elemento llamado "choice" con una restricción. El valor aceptable es una de las letras x, y o z:

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

El siguiente ejemplo define un elemento llamado "prodid" con una restricción. El valor aceptable es una secuencia de cinco dígitos arábigos, y cada dígito está en el rango 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>


Otras restricciones sobre una serie de valores

El siguiente ejemplo define un elemento llamado "letter" con una restricción. Los valores aceptables son cero o más letras 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>

El siguiente ejemplo define un elemento llamado "letter" con una restricción. Los valores aceptables son uno o más pares de letras, cada par compuesto por una letra minúscula seguida de una letra mayúscula. Por ejemplo, "sToP" pasará la validación de este patrón, pero "Stop", "STOP" o "stop" no la pasarán:

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

El siguiente ejemplo define un elemento llamado "gender" con una restricción. Los valores aceptables son male o female:

<xs:element name="gender">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="male|female"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

El siguiente ejemplo define un elemento llamado "password" con una restricción. El valor aceptable es una cadena de 8 caracteres, los cuales deben ser letras mayúsculas o minúsculas a - z o dígitos 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>


Restricciones sobre caracteres de espacio en blanco

Para especificar cómo se manejan los caracteres de espacio en blanco (whitespace characters), necesitamos utilizar la restricción whiteSpace.

El siguiente ejemplo define un elemento llamado "address" con una restricción. Esta restricción whiteSpace está establecida en "preserve", lo que significa que el procesador XML no eliminará ningún carácter de espacio en blanco:

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

Este ejemplo también define un elemento llamado "address" con una restricción. Esta restricción whiteSpace está establecida en "replace", lo que significa que el procesador XML eliminará todos los caracteres de espacio en blanco (saltos de línea, retornos de carro, espacios y tabulaciones):

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

Este ejemplo también define un elemento llamado "address" con una restricción. Esta restricción whiteSpace está establecida en "collapse", lo que significa que el procesador XML eliminará todos los caracteres de espacio en blanco (los saltos de línea, retornos de carro, espacios y tabulaciones se reemplazan por espacios, los espacios al inicio y al final se eliminan, y múltiples espacios consecutivos se reducen a un solo espacio):

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


Restricciones sobre la longitud

Para restringir la longitud de un valor en un elemento, necesitamos utilizar las restricciones length, maxLength y minLength.

Este ejemplo define un elemento llamado "password" con una restricción. Su valor debe tener exactamente 8 caracteres:

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

Este ejemplo también define un elemento llamado "password" con una restricción. Su valor debe tener un mínimo de 5 caracteres y un máximo de 8 caracteres:

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


Restricciones de tipos de datos

Restricción Descripción
enumeration Define una lista de valores aceptables.
fractionDigits Define el número máximo de decimales permitido. Debe ser mayor o igual que 0.
length Define el número exacto de caracteres o elementos de lista permitidos. Debe ser mayor o igual que 0.
maxExclusive Define el límite superior de un valor numérico. El valor permitido debe ser menor que este valor.
maxInclusive Define el límite superior de un valor numérico. El valor permitido debe ser menor o igual que este valor.
maxLength Define el número máximo de caracteres o elementos de lista permitidos. Debe ser mayor o igual que 0.
minExclusive Define el límite inferior de un valor numérico. El valor permitido debe ser mayor que este valor.
minInclusive Define el límite inferior de un valor numérico. El valor permitido debe ser mayor o igual que este valor.
minLength Define el número mínimo de caracteres o elementos de lista permitidos. Debe ser mayor o igual que 0.
pattern Define la secuencia exacta de caracteres aceptables.
totalDigits Define el número exacto de dígitos arábigos permitidos. Debe ser mayor que 0.
whiteSpace Define cómo se manejan los caracteres de espacio en blanco (saltos de línea, retornos de carro, espacios y tabulaciones).
Otras extensiones