Manual de Instalación - BRIDGE POS v4.1

Revisión 2.7 

Introducción

¿Qué es BRIDGE POS?

BridgePOS es la aplicación de punto de venta que integra las interfaces de usuario, con servicios asociados a la venta (servicios en línea y gestión de promociones) y las reglas de negocio personalizadas, permitiendo su reutilización para los diferentes canales de venta, transformándose en un punto de servicio multicanal.
BridgePOS maneja además de las operaciones de venta y devolución, operaciones de no venta y de contabilidad de caja.
En este manual encontrará la información requerida para la instalación y configuración del producto BridgePOS y sus componentes.

Acerca de este manual

Se explicarán cada uno de los pasos de instalación, los requerimientos de hardware y software, las propiedades a ser configuradas.
El manual se encuentra dividido en los siguientes capítulos:

• Capítulo 1 - Introducción

Provee una breve descripción del producto así como también una visión global del manual, brindado información sobre el contenido del mismo.

• Capítulo 2 – Instalación de Bridge POS

Informa los requerimientos de software y hardware para poder instalar el sistema, la instalación del producto y la ejecución del Sistema.

• Capítulo 3 – Anexo

Se detallan escenarios de soluciones a posibles problemas y un anexo de instalación del motor de Promo.

Instalación de Bridge POS

Plataformas Soportadas

• Windows XP (sólo 32 bits) (de utilizar Java 1.8 ya no será soportado el SO XP)
• Windows 7
• Windows 8
• Linux Ubuntu 10.4+/gtk2 2.18+.
• Mac OS X 10.7.3 o superior (solo 64 bits)

Requerimientos mínimos de Hardware

Los siguientes requerimientos son los recomendados de mínima, considerando que sean de uso dedicado para la aplicación Bridge.

• Memoria RAM: 2 Gb (mínimo)
• CPU: i3 o similar. 2 GHz o superior / 32-bit (x86) o 64-bit (x64)
• Capacidad de almacenamiento en Disco Rígido: 500Mb o superior (considerando el espacio requerido para logs)
• Placa de video – Aceleración por HW

Requerimientos de Software

• JVM 1.8.0_25 o superior
• Base de datos (para Bridge Manager):
  • MSSQL Server 2008 R2 o superior
  • Oracle 10g o superior

Existen configuraciones alternativas dependiendo del sistema operativo (2.4.2 Configuraciones alternativas).

Instalación

Requisitos iniciales

Es requisito que antes de descomprimir el paquete instalador se encuentren instalados y funcionando los siguientes componentes:

• Servidor de base de datos (con la base de datos generada para Bridge Manager).
• JDK.

Es requisito que antes de comenzar la instalación la terminal a asociar al POS que se está instalando debe existir en Bridge Manager Tienda. El instalador consulta datos de la misma en el proceso de instalación y no quedará correctamente instalado si la terminal no existe aún.
NOTA:
A partir de la versión 4.1.3 de Bridge, el instalador permitirá instalar Bridge POS junto con el motor Promo (v1.3), librería EMV para Argentina y agente de Director para actualización de Promo.
Por prerrequisitos para instalar Promo, ver Anexo instalación motor de Promo y librería EMV

Configuraciones alternativas

Opciones basadas en Windows

1. 1. Opción 1
      1. Versión  XP
      2. CPU: Pentium IV 2.4 GHz
      3. RAM: 2 GB
      4. Video: Intel 82915 G/GV/910GL - 128 MB
   2. Opción 2
      1. Versión 7 / 8
      2. CPU: Intel Celeron CPU G1820 @ 2.70GHz
      3. RAM: 2.00 GB
      4. Video: Intel HD Graphics
   3. Opción 3 (HP ProDesk 400 G2.5 SFF)
      1. Versión 7 / 8 / 10
      2. CPU: Core i7 4.0 GHZ / i5 3.7 GHZ / i3 3.3 GHZ / Pentium 3.3 GHZ / Celeron 2.9 GHZ
      3. RAM: 4 GB / 8GB (dependiendo el modelo)
      4. Video: Intel HD Graphics

Opciones basadas en Linux

1. Opción 1 (nota: requiere ajustes de UI por un problema en las transiciones de escenas donde se usan transparencias con algún grado de alpha)
2. Versión: SLEPOS V11 – SP4 (En una versión de Suse armada por NCR – Entorno gráfico GNome).
3. Intel CORE I3-2120T – 2.6Ghz
4. RAM 4Gb DDR3
5. Placa gráfica Intel HD
6. Opción 2 (nota: Realizando la configuración 3D y aceleración por hardware)
7. Versión: Suse desktop 12, con entorno gráfico KDE.
8. Intel CORE I3-2120T – 2.6Ghz
9. RAM 4Gb DDR3
10. Placa gráfica Intel HD
11. Opción 3
12. Versión: OpenSUSE 13
13. Intel CORE I3-2100 – 3.1Ghz
14. RAM 3Gb
15. Placa gráfica Intel HD
16. Opción 4 (corriendo en una máquina virtual de un equipo que tiene instalado Windows 8 – Entorno de desarrollo)
17. Versión: Kubuntu
18. Intel CORE I5-3210 – 3.1Ghz
19. RAM 8Gb
20. Placa gráfica Intel HD 4000

Instalación de la aplicación (Entorno Windows)

Ejecución del instalador

El nombre del archivo del instalador es: bridge-pos-installer-${version}.jar, donde ${versión} es el número de versión del producto.
Para iniciar el instalador, se debe ejecutar el siguiente comando desde una ventana de línea de comando en modo administrador
java –jar bridge-pos-installer -${ version}.jar
(Ejemplo: c:\Descargas\java –jar bridge-pos-installer-4.1.5-SNAPSHOT.jar)
IMPORTANTE: se debe ejecutar desde una ventana en modo administrador, debido a que si se instala el motor de Promo se requiere registrarlo como servicio.


Para iniciar el instalador, se debe ejecutar el siguiente comando desde la ventana de línea de comando:
Directorio del instalador …:\>java –jar bridge-pos-installer-${ version}.jar
(Ej: c:\Descargas\java –jar bridge-pos-installer-4.1.5-SNAPSHOT.jar)
En el caso de que se quiera forzar el idioma del instalador al español, agregar el parámetro del idioma:
java -jar -Duser.language=es bridge-pos-installer-4.1.5-SNAPSHOT.jar
(Ej: c:\Descargas\java –jar -Duser.language=es bridge-pos-installer-4.1.5-SNAPSHOT.jar)

Pasos de instalación

1. Ejecutarlo desde línea de comando, como se explicó en el paso anterior. Al comenzar a descomprimirse, se mostrará la siguiente imagen:

1. Si el sistema encuentra configuraciones ya existentes informa el siguiente mensaje y permite cargar una configuración previa.
   • Si se presiona el botón "SI" se precargará la configuración previa
   • Si se presiona el botón "NO" o si no existiera configuración previa, pasará a mostrar la pantalla del siguiente punto f)

1. La próxima pantalla a mostrarse es la de "términos y condiciones de uso" donde se detalla el texto de las condiciones de licenciamiento.

• • Para poder leer el texto completo, se podrá hacer uso de la barra de scroll, pudiendo verificar el texto completo

