EXPORT TEXT

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)


EXPORT TEXT ({tabla; }documento)

ParámetroTipoDescripción
tablaTablaTabla desde la cual exportar datos o
Tabla por defecto, si se omite
documentoAlfaDocumento texto para recibir los datos

Descripción

El comando EXPORT TEXT escribe datos de los registros de la selección actual de la tabla en el proceso actual. Los datos se escriben en documento, un documento de texto Windows o Macintosh en el disco.

La operación de exportación se efectúa por el formulario de salida actual. La operación de exportación escribe los campos y las variables basado en el orden de entrada del formulario de salida. Por esta razón, utilice un formulario de salida que sólo contenga los campos u objetos editables que quiera exportar. No ubique botones u otros objetos en el formulario de exportación. Los objetos de subformulario se ignoran.

Un evento On Load se envía al método del formulario por cada registro exportado. Utilice este evento para definir las variables que podría utilizar en el formulario de exportación.

El parámetro documento puede dar nombre a un documento nuevo o existente. Si documento tiene el mismo nombre que un documento existente, el documento existente se sobrescribe. El documento puede incluir una ruta de acceso que contenga los nombres de los volúmenes y las carpetas. Si pasa una cadena vacía, aparece la caja de diálogo estándar de guardar archivos. Si el usuario cancela este diálogo, se cancela la operación de exportación, y la variable sistema OK toma el valor 0.

Un termómetro de progreso aparece durante la exportación. El usuario puede cancelar la operación haciendo clic en el botón Detener. Si la exportación termina con éxito, la variable sistema OK toma el valor 1. En caso de error o si la operación se interrumpe, la variable OK toma el valor 0. El termómetro puede ocultarse con el comando MESSAGES OFF.

En modo Unicode (modo estándar), el comando utiliza por defecto el conjunto de caracteres UTF-8. Puede utilizar el comando USE CHARACTER SET para modificar este conjunto de caracteres.

En modo compatibilidad ASCII, la operación de exportación utiliza la tabla ASCII de la plataforma en la cual es ejecutada, excepto si el comando USE CHARACTER SET fue utilizado antes de la exportación.

Durante la utilización de EXPORT TEXT, el delimitador de campos por defecto es el carácter de tabulación (code 9). El delimitador de registros por defecto es el retorno de carro (code 13). Puede cambiar estos valores por defecto asignando nuevos valores a las variables sistema: FldDelimit y RecDelimit. El usuario puede cambiar los valores por defecto en la caja de diálogo de exportación del entorno Aplicación. Los campos texto pueden contener retornos de carro, por lo tanto, tenga cuidado cuando utilice como delimitador un retorno de carro si está exportando campos texto.

Ejemplo

Este ejemplo exporta datos a un documento texto. El método primero comienza por definir el formulario de salida se manera que los datos sean exportados por el formulario correcto, cambia los delimitadores, luego efectúa la exportación:

   OUTPUT FORM([Personas];"Exportar")
   FldDelimit:=27 ` Definir carácter delimitador de campos: Escape
   RecDelimit:=10 ` Definir carácter delimitador de registros: Line Feed
   EXPORT TEXT([Personas];"Nuevas_Personas.txt") ` Exportación del documento "Nuevas_Personas.txt"

Ver también

EXPORT DIF, EXPORT SYLK, IMPORT TEXT, USE CHARACTER SET.

Variables y conjuntos Sistema

OK toma el valor 1 si la exportación termina con éxito; de lo contrario, 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