Este es el sitio web histórico de la documentación de 4D. La documentación se está trasladando progresivamente a developer.4d.com

Inicio

 
4D v20 R7
DOM EXPORT TO FILE

DOM EXPORT TO FILE 


 

DOM EXPORT TO FILE ( elementRef ; rutaArchivo ) 
Parámetro Tipo   Descripción
elementRef  Cadena in Referencia del elemento XML raíz
rutaArchivo  Texto in Ruta de acceso completa del archivo

El comando DOM EXPORT TO FILE  permite guardar un árbol XML en un archivo en el disco.

Pase en elementRef la referencia del elemento raíz a exportar.

Pase en rutaArchivo la ruta de acceso completa del archivo de exportación a utilizar o a crear. Si el archivo no existe, se crea.

Si pasa únicamente un nombre de archivo (sin ruta de acceso), se buscará el archivo o se creará junto al archivo de estructura.

Si pasa una cadena vacía (""), aparece una caja de diálogo estándar de apertura y creación de archivos.

En XML, los saltos de línea no son significativos, independientemente de si se encuentran dentro o entre los elementos XML. Internamente, XML utiliza caracteres estándar LF como separadores de líneas. Durante las operaciones de importación y exportación, los caracteres de salto de línea se pueden convertir. Durante una importación, el analizador XML reemplaza los caracteres CRLF (rupturas de línea estándar en Windows) por caracteres de LF. Durante la exportación, los caracteres LF se sustituyen por caracteres CRLF en Windows (sin remplazar en macOS).

Nota: si desea mantener los retornos de carro, debe incluir en un elemento XML CDATA de manera que no sea procesado por el analizador XML. En lugar de caracteres CRLF, también puede utilizar el carácter "<br/>", que es un retorno de carro explícito que no será procesado por el analizador.

Por defecto, los archivos XML se escriben sin BOM (Byte order mask).

Puede controlar el final de línea XML y la gestión BOM utilizando el comando XML SET OPTIONS.

Nota de compatibilidad: en bases/proyectos creados con versiones de 4D hasta la v19.x, por defecto 4D utiliza CR como caracteres de fin de línea en macOS y un BOM. Para activar la nueva configuración por defecto, compruebe los ajustes de compatibilidad (ver Página Compatibilidad) o utilice el comando XML SET OPTIONS.

Ejemplo  

Este ejemplo guarda el árbol vRefElem en el archivo MiDoc.xml:

 DOM EXPORT TO FILE(vRefElem;"C:\\carpeta\MiDoc.xml")

Si el comando se ejecutó correctamente, la variable sistema OK toma el valor 1. De lo contrario, toma el valor 0 y se genera un error.

Se genera un error cuando:

  • La referencia del elemento no es válida,
  • La ruta de acceso especificada no es válida,
  • El volumen de almacenamiento devuelve un error (disco lleno, etc.).



Ver también 

DOM EXPORT TO VAR
SVG EXPORT TO PICTURE

 
PROPIEDADES 

Producto: 4D
Tema: XML DOM
Número 862

Este comando modifica la variable sistema OKEste comando modifica la variable sistema ErrorThis command can be run in preemptive processes

 
CONTENIDO DE LA PÁGINA 
 
HISTORIA 

Creado por: 4D 2004

 
ARTICLE USAGE

Manual de lenguaje 4D ( 4D v20 R7)