Guía de Instalación de Abanq y gestión de módulos
En esta guía veremos cómo instalar Abanq y gestionar sus módulos
Descarga e instalación de la aplicación base
En primer lugar debemos dirigirnos a la zona de descargas de www.Abanq.org y obtener la aplicación base -ejecutable- adecuada a nuestra plataforma.
- Instalación para Windows / Mac OS X. Ejecutamos directamente el programa de instalación y seguimos las instrucciones como en cualquier otro programa de instalación para Windows o Mac OS X
- Instalación para GNU / Linux. Abrimos una consola como usuario raíz (root), y desde el directorio donde hemos guardado el paquete, lo ejecutamos:
Como hemos visto al inicio de este tema, la principal característica de Abanq y una de las claves de su flexibilidad es el hecho de que tanto los datos de usuario como los módulos se almacenan en una base de datos.
Al iniciar la aplicación, el primer cuadro de diálogo pide los datos para la conexión.
Si es la primera vez que iniciamos Abanq, introduciremos el nuevo nombre para la base de datos, a nuestra elección. 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 creación de la base de datos y arrancará la aplicación.
Es importante recordar que cada nueva base de datos no contendrá ningún módulo instalado salvo el de sistema. El resto de módulos deberán ser cargados como se explica posteriormente.
Es perfectamente posible crear una nueva base de datos sólamente indicando un nuevo nombre para la base de datos en el diálogo 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 módulos y datos de usuario, desde una única instalación del cliente Abanq.
Podríamos, por ejemplo, tener una base de datos para cada empresa, en caso de querer gestionar más de una, o crear una base de datos de pruebas sobre la que realizar un test sobre las funcionalidades de nuevos módulos, antes de instalarlos sobre nuestra base de datos habitual.
Nota Importante. En este documento explicaremos cómo cargar, actualizar y desinstalar los módulos sobre la aplicación base de Abanq. Es importante tener en cuenta que la versión actual para Windows incluye ya incorporados los módulos públicos, 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 módulo de sistema para posteriores instalaciones o actualizaciones de los módulos.
Antes de poder instalar los módulos es necesario obtenerlos en Abanq.org, donde hay módulos públicos gratuitos y muchos otros módulos especiales. Una vez descargados, descmprimimos el paquete en una carpeta de nuestro disco duro, desde la que a continuación cargaremos los módulos sobre Abanq.
1. Cómo funciona el módulo de administración
El módulo de administración se integra en el área de Sistema. Se crea automáticamente cuando instalamos Abanq, desde él podemos cargar, borrar o recargar todos los demás modulos. Está incluido en un área con el mismo nombre y es el único módulo que no podemos desinstalar. La ventana principal de este módulo está compuesta de las siguientes opciones:
- Cargar Módulos. Desde esta opción se realiza la carga de módulos que aún 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 configuración, desde este mismo lugar podremos crear, borrar o modificar cualquiera de ellas.
- Módulos. Desde esta opción podremos acceder a todos los módulos que componen nuestras áreas, teniendo acceso a todos los ficheros de que está compuesto cada uno de ellos.
2. Cargando los módulos
Arrancamos Abanq y seleccionamos el área Administración. Pulsamos el botón Cargar Módulo y seleccionamos el fichero *.mod correspondiente al módulo que deseamos cargar.
Si todavía no existe el área correspondiente al módulo que estamos instalando, Abanq nos preguntará si queremos crearla en este momento.
Contestamos Sí, e introducimos la descripción del área.
Abanq cargará los ficheros que componen el módulo, mostrando su icono en el menú del área correspondiente.
Con esto hemos terminado la instalación del módulo. Podemos probarlo pulsando sobre el icono.
Seleccionamos el área Sistema y el módulo Administración. Pulsamos el botón Modulos y seleccionamos el fichero correspondiente al módulo que deseamos desinstalar, pulsamos el botón Eliminar Registro.
La desinstalación de un módulo implica que la funcionalidad que dicho módulo proporciona deja de estar disponible para el usuario, aunque los datos (tanto de usuario como de definición del módulo) se mantienen en la base de datos.
Seleccionamos el área Sistema y el módulo Administración. Pulsamos el botón Cargar Módulo
Puesto que el modulo ya existe, debemos confirmar que deseamos recargar el módulo. A continuación Abanq cargará automáticamente todos aquellos ficheros que componen el módulo y tengan alguna modificación.
Cuando cambiemos de módulo Abanq se reiniciará para cargar los nuevos datos.
Por segurodad, es recomendable hacer un backup de los datos antes de recargar un módulo.
Editar ficheros desde el módulo de sistema (para programadores)
Cuando cargamos un módulo desde disco utilizando el área de sistema, todos los ficheros del módulo son almacenados en la base de datos. En el área de sistema, la acción Módulos permite gestionar estos ficheros residentes en la base de datos. Al abrir un módulo de la lista, la ventana resultante nos mostrará un listado de los ficheros que componen dicho módulo. Si abrimos uno de ellos, nos aparecerá la un formulario.
El botón Editar fichero va a lanzar la aplicación adecuada para editar el archivo según su extensión: si se trata de una tabla abrirá un editor de textos, por ejemplo.
Procedimiento para realizar modificaciones (para programadores)
Hemos visto cómo Abanq incorpora varios editores que son accesibles desde el módulo 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 modificación del programa, o para realizar pequeños cambios sobre la marcha. Sin embargo, a la hora de realizar modificaciones más 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 módulo
4. Probar las modificaciones realizadas
5. Repetir los pasos 2 , 3 y 4 hasta finalizar las modificaciones
Volcado a disco de los módulos
Según hemos visto, una vez cargado un módulo, éste pasa a la base datos para ser operativo. Es importante recordar que aunque la estructura de ficheros de los módulos reside en disco, es de la base de datos de donde Abanq toma los módulos previamente cargados.
Abanq integra varias herramientas para editar los módulos, tales como un procesador de textos. Para usar éstas herramientas integradas debemos abrir uno de los ficheros que integran un módulo desde el área de sistema.
No obstante, si vamos a realizar modificaciones importantes en los módulos, resulta más eficiente trabajar sobre los ficheros de los módulos 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 módulo correspondiente con nuestro editor de texto favorito. Una vez modificado el fichero para insertar los nuevos campos, recargaremos el módulo 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 módulo desde el disco podemos perder los cambios realizados. Para evitar esto existe la posibilidad de volcar a disco un módulo.
Para ello abriremos, dentro del área de sistema y la acción módulos, el módulo que deseamos volcar. Pulsando el botón indicado en la figura se creará una copia en disco de los ficheros residentes en la base de datos.