Manual de XML

MANUAL DE XML
1.- Indice del Manual |

2.- Introduccin al lenguaje de marcas XML |
3.- Operador (+): una o muchas apariciones de un nodo |
4.- Operador (|): aparicin de uno u otro elemento |
5.- Utilizacin de los atributos en los nodos |
6.- Tipo de atributo ID |
7.- DTD vs XML-Schema |
8.- XSL: Hojas de estilo para la transformacin de documentos XML |
9.- Expresiones de acceso a nodos XML con Xpath |
10.- Diseo de Hojas de estilos XSL |
11.- Procesamiento Procedural |
12.- Transformacin de ficheros XML con Apache Ant |
13.- Objetos de Formato |
14.- Descripcin del proceso de generacin de PDFs |
15.- Creacin de una hoja de estilos XSL que transformar el documento XML en un fichero XSL-FO |
16.- Herramientas para el trabajo con XML

1.- INDICE DEL MANUAL DE XML
Introduccin al lenguaje de marcas XML - Empezando a ver que es XML.

Operador (+): una o muchas apariciones de un nodo - Este y otros operadores son fundamentales para definir la
estructura del documento XML.

Operador (|): aparicin de uno u otro elemento - Permite definir varios elementos como vlidos.

Utilizacin de los atributos en los nodos - De esta forma podremos definir qu elementos pueden llevar atributos
y cuales.

Tipo de atributo ID - El atributo ID identifica cada elemento de forma nica.

DTD vs XML-Schema - Comparacin de estos dos mtodos.

XSL: Hojas de estilo para la transformacin de documentos XML - Transformacin de documentos XML a otros
documentos XML.

Expresiones de acceso a nodos XML con Xpath - Otro mtodo para acceder a los nodos.

Diseo de Hojas de estilos XSL - Creando las primeras hojas de estilo XSL.

Procesamiento Procedural - Otra forma de aplicar plantillas (templates).

Transformacin de ficheros XML con Apache Ant - Transformacin de archivos XML con XSL y Ant.

Objetos de Formato - Permiten transformar el documento XML en otros documentos como por ejemplo PDF.

Descripcin del proceso de generacin de PDFs - Convirtiendo ficheros XML a PDF.

Creacin de una hoja de estilos XSL que transformar el documento XML en un fichero XSL-FO - til para la
generacin de datos dinmica.

