DOM Parse XML source

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11 (Modificado)


DOM Parse XML source (document{; validacion{; dtd | esquema}}) Cadena

ParámetroTipoDescripción
documentCadenaRuta de acceso del documento
validacionBooleanoTrue = Validación
False = No validación
dtd | esquemaCadenaUbicación de la DTD o del esquema XML
ResultadoCadenaReferencia del elemento XML (16 caracteres)

Descripción

El comando DOM Parse XML source analiza un documento que contiene una estructura XML y devuelve una referencia para este documento. El comando puede validar (o no) el documento vía una DTD o un esquema XML (XML Schema Definition (XSD) document).

El documento puede estar ubicado en el disco o en Internet/Intranet.

En el parámetro document puede pasar:

una ruta de acceso completa estándar (del tipo C:\\Carpeta\\Archivo\\... bajo Windows y MacintoshHD:Carpeta:Archivo bajo Mac OS),

o una ruta Unix bajo Mac OS (la cual debe comenzar por /).

o una ruta red de tipo http://www.sitio.com/Archivo o ftp://publico.ftp.com...

El parámetro booleano validacion permite indicar si validar o no la estructura.

Si validacion es igual a True, la estructura se validará. En este caso, el analizador intentará validar la estructura XML del documento basado en la referencia DTD o XSD incluida en el documento, o vía la DTD o el esquema XML designado por el tercer parámetro si se pasa.

Si validacion es igual a False, la estructura no se validará.

Si pasa True en validacion y omite el tercer parámetro, el comando intentará validar la estructura XML vía una referencia DTD o XSD encontrada en la estructura misma. La validación puede ser indirecta: si la estructura contiene una referencia a un archivo DTD que contiene una referencia a un archivo XSD, el comando intentará efectuar las dos validaciones.

El tercer parámetro permite designar una DTD específica o un esquema XML para el análisis del documento. Si utiliza este parámetro, el comando no tendrá en cuenta la DTD referenciada en el documento XML.

Validación por DTD

Hay dos formas de especificar una DTD:

Como una referencia. Para hacer esto, pase la ruta de acceso completa de la nueva DTD (extensión "dtd") en el parámetro dtd. Si el documento indicado no contiene una DTD válida, el parámetro dtd se ignora y se genera un error.

Directamente en un texto. En este caso, si los contenidos del parámetro comienzan por "<?xml", 4D considerará que esa es la DTD; de lo contrario, 4D lo considerará como una ruta de acceso.

Validación por esquema

Para validar el documento vía un esquema XML, sólo necesita pasar en el tercer parámetro un archivo o un URL de extensión "xsd" en lugar de un "dtd". La validación por esquema XML se considera más flexible y poderosa que la validación por DTD. El lenguaje de los documentos XSD está basado en el lenguaje XML. Más particularmente, los esquemas XML soportan tipos de datos. Para mayor información sobre los esquemas XML, por favor consulte la siguiente dirección: http://www.w3.org/XML/Schema.

Si no se puede efectuar la validación (no DTD o XSD, URL incorrecto, etc.), se genera un error. La variable sistema Error indica el número del error. Puede interceptar este error utilizando un método instalado por el comando ON ERR CALL.

El comando devuelve una cadena de 16 caracteres (RefElement) constituyendo la referencia en memoria de la estructura virtual del documento. Esta referencia debe utilizarse con los otros comandos de análisis XML.

Importante: una vez no lo necesite, recuerde llamar al comando DOM CLOSE XML con esta referencia con el fin de liberar memoria.

Ejemplos

1. Apertura sin validación de un documento XML en disco:

   $xml_Ref_Estruct:=DOM Parse XML source("C:\\importar.xml")

2. Apertura sin validación de un documento XML ubicado junto al archivo de estructura de la base:

   $xml_Ref_Estruct:=DOM Parse XML source("importar.xml")

3. Apertura de un documento XML ubicado en el disco y validación utilizando un DTD ubicado en el disco:

   $xml_Ref_Estruct:=DOM Parse XML source("C:\\importar.xml";True;"C:\\importar_dtd.xml")

4. Apertura sin validación de un documento XML ubicado en un URL específico:

   $xml_Ref_Estruct:=DOM Parse XML source("http://www.4DHispano.com/xml/importar.xml")

Ver también

DOM CLOSE XML, DOM Parse XML variable.

Variables y conjuntos sistema

Si el comando ha sido ejecutado correctamente, la variable sistema OK toma el valor 1. Si ocurre un error, toma el valor 0.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente