Funciones XSLT y XPath

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

document

XSLT

 

La función fn:document devuelve el nodo documento del recurso correspondiente al URI introducido en el argumento. Si el documento procede de un sistema de ficheros, es posible que la aplicación requiera que el URI comience con file:///, que la separación entre los nombres de carpeta se marquen mediante una barra inclinada (/), y que se sustituyan los espacios en blanco en los nombres de carpetas y documentos por %20.

Es posible utilizar especificaciónes de ruta relativas. Así, si el URI es relativo, se añadirá al URI base. El URI base puede introducirse en el segundo argumento. Si éste no se introduce, se transmitirá el URI base del contexto actual. El URI base se establece mediante el procesador con independencia de la transformación XSLT (p.ej. el URI del documento), o bien al principio de la misma.

Se debe observar que la función sólo devolverá el nodo documento, no el nodo raíz. Si se desea seleccionar el nodo raíz, se deberá especificar el mismo en la correspondiente expresión XPath (p.ej. doc('URI')/elementoraiz).Al contrario que fn:doc, la función fn:document puede convertir el mismo URI en dos nodos documento distintos.

La función fn:document sólo puede utilizarse en transformaciones con XSLT. En XQuery se puede emplear únicamente la función fn:doc, que sólo admite un URI base por consulta y para la que no pueden añadirse identificadores de fragmento en la cadena URI.

 

Argumentos

URI de un documento o de acceso al mismo

Es obligatorio, pero puede ser una secuencia vacía.

Tipo: xs:anyURI

 

URI base

Opcional

Tipo: xs:anyURI

 

Valor de salida

Nodo documento

Tipo: node()

 

 

Ejemplo

document('ejemplos/ejemplo1.xml')/funciones/funcion[3]/nombre

Resultado: fn:max

> Volver a la referencia alfabética de XSLT y XPATH