Herramientas para el trabajo con XML - Para seguir trabajando con XML.
2.- INTRODUCCION AL LENGUAJE DE MARCAS XML
Un documento XML es vlido si ha sido asociado a un documento de definicin de
tipos y si el documento cumple las restricciones expresadas en l. El documento de
definicin de tipos tiene que aparecer antes del primer elemento del documento. El
nombre que sigue a DOCTYPE en el documento de definicin de tipos debe ser el
mismo que el nombre del elemento raz.
Ejemplo 1:
Un documento puede contener nicamente el elemento raz tutorial que contiene algn
texto.
<!ELEMENT tutorial (#PCDATA)>

Un documento vlido que contiene algn texto
<!DOCTYPE tutorial SYSTEM "tutorial.dtd">
<tutorial>Este es un documento XML</tutorial>

Este documento tambin es vlido
<!DOCTYPE tutorial SYSTEM "tutorial.dtd">
<tutorial/>

Elementos padre/hijo en los documentos XML.- Un tipo elemento puede contener otros
elementos hijos. En este caso no podr contener ningn texto sino tan solo elementos
separados, opcionalmente, por espacios en blanco.
Ejemplo 2:
El elemento raz XXX debe contener nicamente un elemento AAA seguido de otro
elemento BBB. Los elementos AAA y BBB pueden contener texto pero no otros
elementos.
<!ELEMENT XXX (AAA , BBB)>
<!ELEMENT AAA (#PCDATA)>
<!ELEMENT BBB (#PCDATA)>

Un documento vlido que contiene algn texto
<!DOCTYPE XXX SYSTEM "tutorial.dtd">
<XXX>
<AAA>Comienzo</AAA>
<BBB>Fin</BBB>
</XXX>

Este documento tambin es vlido
<XXX> <AAA/> <BBB/> </XXX>

Operador (*): cero o muchas apariciones de un nodo
Si el nombre de un elemento en una DTD va seguido por un asterisco [*], este elemento
puede aparecer ninguna, una o varias veces.
Ejemplo 3:
El elemento raz XXX puede contener ninguno, uno o varios elementos AAA seguido
de exactamente un elemento BBB. El elemento BBB tiene que estar siempre presente.
<!ELEMENT XXX (AAA* , BBB)>

Un documento vlido

Otro documento vlido. El elemento AAA no es obligatorio
<XXX> <BBB/> </XXX>

Ms de un elemento AAA puede aparecer dentro del documento
<XXX> <AAA/> <AAA/> <AAA/> <AAA/> <AAA/> <AAA/> <AAA/>
<BBB/> </XXX>

3.- OPERADOR (+): UNA O MUCHAS APARICIONES DE UN NODO
Si el nombre de un elemento en una DTD est seguido por el caracter ms [+], este
elemento tiene que aparecer una o ms veces .
Ejemplo 4: el elemento raz XXX debe contener uno o ms elementos AAA seguidos de
exactamente un elemento BBB. El elemento BBB tiene que estar siempre presente.
<!ELEMENT XXX (AAA+ , BBB)>

Un documento vlido

Pueden aparecer varios elementos AAA en el documento
<XXX> <AAA/> <AAA/> <AAA/> <AAA/> <AAA/>
<AAA/> <AAA/> <BBB/> </XXX>

Operador (?): cero o una aparicin de un nodo (opcionalidad).- Si el nombre de un
elemento en la DTD est seguido por un signo de interrogacin [?], este elemento puede
aparecer ninguna o una vez.
Ejemplo 5:
El elemento raz XXX puede contener un elemento AAA seguido de exactamente un
elemento BBB. El elemento BBB tiene que estar siempre presente:
<!ELEMENT XXX (AAA? , BBB)>
<!ELEMENT AAA (#PCDATA)><!ELEMENT BBB (#PCDATA)>

Un documento vlido:

El elemento AAA no es obligatorio:
<XXX> <BBB/> </XXX>

Combinacin de los operadores +, * y ?.- Este ejemplo usa una combinacin de [ + * ?]
Example 6:
El elemento raz XXX puede contener un elemento AAA seguido de uno o ms
elementos BBB. El elemento AAA puede contener un elemento CCC y varios
elementos DDD. El elemento BBB tiene que contener, exactamente, un elemento CCC
y un elemento DDD:
<!ELEMENT XXX (AAA? , BBB+)>
<!ELEMENT AAA (CCC? , DDD*)>
<!ELEMENT BBB (CCC , DDD)>
<!ELEMENT CCC (#PCDATA)>
<!ELEMENT DDD (#PCDATA)>

Un documento vlido:
<XXX>
<AAA>
<CCC/><DDD/>
</AAA>
<BBB>
<CCC/><DDD/>
</BBB>
</XXX>

Los elementos en AAA no son obligatorios:
<XXX>
<AAA/>
<BBB>
<CCC/><DDD/>
</BBB>
</XXX>

El elemento AAA no puede ser omitido:
<XXX>
<BBB>
<CCC/><DDD/>
</BBB>
</XXX>
4.- OPERADOR (|): APARICION DE UNO U OTRO ELEMENTO
Con el caracter [ | ] se puede seleccionar uno de entre varios elementos.
Ejemplo 7: el elemento raz XXX debe contener un elemento AAA seguido de un
elemento BBB. El elemento AAA tiene que contener un elemento CCC seguido de un
elemento DDD. El elemento BBB tiene que contener bien un elemento CCC o bien un
elemento DDD:
<!ELEMENT XXX (AAA , BBB)>
<!ELEMENT AAA (CCC , DDD)>
<!ELEMENT BBB (CCC | DDD)>

Un documento vlido:
<XXX>
<AAA>
<CCC/> <DDD/>
</AAA>
<BBB>
<CCC/>
</BBB>
</XXX>

Otro documento vlido:
<XXX>
<AAA>
<CCC/> <DDD/>
</AAA>
<BBB>
<DDD/>
</BBB>
</XXX>

Intercalado de nodos y texto en un documento.- El texto puede ser intercalado con
elementos.
Ejemplo 8:
El elemento AAA puede contener o bien BBB o CCC. Por otro lado el elemento BBB
puede contener cualquier combinacin de texto y elementos CCC.:
<!ELEMENT XXX (AAA+ , BBB+)>
<!ELEMENT AAA (BBB | CCC )>
<!ELEMENT BBB (#PCDATA | CCC )*>

Un documento vlido que explora varias posibilidades:
<XXX>
<AAA>
<CCC>Exactamente un elemento.</CCC>
</AAA>
<AAA>
<BBB>
<CCC/>
<CCC/>
<CCC/>
</BBB>
</AAA>
<BBB/>
<BBB>
Esta es <CCC/> una combinacion <CCC/> de <CCC> elementos CCC
</CCC> y texto <CCC/>.
</BBB>
<BBB>
Slo texto.
</BBB>
</XXX>
5.- UTILIZACION DE LOS ATRIBUTOS EN LOS NODOS
Los atributos se usan para asociar pares nombre-valor con elementos. La especificacin
de atributos slo puede aparecer dentro de la etiqueta de apertura y en los elementos
vacios. La declaracin comienza con ATTLIST seguido del nombre del elemento al que
pertenece el atributo y despus le sigue la definicin individual de cada atributo.
Ejemplo 9:
Un atributo del tipo CDATA puede contener cualquier caracter si ste se atiene a las
reglas de formacin. Los atributos #REQUIRED deben estar siempre presentes, los
#IMPLIED son opcionales:
<!ELEMENT attributes (#PCDATA)>
<!ATTLIST attributes
aaa CDATA #REQUIRED
bbb CDATA #IMPLIED>

Los atributos CDATA pueden contener cualquier caracter que se atenga a las reglas:
<!DOCTYPE attributes SYSTEM "tutorial.dtd">
<attributes aaa="#d1" bbb="*~*">
Text
</attributes>

El orden de los atributos es indiferente:
<attributes bbb="$25" aaa="13%">
Texto
</attributes>

El atributo bbb puede omitirse ya que es #IMPLIED:
<attributes aaa="#d1" />

Tipos de atributos CDATA, NMTOKEN y NMTOKENS.-
Un atributo del tipo CDATA puede contener cualquier caracter si ste se atiene a las
reglas de formacin. Si es del tipo NMTOKEN slo puede contener letras, dgitos,
punto [ . ], guin [ - ], subrayado [ _ ] y dos puntos [ : ] . Los del tipo NMTOKENS
pueden contener los mismos caracteres que NMTOKEN ms espacios en blanco. Un
espacio en blanco consiste en uno o ms espacios, retornos de carro o tabuladores.
Ejemplo 10:
Los atributos bbb y ccc siempre tienen que estar presentes, el atributo aaa es opcional:
<!ELEMENT attributes (#PCDATA)>
<!ATTLIST attributes
aaa CDATA #IMPLIED
bbb NMTOKEN #REQUIRED
ccc NMTOKENS #REQUIRED>

Todos los atributos obligatorios estn presentes y sus valores son del tipo correcto:
<attributes aaa="#d1" bbb="a1:12" ccc=" 3.4 div -4"/>

Todos los atributos obligatorios estn presentes y sus valores son del tipo correcto:
<attributes bbb="a1:12" ccc="3.4 div -4"/>
6.- TIPO DE ATRIBUTO ID
El valor de un atributo de tipo ID puede contener slo caracteres vlidos en NMTOKEN
y debe comenzar con una letra. Ningn tipo de elemento puede tener especificado ms
de un atributo de tipo ID. El valor de un atributo ID debe ser nico entre todos los
valores de atributos ID.
Ejemplo11:
Los atributos id, code y X determinan de manera inequvoca su elemento:
<!ELEMENT XXX (AAA+ , BBB+ , CCC+)>
<!ATTLIST AAA
id ID #REQUIRED>
<!ATTLIST BBB
code ID #IMPLIED
list NMTOKEN #IMPLIED>
<!ATTLIST CCC
X ID #REQUIRED
Y NMTOKEN #IMPLIED>

Todos los valores ID son nicos:
<XXX>
<AAA id="a1"/>
<AAA id="a2"/>
<AAA id="a3"/>
<BBB code="QWQ-123-14-6" list="14:5"/>
<CCC X="zero" Y="16" />
</XXX>

Los atributos list y Y son del tipo NMTOKEN no ID. stos pueden tener, por lo tanto,
el mismo valor que los atributos ID o tener el mismo valor en varios elementos:
<XXX>
<AAA id="L12"/>
<BBB code="QW" list="L12"/>
<CCC X="x-0" Y="QW" />
<CCC X="x-1" Y="QW" />
</XXX>

Tipo de atributo IDREF y IDREFS.- El valor de un atributo IDREF tiene que
corresponder con el valor de algn atributo ID del documento. El valor del atributo
IDREFS puede contener varias referencias a elementos con atributos ID separados por
espacios en blanco.
Ejemplo 12:
Los atributos id y mark determinan inequvocamente su elemento. Los atributos ref
hacen referencia a estos elementos:
<!ELEMENT XXX (AAA+ , BBB+, CCC+, DDD+)>
<!ATTLIST AAA
mark ID #REQUIRED>
<!ATTLIST BBB
id ID #REQUIRED>
<!ATTLIST CCC
ref IDREF #REQUIRED>
<!ATTLIST DDD
ref IDREFS #REQUIRED>

Todos los valores ID son nicos y todos los valores IDREF e IDREFS apuntan a
elementos con IDs relevantes:
<XXX>
<AAA mark="a1"/>
<AAA mark="a2"/>
<AAA mark="a3"/>
<BBB id="b001" />
<CCC ref="a3" />
<DDD ref="a1 b001 a2"/>
</XXX>
7.- DTD VS XML-SCHEMA
Ejemplo de documento XML para matrcula
Definicin general del documento XML que representa la imagen de matrcula de un
alumno que realiza la Automatrcula en la Universitat Jaume I. En esto documento no
diferenciamos si su estructura interna va a ser definida por un DTD o por un XML-
Schema ...
<?xml version="1.0" encoding="ISO-8859-1"?>
<matricula>
<personal>
<dni>52945813C</dni>
<nombre>Ricardo Borillo Domenech</nombre>
<titulacion>Enginyeria Informtica (Pla 2001)</titulacion>
<curso_academico>2002/2003</curso_academico>
<domicilios>
<domicilio tipo="familiar">
<nombre>C/ Principal n1</nombre>
</domicilio>
<domicilio tipo="habitual">
<nombre>C/ Secundaria n2</nombre>
</domicilio>
</domicilios>
</personal>
<pago>
<tipo_matricula>Matrcula ordinria</tipo_matricula>
</pago>
</matricula>

En el caso de que queramos definir la estructura del documento mediante un XML-
Schema, deberemos sustituir la cabecera del documento de la forma siguiente:
<matricula xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="prueba.xsd">
...
</matricula>

Si por el contrario, queremos seguir utilizando la estructura clsica de un DTD:
<!DOCTYPE matricula SYSTEM "matricula.dtd">
<matricula>
...
</matricula>

Ejemplo de DTD para matrcula.-
<!ENTITY matricula (personal, pago)>
<!ENTITY personal (dni, nombre, titulacion, curso_academico, domicilios)>
<!ENTITY dni (#PCDATA)>
<!ENTITY nombre (#PCDATA)>
<!ENTITY titulacion (#PCDATA)>
<!ENTITY curso_academico (#PCDATA)>
<!ENTITY domicilios (domicilio+)>
<!ENTITY domicilio (nombre)>
<!ATTLIST domicilio
tipo (familiar|habitual) #REQUIRED>
<!ENTITY nombre (#PCDATA)>
<!ENTITY pago (tipo_matricula)>
<!ENTITY tipo_matricula (#PCDATA)>

Ejemplo de XML-Schema para matrcula.-
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xml:lang="ES">
<xs:element name="matricula" type="tMatricula"/>

<xs:complexType name="tMatricula">
<xs:sequence>
<xs:element name="personal" type="tPersonal"/>
<xs:element name="pago" type="tPago"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="tPersonal">
<xs:all>
<xs:element name="dni" type="xs:string"/>
<xs:element name="nombre" type="xs:string"/>
<xs:element name="titulacion" type="xs:string"/>
<xs:element name="curso_academico" type="xs:string"/>
<xs:element name="domicilios" type="tDomicilio"/>
</xs:all>
</xs:complexType>
<xs:complexType name="tPago">
<xs:all>
<xs:element name="tipo_matricula" type="xs:string"/>
</xs:all>
</xs:complexType>
<xs:complexType name="tDomicilio">
<xs:sequence>
<xs:element name="domiclio" maxOccurs="unbounded">
<xs:complexType>
<xs:all>
<xs:element name="nombre" type="xs:string"/>
</xs:all>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:schema>

XML-Schemas y RELAX NG.- Al igual que surgi XML Schema como una mejora
necesaria sobre la idea en la que se fundamentaban las DTDs, han surgido distintas
propuestas al margen de los Schemas, de estas ideas no vamos a quedar con una,
RELAX NG, que es, a su vez, la fusin de otras dos iniciativas TREX y RELAX que
para conseguir un mayor avance han decidido aunar fuerzas. Bsicamente, RELAX NG
maneja documentos XML que representan esquemas e instancias a travs de un modelo
abstracto de datos, esto que suena un poco oscuro viene a querer expresar que, para
RELAX NG, un documento XML es la representacin de un elemento y que a su vez un
elemento est formado por una serie de "partes" como son: un nombre, un contexto, un
conjunto de atributos y una secuencia ordenada de cero o ms hijos. Y as con cada una
de estas partes. Aunque la especificacin completa se puede encontrar en OASIS7,
vamos a mostrar cuales son la principales diferencias, no tanto conceptuales si no de
uso, de RELAX NG con respecto a XML Schema. En primer lugar es importante
resaltar que RELAX NG, y sus precursores RELAX y TREX, son intentos de
simplificar y/o potenciar la utilidad de las DTDs en general y en particular de XML
Schema. Tambin es importante indicar que esta iniciativa no es oficial de W3.ORG, si
bien est impulsndose dentro de un nutrido grupo de gente lideradas por James Clark,
MURATA Makoto, y an no est reconocido por el estndar ni tan siquiera como
recomendacin. En segundo lugar, podemos decir, sin mucho margen de error, que la
principal mejora de RELAX NG respecto a XML Schema es la mayor simplicidad en
manejo y aprendizaje que requiere. Como consecuencia de esta simplificacin
renunciamos al uso de los <simpleType> y <complexType> a favor del uso de,
nicamente, elementos y ciertas etiquetas especiales para marcar nmero requerido de
apariciones, tipo de dato de un elemento, etc
8.- XSL: HOJAS DE ESTILO PARA LA TRANSFORMACION DE DOCUMENTOS XML
XSL es un lenguaje creado para dar estilo a los documentos XML a los cuales se aplica.
As, XSL es una especificacin que se compone de partes o recomendaciones:

-Xpath: lenguaje que permite escribir expresiones para la bsqueda de nodos dentro del
arbol XML.
-XSLT: reglas o patrones para la transformacin del contenido de los nodos XML sobre
los cuales se consigue una correspondencia. Si lo que queremos es generar pginas
HTML a partir de documentos XML, podemos complementar/sustituir XSL por CSS.
-Formatting Objects: actualmente, constituye un lenguaje de especificacin de estilo en
base al cual nos es posible la generacin de PDFs.
Patrones de transformacin XSLT.-
Definicin de las cabeceras de la pgina XSL
Ejemplo 16.
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">
...
</xsl:stylesheet>

El patrn o template: Elemento bsico de la pginas de estilo
Para cada nodo del rbol XML tenemos la posibilidad de definir un patrn de estilos
que marcar como se va a presentar este nodo en el documento final. Por ejemplo, si
tenemos el siguiente documento XML:
Ejemplo 17:
<test1>
<titulo>Prueba de patrones XSL</titulo>
<descripcion>Cuerpo del documento</descripcion>
</test1>

... y esta hoja de estilos:
version="1.0">
<xsl:template match="test1">
<html>
<head>
<title><xsl:apply-templates select="titulo" mode="head"/></title>
</head>
<body>
<xsl:apply-templates/>
</body>
</html>
</xsl:template>
<xsl:template match="titulo" mode="head">
<xsl:value-of select="text()"/>
</xsl:template>
<xsl:template match="titulo">
<h1><xsl:value-of select="text()"/></h1>
</xsl:template>
<xsl:template match="descripcion">
</xsl:template>
</xsl:stylesheet>

... el resultado de la transformacin ser el siguiente:
<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
<title>Prueba de patrones XSL</title>
</head>
<body>
<h1>Prueba de patrones XSL</h1>
<h3>Cuerpo del documento</h3>
</body>
</html>

En este ejemplo podemos apreciar de varias instrucciones XSL:
1.Uso de la instruccin "xsl:template" para definir nuevos templates con los que van a ir
identicndose los nodos del documento XML. En los templates, podemos utilizar el
atributo modificador "mode" con el fin de poder llamar a un mismo template desde dos
contextos distintos en los que queremos dos resultados distintos. Es por esto que
procesar el nodo "title" desde la cabecera o desde el cuerpo del documento HTML, va
ha tener una representacin distinta.
2.Uso de sentencias de procesamiento de templates como "xsl:apply-templates". Esta
instruccin lanza la bsqueda de templates a aplicar a partir del punto en el que nos
encontremos del rbol XML. Si ya hemos procesado el nodo titulo con un template
'xsl:template match="titulo"' y desde aqu queremos procesar la descripcin, no
podremos utilizar directamente un "xsl:apply-templates" ya que este nodo se encuentra
en otro punto de la jerarqua. A esta instruccin podemos aplicarle el atributo
modificador "select", para restringir los templates que se aplican a los de un tipo
determinado.
9.-EXPRESIONES DE ACCESO A NODOS XML CON XPATH
Ejemplos de expresiones que podemos aplicar dentro del modificador "select" de una
instruccin "xsl:apply-templates":
-Acceso a todos los nodos "titulo":
<xsl:apply-templates select="titulo"/>

-Acceso a todos los nodos "titulo" que tengan como padre a "test1":
<xsl:apply-templates select="test1/titulo"/>

-Acceso al nodo raz del documento XML:
<xsl:apply-templates select="/"/>

-Acceso a todos los nodos "titulo" que tengan como antecesor a "test1":
<xsl:apply-templates select="test1//titulo"/>

-Acceso al primero de los nodos "titulo" que tengan como padre a "test1":
<xsl:apply-templates select="test1/titulo[1]"/>

-Acceso al ltimo de los nodos "titulo" que tengan como padre a "test1":
<xsl:apply-templates select="test1/titulo[position()=last()]"/>

-Acceso a los nodos "titulo" que sean pares y que tengan como padre a "test1":
<xsl:apply-templates select="test1/titulo[position() mod 2 = 0]"/>

-Acceso a todos los nodos "titulo" en cualquier parte del documento:
<xsl:apply-templates select="//titulo"/>

-Acceso a todos los nodos "titulo" en cualquier parte del documento, a partir del
contexto actual:
<xsl:apply-templates select=".//titulo"/>

-Acceso a todos los nodos "titulo" que tengan como "abuelo" a "test1":
<xsl:apply-templates select="test1/*/titulo"/>

-Acceso a todos los nodos "titulo" que tengan un atributo "id":
<xsl:apply-templates select="titulo[@id]"/>

-Acceso a todos los nodos "titulo" que NO tengan un atributo "id":
<xsl:apply-templates select="titulo[not(@id)]"/>

-Acceso a todos los nodos "titulo" que tengan un atributo "id" con valor "XXX":
<xsl:apply-templates select="titulo[@id='XXX']"/>

-Acceso a todos los nodos "test1" que tengan un hijo "titulo" con valor "XXX":
<xsl:apply-templates select="test1[titulo='XXX']"/>

-Acceso a todos los nodos "test1" que tengan un hijo "titulo" con valor "XXX",
normalizando la bsqueda, es decir, eliminado espacios en blanco al inicio y final del
nodo:
<xsl:apply-templates select="test1[normalize-space(titulo)='XXX']"/>

-Acceso a todos los nodos "titulo" o "descripcion":
<xsl:apply-templates select="titulo|descripcion"/>
10.- DISEO DE HOJAS DE ESTILOS XSL
Seleccin de valores individuales.

Ejemplo18:
Para la seleccin de valores individuales, extraidos de los nodos del rbol XML,
debemos utilizar la instruccin "xsl:value-of", con ella podemos hacer referencia tanto a
nodos, como variables, clculos matemticos, etc. Para el acceso a los nodos, debemos
utlizar las expresiones Xpath previamente descritas:
<xsl:value-of select="matricula/personal/dni"/>
<xsl:value-of select="$valor"/>
<xsl:value-of select="3+2"/>

Templates y el modificador " mode ".
Templates con nombre: este tipo de templates no se corresponden con ningn nodo del
documento XML y slo podemos invocarlos haciendo referencia a ellos directamente.
Su sentencia de definicin ya no incluye el atributo "match", sino que este se sustituye
por "name". Podemos aumentar las funcionalidades de este tipo de templates pasandole
parmetros. El siguiente ejemplo hace uso de la definicin de templates por nombre y
paso de parmetros:
Ejemplo 19:
Documento XML que usaremos como base:
<test2>
<titulo>Prueba de patrones XSL</titulo>
<descripcion>Cuerpo del documento</descripcion>
</test2>

Documento XSL que aplica los templates por nombre:
version="1.0">
<xsl:template match="test2">
<html>
<head>
<title><xsl:apply-templates select="titulo" mode="head"/></title>
</head>
<body>
<xsl:apply-templates/>
<xsl:call-template name="print">
<xsl:with-param name="in"><xsl:value-of
select="/test2/titulo"/></xsl:with-param>
</xsl:call-template>
</body>
</html>
</xsl:template>
<xsl:template match="titulo" mode="head">
</xsl:template>
<xsl:template match="titulo">
</xsl:template>
<xsl:template match="descripcion">
</xsl:template>
<xsl:template name="print">
<xsl:param name="in">Nothing</xsl:param>
<i><xsl:value-of select="$in"/></i>
</xsl:template>
</xsl:stylesheet>

Resultado de la transformacin:
<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
<title>Prueba de patrones XSL</title>
</head>
<body>
<h1>Prueba de patrones XSL</h1>
<h3>Cuerpo del documento</h3>
<i>Prueba de patrones XSL</i>
</body>
</html>
11.- PROCESAMIENTO PROCEDURAL
Procesamiento procedural, otro enfoque para aplicar templates.
Ejemplo 20:

<xsl:for-each select="row">
<xsl:for-each select="col">
<xsl:apply-templates select="cell"/>
</xsl:for-each>
</xsl:for-each>

Procesamiento condicional.
Ejemplo 21:

<xsl:if test="@atributo='x'">
<h1>Este tipo de condicional no tiene ELSE</h1>
</xsl:if>

Procesamiento condicional para varias opciones/comprobaciones.
Ejemplo 22:

<xsl:choose>
<xsl:when test="$variable=1"><h3>Valor uno</h3></xsl:when>
<xsl:when test="$variable=2"><h3>Valor dos</h3></xsl:when>
<xsl:otherwise>
<h1>Variable con valor erroneo</h1>
</xsl:otherwise>
</xsl:choose>

Reportar errores desde la hoja de estilos.
Ejemplo 23:

<xsl:message>
<xsl:text>Este es el mensaje de error !!</xsl:text>
<xsl:value-of select="@atributo"/>
</xsl:message>

Creacin de nuevos elementos dinmicamente.
Ejemplo 24:

<xsl:variable name="test">a</xsl:variable>
<xsl:element name="{$test}">
<xsl:attribute name="href">http://www.si.uji.es</xsl:attribute>
Servei d'informtica
</xsl:element>

Ordenacin de elementos en XSLT
Ejemplo 25.
<xsl:template match="personal">
<xsl:apply-templates>
<xsl:sort select="dni" data-type="string" order="descending"/>
<xsl:sort select="curso_academico" data-type="number"
order="ascending"/>
</xsl:apply-templates>
</xsl:template>

Expresiones matemticas
Ejemplo 26:
Consideramos la existencia de dos nodos con valores numricos a partir de nuestro
contexto, cuyos nombres son "x" e "y":
<xsl:value-of select="x+y"/>
<xsl:value-of select="x-y"/>
<xsl:value-of select="x*y"/>
<xsl:value-of select="x div y"/>
<xsl:value-of select="x mod y"/>
<xsl:value-of select="sum(*)"/>
<xsl:value-of select="floor(x)"/>
<xsl:value-of select="ceiling(x)"/>
<xsl:value-of select="round(x)"/>
<xsl:value-of select="count(*)"/>
<xsl:value-of select="string-length(x)"/>
Uso de variables
Ejemplo 27:

<xsl:template match="pago">
<xsl:variable name="test" select="/matricula/pago/tipo_matricula"/>
<xsl:value-of select="$test"/>
</xsl:template>

12.- TRANSFORMACION DE FICHEROS XML CON APACHE ANT
Ant es un sistema de compilacin basada en Java. Su funcionalidad es similar a los
clsicos Makefiles del mundo UNIX, aunque en lugar de poder extenderse mediante el
uso de comandos del Shell, Ant puede extenderse en base a clases Java.
Ant ejecuta un conjunto de objetivos o targets descritos en un fichero XML que se llama
por defecto "build.xml".
Todos los targets en Ant se ejecutan despues del target raiz (init).
En un fichero de compilacion de Ant podemos hacer que un target dependa de otros con
el fin de que no se pueda realizar si todos los anteriores no se han completado.
Ejemplo 28:
Ejemplo de fichero Ant en el que tenemos el target raiz y un segundo target que
depende del raz.
<?xml version="1.0"?>
<project name="nombre_del_proyecto" default="target_por_defecto">
<target name="init">
<echo message="Esta es la tarea raiz !!" />
</target>
<target name="html" depends="">
<echo message="Esta es la tarea html y requiere que la tarea raiz se haya completado
primero !!" />
</target>
</project>

Ant define una lista muy amplia de tareas que se pueden ejecutar dentro de un target,
como por ejemplo:
javac: compila un fichero Java.
java: ejecuta un fichero Java.
jar: empaqueta un conjunto de recursos.
mail: envio de mails.
ftp: transmisin de ficheros por FTP.
war: empaqueta una aplicacin J2EE.
Podemos encontrar un listado completo de todas las tareas soportadas por Ant en la
direccin http://ant.apache.org/manual/index.html . As, existen adems una serie de
tareas relacionadas con el procesamiento de ficheros XML:
xmlproperty: permite cargar un fichero XML como propiedades de Apache Ant.
xslt: transformacin de documento XML mediante hojas de estilo XSL. Slo podemos
utilizar esta tarea si contamos con el .JAR del Xalan (procesador XSLT de Apache).
xmlvalidate: validacin de documentos XML utilizando un interfaz SAX.
Ejemplo 29:
Ejemplo de fichero Ant en el que se transforma un documento XML aplicando una hoja
de estilos XSL:
<project name="nombre_del_proyecto" default="target_por_defecto">
<target name="init" />
<target name="html" depends="init">
<echo message="Generando test.html ..." />
<xslt in="test.xml" out="test.html" style="test.xsl">
<outputproperty name="method" value="html"/>
<outputproperty name="standalone" value="yes"/>
<outputproperty name="encoding" value="ISO-8859-1"/>
<outputproperty name="indent" value="yes"/>
</xslt>
</target>
</project>
13.- OBJETOS DE FORMATO
El estandar XSL, tal y como est definido actualmente, se divide en dos grandes partes:
- XSLT: transformacin de un documento de entrada XML en algn tipo de documento
de salida, ya sea XML, HTML, PDF, etc.
- Formatting Objects: se encargan de definir la visualizacin final del resultado de la
transformacin.
El nico uso que se ha hecho en la actualidad de Formatting Objects, siempre ha estado
enfocado a la generacin de documentos de calidad destinados a la impresin. Este es el
caso de los documentos PDF.
Implementaciones disponibles.- Si queremos generar un PDF a partir de un documento
en formato FO, podemos utilizar los siguientes conjuntos de utilidades, siendo las dos
primeras de libre distribucin:
- Apache FOP: API desarrollada por el proyecto Apache que permite la generacin de
los PDFs en lnea de comandos o mediante llamadas al API.
- PassiveTex: conjunto de macros LaTeX que nos permiten la transformacin del
documento XML a un documento en TeX sobre el que podremos generar un PS y
posteriormente un PDF.
- XEP: producto comercial de "RenderX" ( http://www.renderx.com ) escrito en Java.
- XSL Formatter: producto comercial de "Antenna House" (
http://www.antennahouse.com )
- Unicorn Formatting Objects: producto comercial de "Unicorn Enterprises" (
http://www.unicorn-enterprises.com ) que adems es slo para Windows.
Ventajas del uso de FO para la generacin de documentos.-
1.Sencillo manejo de ciertas caractersticas de la generacin de documentos como:
-Pginacin automtica.
-Definicin de mrgenes para el documento.
-Definicin de patrones distintos de presentacin para cada una de las hojas.
-Control "al milmetro" de la presentacin de los elementos dentro del PDF.
-Definicin simplificada de cabeceras y pies de pgina.
-Permite la insercin de diversos elementos grficos como: imgenes, tablas, etc.
2.Permite definir la presentacin de cada elemento del documento en base a atributos
muy similares, en la mayora de los casos, a los atributos de una hoja de estilos CSS.
El API de Apache FOP permite una gran integracin con otras APIs del proyecto
Apache:
-FOP es una parte constituyente de Cocoon (Framework para la publicacin de
documentos XML a travs de la web).
-FOP permite embeber grficos SVG, renderizndolos a PNGs e insertndo el resultado
dentro del propio PDF.
Con XSL-FO podemos acometer varios aspectos en la generacin de documentos con
una alta calidad de impresin:
-Definicin del tamao fsico de la pgina que se crear (A4, Letter, etc).
-Control sobre propiedades de la pgina como los mrgenes, cabeceras, pies, etc.
-Uso de elementos clsicos dentro del documento como son los prrafos, tablas, etc.
Posibilidad de dar formato de presentacin al texto generado, cambiando el tipo de
fuente, su tamao, su color y dems recursos grficos.
14.- DESCRIPCION DEL PROCESO DE GENERACION DE PDFS
El estandar XSL, tal y como est definido actualmente, se divide en dos grandes partes:
- XSLT: transformacin de un documento de entrada XML en algn tipo de documento
de salida, ya sea XML, HTML, PDF, etc.
- Formatting Objects: se encargan de definir la visualizacin final del resultado de la
transformacin.
El nico uso que se ha hecho en la actualidad de Formatting Objects, siempre ha estado
enfocado a la generacin de documentos de calidad destinados a la impresin. Este es el
caso de los documentos PDF.
Implementaciones disponibles.- Si queremos generar un PDF a partir de un documento
en formato FO, podemos utilizar los siguientes conjuntos de utilidades, siendo las dos
primeras de libre distribucin:
- Apache FOP: API desarrollada por el proyecto Apache que permite la generacin de
los PDFs en lnea de comandos o mediante llamadas al API.
- PassiveTex: conjunto de macros LaTeX que nos permiten la transformacin del
documento XML a un documento en TeX sobre el que podremos generar un PS y
posteriormente un PDF.
- XEP: producto comercial de "RenderX" ( http://www.renderx.com ) escrito en Java.
- XSL Formatter: producto comercial de "Antenna House" (
http://www.antennahouse.com )
- Unicorn Formatting Objects: producto comercial de "Unicorn Enterprises" (
http://www.unicorn-enterprises.com ) que adems es slo para Windows.
Ventajas del uso de FO para la generacin de documentos.-
1.Sencillo manejo de ciertas caractersticas de la generacin de documentos como:
-Pginacin automtica.
-Definicin de mrgenes para el documento.
-Definicin de patrones distintos de presentacin para cada una de las hojas.
-Control "al milmetro" de la presentacin de los elementos dentro del PDF.
-Definicin simplificada de cabeceras y pies de pgina.
-Permite la insercin de diversos elementos grficos como: imgenes, tablas, etc.
2.Permite definir la presentacin de cada elemento del documento en base a atributos
muy similares, en la mayora de los casos, a los atributos de una hoja de estilos CSS.
El API de Apache FOP permite una gran integracin con otras APIs del proyecto
Apache:
-FOP es una parte constituyente de Cocoon (Framework para la publicacin de
documentos XML a travs de la web).
-FOP permite embeber grficos SVG, renderizndolos a PNGs e insertndo el resultado
dentro del propio PDF.
Con XSL-FO podemos acometer varios aspectos en la generacin de documentos con
una alta calidad de impresin:
-Definicin del tamao fsico de la pgina que se crear (A4, Letter, etc).
-Control sobre propiedades de la pgina como los mrgenes, cabeceras, pies, etc.
-Uso de elementos clsicos dentro del documento como son los prrafos, tablas, etc.
Posibilidad de dar formato de presentacin al texto generado, cambiando el tipo de
fuente, su tamao, su color y dems recursos grficos.
15.- CREACION DE UNA HOJA DE ESTILOS XSL QUE TRANSFORMARA EL DOCUMENTO XML EN UN
FICHERO XSL-FO
Con el fin de que la informacion que se genere en el documento XSL-FO de salida
pueda ser dinamica, haremos que los datos se almacenen en un documento XML,
transformandose en el documento de salida mediante el uso de una hoja de estilos XSL.
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:fo="http://www.w3.org/1999/XSL/Format">
<xsl:output encoding="ISO-8859-1" indent="yes"/>
<xsl:template match="listado">
<fo:root xmlns:fo=" http://www.w3.org/1999/XSL/Format ">
<fo:layout-master-set>
<fo:simple-page-master margin-right="1cm" margin-left="1cm" margin-
bottom="1cm"
margin-top="1cm" page-width="210mm" page-height="297mm"
master-name="first">
<fo:region-before extent="1cm"/>
<fo:region-body margin-top="1cm" margin-bottom="1cm"/>
<fo:region-after extent="1cm"/>
</fo:simple-page-master>
</fo:layout-master-set>
<fo:page-sequence master-reference="first">
<fo:flow flow-name="xsl-region-body">
<fo:block>
<xsl:value-of select="cabecera" />
</fo:block>
<fo:list-block space-before="0.5cm" space-after="0.5cm" font-size="12pt">
<xsl:apply-templates select="articulos/articulo" />
</fo:list-block>
</fo:flow>
</fo:page-sequence>
</fo:root>
</xsl:template>
<xsl:template match="articulo">
<fo:list-item>
<fo:list-item-label end-indent="label-end()">
<fo:block text-align="start">
<xsl:text>•</xsl:text>
</fo:block>
</fo:list-item-label>
<fo:list-item-body start-indent="body-start()">
<fo:block>
</fo:block>
</fo:list-item-body>
</fo:list-item>
</xsl:template>
</xsl:stylesheet>

Ejecutar la transformacin con un parser XSL
Si vamos a utilizar un procesador en linea de comandos como puede ser el XSLTPROC,
la instruccin a ejecutar seria la siguiente:
xsltproc sample.xsl sample.xml > sample.fo

Si vamos a utilizar Apache ANT. El fichero "build.xml" seria el siguiente:
<project name="procesando-xml" default="fo">
<target name="init" />
<target name="fo" depends="init">
<echo message="Generando sample.fo ..." />
<xslt in="sample.xml" out="sample.fo" style="sample.xsl">
<outputproperty name="method" value="xml"/>
<outputproperty name="standalone" value="yes"/>
<outputproperty name="encoding" value="ISO-8859-1"/>
<outputproperty name="indent" value="yes"/>
</xslt>
</target>
</project>

La ejecucion de esta definicion nos permite tomar un fichero "sample.xml" como
entrada, aplicarle una hoja de estilos xsl "sample.xsl" y obtener como salida un fichero
"sample.fo" con el codigo FO correspondiente.
Procesamiento de dicho fichero XSL-FO con Apache FOP
Para obtener finalmente el fichero PDF que queremos como resultado, podemos ejecutar
el siguiente script que viene con la distribucion de Apache FOP:
/opt/fop-0.20.5rc2/fop.sh sample.fo -pdf sample.pdf
16.- HERRAMIENTAS PARA EL TRABAJO CON XML
Herramientas para el trabajo con XML.-
1.XML
-Apache Xerces (Java)
-4Suite (Python)
-Sablotron (C y PHP)
2.XSL
-xlstproc (linea de comandos)
-Apache Xalan (Java)
-Jame's Clark XT (C y Java)
-4Suite (Python)
-Sablotron (C y PHP)
3.Formatting Objects
-Apache FOP (Java)
-Passive TeX (LaTeX - linea de comandos y conocido como PDF LaTeX)
Entornos de trabajo con XML.-
1.Publicacin de documentos XML aplicando plantillas XSL
-Apache Cocoon (Java)
-AxKit (Perl)
2.Edicin de documentos XML/XSL/Schemas/FO
-XML Spy 4.4 (windows)
-eXcelon Stylus (windows)
-Emacs (modo PSGML/XSL)

Cmo hacer una galera de imgenes con Flash y XML
As ha de ser el archivo XML (Copiar y Pegar cambiando los nombres de las imgenes
por las pertinentes):
<?xml version="1.0" encoding="iso-8859-1"?>
<imagenes>
<imagen id="img01.jpg"/>
</imagenes>
Coloca ste cdigo en el primer fotograma de la pelcula flash.
// -- posicin donde se cargar la primera imagen
x = 3;
y = 3;
// -- ancho y alto de la imagen ms 5 pixeles de espacio
ancho = 105;
alto = 80;
// -- numero de columnas
num_columnas = 3;
// -- creo un nuevo objeto XML
miXML = new XML();
// -- ignorar espacios
miXML.ignoreWhite = true;
// -- proceso si la carga tuvo xito
miXML.onLoad = function(succes) {
if (succes) {
// -- por cada nodo hijo del nodo principal...
for (var i = 0; i<this.firstChild.childNodes.length; i++) {
// -- delaro una variable que recoje el atributo
// -- del nodo (nombre de la imagen)
galeria = this.firstChild.childNodes[i].attributes.id;
// -- creo un clip de pelcula vacio
_root.createEmptyMovieClip("diapo"+i, i+100);
// -- cargo la imen el clip vacio
item = _root["diapo"+i];
item.loadMovie(galeria);
// -- indico posicin x - y
item._x = x;
item._y = y;
// -- incremento el valor de x para la siguiente imgen
x += ancho;
// -- incremento en 1 el nmero de columnas
columna += 1;
// -- ruptura de control, control de nmero de columnas
if (columna == num_columnas) {
columna = 0;
x -= (ancho*num_columnas);
y += alto;
}
}
}
};
// -- cargar XML
//miXML.load("imagenes.xml");
miXML.load("imagenes.xml");

Autor: Toni Lpez
http://www.after-hours.org/blog/archives/2004/01/18/flash-xml-galeria-de-imagenes/
Diferencias entre XML y HTML
XML y HTML son lenguajes muy diferentes. Ambos nacen de la misma inspiracin
llamada SGML por lo que su sintaxis es similar, aunque cada uno fue diseado para
cumplir distintas funciones:
El XML (eXtensive Markup Language) es un lenguaje que fue concebido para describir
informacin. Su funcin principal es ayudarnos a organizar contenidos y eso hace que
los documentos XML sean portables hacia diferentes tipos de aplicaciones.
El HTML (HyperText Markup Language) por otro lado ha sido concebido para mostrar
informacin, determinar como acta y que hace. Su funcin radica en ayudarnos a darle
formato a los diversos contenidos de una pgina.
Resumiendo, el XML sirve para describir informacin y el HTML sirve para darle
formato y presentarla a travs de un navegador. O sea que el XML no es ni ser nunca
un reemplazo del HTML sino un complemento que sirve para manejar la informacin
separada del formato.
Un dato importante es que al hablar de XML hablamos de documentos bien formados
(well formed). Mientras en HTML podemos ser desordenados: <P><B><i>Este texto
estar en negritas e itlicas</b></I><BR>, en XML tenemos que respetar los tags.
Todos debern ser anidados correctamente:
<TagA><TagB>Contenidos</TagB></TagA>. Algo muy importante es que son "case
sensitive" de tal forma que <B> no es lo mismo que <b> sino son dos tags diferentes.
Tambin debemos presetar atencin importante a que todos los tags deben ser cerrados.
Si usamos un tag independiente como el <br> o <hr>, lo cerramos incluyndole un
diagonal al final: <br />, <hr />. Por lo anterior, el XML est ayudando a que seamos
ms ordenados y respetemos el lenguaje que gracias a la tolerancia de los navegadores
ha ido decayendo.
Otra caracterstica del XML es que es un lenguaje que puede extenderse. Al trabajar con
documentos XML podemos determinar nuestros propios tags y estructura de
documentos para trabajar. En XML el tag <christian></christian> es vlido por que yo
lo puedo definir y utilizar sin ningn problema. Por otro lado en el HTML todos los tags
ya han sido predefinidos y son parte del estndar HTML definido por el W3C.
Hacia donde van el XML y el HTML?
A pesar de que el HTML tiene sus definiciones, la tolerancia de los navegadores ha
hecho que documentos mal formados funcionen. Por ello nace el esfuerzo de juntar lo
mejor de los dos lenguajes que hemos analizado para pensar a futuro en XHTML. El
XHTML (eXtensive HyperText Markup Language) es una familia de tipos de
documentos y mdulos que reproducen, definen y extienden el HTML reformulando
gracias al XML.
Para explicarlo de forma ms sencilla, se busca definir estndares en el lenguaje que le
da formato a la informacin, pero con tags bien formados, correctamente anidados y que
nos permitan navegar a travs de la informacin de forma comprensible y sencilla. El
XHTML debe ser desde ya una meta para todos nuestras pginas web. Los invito a que
a travs del servicio de validacin de documentos del W3C revisen sus pginas y vean
que podran mejorar para estar conforme a los estndares.

Autor: Christian Van Der Henst S.
http://www.maestrosdelweb.com/editorial/xmlvshtml/

http://www.webtaller.com/construccion/lenguajes/info/lecciones/xml/

Manual de XML

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual de XML

Cargado por

Copyright:

Formatos disponibles

MANUAL DE XML

1.- Indice del Manual |

También podría gustarte