Los contenidos de estos apuntes forman parte del tutorial de XSD de "Abrirllave.com".
Size: 933.52 KB
Language: es
Added: Feb 07, 2017
Slides: 21 pages
Slide Content
Apuntes de XSD de “Abrirllave.com” 1 / 21
Apuntes de XSD
(XML Schema )
{Abrirllave.com – Tutoriales de informática
Contenidos del tutorial de XSD www.abrirllave.com/xsd/
(Estos apuntes incluyen enlaces a los apartados y ejercicios resueltos del tutorial en la Web)
1. Qué es XSD
2. Validación de un documento XML con XSD
Definición de un espacio de nombres
Elementos globales y locales en XSD
elementFormDefault="unqualified"
elementFormDefault="qualified"
Validación de un sitemap XML
3. Elementos simples
Tipos de declaración de elementos simples (fixed, default)
4. Atributos
Tipos de declaración de atributos (fixed, default, optional, required)
5. Restricciones (facetas)
xs:minExclusive y xs:maxInclusive
xs:enumeration
xs:pattern
xs:length
xs:whiteSpace
7. Elementos complejos
Elemento vacío
Contenido mixto
8. Indicadores
Indicadores de orden (xs:sequence, xs:all, xs:choice)
Indicadores de ocurrencia (maxOccurs, minOccurs)
Indicadores de grupo (xs:group, xs:attributeGroup)
9. Recursos de XSD
Apuntes de XSD de “Abrirllave.com” 2 / 21
1. Qué es XSD
XSD (XML Schema Definition) es un lenguaje, también llamado simplemente XML Schema, que
sirve para definir la estructura de un documento XML, permitiendo su validación.
En los siguientes enlaces se puede consultar la W3C Recommendation de XSD, en la cual están
basados estos apuntes de introducción a XML Schema:
XML Schema Part 0: Primer
www.w3.org/TR/xmlschema-0/
XML Schema Part 1: Structures
www.w3.org/TR/xmlschema-1/
XML Schema Part 2: Datatypes
www.w3.org/TR/xmlschema-2/
Los contenidos –teoría y ejemplos– de estos apuntes, están redactados asumiendo que el
lector ya posee conocimientos previos de XML. De no ser así, se recomienda consultar el
tutorial de XML en www.abrirllave.com/xml/.
2. Validación de un documento XML con XSD
EJEMPLO Se quiere almacenar una lista de marcadores de páginas web, guardando de cada
uno de ellos su nombre, una descripción y su URL. Para ello, se ha escrito el siguiente
documento XML (“marcadores.xml”) asociado al archivo “marcadores.xsd”:
Apuntes de XSD de “Abrirllave.com” 3 / 21
Para vincular un esquema a un documento XML, es obligatorio que este último haga
referencia al espacio de nombres http://www.w3.org/2001/XMLSchema -
instance. Para ello, habitualmente se utiliza el prefijo xsi.
El atributo noNameSchemaLocation permite referenciar a un archivo con la
definición de un esquema que no tiene ningún espacio de nombres asociado. En este
caso, dicho archivo es “marcadores.xsd”.
El esquema XML guardado en “marcadores.xsd” y que permita validar el documento XML
“marcadores.xml” podría ser:
Para estar bien formado, un esquema XML tiene que cumplir las mismas reglas de sintaxis que
cualquier otro documento XML.
Por otra parte, hay que tener en cuenta que, en todos los esquemas XML, el elemento raíz es
“schema”. Ahora bien, para escribirlo, es muy común utilizar el prefijo xsd o xs.
Con xmlns:xs="http://www.w3.org/2001/XMLSchema" se ha indicado que:
Los elementos y tipos de datos utilizados en el esquema pertenecen al espacio de
nombres http://www.w3.org/2001/XMLSchema .
Dichos elementos y tipos de datos deben llevar el prefijo xs (xs:schema,
xs:element, xs:complexType, xs:string...).
Fíjese también que:
Los elementos “marcadores” y “página” son de tipo complejo (complexType), ya
que, contienen a otros elementos.
sequence indica que los elementos hijo deben aparecer, en el documento XML, en el
mismo orden en el que sean declarados en el esquema.
Los elementos “nombre”, “descripción” y “url” son de tipo simple (string en este
caso) y no pueden contener a otros elementos.
Mediante maxOccurs="unbounded" se ha indicado que pueden aparecer
ilimitados elementos “página” en el documento XML.
Ejercicio
Validar un documento XML
Apuntes de XSD de “Abrirllave.com” 4 / 21
Definición de un espacio de nombres
EJEMPLO En el siguiente documento XML se ha definido un espacio de nombres escribiendo
xmlns:mar="http://www.ab rirllave.com/marcadores" :
En el atributo schemaLocation se pueden escribir parejas de valores:
En el primer valor de cada pareja, hay que hacer referencia a un espacio de nombres.
En el segundo valor, se tiene que indicar la ubicación de un archivo donde hay un
esquema de ese espacio de nombres.
En cuanto al archivo “marcadores.xsd”, ahora su código podría ser:
Apuntes de XSD de “Abrirllave.com” 5 / 21
En el atributo targetNamespace se está indicando que los elementos definidos en
este esquema (“marcadores”, “página”, “nombre”, “descripción” y “url”), provienen
del espacio de nombres http://www.abrirllave.com/marcadores .
xmlns="http://www.abrirllave.com/marcadores" especifica que este es el
espacio de nombres por defecto.
El atributo elementFormDefault="qualified" indica que todos los elementos
declarados localmente en el esquema tienen que estar calificados, es decir, tienen que
pertenecer a un espacio de nombres. Por esta razón, en “marcadores.xls” se han
escrito con el prefijo mar.
Elementos globales y locales en XSD
Los elementos pueden ser globales o locales:
Los elementos globales son hijos directos del elemento raíz, <xs:schema> en este
caso. En el ejemplo que estamos tratando, solamente existe un elemento global:
<xs:element name="marcadores"> .
Los elementos locales son el resto de elementos.
Cuando se define un espacio de nombres, los elementos globales tienen que estar calificados,
obligatoriamente.
elementFormDefault="unqualified"
EJEMPLO En el supuesto de que el valor del atributo elementFormDefault fuese
"unqualified", para que “marcadores.xls” fuese válido, se podría escribir algo similar a:
"unqualified" es el valor por defecto del atributo elementFormDefault.
Apuntes de XSD de “Abrirllave.com” 6 / 21
elementFormDefault="qualified"
EJEMPLO Si el atributo elementFormDefault se definiese "qualified", también
sería válido el siguiente documento XML:
Ahora, ningún elemento lleva prefijo, al igual que el espacio de nombres al que pertenecen:
xmlns="http://www.abrirllave.com/marcadores"
Validación de un sitemap XML
EJEMPLO Para validar el archivo “sitemap.xml” que da solución al ejercicio de XML
propuesto en el siguiente enlace:
http://www.abrirllave.com/xml/ejercicio-crear-un-sitemap-xml.php
Obsérvese que, es necesario añadir el texto resaltado que se muestra a continuación:
Al visualizar en un navegador web el código fuente del archivo “sitemap.xsd” ubicado en:
http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd
En pantalla se verá algo parecido a:
Nótese que, en el archivo “sitemap.xsd”, la etiqueta <xsd:schema> contiene los atributos
xmlns:xsd, targetNamespace, xmlns y elementFormDefault.
Apuntes de XSD de “Abrirllave.com” 8 / 21
3. Elementos simples
Los elementos simples solamente pueden contener texto (caracteres). Dicho de otro modo,
los elementos simples no pueden contener a otro u otros elementos (hijos), ni tampoco
pueden tener atributos. Ahora bien, el texto contenido en un elemento simple, puede ser de
diferentes tipos de datos predefinidos en W3C XML Schema o definidos por el usuario
(programador).
Los tipos de datos predefinidos pueden ser primitivos (string, boolean, decimal...) o derivados
de estos (integer, ID, IDREF...). Véase en el siguiente enlace, una imagen donde se puede ver la
relación que existe entre todos ellos:
https://goo.gl/lK2l2I: este enlace lleva a una carpeta compartida de Google
Drive –pública en la Web– donde se puede acceder a la imagen “w3c-xml-schema-
type-hierarchy.gif”.
Para definir un elemento simple se puede utilizar la siguiente sintaxis:
EJEMPLO Para el elemento “curso” siguiente, donde aparece el atributo “grupo”:
<curso grupo="B">2</curso>
Sus definiciones pueden ser:
<xs:element name="curso" type="xs:integer"/>
<xs:attribute name="grupo" type="xs:string"/>
Todos los atributos pueden tomar por valor tipos simples.
Por otra parte, cuando un elemento tiene al menos un atributo –como es el caso del
elemento “curso” en este ejemplo– dicho elemento se dice que es complejo.
Tipos de declaración de atributos (fixed, default, optional,
required)
Para indicar que el valor de un atributo es fijo (fixed), es posible escribir, por ejemplo:
Por defecto, si no se indica nada, el atributo será opcional (optional).
Ejercicio resuelto
Fichas de personas
Apuntes de XSD de “Abrirllave.com” 10 / 21
5. Restricciones (facetas)
XML Schema permite definir restricciones a los posibles valores de los tipos de datos. Dichas
restricciones se pueden establecer en diferentes aspectos, llamados facetas.
Dicho de otro modo, las facetas permiten definir restricciones sobre los posibles valores de
atributos o elementos. Las facetas que pueden utilizarse son:
Facetas de XSD
Faceta
Descripción
xs:length
Especifica una longitud fija.
xs:minLength
Especifica una longitud mínima.
xs:maxLength
Especifica una longitud máxima.
xs:pattern
Especifica un patrón de caracteres admitidos.
xs:enumeration
Especifica una lista de valores admitidos.
xs:whiteSpace
Especifica cómo se debe tratar a los posibles espacios en blanco,
las tabulaciones, los saltos de línea y los retornos de carro que
puedan aparecer.
xs:maxInclusive
Especifica que el valor debe ser menor o igual que el indicado.
xs:maxExclusive
Especifica que el valor debe ser menor que el indicado.
xs:minExclusive
Especifica que el valor debe ser mayor que el indicado.
xs:minInclusive
Especifica que el valor debe ser mayor o igual que el indicado.
xs:totalDigits
Especifica el número máximo de dígitos que puede tener un
número.
xs:fractionDigits
Especifica el número máximo de decimales que puede tener un
número.
Seguidamente, se muestran algunos ejemplos de restricciones definidas con una o más facetas:
xs:minExclusive y xs:maxInclusive
EJEMPLO En el siguiente código se define un elemento llamado “mes” con la restricción de
que el valor que tome no pueda ser menor que 1 ni mayor que 12:
Apuntes de XSD de “Abrirllave.com” 11 / 21
xs:simpleType permite definir un tipo simple y especificar sus restricciones.
xs:restriction sirve para definir restricciones de un xs:simpleType (como se
ha hecho en este ejemplo). También sirve para definir restricciones de un
xs:simpleContent o de un xs:complexContent. Estos elementos se
estudiarán más adelante.
En el atributo base se indica el tipo de dato a partir del cual se define la restricción.
xs:minInclusive sirve para especificar que el valor debe ser mayor o igual que el
indicado en su atributo value, (en este caso, mayor o igual que 1).
xs:maxInclusive sirve para especificar que el valor debe ser menor o igual que el
indicado en su atributo value, (en este caso, menor o igual que 12).
También se podría haber escrito:
Haciendo esto, el tipo numeroMes definido, podría ser utilizado por otros elementos, ya que,
no está contenido en el elemento “mes”.
Ejercicios resueltos
Edad entre 0 y 130 años
Precios de tres dígitos
xs:enumeration
EJEMPLO En el siguiente ejemplo se define un elemento llamado “color” con la restricción
de que los únicos valores admitidos son: "verde", "amarillo" y "rojo".
xs:enumeration sirve para definir una lista de valores admitidos.
Ejercicio resuelto
Tipo de vehículo
Apuntes de XSD de “Abrirllave.com” 12 / 21
xs:pattern
EJEMPLO En el siguiente ejemplo se define un elemento llamado “letra” con la restricción de
que el único valor admitido es una de las letras minúsculas de la "a" a la "z":
xs:pattern sirve para definir un patrón de caracteres admitidos (en este caso se
admite una única letra minúscula de la "a" a la "z"). El valor del patrón tiene que
ser una expresión regular.
Ejercicios resueltos
Iniciales de personas famosas
Iniciales al revés
Respuestas admitidas
Números y letras
Escribir expresiones regulares
Letras admitidas
xs:length
EJEMPLO En el siguiente ejemplo se define un elemento llamado “clave” con la restricción
de que su valor tiene que ser una cadena de, exactamente, doce caracteres:
xs:length sirve para especificar una longitud fija.
Ejercicios resueltos
Longitud fija de una clave
Longitud mínima y máxima de una clave
Apuntes de XSD de “Abrirllave.com” 13 / 21
xs:whiteSpace
EJEMPLO En el siguiente ejemplo se define un elemento llamado “dirección” con la
restricción de que los espacios en blanco, las tabulaciones, los saltos de línea y los retornos de
carro que aparezcan en él, se deben mantener (preserve):
xs:whiteSpace sirve para especificar cómo se debe tratar a los posibles espacios
en blanco, las tabulaciones, los saltos de línea y los retornos de carro que puedan
aparecer.
En vez de preserve también se puede utilizar:
replace para sustituir todas las tabulaciones, los saltos de línea y los retornos de
carro por espacios en blanco.
collapse para, después de reemplazar todas las tabulaciones, los saltos de línea y
los retornos de carro por espacios en blanco, eliminar todos los espacios en blanco
únicos y sustituir varios espacios en blanco seguidos por un único espacio en blanco.
6. Extensiones
xs:extension sirve para extender un elemento simpleType o complexType.
xs:extension (complexContent)
EJEMPLO Dado el siguiente documento XML:
Obsérvese que, infoPersonaAmpliada se basa en infoPersona, añadiéndole
dos elementos: “ciudad” y “país”.
En cuanto a xs:complexContent, sirve para definir restricciones o extensiones a
un tipo complejo (complexType).
Ejercicio resuelto
Información de persona ampliada
Apuntes de XSD de “Abrirllave.com” 15 / 21
xs:extension (simpleContent)
xs:simpleContent permite definir restricciones o extensiones a elementos que solo
contienen datos, es decir, no contienen a otros elementos.
EJEMPLO El siguiente archivo “precios.xsd”:
Nótese que, utilizando xs:extension, al elemento “precio” se le ha incorporado el
atributo moneda.
Ejercicios resueltos
Precios de artículos
Información de ubicaciones
Colores de muebles
Apuntes de XSD de “Abrirllave.com” 16 / 21
7. Elementos complejos
Un elemento es complejo (complexType) cuando contiene uno o más elementos y/o
atributos. De entre las posibles combinaciones de elementos y/o atributos que puede
contener un elemento complejo (1 elemento y 0 atributos, 1 elemento y 1 atributo, 1
elemento y varios atributos, 0 elementos y 1 atributo...) cabe destacar las siguientes:
Un elemento complejo puede estar vacío, es decir, no contener elementos ni texto,
pero sí tener al menos un atributo.
Un elemento complejo puede contener contenido mixto, es decir, contener uno o
más elementos, además de texto. Por otra parte, podría tener atributos, o no.
Elemento vacío
EJEMPLO En el siguiente código se ha definido vacío el elemento “bola”, no pudiendo
contener ni otros elementos ni texto. Ahora bien, véase que sí tiene un atributo, llamado
numero:
8. Indicadores
Los indicadores permiten establecer cómo se van a escribir –o utilizar– los elementos en un
documento XML. Hay siete tipos de indicadores que se pueden clasificar en:
Indicadores de orden: secuencia (sequence), todo (all) y elección (choice).
Indicadores de ocurrencia: maxOccurs y minOccurs.
Indicadores de grupo: de elementos (group) y de atributos (attributeGroup).
Indicadores de orden (xs:sequence, xs:all, xs:choice)
Mientras que xs:sequence sirve para especificar el orden en el que obligatoriamente
deben aparecer los elementos hijo de un elemento, xs:all sirve para indicar que dichos
elementos pueden aparecer en cualquier orden.
EJEMPLO El siguiente archivo “lugar.xsd”:
Apuntes de XSD de “Abrirllave.com” 18 / 21
Por otra parte, xs:choice sirve para especificar que solamente se permite escribir uno de
los elementos hijo. Por ejemplo, en este caso, se podría utilizar para indicar que habría que
elegir entre escribir el “nombre” o escribir el “país” de la “ciudad”, pero no ambos.
Indicadores de ocurrencia (maxOccurs, minOccurs)
maxOccurs y minOccurs permiten establecer, respectivamente, el número máximo y
mínimo de veces que puede aparecer un determinado elemento. El valor por defecto para
maxOccurs y minOccurs es 1.
EJEMPLO Dado el siguiente documento XML “paises.xml”:
Considerando que se quiere especificar que:
“país” pueda aparecer una o ilimitadas veces.
“nombre” tenga que escribirse obligatoriamente, y solo una vez, dentro de “persona”.
De cada “país” puedan escribirse de cero a cinco “ciudades”.
El código del archivo “paises.xsd” que permita validar “paises.xml”, podría ser:
Indicadores de grupo (xs:group, xs:attributeGroup)
xs:group sirve para agrupar un conjunto de declaraciones de elementos relacionados.
EJEMPLO Dado el siguiente documento XML “personas.xml”:
Obsérvese que, se ha definido el grupo datosBasicos, el cual ha sido incorporado a
la definición del tipo complejo datosDePersona.
Del mismo modo, attributeGroup sirve para definir un grupo de atributos. Por ejemplo,
para validar el siguiente documento XML:
En este caso, se ha definido el grupo de atributos datosDePersona, el cual ha sido
incorporado a la definición del elemento persona.
Ejercicios resueltos
Panel de vuelos
Factura
Registro de conexiones
Personal de departamentos
9. Recursos de XSD
Tutorial de XSD
http://www.abrirllave.com/xsd/
Ejercicios resueltos de XSD
http://www.abrirllave.com/xsd/ejercicios-resueltos.php
ACERCA DE LOS CONTENIDOS DE ESTE DOCUMENTO
Todos los contenidos de este documento forman parte del Tutorial de XSD de Abrirllave y
están bajo la Licencia Creative Commons Reconocimiento 4.0 Internacional (CC BY 4.0).