EXPORT DATA

4D v20 R7

EXPORT DATA


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

Parámetro	Tipo	Descripción
nomArchivo	Cadena	Ruta de acceso y nombre del archivo a exportar
proyecto	Variable texto, BLOB variable	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:

 C_TEXT($ExportPath)

 C_LONGINT($i)

 $ExportPath:=Select folder("Por favor seleccione la carpeta de exportación:")

 If(Ok=1)

    For($i;1;Get 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:

 C_POINTER($1) //tabla

 C_TEXT($2) //ruta del archivo de destino

 C_BOOLEAN($3) //exportar todos los registros

 C_LONGINT($i)

 C_TEXT($ref)

 $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;Get 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:

 C_TEXT($exportParams)

 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