EXPORT DATA

EXPORT DATA ( nomArchivo {; proyecto {; *}} )

Parámetro	Tipo		Descripción
nomArchivo	Text	→	Ruta de acceso y nombre del archivo a exportar
proyecto	Text, Blob	→	Contenido del proyecto de exportación
←	Nuevo contenido del proyecto de exportación (si se pasa el parámetro *)
*	Operador	→	Visualización de la caja de diálogo de exportación y actualización del proyecto

Descripción

El comando EXPORT DATA exportar datos en el archivo nomArchivo. 4D puede exportar datos en los siguientes formatos: Texto, Texto de longitud fija, XML, SYLK, DIF, DBF (dBase) y 4D.

Si pasa una cadena vacía en nomArchivo, EXPORT DATA muestra la caja de diálogo estándar de guardar archivos, permitiendo al usuario definir el nombre, tipo y ubicación del archivo de exportación. Una vez aceptada la caja de diálogo, la variable sistema Documento contiene la ruta de acceso y el nombre del archivo. Si el usuario hace clic en Cancelar, se detiene la ejecución del comando y la variable sistema OK toma el valor 0.

El parámetro opcional proyecto permite utilizar un proyecto para exportar datos. Cuando pasa este parámetro, se lleva a cabo la exportación directamente, sin ninguna intervención (a menos de que utilice la opción *, ver a continuación). Si no pasa este parámetro, aparece la caja de diálogo de exportación. El usuario puede definir sus parámetros de exportación o cargar un proyecto de exportación existente.

Un proyecto de exportación contiene todos los parámetros de exportación, tales como las tablas y campos a exportar, los delimitadores, etc. En el parámetro proyecto puede pasar una variable Texto con XML o una variable Texto con una referencia a un elemento DOM pre existente, o un BLOB. Los proyectos pueden crearse por programación (proyectos de formato XML únicamente) o cargando los parámetros previamente definidos en la caja de diálogo de exportación. En el último caso, hay dos soluciones disponibles:

• Usar el comando EXPORT DATA con un parámetro proyecto vacío y el parámetro opcional *, luego guardar el parámetro proyecto en un campo Texto o BLOB (ver a continuación). Esta solución le permite guardar el proyecto con el archivo de datos.
• Guardar el proyecto en el disco, luego cargarlo utilizando el comando DOM Parse XML source y pasando su referencia en el parámetro proyecto. Nota de compatibilidad: a partir de la versión 12 de 4D, los proyectos de exportación son codificados en XML. 4D puede abrir los proyectos de exportación generados con las versiones anteriores de 4D (formato BLOB), sin embargo los proyectos creados a partir de la v12 no pueden abrirse con una versión 11 o anterior. Además se recomienda utilizar variables Texto para manipular los archivos de exportación.

El parámetro opcional *, si se especifica, hace que aparezca la caja de diálogo de exportación con los parámetros definidos en proyecto. Esta característica le permite utilizar un proyecto predefinido, mientras tiene aún la posibilidad de modificar uno o más parámetros. Además, el parámetro proyecto contiene, después de cerrar la caja de diálogo de exportación, los parámetros del “nuevo” proyecto. Entonces puede almacenar el nuevo proyecto en un campo BLOB, en disco, etc.

Si la exportación fue exitosa, la variable sistema OK es igual a 1.

Ejemplo 1

Este ejemplo presenta el uso del comando EXPORT DATA para exportar datos en formato binario.

• Este método hace un bucle por todas las tablas de la base y llama al método ExportBinary:

 var $ExportPath : Text
 var $i : Integer
 $ExportPath:=Select folder("Por favor seleccione la carpeta de exportación:")
 If(Ok=1)
    For($i;1;Last table number)
       If(Is table number valid($i))
          ExportBinary(Table($i);$ExportPath+Table name($i);True)
       End if
    End for
 End if

• Este es el código del método ExportBinary:

 var $1 : Pointer //tabla
 var $2 : Text //ruta del archivo de destino
 var $3 : Boolean //exportar todos los registros
 var $i : Integer
 var $ref : Text
 $ref:=DOM Create XML Ref("settings-import-export")
  // Exportar la tabla "$1" en formato binario '4D', todos los registros o únicamente la selección actual
 DOM SET XML ATTRIBUTE($ref;"table_no";Table($1);"format";"4D";"all_records";$3)
  // Definición de los campos a exportar
 For($i;1;Last field number($1))
    If(Is field number valid($1;$i))
       $elt:=DOM Create XML element($ref;"field";"table_no";Table($1);"field_no";$i)
    End if
 End for
 EXPORT DATA($2;$ref)
 If(Ok=0)
    ALERT("Error durante la exportación de la tabla "+Table name($1))
 End if
 DOM CLOSE XML($ref)

Ejemplo 2

Este ejemplo crea un proyecto vacío y guarda los parámetros definidos por el usuario en la caja de diálogo de exportación:

 var $exportParams : Text
 EXPORT DATA("DocExport.txt";$exportParams;*) // Visualización de la caja de diálogo de exportación

Variables y conjuntos del sistema

Si el usuario hace clic en Cancelar en la caja de diálogo estándar de abrir archivos o de exportación, la variable sistema OK toma el valor 0. Si la exportación fue exitosa, la variable sistema OK toma el valor 1.

Ver también

EXPORT DIF
EXPORT SYLK
EXPORT TEXT
IMPORT DATA

Propiedades

Número de comando	666
Hilo seguro	✗
Modifica variables	OK, Document