Gua de Instalacin de Abanq y gestin de mdulos En esta gua veremos cmo instalar Abanq y gestionar sus mdulos Descarga

e instalacin de la aplicacin base En primer lugar debemos dirigirnos a la zona de descargas de www.Abanq.org y obtener la aplicacin base -ejecutable- adecuada a nuestra plataforma.

Instalacin para Windows / Mac OS X. Ejecutamos directamente el programa de instalacin y seguimos las instrucciones como en cualquier otro programa de instalacin para Windows o Mac OS X Instalacin para GNU / Linux. Abrimos una consola como usuario raz (root), y desde el directorio donde hemos guardado el paquete, lo ejecutamos:

[root@mimaquina midir]# sh ./Abanq-lite-X.X.x86.Linux.bin.run Bases de Datos Como hemos visto al inicio de este tema, la principal caracterstica de Abanq y una de las claves de su flexibilidad es el hecho de que tanto los datos de usuario como los mdulos se almacenan en una base de datos. Al iniciar la aplicacin, el primer cuadro de dilogo pide los datos para la conexin.

Si es la primera vez que iniciamos Abanq, introduciremos el nuevo nombre para la base de datos, a nuestra eleccin. Rellenaremos el resto del formulario tal como aparece en la figura. Si la base de datos no existe, Abanq preguntar si deseamos crear una nueva base de datos. Si respondemos afirmativamente, se nos avisar de la creacin de la base de datos y arrancar la aplicacin. Es importante recordar que cada nueva base de datos no contendr ningn mdulo instalado salvo el de sistema. El resto de mdulos debern ser cargados como se explica posteriormente. Es perfectamente posible crear una nueva base de datos slamente indicando un nuevo nombre para la base de datos en el dilogo al iniciar Abanq. Esto no influye en absoluto

sobre otras bases de datos previas; podemos perfectamente trabajar con varias bases de datos, cada una con sus mdulos y datos de usuario, desde una nica instalacin del cliente Abanq. Podramos, por ejemplo, tener una base de datos para cada empresa, en caso de querer gestionar ms de una, o crear una base de datos de pruebas sobre la que realizar un test sobre las funcionalidades de nuevos mdulos, antes de instalarlos sobre nuestra base de datos habitual. Ms informacin sobre PostgreSQL Instalacin de mdulos Nota Importante. En este documento explicaremos cmo cargar, actualizar y desinstalar los mdulos sobre la aplicacin base de Abanq. Es importante tener en cuenta que la versin actual para Windows incluye ya incorporados los mdulos pblicos, por lo que no es necesario seguir los pasos aqu descritos a la hora de instalar Abanq por primera vez. S es interesante conocer el funcionamiento del mdulo de sistema para posteriores instalaciones o actualizaciones de los mdulos. Antes de poder instalar los mdulos es necesario obtenerlos en Abanq.org, donde hay mdulos pblicos gratuitos y muchos otros mdulos especiales. Una vez descargados, descmprimimos el paquete en una carpeta de nuestro disco duro, desde la que a continuacin cargaremos los mdulos sobre Abanq. 1. Cmo funciona el mdulo de administracin El mdulo de administracin se integra en el rea de Sistema. Se crea automticamente cuando instalamos Abanq, desde l podemos cargar, borrar o recargar todos los dems modulos. Est incluido en un rea con el mismo nombre y es el nico mdulo que no podemos desinstalar. La ventana principal de este mdulo est compuesta de las siguientes opciones:

Cargar Mdulos. Desde esta opcin se realiza la carga de mdulos que an no existen o que han sido modificados. reas. Se abrir una ventana en la que aparecer el nombre de todas aquellas reas que componen nuestra configuracin, desde este mismo lugar podremos crear, borrar o modificar cualquiera de ellas. Mdulos. Desde esta opcin podremos acceder a todos los mdulos que componen nuestras reas, teniendo acceso a todos los ficheros de que est compuesto cada uno de ellos.

2. Cargando los mdulos Arrancamos Abanq y seleccionamos el rea Administracin. Pulsamos el botn Cargar Mdulo y seleccionamos el fichero *.mod correspondiente al mdulo que deseamos cargar.

Si todava no existe el rea correspondiente al mdulo que estamos instalando, Abanq nos preguntar si queremos crearla en este momento. Contestamos S, e introducimos la descripcin del rea. Abanq cargar los ficheros que componen el mdulo, mostrando su icono en el men del rea correspondiente. Con esto hemos terminado la instalacin del mdulo. Podemos probarlo pulsando sobre el icono.

