Conversor dBase
===============

Versin: 1.1
Autor:   Pedro Reina
Fecha:   J.12.2.1998


Objetivo del programa
---------------------

Realizar conversiones de ficheros dBase en distintos formatos:

a) De un fichero exp generado por Archive (con la opcin "quill") a un fichero
dbf en formato dBase que utilice para los textos el juego de caracteres del QL
o del PC.

b) De un fichero dbf en formato dBase a otro en el mismo formato, pero que use
para los textos un juego de caracteres diferente.


Requisitos del programa
-----------------------

El programa puede funcionar en un QL o en un PC, sin ninguna limitacin.


Arranque del programa
---------------------

Para arrancar el programa en el QL, ste debe estar en modo de alta resolucin
(MODE 4); hay que teclear

EXEC_W Convdb_exe

Se puede usar cualquier orden equivalente a EXEC_W, como por ejemplo EW.

En el PC se teclea

Convdb

Opcionalmente, se puede invocar el programa escribiendo como parmetro el
nombre del fichero de configuracin que se desea usar. Si se deseara usar el
fichero de nombre "Ejemplo", habra que teclear en el QL

EXEC_W Convdb_exe ; "Ejemplo"

(Para usar esta opcin es necesario que en el QL est instalado Toolkit II).

En el PC habra que teclear

Convdb Ejemplo


Lectura de la configuracin
---------------------------

Si se invoca Convdb sin especificar ninguna configuracin, se busca una por
defecto:

En el QL, se busca el fichero Convdb_cnf en el directorio de datos establecido
por Toolkit II.

En el PC, se busca el fichero Convdb.cnf en el directorio actual.


Uso del programa
----------------

El programa presenta un men principal con cuatro opciones:

La opcin Salida permite concluir el programa. Tambin se puede salir del
programa pulsando ESC en el men principal.

La opcin Explica presenta unas indicaciones sobre el uso del programa y la
forma de contactar con el autor.

La opcin Fichero es la que permite realizar la conversin de ficheros. Se
encuentran cinco opciones:

    La opcin Tipo permite especificar el tipo de conversin que se desea
    realizar. Hay cuatro posibilidades:

         1. exp Archive  dBase PC. Convierte un fichero exportado desde
         Archive con la opcin "quill" en un fichero dBase que utiliza para los
         textos el juego de caracteres del PC.

         2. exp Archive  dBase QL. Convierte un fichero exportado desde
         Archive con la opcin "quill" en un fichero dBase que utiliza para los
         textos el juego de caracteres del QL.

         3. dBase PC  dBase QL. Convierte un fichero dBase que utiliza para
         los textos el juego de caracteres del PC en un fichero dBase que
         utiliza para los textos el juego de caracteres del QL.

         4. dBase QL  dBase PC. Convierte un fichero dBase que utiliza para
         los textos el juego de caracteres del QL en un fichero dBase que
         utiliza para los textos el juego de caracteres del PC.

    La opcin Convierte busca en el directorio seleccionado todos los ficheros
    que coincidan con la mscara que est escrita en ese momento y que tengan
    la extensin correcta. Aparece un men con todos los archivos encontrados.
    Se selecciona el que se desea convertir o se pulsa ESC para anular el
    proceso.

    Opcionalmente, los ficheros pueden aparecer en orden alfabtico si en el
    men "Opciones" se selecciona "Orden" S.

    Nota: en el QL los nombres muy largos de fichero pueden no aparecer
    completos en la lista, aunque los ficheros se leern perfectamente.

    Una vez elegido el fichero, aparece un cuadro con el informe de los
    parmetros de la conversin y se pide el nombre que tendr la base de datos
    que se va a crear. Si se est realizando la conversin a partir de un
    fichero expoortado de Archive, aparecer otro cuadro con los primeros
    campos que se crearn del nuevo fichero dBase.

    La opcin Directorio permite especificar el directorio donde se buscarn
    los ficheros. Si se deja en blanco, se toma como directorio en el PC, el
    actual y en el QL, el de datos de Toolkit II.

    La opcin Mscara permite escribir la mscara que se usar para buscar
    ficheros. Se pueden usar dos caracteres especiales: el asterisco (*), que
    significa cualquier cantidad de caracteres y la interrogacin (?), que
    significa uno o ningn carcter.

    La opcin Extensin permite especificar la extensin de los ficheros.

La opcin Opciones se usa para especificar dos parmetros del programa:

    La opcin Sonido permite tener seales acsticas durante el programa.

    La opcin Orden determina que la lista de ficheros que aparece en la opcin
    "Convierte" del men "Fichero" est en orden alfabtico o aparezcan tal
    como se encuentran en el directorio.


El fichero de configuracin
---------------------------

Cuando se invoca Convdb se puede cargar un fichero de configuracin para
definir algunos parmetros del programa.

Los ficheros de configuracin son simples ficheros de texto que se pueden crear
y modificar con cualquier editor de texto. Se pueden introducir cuantos
comentarios se desee. Se considera comentario toda lnea que comience con el
carcter '*' y toda la parte de una lnea a partir de la doble barra ("//").
Las lneas en blanco se ignoran.

Para configurar un parmetro hay que introducir una lnea en el fichero que
tenga como primera palabra el indicador de lo que se quiere configurar y a
continuacin el valor o valores que se desean dar. Se pueden introducir en
cualquier orden.

Para ayudar al usuario a crear su propio fichero de configuracin se incluye
uno de ejemplo, llamado Convdb_cnf en el QL y Convdb.cnf en el PC.

A continuacin se describen las posibles entradas:

Sonido

Escribiendo "S" o "No", se especifica si el programa debe comenzar con el
sonido conectado o no. Si este parmetro no se incluye el programa toma por
defecto el valor "No".

Ordenar

Escribiendo "S" o "No", se especifica si la lista de ficheros que aparece en
la opcin "Convierte" del men "Fichero" debe verse en orden alfabtico o tal
como se encuentran en el directorio. Si este parmetro no se incluye el
programa toma por defecto el valor "No".