1. Al presionar "aceptar", pasará a la próxima pantalla de aceptación de "términos y condiciones de uso".

1. Se deben completar con los datos del encargado del área del retailer (datos obligatorios)
   • Tildar la opción "acepto los términos y condiciones de uso" (obligatorio para una correcta instalación)
   • "nombre completo"
   • "correo electrónico"

Ejemplo:

• • Si se ingresara uno de los datos con formato no válido se informará con un mensaje de error (formato de email y el campo nombre que se encuentre completo)

Nota: si no se aceptan los términos y condiciones de uso, el proceso de instalación pasará a la última pantalla del instalador salteando las configuraciones restantes. Ver Instalación fallida por no aceptación de términos y condiciones

1. Luego de completos los datos obligatorios y presionar el botón "siguiente", el sistema mostrará la siguiente pantalla para su configuración, con valores predeterminados que podrán ser modificados.

• • Directorio de instalación: presionando el botón Seleccionar, se abre un menú para seleccionar la carpeta, crearla o directamente se configura el directorio en el campo de ingreso.

Importante: El directorio de instalación del POS debe ser distinto al que se seleccionó para la instalación del BM. De esta forma, si para la instalación de BM se seleccionó c:\Synthesis\bridge, se recomienda seleccionar ahora c:\Synthesis\pos.

• • Directorio Java: se debe configurar con el directorio en el cual se encuentra instalada la máquina virtual de Java (sin incluir el directorio bin dentro del directorio a configurar)

• • Instalar Motor de Promo: indicador si se instala o no el motor de promociones junto con el POS.
  • Instalar EMVKit: indicador si se instala o no la librería de VTOL con EMV.
  • URL Promo Central: URL y puerto donde se encuentra corriendo la consola de Promo. Este dato es requerido cuando el motor de Promo trabaja con el módulo de Loyalty. Si la instalación de la consola se realizó junto con Bridge Manager, la URL será la misma.
  • Carpeta de Mapas de Promo: directorio al cual se distribuyen los mapas de Promo. Si la consola se instaló junto con Bridge Manager, el directorio por defecto será:
    1. Directorio de instalación de BM\config\promo\sales (incluyendo la carpeta sales que será donde residen los mapas) 

Ej: C:\synthesis\bridge\config\promo\sales

Nota: en el directorio se encontrará el directorio sales y desde el POS se deberá tener permiso para accederlo si es un recurso compartido.

• • Ubicación URL de Director: URL y puerto donde se encuentra funcionando Director (actualizador de versiones)
  • Seleccione el Tipo de Punto de Venta: se configura el tipo de instalación. Las opciones disponibles son:

1. 1. 1. "Tienda": modalidad estándar de Bridge POS.
      2. "Self Order": auto facturación directa del cliente con cobro con tarjeta bancaria (ver Configuración modalidad SefOrder)
      3. "Supermercado" (ver Configuración modalidad Supermercado)
   • ¿Desea permitir operar en forma offline?: Esta opción permite configurar una base local para registrar las transacciones que se pueden realizar en forma offline.
   • ¿Desea ejecutar el punto de venta a pantalla completa?: se debe indicar si el POS se inicia como pantalla completa o en modo ventana.

1. Una vez configurados todos estos datos presionar el botón "Siguiente". Si alguno de los directorios configurados no existe, se solicitará que confirme la creación del mismo (esto por cada directorio configurado que no exista)

1. La próxima pantalla permite seleccionar si el servidor de la base de datos de Bridge Manager a la cual se conectará el POS se encuentra en SQL Server o Oracle.

1. La próxima pantalla permite configurar los datos del servidor y de la base de datos de Bridge Manager a la cual se conectará el POS, si la opción seleccionada previamente fue SQL Server (ver Motor de base de datos Oracle)

• • Host: dirección IP del servidor de base de datos o el nombre del host (localhost en el caso en el cual resida en el mismo servidor).
  • Puerto: por defecto es el puerto 1433.
  • Instancia: para SQL Server no siempre requiere ingreso de dato.
  • Base de datos: nombre de la base de datos.
  • Usuario: usuario de la base de datos.
  • Contraseña: clave del usuario de la base de datos.
  • Código de Terminal: se debe configurar con el código de una de las terminales habilitadas para la tienda en Bridge Manager. Se pueden verificar las terminales existentes desde el menú Administración/Negocio/Terminales de Bridge Manager Tienda (columna "código")

El botón "Verificar conexión con la base de datos" permite corroborar los datos ingresados.



Luego de configurar la base de datos y verificar su prueba de conexión, presionar el botón "Siguiente".

1. Si en la primera pantalla de configuración del instalador se seleccionó ¿Desea permitir operar en forma offline?: "si", el sistema solicita la información de la base de datos local del POS para poder trabajar con modalidad offline de los maestros de Bridge Manager.

• • Host: dirección IP del servidor de base de datos o el nombre del host (localhost en el caso en el cual resida en el mismo servidor).
  • Puerto: por defecto es el puerto 1433.
  • Instancia: para SQL Server no siempre se requiere ingreso de dato.
  • Usuario: usuario de la base de datos.
  • Contraseña: clave de la base de datos.

NOTA: no es requerido indicar el nombre de la base de datos dado que en caso de que el sistema necesite operar en forma offline, creará una base de datos automáticamente. El nombre será, por convención: "Bridge-<DiaActual>"

1. Luego, el sistema consultará si desea configurar los dispositivos. De no requerirse el cambio quedarán configurados los nombres lógicos definidos por defecto y no será necesario su ingreso, quedando los campos en blanco. Sólo deberán ingresarse si se requiere sobrescribir los mismos.

• ¿Desea configurar los dispositivos?: si/no
• Seleccione el tipo de impresora fiscal: se habilita un listado de los modelos de impresora fiscal homologados. De no tener una impresora fiscal, se deberá dejar configurado como "Ninguna".

• Puerto Serial de la impresora fiscal: se deberá ingresar el COM donde se encontrará conectada la impresora. Ej: COM2 o COM1
• ¿Desea utilizar los emuladores de los dispositivos?: si/no. En caso de habilitarse con la opción "si" se podrán configurar que dispositivos levantará la aplicación POS al iniciar.

Por configuración de emuladores: ver Configuración de emuladores de dispositivos
Esta pantalla sólo se mostrará si se configuró previamente ¿Desea configurar los dispositivos?: si en la pantalla previa.

• • Directorio lib dispositivos: se podrá definir el directorio en el cual residen las librerías externas requeridas para los dispositivos (jar, .dll)

Nombres lógicos por defecto que tomará la configuración de no ser ingresados otros.

• Scanner: scanner.logicalName
• MSR: msr.logicalName
• Impresora: printer.logicalName
• Teclado POS: keyboard.logicalName
• Cajón de dinero: cashdrawer.logicalName
• MICR: micr.logicalName

1. Luego de configurar los dispositivos, presionar el botón "Siguiente", donde pasará a mostrarse una pantalla en la cual se podrán configurar las librerías adicionales que puedan ser requeridas. Si no se requiere configuración, se presiona "Siguiente" listándose las páginas 1 y 2 para .jar adicionales.

