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