IMPORT DIF

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 3


IMPORT DIF ({tabla; }documento)

ParámetroTipoDescripción
tablaTablaTabla en la cual importar datos, o
Tabla por defecto, si se omite
documentoAlfaDocumento DIF a importar

Descripción

El comando IMPORT DIF lee datos de documento, un documento DIF Windows o Macintosh, y los escribe en tabla creando nuevos registros para esa tabla.

La operación de importación se realiza por intermedio del formulario de entrada actual. La operación de importación lee los campos y las variables en función del plano de los objetos en el formulario de entrada. Por esta razón, debe ser muy cuidadoso en cuanto al orden de los objetos texto (campos y variables) en el formulario. El primer objeto en el cual los datos serán importados debe estar al fondo del formulario, etc. Si el número de campos o variables en el formulario no corresponde al número de campos a importar, los campos extras son ignorados. Un formulario de entrada utilizado para importar no puede contener botones. Los objetos de subformulario son ignorados.

Nota: Una manera de asegurar que los datos sean importados en los objetos correctos es seleccionar el objeto en el cual el primer campo debe ser importado y moverlo al primer plano. Continúe moviendo los campos y variables al primer plano, en orden, asegurándose de que tenga un campo o variable para cada campo a importar.

Un evento On Validate se envía al método de formulario para cada registro que se importa. Utilice este evento para copiar los datos de las variables a los campos, si utiliza las variables en el formulario de importación.

El parámetro documento puede incluir una ruta de acceso que contenga los nombres de volúmenes y carpetas. Si pasa una cadena vacía, aparece la caja de diálogo estándar de apertura de archivos. Si el usuario cancela este diálogo, se cancela la operación de importación, y la variable sistema OK toma el valor 0.

Un termómetro de progreso aparece durante la importación. El usuario puede cancelar la operación haciendo clic en el botón Detener. Los registros que ya hayan sido importados no serán removidos si el usuario presiona el botón Detener. Si la importación termina con éxito, la variable sistema OK toma el valor 1. Si ocurre un error o se interrumpe la operación, la variable sistema 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 cambiar este conjunto de caracteres.

En modo compatibilidad ASCII, la operación de exportación se realiza utilizando el mapa ASCII por defecto de la plataforma en la cual se efectúa la exportación, a menos que el comando USE CHARACTER SET haya sido previamente utilizado.

Durante la utilización de EXPORT DIF, el delimitador de campos por defecto es el carácter de tabulación (código 9). El delimitador del registro por defecto es el retorno de carro (código 13). Puede modificar estos valores asignando nuevos valores a las dos variables sistema FldDelimit y RecDelimit. El usuario puede cambiar estos valores en la caja de diálogo de exportación del entorno Diseño. Como los campos Texto pueden contener retornos de carro, sea cuidadoso si utiliza el retorno de carro como delimitador entre los campos a exportar.

Ejemplo

El siguiente ejemplo importa datos de un documento DIF. El método comienza definiendo el formulario de entrada de manera que los datos se importen por el formulario correcto, luego realiza la importación:

   INPUT FORM([Personas]; "Importar")
   IMPORT DIF([Personas];"Nuevas_Personas.dif") ` Importación del documento "Nuevas_Personas.dif"

Ver también

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

Variables y conjuntos Sistema

OK toma el valor 1 si la importació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