1. Presionar el botón "Siguiente", donde pasará a la siguiente pantalla de configuración de la librería EVM para Argentina (siempre y cuando en la pantalla inicial de configuración del instalador se haya tildado la opción "Instalar EMVKit"). De no ser utilizada no es requerida su configuración.

• • Ingrese la Ip de VTOL: se define la IP del servidor VTOL
  • Ingrese el Puerto de VTOL
  • Ingrese la IP donde se vincule EMVKIT: por defecto localhost si reside en el mismo equipo del POS.
  • Ingrese el Puerto donde se vincula EMVKIT: por defecto es 3500

Si alguno de los campos no es ingresado o su formato no es válido, se informará mediante el siguiente mensaje:

1. Presionar el botón "Siguiente", donde pasará a la siguiente pantalla de configuración del driver del pinpad. De no ser utilizado no es requerida su configuración.
   • Puerto del pinpad
   • Driver del pinpad: opciones POSNET A0600, POSNET A0700 3DES o VISA 306B06

1. Presionar el botón "Siguiente", donde pasará finalmente a la pantalla final del instalador.

1. Presionar el botón "Instalar". Al finalizar satisfactoriamente el sistema informa el siguiente mensaje:

En aquellos casos en los cuales se haya instalado el motor de Promo, se visualizarán los servicios de Promo instalados.

En aquellos casos en los cuales se haya instalado la modadidad de EMVKit, se visualizarán los servicios de VTOL instalados.

1. En caso de error se podrán visualizar los errores mediante un click sobre el botón "Enseñar detalles, errores"

1. En caso de requerir cancelar el proceso de instalación en cualquiera de las pantallas previas, se debe presionar el botón "Cancelar".

Instalación fallida por no aceptación de términos y condiciones

Flujo particular si no fueron aceptados los términos y condiciones durante el proceso de
Instalación de Bridge POS

1. En caso de no haber tildado la opción de aceptación de términos y condiciones, pasará directamente a la última pantalla del proceso de instalación, informando que la misma fue fallida.

Instalación en modo silencioso

A partir de Bridge v4.1.4, el instalador ofrece la posibilidad de instalar el motor de Promo en conjunto con Bridge POS.
En esta modalidad de instalación, se podrá pre configurar mediante un archivo de configuración, para que el instalador tome los valores precargados y no sean solicitados en forma interactiva con las diferentes pantallas gráficas del instalador estándar.
El archivo de configuración ant.install que se haya generado de una instalación previa, podrá ser utilizado de base para próximas instalaciones ajustando aquellos parámetros requeridos para una nueva instalación tomando estos como parámetros por defecto.

1. Configurar parámetros del archivo ant.install
   1. Para la instalación de un Bridge POS: se debe tomar la referencia de un ant.install de Bridge POS (ver: Detalle de parámetros del archivo ant.install para Bridge POS)
2. Copiar el archivo en el directorio donde se encuentra el instalador y desde donde se ejecutará el mismo en modalidad silencioso.
3. Abrir una ventana de comandos como administrador.

1. Una vez configurado el archivo de propiedades ant.install, desde el directorio donde se encuentra ubicado el archivo del instalador, ejecutar el comando

java –jar bridge-pos-installer-{version}.jar text-auto

1. Una vez ejecutado el comando java –jar bridge-manager-installer-{version}.jar text-auto, se descomprimirá el archivo informando en la ventana de comando "Loading self extractor…" abriéndose un popUp donde irá informando el avance.

1. A medida que el instalador va ejecutando sus pasos, se irán informando en la ventana de comandos.

1. Al finalizar la instalación se informará en la ventana de comando como "Terminado"

Instalación fallida

En aquellos casos en los cuales se genere algún error, se informará en la ventana de comandos el mensaje de error.
En el ejemplo, la clave del usuario de la base de datos no es correcto y da un error al intentar hacer un login con el usuario y clave configurados en el archivo de propiedades ant.install

Detalle de parámetros del archivo ant.install para Bridge POS

A continuación se detallan aquellos parámetros que son tomados como base desde el archivo ant.install en aquellos casos en los cuales la instalación se lleve a cabo a través del comando text-auto sin tener la interacción con las pantallas gráficas donde se va solicitando el ingreso de la configuración de la instalación
basedir = C\:\\Synthesis\\Compartida\\Instalador\ Unificado
.
ant.install.config.version = 0.0

1. 1. Properties from Page:license
      <!— Datos ingresados de aceptación de términos y condiciones de uso-->
   2. Properties from Page:licenseInput
2. .CheckboxInput
   license.accepted = true
3. .ValidatedTextInput
   license.name = Juan Perez
4. .ValidatedTextInput
   license.email = [email protected]
   
   <!— Propiedades definidas para los directorios de instalación -->
   1. Properties from Page:InstDIR
5. .DirectoryInput
   installDir = C\:\\synthesis
   pos <!— Directorio de instalación -->
6. .JavaDirectoryInput
   javaDir = C\:
   Program Files\\Java
   jre1.8.0_25 <!— Directorio de Java -->
7. .UnvalidatedTextInput
   terminalId = 6 <!— Número de terminal -->
8. .TargetInput
   InstallPromoEngine = true <!— Indicador de motor de Promo -->
9. .TargetInput
   InstallEMVKit = false <!— Indicador de librería EMVKit de VTOL -->
10. .UnvalidatedTextInput
    promo.url = http\://localhost\:8080/promo <!— URL de consola de Promo -->
11. .DirectoryInput
    promo.maps = c\:\\synthesis\\BMT_Mar6v415\\config\\promo
    <!— directorio donde residen los mapas donde tomará el motor de Promo -->
12. .UnvalidatedTextInput
    director.url = https\://synthesis-director\:8490/ <!— URL de instalación de Director -->
13. .LargeSelectInput
    posType = store <!— Tipo de punto de venta. Opciones : store, selfOrder, supermarket -->
14. .TargetSelectInput
    offline = offlineDisable <!— Desea permitir operar en modo offline. Opciones :offlineDisable, offlineEnable -->
15. .LargeSelectInput
    fullscreen = false <!— Pantalla completa o no : true o false -->
16. Targets selected for page
    InstDIR-targets = InstallPromoEngine,offlineDisable, <!— Resumen de pantalla, sumando los datos de los parámetros InstallPromoEngine (solo si es true),offline, -->
    
    
    
    
    <!— Propiedades definidas para la configuración de base de datos -->
    1. Properties from Page:dbselect
17. .TargetSelectInput
    dbengine = mssql <!— Microsoft SQL u Oracle. Opciones : mssql u oracle -->
18. Targets selected for page
    dbselect-targets = mssql, <!— Resumen -->
    
    <!— Propiedades definidas para configuración de la base de datos -->
    1. Properties from Page:dsmssql
19. .UnvalidatedTextInput
    datasource.dbhost = NTK-ANDREAA <!— Host del motor de BD -->
20. .UnvalidatedTextInput
    datasource.dbport = 1433 <!— Puerto del motor de BD -->
21. .UnvalidatedTextInput
    datasource.dbinstance = SQLEXPRESS <!— Instancia del BD -->
22. .UnvalidatedTextInput
    datasource.dbname = BMT_Mar6v415<!— Nombre de la BD -->
