Este es el sitio web histórico de la documentación de 4D. La documentación se está trasladando progresivamente a developer.4d.com
- Manual de lenguaje 4D
-
- XML DOM
-
-
Presentación de los comandos XML DOM
-
DOM Append XML child node
-
DOM Append XML element
-
DOM CLOSE XML
-
DOM Count XML attributes
-
DOM Count XML elements
-
DOM Create XML element
-
DOM Create XML element arrays
-
DOM Create XML Ref
-
DOM EXPORT TO FILE
-
DOM EXPORT TO VAR
-
DOM Find XML element
-
DOM Find XML element by ID
-
DOM Get first child XML element
-
DOM Get last child XML element
-
DOM Get next sibling XML element
-
DOM Get parent XML element
-
DOM Get previous sibling XML element
-
DOM Get Root XML element
-
DOM GET XML ATTRIBUTE BY INDEX
-
DOM GET XML ATTRIBUTE BY NAME
-
DOM GET XML CHILD NODES
-
DOM Get XML document ref
-
DOM Get XML element
-
DOM GET XML ELEMENT NAME
-
DOM GET XML ELEMENT VALUE
-
DOM Get XML information
-
DOM Insert XML element
-
DOM Parse XML source
-
DOM Parse XML variable
-
DOM REMOVE XML ATTRIBUTE
-
DOM REMOVE XML ELEMENT
-
DOM SET XML ATTRIBUTE
-
DOM SET XML DECLARATION
-
DOM SET XML ELEMENT NAME
-
DOM SET XML ELEMENT VALUE
-
DOM Parse XML source
| DOM Parse XML source ( doc {; validacion {; dtd | esquema}} ) -> Resultado | ||||||||
| Parámetro | Tipo | Descripción | ||||||
| doc | Cadena |
|
Ruta de acceso del documento | |||||
| validacion | Booleano |
|
True = Validación False = No validación | |||||
| dtd | esquema | Cadena |
|
Ubicación de la DTD o del esquema XML | |||||
| Resultado | Cadena |
|
Referencia del elemento XML | |||||
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 (documento XSD, XML Schema Definition).
El documento puede estar en el disco o en Internet/Intranet.
Nota: la ejecución del comando DOM Parse XML source es síncrona.
En el parámetro documento 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 el esquema XML 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 que se encuentra 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 hacerlo, 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 la validación no se puede efectuar (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.
Apertura sin validación de un documento XML en disco:
$xml_Ref_Estruct:=DOM Parse XML source("C:\\importar.xml")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")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")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")Si el comando ha sido ejecutado correctamente, la variable sistema OK toma el valor 1. Si ocurre un error, toma el valor 0.
Producto: 4D
Tema: XML DOM
Número
719
Modificado: 4D v11 SQL
Manual de lenguaje 4D ( 4D v20 R7)
