Importación de una definición de archivo .CSV

LECCIÓN 5
IMPORTACIÓN DE DATOS PREEXISTENTES
109
- IMPORTACION DE DATOS PREEXISTENTES
Conversión de archivos de datos
Usted puede tener datos de aplicaciones heredadas que quiere conservar y usar en las aplicaciones
Clarion . Para esto, este capítulo le enseñará a:
 Importar una definición de archivo a partir de datos preexistentes.
 Recorrer y modificar un archivo usando el Administrador de Base de Datos (" Database
Manager")
 Cómo convertir datos de un formato de archivo a otro.
Punto de inicio:
El archivo TUTORIAL.DCT debe estar abierto.
Importación de una definición de archivo .CSV
Una forma sencilla de convertir archivos de datos es exportar los datos existentes de la aplicación
anterior a archivos de valores separados por comas(.CSV). Se trata del formato de archivo
utilizado originalmente por el lenguaje Basic, en que los datos se contienen entre comillas dobles,
los campos están separados por comas y los registros se separan mediante un retorno de carro y
avance de línea. El controlador Clarion de archivos BASIC lee y escribe estos archivos .CSV.
Importaremos la definición de un archivo .CSV existente que contiene datos de Clientes, luego
generaremos un programa simple de conversión de datos (para demostrar lo fácil que es), que los
colocará en un archivo TopSpeed.
Importación de la definición de archivo
1. Elija File  Import File.
2. Seleccione BASIC de la lista desplegable y luego oprima el botón OK.
Aparece la caja de diálogo Open BASIC File.
CLARION 5™
110
APRENDIENDO CLARION
3. En el campo Filename, escriba c:\clarion5\examples\tutor\import1.csv y luego oprima el
botón OK.
Aparece la caja de diálogo Edit File Properties.
4. Oprima el botón OK.
Ahora tiene la definición del archivo IMPORT1.CSV. El siguiente paso será echar un vistazo a
los datos en el Administrador de Bases de Datos.
Modificación de los datos
Dé CLIC DERECHO sobre el archivo IMPORT1.CSV, ilumine Browse IMPORT1 y luego dé CLIC
para llamar al Administrador de Bases de Datos.
El Administrador de Bases de Datos de Clarion le permite modificar en forma directa los datos de
los archivos. Se trata de una herramienta para el programador, diseñada para permitirle hacer
todos los cambios necesarios en los archivos. Esto significa que no hay salvaguardas contra
violaciones de la integridad referencial o de la integridad de los datos. Por lo tanto, esta
herramienta debe usarse con mucho cuidado.
LECCIÓN 5
IMPORTACIÓN DE DATOS PREEXISTENTES
111
Advierta que el primer registro contiene los nombres de campos, no datos. Este es el modo
estándar de construír archivos .CSV. También, esos nombres de campo son exactamente los
mismos que los nombres de campo de las definiciones del archivo Clientes (lo que facilitará
mucho la conversión )
Conversión de un archivo de datos
En este punto, usted está obsevando a los datos del archivo .CSV en el Administrador de Bases de
Datos Clarion.Lo siguiente es llevar esos datos a un archivo TopSpeed, para que los programs
Clarion puedan usarlos.
Generación de un programa convertidor de archivos
1. Elija File  Convert File ( u oprima CRTL+V)
Aparece la caja de diálogo File Convert.
2. En el campo Target
Filename, escriba Clientes.TPS como nombre del nuevo archivo
(eliminando todo el texto preconfigurado que había en el campo).
3. Oprima el botón de tres puntos suspensivos (...) junto al campo Target Structure.
4. Destaque Clientes, y luego oprima el botón Select.
La caja de diálogo File Convert debería aparecer ahora así :
CLARION 5™
112
APRENDIENDO CLARION
Cuando oprima el botón OK, esto generará todo el código Clarion necesario para tomar los
datos del archivo fuente (Source Filename), y copiarlos en un nuevo archivo de
destino(Target Filename), utilizando el formato de archivo especificado en la estructura de
destino (Target Structure).
La mejor razón para generar código fuente Clarion para la conversión de datos es darle la
oportunidad de modificar el código antes de su compilación y ejecución, lo que da la
oportunidad de manejar cualquier necesidad especial que uno pueda tener referente a la
conversión. Esto hace completamente flexible el proceso de conversión para manejar cualquier
situación que pudiera presentarse.
5. Oprima el botón OK.
Aparecerá un mensaje que anuncia la generación del código fuente.
6. Oprima el botón OK para regresar al Administrador de Bases de Datos.
7. Oprima el botón Exit para salir del Administrador de Base de Datos.
Borrado de la definición del archivo IMPORT1
El único fin de esta definición era permitir que el Administrador de Bases de Datos generara el
código de conversión. Por lo tanto, podemos eliminarlo ahora del Diccionario de Datos.
1. Estando iluminado IMPORT1, oprima el botón Delete.
2. Oprima el botón Yes cuando se le pregunte si confirma el borrado.
3. Oprima el botón Close para salir del Editor del Diccionario de Datos, y oprima el botón Yes
para guardar los cambios al salir.
Compilación y ejecución del programa convertidor
1. Elija File  Open (u oprima CTRL+O).
2. Seleccione Clarion source (*.clw) de la lista desplegable File of type.
3. Seleccione la carpeta C:\CLARION5\TUTORIAL.
4. Destaque el archivo CONVERT.CLW y oprima el botón Open.
LECCIÓN 5
IMPORTACIÓN DE DATOS PREEXISTENTES
113
Aparece el Editor de Texto Clarion, con el archivo cargado para modificar.
El Administrador de Bases de Datos creó el código fuente de conversión en este archivo, que
contiene todo lo necesario para leer los datos del archivo BASIC y copiarlo al archivo
TopSpeed.
5. Elija Project  Set ... .
Aparece la caja de diálogo Select Proyect.
6. Elija Proyect file (*.prj) de la lista desplegable File of type.
7. Seleccione el directorio C:\CLARION5\TUTORIAL.
8. Destaque el archivo CONVERT.PRJ, y luego oprima el botón Open.
El Adminstrador de Bases de Datos generó también el archivo CONVERT.PRJ al mismo
tiempo que el archivo fuente CONVERT.CLW.
Cada programa Clarion tiene un Proyecto ("Project") que controla las opciones para la
compilación del código fuente y el linkeado para producir el archivo .EXE resultante. En el
caso de programas codificados a mano (y conversiones de archivos generadas por el
Administrador de
Bases de Datos), estas configuraciones se contienen en un archivo .PRJ.
No hay necesidad de un .PRJ cuando se usa el Generador de Aplicaciones, dado que el archivo
.APP mismo contiene todas las configuraciones del Proyecto.
En este punto, podríamos modificar el código fuente para realizar cualquier conversión de
datos que se necesite (véase los temas en la ayuda en línea sobre: How to Convert a FileGenerate Source y How to Make a Field Assignment para más información sobre cómo
adaptar el código de conversión de datos). Sin embargo, no hay nada que debamos hacer en
este proyecto, así que basta con compilar y ejecutar el programa.
9. Elija Project  Run (u oprima CRTL+R)
Esto compila el programa, lo linkea a un .EXE, y corre el ejecutable resultante para realizar la
conversión de archivos. Mientras corre el programa, aparece una ventana de estado, que
indica el estado de la conversión. Dado que hay sólo unos pocos registros que convertir en este
caso, desaparecerá muy pronto y probablemente no podrá verla.
10. Elija File  Close para cerrar el archivo y salir del Editor de Texto.
CLARION 5™
114
APRENDIENDO CLARION
Prueba
Ahora puede comprobar los datos en el nuevo archivo, abriéndolo con el Administrador de
Bases de Datos y desplazándose por los registros.
1. Elija File  Open (u oprima CTRL+O)
2. Elija Database file de la lista desplegable File of type, ilumine el archivo CLIENTES.TPS, y
oprima el botón Open.
Se abre una caja de diálogo que pregunta por el Controlador (driver) del archivo, la contraseña
(password), y opciones necesarias para abrir el archivo.
3. Seleccione TOPSPEED de la lista desplegable Driver, y oprima el botón OK.
Esto demuestra otra forma de abrir el Administrador de Bases de Datos, distinta que desde el
Editor del Diccionario.
Adviértase que el primer registro contiene los nombres de campo y no datos, así como ocurría
en el archivo en el archivo IMPORT1.CSV. No se necesitan tales nombres en este archivo, de
modo que puede borrar este registro inútil.
4. Con la barra deslizable ubicada sobre el primer registro, oprima DELETE, luego oprima el
botón Yes cuando se le pregunte si confirma el borrado.
5. Oprima el botón Yes cuando se le pregunte si desea hacer un archivo de respaldo(backup).
El Administrador de Bases de Datos siempre pregunta si desea hacer una copia de seguridad
antes de realizar cualquier tipo de modificación de los datos. Siempre es buena idea premitir
que lo haga (¡por las dudas!).
6. Oprima el botón Exit.
Aparece un mensaje que pregunta si se desea guardar los cambios realizados en el archivo
CLIENTES.TPS. Este diálogo ofrece una oportunidad adicional para deshacer los cambios
realizados, si se da cuenta que fue un error efectuar modificaciones. Yes guarda los cambios y
sale; No revierte el archivo al estado en que estaba cuando usted ingresó al Administrador de
Bases de Datos y sale, y Cancel lo devuelve al Administrador.
7.
Oprima el botón Yes para guardar los cambios realizados.
Ahora usted ha convertido algunos datos existentes importantes al formato TopSpeed para que
las aplicaciones Clarion puedan usarlos. En el siguiente capítulo, comenzaremos a construir
una aplicación "desde cero" usando el Generador de Aplicaciones.