23. .UnvalidatedTextInput
    datasource.username = sa <!— Usuario de BD -->
24. Property hidden .PasswordTextInput
    #datasource.password= XXXXXXXX <!— Contraseña de la base de datos. Descomentar esta línea y agregar la clave del usuario
    Ej.:datasource.password= nosotros -->
25. .UnvalidatedTextInput
    terminalId = 4 <!— Número de terminal -->
    
    <!— Configuración de base de datos de Bridge Manager, si la base de datos seleccionada es Oracle-->
    1. Properties from Page:dsoracle
26. .UnvalidatedTextInput
    datasource.dbhost = NTK-ANDREAA <!— Host del motor de BD -->
27. .UnvalidatedTextInput
    datasource.dbport = 1433 <!— Puerto del motor de BD -->
28. .UnvalidatedTextInput
    datasource.dbservice = orcl <!— Nombre de la base de datos/instancia -->
29. .UnvalidatedTextInput
    datasource.username = sa <!— Usuario de BD -->
30. Property hidden .PasswordTextInput
    #datasource.password= XXXXXXXX <!— Contraseña de la base de datos. Descomentar esta línea y agregar la clave del usuario
    Ej.:datasource.password= nosotros -->
31. .UnvalidatedTextInput
    terminalId = 6 <!— Número de terminal -->
    
    <!— Propiedades definidas para configuración de la base de datos offline Oracle-->
    1. Properties from Page:dsofflineoracle
32. .UnvalidatedTextInput
    offline.host = localhost <!— Host de la BD offline -->
33. .UnvalidatedTextInput
    offline.port = 1433 <!— Puerto de la BD offline -->
34. .UnvalidatedTextInput
    offline.instance = <!— Nombre de BD/Instancia de la BD offline -->
35. .UnvalidatedTextInput
    offline.username = sa <!— Usuario de la BD offline -->
36. Property hidden .PasswordTextInput
    #offline.password=XXXXXXXX <!— Contraseña de la base de datos offline. Descomentar esta línea y agregar la clave del usuario
    Ej.:offline.password= nosotros -->
    <!— Propiedades definidas para configuración de la base de datos offline SQL -->
    1. Properties from Page:dsofflinemssql
37. .UnvalidatedTextInput
    offline.host = localhost <!— Host de la BD offline -->
38. .UnvalidatedTextInput
    offline.port = 1433 <!— Puerto de la BD offline -->
39. .UnvalidatedTextInput
    offline.instance = <!— Instancia de la BD offline -->
40. .UnvalidatedTextInput
    offline.username = sa <!— Usuario de la BD offline -->
41. Property hidden .PasswordTextInput
    #offline.password=XXXXXXXX <!— Contraseña de la base de datos offline. Descomentar esta línea y agregar la clave del usuario
    Ej.:offline.password= nosotros -->
    
    <!— Propiedades definidas para configuración de dispositivos -->
    1. Properties from Page:configureDevices
42. .TargetSelectInput
    installType = notConfigureDevices <!—Configura o no dispositivos. Opciones: notConfigureDevices (no), configureDevices (si) -->
43. .LargeSelectInput
    fiscalPrinter = <!— modelo de printer fiscal -->
44. .UnvalidatedTextInput
    fiscalPort = <!— puerto donde se conecta la printer fiscal -->
45. .LargeSelectInput
    emuladores = ALL <!— Utiliza o no emuladores. Opciones : ALL (si), NONE (no)-->
46. Targets selected for page
    configureDevices-targets = notConfigureDevices, <!— Resumen -->
    
    
    <!— Propiedades definidas para configuración de dispositivos con nombres lógicos -->
    1. Properties from Page:DevicesConfig
47. .UnvalidatedTextInput
    devices.scanner = <!— Nombre lógico del dispositivo -->
48. .UnvalidatedTextInput
    devices.msr =
49. .UnvalidatedTextInput
    devices.posprinter =
50. .UnvalidatedTextInput
    devices.keyboard =
51. .UnvalidatedTextInput
    devices.cashdrawer =
52. .UnvalidatedTextInput
    devices.MICR =
53. .UnvalidatedTextInput
    devices.externalDisplay =
54. .UnvalidatedTextInput
    devices.externalLibraries =
    
    
    <!— Propiedades definidas para configuración del directorio de un jar de un dispositivo -->
    1. Properties from Page:LibsDirConfig
55. .UnvalidatedTextInput
    jars.path.1 = <!— directorio donde se encuentra el jar del dispositivo -->
56. .UnvalidatedTextInput
    jars.path.2 =
57. .UnvalidatedTextInput
    jars.path.3 =
58. .UnvalidatedTextInput
    jars.path.4 =
59. .UnvalidatedTextInput
    jars.path.5 =
60. .UnvalidatedTextInput
    jars.path.6 =
61. .UnvalidatedTextInput
    jars.path.7 =
62. .UnvalidatedTextInput
    jars.path.8 =
63. .UnvalidatedTextInput
    jars.path.9 =
64. .UnvalidatedTextInput
    jars.path.10 =
    
    
    <!— Propiedades definidas para configuración de VTOL para trabajar con EMVKit -->
    1. Properties from Page:VtolInstDIR
65. .ValidatedTextInput
    vtol.ip = demosynthesis.cloudapp.net <!— IP del servidor VTOL -->
66. .ValidatedTextInput
    vtol.port = 3003 <!— Puerto del servidor de VTOL -->
67. .ValidatedTextInput
    lib.bind.ip = localhost <!— IP donde se vincula la librería EMV Argentina -->
68. .ValidatedTextInput
    lib.bind.port = 3500 <!— Puerto donde se vincula la librería EMV Argentina -->
    
    <!— Propiedades definidas para la configuración del pinpad de la librería EMV de VTOL -->
    1. Properties from Page:VtolConnection
69. .UnvalidatedTextInput
    pinpad.portName = COM9 <!— Puerto del pinpad -->
70. .LargeSelectInput
    pinpad.driver = com.synthesis.vtol.ar.client.devices.posnet.PinpadVx820A0600PosnetDriver
    <!— Driver del pinpad. Opciones:
    com.synthesis.vtol.ar.client.devices.visa.PinpadVx8200310B00VisaDriver,
    com.synthesis.vtol.ar.client.devices.posnet.PinpadVx820A0700PosnetDriver,
    com.synthesis.vtol.ar.client.devices.posnet.PinpadVx820A0600PosnetDriver -->
    
    <!— Resumen de instalación -->
    1. Properties from Page:progress
71. Targets selected for page
    progress-targets = pos,licenseAccepted,configStore,configSelfOrder,configSupermarket,config,vtolservices,cleanuptarget,
    
    

    Motor de base de datos Oracle

    Flujo particular si el servidor de base de datos seleccionado fue Oracle
    Si fue seleccionado Oracle, la pantalla permite configurar los datos del servidor y de la base de datos de Bridge Manager a la cual se conectará el POS.
    
    • Host: dirección IP del servidor de base de datos o el nombre del host (localhost en el caso en el cual resida en el mismo servidor).
    • Puerto: por defecto es el puerto 1521.
    • Servicio o SID: nombre de la base de datos/instancia
    • Usuario: usuario de la base de datos.
    • Contraseña: clave de la base de datos.

Nota: retomar al flujo de instalación (configuración punto-g)

Estructura de directorios creada en la instalación

Luego de haber descomprimido el paquete de instalación de Bridge POS, quedará una estructura de directorios similar a la siguiente en el directorio de instalación (ej.: c:\synthesis\BridgePOS).
En esta figura (obtenida de una instalación en Windows), se ve el árbol de directorio con las carpetas más importantes a tener en cuenta:

• Directorio de instalación/bridge/app/config: contiene los archivos de configuración de la base de datos, hibernate.cfg.xml y para offline, de las impresoras fiscales (dependiendo del modelo utilizado como Epson o Hasar), logs y las siguientes carpetas:
  • documents: archivos templates utilizados para impresión.
  • pinpad: archivos de configuración del dispositivo del pinpad.
  • promo: contiene los archivos de configuración requeridos para el motor de PROMO, junto con su carpeta de mapas y archivo de índice. Esto depende del directorio configurado en el instalador.
  • views: contiene los archivos requeridos para las definiciones de las diferentes pantallas utilizadas por Bridge POS y las respectivas imágenes que las componen.
    • En la carpeta Directorio de instalación\bridge\app\config\views\themes\synthesis\screensaver\img se colocarán las imágenes y videos que se desean exponer en Bridge POS en los tiempos de inactividad de la terminal.
    • En la carpeta *Directorio de instalación* *bridge\app\config\views\themes* se encuentran las carpetas utilizadas para otros formatos de pantalla y resolución de imágenes.
  • vouchers: contiene los archivos de configuración de los templates de los comprobantes a imprimir en Bridge POS.
• Directorio de instalación/bridge/app/Lib: contiene las librerías utilizadas por Bridge POS (.jar)
• Directorio de instalación/ bridge/app/Log: contiene los archivos de logs de la aplicación Bridge POS.

Luego de la primera ejecución de Bridge POS, se generan directorios adicionales a los de la instalación.

• Directorio de instalación/bridge/app/tlog: dentro de este directorio se encontrarán otras tres carpetas processed, uncommited y with-errors donde se irán guardando los TLOGs generados para cada operación y auditoría. Luego de que hayan sido enviados a Bridge Manager tienda para su distribución pasarán a la carpeta "processed" o aquellos que hayan sido leídos pero que se dio algún error "with-errors" o "uncommited"
• Directorio de instalación/bridge/app/audit y electronicJournal: se guardan los archivos que permiten generar luego los reportes de auditoría desde el Bridge Manager
• Directorio de instalación/director: archivos y librerías requeridas para el agente de Director (actualizador de versiones)

Ejecución del sistema

Configuración de la JVM

Antes de comenzar la ejecución de la aplicación se deberá chequear que se encuentren correctamente configurados algunos de los parámetros y variables de entorno relativos a la JVM.
Parámetros y Variables de Entorno:
JAVA_HOME: mediante esta variable de entorno es posible configurar el path del componente JDK.

Iniciar la aplicación

Para iniciar la aplicación "BridgePOS" se debe ejecutar el archivo:

• Para Windows
  • Directorio de instalación del POS/bridge/app/run.bat

Nota: si se desea asignar memoria al pos debe agregarse el parámetro -Xmx512m en run.bat
Ejemplo:
"C:/Program Files/Java/jre1.8.0_25/bin/java" %DEBUG_OPTIONS% -Xmx512m -cp %CLASSPATH%

Detener la aplicación

Para detener la aplicación, deben presionarse en forma simultánea las teclas "CONTROL + C" dentro de la ventana donde se esté ejecutando la aplicación BridgePOS. Y luego confirmar la cancelación del proceso.

Mantenimiento

Luego de haber realizado la instalación de la aplicación Bridge POS, puede ser requerido algún cambio en los parámetros de configuración.
Estos cambios pueden ser necesarios ya sea por:

• cambio requerido en la ubicación de la base de datos o usuario/clave de la base de datos,
• cambio en el directorio de configuración,
• cambios en dispositivos
• depuración de archivos de log,
• otras.

Nota: Tener en cuenta que para realizar el mantenimiento se deberá detener la aplicación, realizar los cambios requeridos y luego volver a iniciarla. Para mayor información de cómo iniciar y detener la aplicación ver: Ejecución del sistema.

Configuración de la base de datos

De ser necesario cambiar alguna de las siguientes propiedades de la conexión a la base de datos luego del setup del POS:

• Nombre de usuario
• Contraseña
• Dirección IP donde se encuentra el servidor
• Nombre de la base de datos
• Tipo de Driver

Deberá editarse el siguiente archivo:
Bridge\app\config\hibernate.cfg.xml (en el directorio de instalación de BridgePOS)
Dentro de las configuraciones Database connection settings, los parámetros que podrán editarse:

• Cadena de conexión para conectarse a la base de datos de Bridge Manager, en caso de requerir modificar la dirección IP o su puerto (en el ejemplo: localhost:1433), el nombre de la base de datos (ej.: BRIDGEPOSFX)

<property name="connection.url">jdbc:jtds:sqlserver://localhost:1433/BRIDGEPOSFX;instance=;</property>

• Clase que implementa el Driver para la conexión a la base de datos.

<property name="connection.driver_class">net.sourceforge.jtds.jdbc.Driver</property>

• Nombre se usuario para acceder a la base de datos de Bridge Manager.

<property name="connection.username">sa</property>

• Contraseña para acceder a la base de datos de Bridge Manager.

<property name="connection.password">nosotros</property>

Configuración del ID de terminal

De ser necesario cambiar el ID de terminal (por otro ID que se encuentre definido en Bridge Manager), deberá editarse el archivo:
run.bat (en el directorio de instalación de BridgePOS)
set TERMINAL_ID=10

Configuración del teclado y sus acciones

Es posible personalizar el teclado con sus diferentes funciones a través de scripts de base de datos (esto como parte de la personalización de un proyecto)
Esta configuración permite definir el mapeo de las teclas de función, con los códigos de teclas (keymap_id) y el código manejado por BridgePOS (action).
En el manual de usuario se especificarán que valores de BridgePOS corresponden a que funcionalidad sólo a modo de referencia.
Ejemplo de definición de un teclado con las funciones asociadas

1. Keyboard_modelo: modelos de teclado a configurar

insert into keyboard_model (code, description) values ('1','Modular Compact Alphanumeric POS Keyboard');
insert into keyboard_model (code, description) values ('2','Retail Point of Sale Keyboard with Card Reader and Display');
insert into keyboard_model (code, description) values ('3','Modular 67 Key Keyboard');
insert into keyboard_model (code, description) values ('4','Teclado PC');

1. Keymap: teclado asociado a un modelo

insert into keymap (code, description, keyboard_model_id) values ('1','Mapa Solo Venta',4)

1. Keymap_store: tienda/terminal que tiene ese teclado

insert into keymap_store (store_id, work_station_id, keymap_id) values (null, null, 1)

1. Keymap_key: teclas de función y acciones disponibles

INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA1', 'onCashPesos') –- Pago en pesos
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA2', 'onCardOff') –- Pago con tarjeta
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA3', 'onPromotions') –- Ver promociones o seleccionar opciones de promociones
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA4', 'onFindCustomers') –- Consulta clientes
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA5', 'onNewCustomer') – alta cliente
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA6', 'onSuspendTransaction') –- suspender transacción
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA7', 'onPayment') –- Pasar de venta a PAGOS
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA8', 'onVoid')-- anular articulo o pago
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA9', 'onQuantity') –- venta por cantidad
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA10', 'onMagnitude') –- venta por peso/magnitud
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA11', 'onBackToSales') –- volver a pantalla de ventas (desde pagos)
INSERT [keymap_key] ([keymap_id], [logical_key], [action]) VALUES (1, 'TECLA12', 'onSearch') –- consulta artículos

Configuración de dispositivos con sus nombres lógicos

Para la configuración de dispositivos se cuenta con valores por defecto, los cuales podrán ser modificados por otros al momento del setup.
Los valores por defecto para los nombres lógicos de dispositivos son:

• Impresora: printer.logicalName
• Scanner: scanner.logicalName
• MSR: msr.logicalName
• Cajón de dinero: cashdrawer.logicalName
• Teclado POS: keyboard.logicalName
• MICR: micr.logicalName

El POS inicializa los dispositivos utilizando los nombres predefinidos en el archivo de configuración jpos.xml
De requerir modificar los nombres lógicos configurados por defecto, se deben extender los modelos de los dispositivos en el archivo ejecutable run.bat.
Si se desea utilizar un nombre lógico diferente para algún dispositivo en particular, como el scanner y el MSR, se debería agregar en el archivo run.bat la siguiente configuración:
rem ***********************************************************************
rem *** A continuación se setea el nombre lógico de los dispositivos ***
rem ***********************************************************************
set SCANNER=
set MSR=
set PRINTER=
set MICR=
set KEYBOARD=
set CASHDRAWER=

Librerías externas requeridas para dispositivos

En el proceso de setup del POS se configuran aquellas librerías que puedan ser requeridas por los dispositivos y que son externas al POS. Estas se podrán modificar desde el archivo run.bat
rem ***********************************************************************
rem *** A continuación se agregan los jars adicionales a la aplicación, ***
rem *** como por ejemplo los necesarios para el uso de dispositivos. ***
rem *** NOTA: cabe destacar que NO se debe incluir ninguna versión ***
rem *** del jar de JavaPOS, ya que la aplicación ya cuenta con ***
rem *** la última versión del mismo. ***
rem ***********************************************************************
set JARS_PATH=

Directorio de librerías externas para dispositivos (.dll, .jar)

En el proceso de setup del POS se configura el directorio donde el POS debe ir a buscar las librerías externas que pueda requerir. En el caso de requerir modificarlo por otro directorio, se debe modificar en el archivo run.bat
rem ***********************************************************************
rem *** A continuación se agregan los directorios adicionales que sean ***
rem *** necesarios para cargar las librerías del sistema que necesitan ***
rem *** los jars agregados previamente. ***
rem ***********************************************************************
set LIBRARY_PATH=""
Nota: no se deben incluir versiones del .jar de JavaPOS ya que es incluida en la aplicación

Configuración de impresora fiscal

Si la terminal requiere de la configuración de una impresora fiscal se deberá chequear que se encuentre configurado en el run.bat los siguientes parámetros:

1. –DfiscalMode=true (de no especificarse o configurarse con un valor distinto a "true" no se iniciará la impresora fiscal)
2. –DfiscalDiver=epson (los parámetros permitidos son Epson o Hasar)

Copiar el archivo dll en la ruta "C:\synthesis\pos\bridge\app\lib"
SO 64 bits:

SO 32 bits:

Modificar el parámetro LIBRARY_PATH del run.bat quedando de la siguiente manera:
LIBRARY_PATH="lib/"
Nota: la configuración específica de las impresoras fiscales, según su modelo se podrán encontrar en el directorio pos/bridge/app/config como: fiscal-epson.xml o fiscal-hasar. Xml

Archivo de configuración de carga de parámetros para Epson TMU220

Dentro del archivo de configuración fiscal-epson.xml que se encuentra en el directorio pos/config.
Se debe revisar la configuración de los siguientes parámetros:
Este parámetro dependerá del puerto que le asigne la PC para la conexión de la printer fiscal:
<param name="port" value="COM4"/>
Este parámetro es el que indica el monto límite por el cual se solicitará el ingreso de un cliente al ticket (generando un ticket factura):
<param name="baudRate" value="9600"/>
<param name="maxTicketAmount" value="1000" />
Este parámetro es el que indica el monto límite por el cual se podrá emitir un ticket factura (superado este límite se debería generar una factura por otro medio):
<param name="maxInvoiceAmount" value="25000" />
Este parámetro configura el micro código de la printer fiscal. En el caso de la Epson puede ser "Demeter" o "Hera":
<param name="printerFirmwareName" value="Hera" />
Estos parámetros se ajustarán de acuerdo al texto que el retailer desee imprimir:
<param name="fantasyName">
<line position="1">
<richText bold="false" underlined="false" doubleWidth="true" doubleHeight="true">Bridge POS</richText>
</line>
<line position="2">
<richText bold="true">Sucursal: 1 - Terminal: 10</richText>
</line>

Configuración de emuladores de dispositivos

En el caso de no disponer de dispositivos físicos conectados a la terminal, se podrá configurar el emulador de ese dispositivo para poder operar en el POS simulando su operación.
Estos emuladores son iniciados al momento de iniciar la aplicación POS.
En el archivo run.bat del Directorio de instalación del POS/bridge/app, se podrá configurar el siguiente parámetro:
set EMULATORS="ALL"
Las variantes de configuración:

• NONE (ninguno de los emuladores de dispositivo por defecto)
  • set EMULATORS="NONE"

• ALL (todos los emuladores activos)
  • set EMULATORS="ALL"

• Si se desean configurar sólo algunos de ellos, se los debe mencionar con una coma de separación entre sí (emuladores de dispositivos disponibles: SCANNER, MSR, PRINTER, KEYBOARD, CASHDRAWER, POS_PRINTER, KEYBOARD, MICR)
  • set EMULATORS="SCANNER, MSR"

Configuración del timeout para período de inactividad

Se podrá configurar el tiempo de inactividad del POS (expresado en milisegundos) para que se activen las imágenes o video para que se muestren durante el período de inactividad del POS.
En el archivo run.bat del Directorio de instalación del POS, se debe configurar en el siguiente parámetro:
set IDLE_TIME_LIMIT=300000
Este parámetro se seteará en la línea de comandos al ejecutar el POS.
El directorio en el cual se toman las imágenes o videos para ser mostrados durante el período de inactividad:

• Directorio de instalación\bridge\app\config\views\themes\synthesis\screensaver\img

Formatos soportados para video, audio e imágenes:

• Video: FLV containing VP6 video and MP3 audio; MPEG-4 multimedia container with H.264/AVC (Advanced Video Coding) video compression.
• Audio: MP3; AIFF containing uncompressed PCM; WAV containing uncompressed PCM; MPEG-4 multimedia container with Advanced Audio Coding (AAC) audio
• Imágenes: .gif (animados también), .jpg 

Configuración de los archivos de log

El archivo logging.properties es el archivo que contiene la configuración de los archivos log del POS ubicado en el directorio config.
En este archivo se puede modificar la configuración de:

• nombre del archivo de log: por defecto está definido como: ./bcore%u.log, lo cual significa que va a generar un log en el directorio configurado en el setup de la aplicación, llamado bcore%u.log, en donde %u es reemplazado por un identificador único, lo cual permitirá ir generando nuevos archivos sin ser sobreescritos al llegar al tamaño límite del archivo.
• directorio donde se guardan los logs: en el parámetro java.util.logging.FileHandler.pattern se podrá configurar/modificar el directorio donde se grabarán los archivos logs.
• nivel de log: en el parámetro java.util.logging.FileHandler.level se podrá configurar/modificar con qué nivel de detalle se registrarán las excepciones en el archivo de log.

Los niveles de log soportados son:

• OFF
• SEVERE
• WARNING
• INFO
• CONFIG
• FINE
• FINER
• FINEST
• ALL

Para mayor detalle de cada uno de los niveles, referenciar el siguiente link:
http://docs.oracle.com/javase/7/docs/api/java/util/logging/Level.html

Depuración de archivos de log

La aplicación registra diversos eventos dentro del archivo de log. Asimismo, estos archivos, con el pasar del tiempo, aumentarán su tamaño progresivamente. Es por ello que es necesario realizar un cierto mantenimiento, consistente en la depuración de los mismos periódicamente.
Los archivos correspondientes al directorio de logs podrán ser eliminados sin afectar el comportamiento de la aplicación Bridge POS.

Configuración del idioma y regional setting

De ser necesario cambiar el idioma y GMT donde debe ejecturase el POS, deberá editarse el archivo:

• run.bat (en el directorio de instalación de BridgePOS)

-Duser.language=es
-Duser.timezone=GMT-5 (ejemplo para zona horaria de Panamá)

Configuración de pantalla completa

Si la terminal requiere no mostrarse en full screen o pantalla completa se debe verificar como se encuentra configurado en el run.bat el parámetro "-Dfullscreen".
De no especificarse, su configuración por defecto es "true" y la aplicación se mostrará en pantalla completa. 
-Dfullscreen=true (pantalla completa) 
-Dfullscreen=false

Configuración de teclado no visible

Si se desea ocultar el teclado numérico o alfanumérico en pantalla que se despliega ante el ingreso de datos en pantalla, el parámetro a configurar en el run.bat es "-DscreenKeyboard"
-DscreenKeyboard=false (no se despliega automáticamente el teclado en pantalla)

Configuración de impresora de red para el POS

Si se requiere configurar una impresora de red para que el POS pueda enviar impresiones específicas (según se encuentren habilitadas en la operación del POS) se deberán configurar los siguientes parámetros en el archivo printers.xml (path de instalación: pos\config\printers.xml)
<?xml version="1.0" encoding="UTF-8"?>
<!-- ******************    Definición de las impresoras     ***************** -->
<!-- **    En este archivo se definen las impresoras (locales o de red) a las     **** -->
<!-- ****    cuales se enviarán a imprimir los documentos.                                **** -->
<printers>
<printer name="\\stsfs1\Impresora_Segundo_Piso" />
</printers>
<!-- ********************** Fin de Definición de las impresoras *************************** -->
Reemplazar según corresponda: ej: Microsoft Print to PDF, \\stsfs1\Impresora_Segundo_Piso

Configuración modalidad SefOrder

En caso de que se haya instalado la modalidad de punto de venta "SelfOrder", la diferencia se podrá encontrar en el run.bat, donde el parámetro es:
com.synthesis.bridge.selforder.XBridgeSelfOrderApplication a diferencia de la utilizada para instalación standard de "tienda":
com.synthesis.bridge.pos.XBridgePosApplication
Nota: para la definición de la pantalla a utilizar en el SelfOrder, se deberá configurar la plantilla de ventas con las categorías (botones) y artículos a vender por categoría. La creación y configuración de las plantillas de venta se pueden realizar desde el Bridge Manager Central, definiendo para la terminal de la tienda requerida.
Luego de su sincronización, la misma podrá operar con la definición que se haya generado.
(Ver: Manual de Usuario - Bridge Manager/Plantillas de venta)

Configuración modalidad Supermercado

En caso de que se haya instalado la modalidad de punto de venta "Supermercado", la diferencia se podrá encontrar en el run.bat, donde el parámetro es:
com.synthesis.bridge.supermarket.XBridgeSupermarketApplication a diferencia de la utilizada para instalación standard de "tienda":
com.synthesis.bridge.pos.XBridgePosApplication
Nota: se debe tener en cuenta que se haya configurado previo al uso de Bridge POS el teclado, ya que en esta modalidad no se visualizan botones de operaciones sino que se hace uso del teclado con las definiciones de teclas de función.

Configuración modo offline

Si la terminal requiere trabajar en modalidad offline se debe verificar como se encuentra configurado en el run.bat el parámetro "-DofflineAllowed".
-DofflineAllowed=true, caso contrario se registrará como -DofflineAllowed=false

Depuración de TLOGs

Bridge cuenta con un proceso de depuración de los TLOGs (xml distribuidos en tienda)
Para esto se cuenta con el parámetro store.depurationDays, el cual permite configurar la cantidad de días a conservar los mismos.
"Cantidad de días en los que se guardan los Tlogs": para proceso de depuración.
Desde el Bridge Manager Tienda, configuración/configuración/tienda/opciones varias de tienda.

Al ejecutarse el proceso de depuración se eliminarán los tlogs cuya fecha sea previa a la cantidad de días configurados (tablas donde se distribuyen los TLOGs en tienda, no directorio)

Documentación relacionada

• MANUAL DE USUARIO - Bridge POS

Anexo

Troubleshooting

A continuación se describen escenarios en los cuales la aplicación Bridge POS no se puede ejecutar y cuáles son las configuraciones a revisar para su solución.

Aplicación no conecta con la base de datos configurada

Si en el log de la aplicación se detecta este tipo de errores:
Caused by: com.synthesis.fwk.persistence.PersistenceException: org.hibernate.exception.GenericJDBCException: Cannot open connection
at com.synthesis.bridge.bcore.persistence.H3PersistenceManager.begin(H3PersistenceManager.java:96)
at com.synthesis.bridge.bcore.business.operations.BaseTransactionalOperation.commit(BaseTransactionalOperation.java:26)
... 22 more
Caused by: org.hibernate.exception.GenericJDBCException: Cannot open connection
Revisar la configuración del servidor SQL, teniendo que encontrarse habilitado el protocolo TCP/IP. Y su configuración debe ser del puerto 1433.

Verificar que se encuentre configurado para aceptar conexiones remotas:

Si se realiza algún tipo de cambio en la configuración del SQL, reiniciar el SQL Server (para que tome los cambios aplicados).
Levantar el servicio de SQL Server Browser.

Aplicación no envía transacciones al servidor

Esto puede ser producido por problemas de conectividad con el servidor. Uno de las posibles soluciones es asociar el nombre del servidor (NombreServidor) con la dirección ip del mismo (IPServidor). A continuación se enumeraran los pasos a seguir para solucionar el problema:

1. Obtener nombre de dominio e IP del servidor.
2. Editar el fichero "C:\Windows\System32\drivers\etc\host"
3. Agregar la línea " IPServidor NombreServidor"
4. Guardar fichero

Anexo instalación motor de Promo y librería EMV

A partir de la versión 4.1.3 de Bridge, el instalador permitirá la instalación integrada del motor de Promo y la librería EMV para Argentina, junto con Bridge POS.

Pre-Requisitos del sistema para el motor de Promo

En el siguiente cuadro se detallan los requisitos mínimos y recomendados para la instalación del motor de promociones:

Servicios instalados

Terminado el proceso de instalación del motor de promociones podrá chequearse en los servicios del sistema la existencia de dos nuevos servicios correspondientes al motor de promociones y al agente Director que ya estarán ejecutandose de manera automática, lo cual permite indicar la correcta instalación y puesta en funcionamiento del nuevo motor de PROMO.

Los servicios instalados para la librería EMV de VTOL y su agente de actualización de Director.

Configuraciones Generales del Motor:

Archivos de Configuración

• CONFIG.XML

  <general> <simulation>false</simulation> <compatibilityMode>false</compatibilityMode> <mapIdentifiers></mapIdentifiers> <ticketIdentifiers>store,terminal</ticketIdentifiers> <disableLoyalty>false</disableLoyalty> </general>

  
  </simulation> : Indica si el motor opera para simulaciones desde la consola o no. Valor por defecto "False" (No simulación)
  </compatibilityMode> : indica si el motor opera en modo compatible con el antiguo motor (Integraciones 4690) agrupando o no los beneficios en la respuestas dadas por el motor. Por default el parámetro viene definido en "False" (No compatble) por lo que en este modo agrupara los beneficios (motor nuevo). En caso de definir el beneficio en "True", no se agruparan los beneficios (compatibilidad con antiguo motor).
  </disableLoyalty>: El valor por default de este parámetro será "false" indicando que el motor mantiene una comunicación con PROMO central para la gestión de elementos de Fidelidad. En caso de configurar en "true" este parámetro, se deshabilitara la comunicación con PROMO central, por lo que un status de Finish, commit, rollback, etc etc se evaluara como un status "sales" (método de evaluación previo a Fidelidad).
  </mapIdentifiers> y </ticketIdentifiers>:
  Directorio de donde tomara los mapas:

  <map> <!-Directorio desde donde el motor lee los mapas-> <directory>sales</directory> <!-Cantidad de segundos en los que chequea nuevo mapa-> <check>60</check> <!-Cantidad de dias hasta remover el archivo del mapa-> <daysUntilRemoval>100</daysUntilRemoval> </map>

  
  Puertos:

  <server> <!-Puerto del servidor rest-> <rest>8888</rest> <!-Puerto del servidor socket-> <socket>3000</socket> </server>

  
  Conexión con PROMO Central:

  <promoCentral> <url>http://localhost:8080/promo</url> <user>sender</user> <password>mate</password> </promoCentral>

  
  Directorio de Offline:

  <offline> <!-Directorio donde se guardarán los tickets offline-> <directory>offline</directory> <!-Cantidad de segundos en los que chequea offline-> <check>60</check> </offline>

  
  Configuración de Decimales en la respuesta:

  <response> <!-Decimales de redondeo de la respuesta-> <roundDecimals>2</roundDecimals> <roundCountables>3</roundCountables> </response>

• LOGGING.PROPERTIES

En este archivo podrán configurarse los niveles de logueo de la consola, siendo el nivel SEVERE el nivel por default y ALL el nivel de logueo para debug.

Mantenimiento - Motor

Depuración de archivos de log

Como se mencionó anteriormente, los archivos donde se registran los eventos que suceden en el motor de promociones son almacenados en uno o varios archivos de log. Estos archivos pueden crecer en tamaño dentro del disco rígido, quitando espacio que el usuario puede utilizar para otros fines. Por lo tanto es posible que se requiera eliminar algunos de estos archivos para liberar espacio.
Para eliminar los archivos de log será necesario consultar el archivo de configuración de log (../conf/logging.propertiesl). En él estarán especificadas las políticas de log, los archivos y los directorios destinados para este fin.

Errores de inicialización

Los siguientes son errores que pueden producirse al iniciar el motor de promociones:

• java.io.FileNotFoundException: \log\669comm.log (El sistema no puede hallar la ruta especificada)
  • Indica un error en la configuración del archivo de log. El error indica que no puede encontrar la ruta o el archivo '\log\669.comm.log'. Para solucionarlo, se recomienda revisar el archivo de configuración config/log4j.xml.

• Exception in thread "main" java.lang.NoClassDefFoundError: …
  • Este error ocurre cuando hay errores en el classpath.

• java.net.BindException: Address in use: JVM_Bind
  • Este error se produce cuando el puerto de comunicaciones que utilizará el Motor de promociones está reservado o siendo utilizado por otra aplicación. Sólo puede suceder en una comunicación TCP/IP. Para solucionarlo se recomienda determinar cuál es la aplicación que utiliza el puerto y cerrarla o configurarla para que utilice otro, o bien modificar la configuración del Motor de promociones para que establezca sus comunicaciones por un puerto diferente (a través del archivo de configuración, propiedad promoCommunication.port).

Errores de procesamiento

Durante su funcionamiento, el motor de promociones podrá informar errores similares a los enunciados a continuación:

• 
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  [promo.MIDDLEWARE] PROMOENGINE VALIDATION ERROR: [P01] combo-component: invalid use of order-criteria with this set

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  • Indica que se ha producido un error en la validación de algún mapa que está intentando cargar. El valor que se encuentra entre corchetes indica en qué promoción se ha producido el error. De no existir los corchetes significa que el error se produjo en la definición de la convivencia de las promociones que se encuentra en el mapa. El texto que sigue a los corchetes describe el tipo de error producido. Asimismo, anterior a esta línea de log se encuentra que mapa se intentó cargar.

• 
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  [promo.MIDDLEWARE.MESSAGING] Message not accepted: Parser exception parsing input message: Content is not allowed in prolog.

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  • Indica que se recibió una petición o ticket que no respeta el formato definido para la mensajería. En estos casos el motor responderá a la terminal que envió el requerimiento un mensaje de respuesta con un código de error (ver "Manual de mensajería – Promo").

• 
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  [promo.MIDDLEWARE] There is no PromoEngine available to process this request.

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  • Este mensaje se emite cuando el Motor de promociones recibe una petición que indica la utilización de una versión de mapa inexistente. Al igual que en el caso anterior, al no poder resolver la petición, se responderá con un mensaje que especificará un código de error (ver "Manual de referencia técnica – API de Promo").

• 
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  [promo.MIDDLEWARE.MESSAGING]- WARNING: INVALID TICKET: cvc-datatype-valid.1.2.1: 's250.0' is not a valid value for 'double'.

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  
  

  • Indica que se ha recibido una petición o ticket que posee un valor o tipo de dato inválido. En este caso, el motor dará un mensaje de respuesta con un código de error (ver "Manual de mensajería – Promo").

Documentación relacionada

1. Documento MANUAL DE USUARIO – PROMO 5.2.doc