IMPORT DIF
IMPORT DIF ( {tabla ;} doc )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| tabla | Table | → | Tabla en la cual importar datos, o Tabla por defecto, si se omite |
| doc | Text | → | Documento DIF a importar |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
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 se importen en los objetos correctos es seleccionar el objeto en el cual debe importarse el primer campo 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.
El comando utiliza por defecto el conjunto de caracteres UTF-8. Los documentos con formato DIF utilizan por lo general el conjunto de caracteres IBM437, puede ser necesario utilizar el comando USE CHARACTER SET para definir el conjunto de caracteres apropiado.
Durante la utilización de IMPORT 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:
FORM SET INPUT([Personas];"Importar")
IMPORT DIF([Personas];"Nuevas_Personas.dif") // Importación del documento “Nuevas_Personas.dif”
Variables y conjuntos del sistema
OK toma el valor 1 si la importación termina con éxito; de lo contrario, toma el valor 0.