Desinstalacin de mdulos Seleccionamos el rea Sistema y el mdulo Administracin. Pulsamos el botn Modulos y seleccionamos el fichero correspondiente al mdulo que deseamos desinstalar, pulsamos el botn Eliminar Registro. La desinstalacin de un mdulo implica que la funcionalidad que dicho mdulo proporciona deja de estar disponible para el usuario, aunque los datos (tanto de usuario como de definicin del mdulo) se mantienen en la base de datos.

Recarga de nuevas versiones Seleccionamos el rea Sistema y el mdulo Administracin. Pulsamos el botn Cargar Mdulo y seleccionamos el fichero .mod correspondiente al mdulo que deseamos recargar. Puesto que el modulo ya existe, debemos confirmar que deseamos recargar el mdulo. A continuacin Abanq cargar automticamente todos aquellos ficheros que componen el mdulo y tengan alguna modificacin. Cuando cambiemos de mdulo Abanq se reiniciar para cargar los nuevos datos. Por segurodad, es recomendable hacer un backup de los datos antes de recargar un mdulo. Editar ficheros desde el mdulo de sistema (para programadores) Cuando cargamos un mdulo desde disco utilizando el rea de sistema, todos los ficheros del mdulo son almacenados en la base de datos. En el rea de sistema, la accin Mdulos permite gestionar estos ficheros residentes en la base de datos. Al abrir un mdulo de la lista, la ventana resultante nos mostrar un listado de los ficheros que componen dicho mdulo. Si abrimos uno de ellos, nos aparecer la un formulario. El botn Editar fichero va a lanzar la aplicacin adecuada para editar el archivo segn su extensin: si se trata de una tabla abrir un editor de textos, por ejemplo. Procedimiento para realizar modificaciones (para programadores) Hemos visto cmo Abanq incorpora varios editores que son accesibles desde el mdulo de sistema para modificar los ficheros contenidos en la base de datos. Dependiendo del tipo de fichero, Abanq abrir el editor adecuado. Este sistema es til a la hora de mostrar la flexibilidad y facilidad de modificacin del programa, o para realizar pequeos cambios sobre la marcha. Sin embargo, a la hora de realizar modificaciones ms serias, o de entrar en un desarrollo real, el procedimiento recomendado es el siguiente: 1. Abrir directamente los ficheros a modificar en el directorio correspondiente y con el editor adecuado: las tablas, scripts y consultas en un editor de texto, los formularios con QT Designer, cuyo ejecutable es designer, instalado en el mismo directorio que el ejecutable de Abanq. 2. Realizar las modificaciones oportunas 3. Volver a Abanq y recargar el mdulo 4. Probar las modificaciones realizadas

5. Repetir los pasos 2 , 3 y 4 hasta finalizar las modificaciones Volcado a disco de los mdulos Segn hemos visto, una vez cargado un mdulo, ste pasa a la base datos para ser operativo. Es importante recordar que aunque la estructura de ficheros de los mdulos reside en disco, es de la base de datos de donde Abanq toma los mdulos previamente cargados. Abanq integra varias herramientas para editar los mdulos, tales como un procesador de textos. Para usar stas herramientas integradas debemos abrir uno de los ficheros que integran un mdulo desde el rea de sistema. No obstante, si vamos a realizar modificaciones importantes en los mdulos, resulta ms eficiente trabajar sobre los ficheros de los mdulos en disco y, una vez modificados, recargarlos a la base de datos desde Abanq. Si, por ejemplo, deseamos insertar nuevos campos en una tabla, podemos abrir el archivo .mtd correspondiente dentro del directorio tables del mdulo correspondiente con nuestro editor de texto favorito. Una vez modificado el fichero para insertar los nuevos campos, recargaremos el mdulo tal como hemos visto en apartados anteriores. Es importante notar que si ya hemos realizado cambios desde el rea de sistema, estos cambios residen en la base de datos pero no han sido trasladados a los ficheros en disco, por tanto si recargamos un mdulo desde el disco podemos perder los cambios realizados. Para evitar esto existe la posibilidad de volcar a disco un mdulo. Para ello abriremos, dentro del rea de sistema y la accin mdulos, el mdulo que deseamos volcar. Pulsando el botn indicado en la figura se crear una copia en disco de los ficheros residentes en la base de datos. Actualizado el 19/11/2007