Gua de Instalacin

Versiones del documento

Autor PabloJ.UrbanoSantos LuisIg.BacasRiveiro PabloJ.UrbanoSantos Fecha 03/12/08 Observaciones Cambiodelogos Versionesanteriores

ndice de contenido
Introduccin.........................................................................................................3 Antes de empezar...............................................................................................3 Base de datos..................................................................................................3 Mquina virtual de Java...................................................................................4 Instalacin...........................................................................................................4 De binarios.......................................................................................................4 De cdigo fuente.............................................................................................7 Ejecucin.............................................................................................................8

Introduccin
El presente documento ofrece las guas para ejecutar por primera vez la aplicacin Opentpv, una modificacin de Openbravo POS especializada en restaurantes de comida rpida.

Antes de empezar
Base de datos
La aplicacin almacena toda la informacin en una Base de datos, por lo que antes de ejecutar la aplicacin es necesario disponer de un Sistema gestor de Base de datos. Opentpv soporta los siguientes gestores de Bases de datos:

Oracle MySQL hSQL PostgreSQL

Recomendamos usar MySQL porque est especialmente probado y permite conexiones simultneas y por red. Se incluye un script de creacin de las tablas. Una vez elegido e instalado el Sistema gestor de Bases de datos a utilizar, se proceder a crear una Base de datos para la aplicacin, el nombre de esta puede ser cualquiera quedando a eleccin del usuario. Es aconsejable tambin crear un usuario que no sea 'root' pero no es imprescindible, en caso de crearlo se le deben dar permisos para el uso de la Base de datos. Ejemplo para MySQL:
mysql> create user opentpv; mysql> create database opentpv; mysql> grant all on opentpv.* to 'opentpv'@'%' identified by xxxx;

Donde xxxx es la contrasea que se quiera establecer para el usuario en la BD.

Mquina virtual de Java

Se necesita una mquina virtual de Java versin 1.5 .

Instalacin
De binarios
Para instalar la aplicacin, hay que seguir los siguientes pasos: 1. Descargar el fichero con los binarios (ejemplo: opentpv_version_bin.zip). 2. Descomprimir el archivo de la aplicacin. Ejemplo unzip opentpv_version_bin.zip -d /opt/opentpv 3. Ejecutar el archivo configure.sh e indicar los datos de configuracin de la Base de datos, as como datos referentes al aspecto del programa, caja registradora, impresoras de tickets, as como del lector de tarjetas bancarias.

Driver (librera): Debe indicarse donde se encuentra el empaquetado .jar de JDBC para el uso del sistema gestor de Bases de datos. Driver (clase): Clase de Java para el uso de la base de datos. En el ejemplo para MySQL sera com.mysql.jdbcDriver. Cadena de conexin: cadena que localiza la Base de datos, puede ser en el mismo ordenador o en otro por red. Usuario y clave de acceso: Los creados en el paso anterior. Caja registradora: En este apartado se configura desde el nombre de la caja registradora, hasta el aspecto (del programa) y si se ejecuta en modo ventana o a pantalla completa, as como la(s) impresora(s) y otros dispositivos externos. Localizacin: Permite adaptar a gusto del usuario el formato de nmero, moneda y otras cantidades. Pagos: Permite introducir los datos para el lector de tarjetas magnticas.

4. En cualquier caso siempre podremos volver a la pantalla de configuracin desde el panel lateral de la pantalla principal de la aplicacin a travs del men Configuracin.

De cdigo fuente
Otra manera de tener la aplicacin es compilar el cdigo fuente disponible. Para ello, seguiremos los pasos: 1. Descargar el fichero con los binarios (ejemplo: opentpv_version_src.zip). 2. Descomprimir el archivo de la aplicacin. Ejemplo: unzip opentpv_version_src.zip -d /opt/opentpv 3. Compilar el proyecto: 4. ant 5. A partir de aqu, configurar y como se haca en el apartado anterior (desde 3). Para instrucciones para la modificacin del cdigo fuente, el mejor recurso es: http://wiki.openbravo.com/wiki/OpenbravoPOS_Developer_guide

Ejecucin
Una vez configurada nuestra aplicacin podremos pasar a usarla normalmente, para ello utilizaremos el ejecutable start.sh (start.bat en Windows). Si no hay una base de datos correspondiente a la configuracin, ofrecer al inicio crear una base de datos automticamente. Una base de datos creada as estar vaca y tendr el formato de tickets y los logos por defecto de Opentpv. En la primera pantalla se nos pedir que nos identifiquemos que usuario somos, pulsaremos sobre el usuario Administrator para poder acceder a toda la aplicacin. La pantalla nos aparecer dividida en 2 partes, en la parte derecha se encuentra la pantalla de ventas y en la parte izquierda el men de configuracin. Desde el men configuracin podremos (segn los permisos de que disponga el usuario):

Men principal:

Realizar ventas, as como editarlas, devolverlas o borrarlas. Operaciones relacionadas con la caja: cierres, movimientos, ... Administracin de clientes: altas, modificaciones, .. Gestin del inventario: altas, bajas, modificaciones de productos, tipos de impuesto, descuentos, zonas de tarificacin, stockaje, movimiento de existencias, ... Informes de ventas Mantenimiento: en esta seccin se pueden definir que tipos de roles habr en la aplicacin, as como los permisos de estos, los usuarios de la aplicacin, la apariencia de los tickets, y el logo de la empresa. Tambin se encuentra aqu la gestin de almacenes. Cambio de clave del usuario. Acceso al panel de configuracin que vimos en el apartado anterior. Posibilidad de ver en la aplicacin los tickets que se han vendido o devuelto desde que se arranc la aplicacin. Cada vez que se cierra la aplicacin est seccin ser vaciada. Salir de la sesin. Volvemos a la pantalla de seleccin de usuario.

Men Administracin:

Men Sistema: