1

Manual de Usuario

El a2 DataMigrador es una utilidad para la migración de datos (conversión de un tipo base de datos a otro), este es capaz de migrar desde
archivos de Texto presentando los datos en forma de columnas, y desde tablas es Microsof FoxPro y DBase en cualquiera de sus versiones
hacia las bases de datos de a2 (DBISAM). El a2DataMigrador parte de los campos comunes entre las fuentes de datos y la tabla origen en a2,
cada campo migrable en las tablas a2 es mostrado y debe relacionarse con el campo correspondiente en la fuente. A continuación se muestra
la pantalla principal de la aplicación, y se explicaran cada uno de los pasos a seguir para su utilización:
Archivo Origen: en esta lista se debe ingresar la dirección donde se encuentra el archivo a migrar.
Destino(Directorio de Datos a2): En esta lista se debe seleccionar la dirección donde se guardara la información una vez migrada(debe
estar almacenada dentro de la carpeta DATA de la aplicación de a2 (Carpeta Data de A2).
Tipo del Archivo Fuente: aquí se indica el tipo de archivo a migrar, es decir la extensión del mismo (texto o base de datos), solo es
necesario marcar el correspondiente.
Tabla a2: en esta lista desplegable se indica el nombre de la tabla a la cual se migraran los datos.

En esta opción se debe

ingresar el directorio
origen. Al presionar este
botón sé ira al
siguiente paso de la
migración.

Al presionar este
En esta opción se
botón se cerrara la
debe ingresar la
aplicación.
dirección destino.

Si se marca esta opción se

borraran los datos existentes
en la tabla donde se van a
2 migrar los datos.
3
A continuación se mostrara los pasos a seguir para la selección de directorios; primero seleccionamos el Archivo Origen:

En la lista desplegable se debe

seleccionar el tipo de extensión del
archivo de origen.(txt,dbf,etc.)

Una vez seleccionado el archivo se

presiona sobre el botón “Aceptar”
para continuar con el proceso.

Al presionar el botón
“Cancelar” se detiene la
operación y se regresa a la
pantalla principal.

Ahora se selecciona el directorio Destino:

En la pantalla se muestra como se debe
ingresar el archivo de destino, es decir la
ubicación exacta donde se almacenara la data
que se va a migrar.

Al presionar el botón “Cancelar”

se detiene la operación y se regresa
a la pantalla principal.

Una vez seleccionado el directorio se

presiona el botón “Aceptar” para
continuar con el proceso.

4
Luego al momento de ingresar los datos en la opción “Tipo del Archivo Fuente”, este nos permitirá indicar el tipo de archivo(ASCII) o
base de datos a convertir. (Si el archivo origen proviene de una base de datos; bien sea DBASE o FoxPro, solo es necesario indicar el tipo y
el botón Opciones aparecerá desactivado.)
Este botón (Opciones) solo se activa
al seleccionar como tipo de archivo
fuente el ASCII, el cual permitirá
visualizar la siguiente pantalla donde
es necesario reflejar el tipo de
separador (este, puede ser cualquier
símbolo que indica donde termina un
campo y donde comienza el
siguiente. Ej...,;/).

Nota: se recomienda, evitar luego del separador campos en

blanco para campos tipo alfanumérico, para así evitar errores en la
migración.
Una vez realizado los pasos anteriores, se procede a seleccionar la tabla, en la cual se migraran los datos (esta pantalla aplica tanto para los
archivo de texto como para las bases de datos):

En esta lista desplegable se selecciona el

nombre de la tabla, a la cual se va a realizar
la migración (Autorizados, bancos, clientes,
etc.)

5
En la pantalla principal al seleccionar la opción de “Reiniciar tabla”, se debe tomar en cuenta que esta opción borrara todos los datos de la
tabla seleccionada, en la cual se migraran los datos, en caso de evitar este proceso se desactiva la misma.
Al reiniciar la tabla muestra la siguiente pantalla:

Al presionar el botón “Si” se confirma la opción Si se presiona la Opción “No”, se

de reinicio de la tabla, luego se debe presionar la cancela la operación y se muestra
opción “Siguiente”, que procederá a eliminar los nuevamente la pantalla principal,
elementos existentes en la tabla destino y se desactivando la opción “Reiniciar
muestra a continuación la pantalla donde indica tabla”.
el progreso y culminación de la misma.

6
Una vez seleccionado los directorios y las tablas, se presionan el botón “Siguiente” para continuar con el proceso de migración, y se
mostrara la siguiente ventana (este caso se aplica solo para archivos con extensión .txt o mejor conocidos como archivo de texto):

Al presionar el botón se tomara como nombre

Al presionar el botón se tomara como nombre o etiqueta de
o etiqueta para los campos la palabra “campo”
los campos, los escritos en el archivo de origen, estos deben
seguido del numero que corresponda a la
estar en columnas con separadores, (separador, pueden ser
posición que tenga en el archivo de origen.
cualquier símbolo que indica donde termina un campo y
(campo1, campo2, etc.)
donde comienza el siguiente :/,.- etc.) en la primera fila del
archivo.

Esta banda aparecerá luego de presionar él

Botón “Si” de la pantalla anterior, indicando
que sé esta abriendo el archivo de datos.

Una vez especificado o no el nombre de los campos, se presiona alguno de los dos botones antes descritos se mostrara la siguiente pantalla
(con las especificaciones ya determinadas según la opción escogida):

7
 Nota: esta pantalla se activara cuando el archivo origen sea de extensión .txt , así como también provenga de base de dato (DBASE o
FoxPro), solo que en el caso de las base de datos no es necesario indicar el nombre de los campos, ya que estos los toma automáticamente
de la tabla origen.

En esta banda
están reflejados
los nombres o
En esta banda están etiquetas de los
reflejados los campos de la
campos de la tabla a tabla origen.
la cual se van a
migrar los datos.
En esta columna del
grid, al posicionarse
sobre algunas de las filas
se puede seleccionar el
nombre del campo y
Los campos que aparecen relacionar lo con el
referenciados en color rojo, campo destino, descrito
representan los campos en la parte izquierda de
requeridos o también la misma fila.
llamados obligatorios (son
campos cuya inclusión es
necesaria).
Al presionar el botón
Al presionar el botón “Cancelar” permitirá
“Siguiente” permitirá continuar cancelar el proceso de
el proceso de migración. migración.

Al presionar el botón “Cancelar” se mostrara el siguiente mensaje de verificación:

8
 Al presionar este Al presionar este botón se continua
botón se cancela la con la operación.
operación.

Una vez presionado la opción “Siguiente” se procede a establecer el formato de origen de los datos, estos se especifican en la siguiente
pantalla:

9
 Aquí se establecen las distintas manera de cómo se manejan
´´ los campos, es decir los formatos que estos tengan
establecidos (en esta pantalla se establecerán los formatos
según como vengan reflejados en el archivo origen.)
Nota: Se recomienda observar y analizar los campos del
archivo fuente, dado que cualquier error en el ingreso del
formato, puede arrojar un error y afectar la forma en que se
migran los datos.

Al presionar el botón “Anterior”,

se regresara la pantalla de selección
´ de campos.
[

Al presionar el botón de “Migrar” se

procederá a trasladar la información
al archivo destino.

Valores Boléanos: hay dos opciones verdadero y falso, en los campos se establecen los valores designados para los mismos. (ej: “F” para
falso y “V” para verdadero)
Valores Numéricos: aquí se especificara el tipo de separador que los datos a migrar posean, y se deben definir para decimales y para
separador de miles.
Formatos de Fecha y Horas: en estos, se debe especificar el carácter que indica la separación de las fechas y así como también el formato
que estas tengan (esto aplica para horas y fechas).
Valor del código Automático: si el campo principal del archivo origen posee un valor incremental (en la pantalla anterior no se
seleccionara el código), la opción de Código Autoincrementado aparecerá activada, y solo será necesario indicar el valor inicial del mismo.

Si en la pantalla “Relación de Campos” uno o varios de los campos seleccionados tiene el formato de multiselección, la pantalla de formato
quedara similar a la pantalla que se mostró recientemente, pero con una pequeña diferencia, en vez del botón “Migrar” aparecerá un botón
llamado “Siguiente”, por ejemplo:

10
 Al seleccionar un campo de multiselección,
se mostrara a continuación la pantalla de
“Opciones de Formato”, pero con el
botón de “Siguiente” activado.

´
Nota: Un campo Multiselección es aquel que posee
varias opciones. Ej.: el campo Clasificación posee
varias opciones:
-Producto.
-Servicio.
Al seleccionar este campo, es necesario describir
dichas opciones.
´

Una vez presionado el botón siguiente en la pantalla de “Opciones de Formato”, se mostrara la pantalla de multiselección:

11
 ´

Aquí se selecciona En esta lista, se

el campo, al cual ingresaran por
se le establecerán teclado, la palabra
los parámetros de letra o numero que
selección. identificara y
relacionara al
parámetro reflejado a
la derecha del grid.

En esta lista se ven

reflejados los
distintos Este botón permite
parámetros. regresar a la pantalla
anterior (Opciones de
formato).

Si selecciona la tabla Inventario de Mercancía, se activa la opción de impuestos (impuesto 1 e impuesto 2), por lo tanto solo es necesario
indicar cual corresponde (o si maneja ambos indicarlos), (este caso ocurre cuando se seleccionan costos y/o precios).

12
 ´

Si maneja
impuesto 1 (15%),
Si maneja impuesto 2 (8%), es
es necesario
necesario ingresar la cifra.
ingresar la cifra.

Al presionar el botón “Migrar” se procede a trasladar la información seleccionada.

´+
Aparecerá una banda que le
indicara que se están abriendo los
archivos de datos, para luego
proceder a migrarlos.

Si durante el proceso de migración se posiciona sobre la banda de progreso aparece un mensaje de verificación, sobre la cancelación del
mismo.

13
 Si se desea cancelar la operación se presiona el botón “Si”, en caso contrario se
´ selecciona el botón “No” y sé continua con el proceso de migración.
Nota: este proceso también se aplica al procedimiento de reinicio de tabla, es
decir se da la opción de cancelar o no, el proceso durante su ejecución.

Si los datos fueron migrados correctamente aparecerá en pantalla un mensaje indicando el éxito del mismo

Esta dirección
representa el lugar
donde esta
almacenado el
archivo .log que
crea la aplicación.

Una vez que la operación ha sido concluida, los resultados de la misma pueden verse reflejados en un archivo .log, que crea el
a2DataMigrador (este archivo lo guarda en la misma dirección donde se encuentra el archivo origen, este se puede ser abierto con Block de
notas)

14
El archivo .log muestra el nombre de la tabla a la cual se hizo la migración, el nombre del archivo origen, los campos a los cuales se hace
referencia en ambos archivos (el de origen y destino), el resultado de la misma; y la fecha y hora del desarrollo del proceso.
En la parte del resultado del proceso, se puede ver reflejado en el archivo .log, el éxito o las posibles fallas (campos no migrados) que haya
tenido la migración y sus causas.

15