IMPORT SYLK

versión 3

IMPORT SYLK ({tabla; }documento)

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

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 exportación.

El parámetro documento puede incluir una ruta de acceso a 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.

El siguiente ejemplo importa datos de un documento SYLK. El método comienza por definir el formulario de entrada de manera que los datos sean importados por el formulario correcto, luego realiza la importación:

   INPUT FORM([Personas]; "Importar")
   IMPORT SYLK([Personas];"Nuevas_Personas.slk") ` Importar del documento "Nuevas_Personas.slk"

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

OK toma el valor 1 si la importación termina con éxito; de lo contrario, toma el valor 0.