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 - Requerimientos

Informa los requerimientos de software y hardware para poder instalar el sistema.

Capítulo 3 - Instalación

Detalle de las opciones y el paso a paso para la instalación.

Capítulo 4 - Ejecución del sistema

Permite conocer como iniciar y finalizar la ejecución del POS.

Capítulo 5 - Configuración

Detalle de las configuraciones que pueden ser modificadas y de configuraciones que pueden requerirse, adicionales a las definidas en la instalación.

Capítulo 6 - Mantenimiento

Sugerencia de opciones para el mantenimiento óptimo de la aplicación.

Capítulo 7 - Personalizaciones

Detalle de opciones de personalización para el POS.

Capítulo 8 - Troubleshooting

Sección con los problemas más comunes y sus soluciones.

Para iniciar el instalador, abrir la ventana de línea de comando en modo administrador:

Navegar hasta el directorio en donde se encuentre el archivo instalador.

Desde ese directorio, ejecutar el siguiente comando, indicando el nombre del archivo instalador disponible:

Ejemplo: c:\Descargas\java –jar bridge-pos-installer-7.0.0.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-7.0.5-SNAPSHOT.jar

Al ejecutar el instalador, comenzará a extraer los archivos necesarios para la instalación.

Paso a paso

Luego de la extracción de los archivos, se presentan una serie de pantallas donde son requeridos datos para completar la instalación.

A continuación se presentan cada una y se detalla la información requerida.

(1) Paso: Napse Demo

Como inicio de la instalación se debe seleccionar ¿Desea instalar el punto de venta apuntando al entorno Napse DEMO? o no.

Para instalaciones productivas, presionar el botón "Siguiente"

NOTA si selecciona opción demo, continuar en: BPOS - Opción Napse demo

(2) Paso: Bienvenido al instalador de BRIDGE POS

Se informan los datos propios de la terminal y tienda:

• • Directorio de instalación: indicar el directorio en que se desee ubicar los archivos de la instalación. Puede ser un directorio nuevo o uno existente. 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:\napse\bridge, se recomienda seleccionar ahora c:\napse\pos. La carpeta debe estar vacia o no existir para evitar conflictos en la instalación.
  • Directorio Java: se debe configurar con el directorio en el cual se encuentra instalada la máquina virtual de Java (INCLUYENDO el directorio bin dentro del directorio a configurar). Por ejemplo: c:\JDK\bin
  • Código de la tienda: identificador de la tienda.
  • Código de terminal: gestionado previamente desde BMT. Se pueden verificar las terminales existentes desde el menú Administración/Negocio/Terminales de Bridge Manager Tienda (columna “código”).
  • Tipo de Punto de Venta: dispone de las siguientes opciones:
    
    
    
    • Tienda: modalidad estándar de Bridge POS.
    • Otros tipos de punto de venta disponibles: 
    • Self Order, Supermercado, Playa, Verificador de Precios, Self Scan, Self CheckOut (para referencias consultar: MANUAL DE USUARIO - Bridge POS v7.0)
  • ¿Desea operar en forma offline?: permite realizar operaciones sin tener conexión a Bridge Manager Tienda. Se recomienda seleccionar "Sí", para poder operar offline.
  • Configuración avanzada: habilita opciones detallados en un paso siguiente (si se requiere configurar Director, Fiscal Flow y/o EMVKit)
  • Ubicación archivo clientPOS.zip (esto se incluye en la versión 7.1: Este archivo contiene imágenes y recursos para un cliente en particular. Si no existe el archivo se instalarán las imágenes y recursos predeterminados debe tener la siguiente estructura:
    
    
    • El nombre del archivo debe ser: clientPOS.zip (es importante que el archivo se comprima directamente en formato zip, no basta con cambiar la extensión de un .rar)
    • Dentro del archivo debe informarse la ruta exacta del archivo a Modificar/Agregar: Ej: "\bridge\app\config\vouchers\templates\sales"
    • Para este ejemplo se crea la siguiente estructura de carpetas
      
      
    • Una vez creada las carpetas se debe guardar el archivo o los archivos como muestra la siguiente imagen:
      
      
    
    
    
    • Una vez que se encuentran los archivos a modificar se debe guardar en formato .zip
    • Al avanzar con la instalación, se debe colocar la ubicación del archivo .zip para que el instalador lo tome y reemplace luego los archivos en las carpetas de instalación.
    • Para modificar archivos de imágenes del POS: El archivo "clientPOS.zip" debe contener en su interior la siguiente estructura: "bridge\app\config\views\themes\synthesis" + "\archivo a modificar"
    • Se puede modificar o agregar cualquier archivo, para eso se debe especificar la ruta correspondiente y el nombre del archivo.
    
    Nota: Se pueden cargar múltiples archivos en diferentes rutas, lo único que hay que respetar es la misma estructura de datos que contiene el POS.
    
    

Una vez configurado, presionar botón "Siguiente" para continuar

(3) Paso: Modo offline

En caso de haber seleccionado en el paso anterior ¿Desea operar en forma offline? = Si, se solicita la siguiente información:

• • Url de Bridge API: Bridge API es un componente de la solución que se instala junto a Bridge Manager en el mismo servidor. El puerto que utiliza comienza con los mismos 3 dígitos que la consola y finaliza en 1. Por ejemplo, si para acceder a la consola de BMT utilizamos el puerto 8180, el puerto de API será 8181
  • Puerto donde se va a instalar el BridgaApi terminal: por defecto será el puerto 10000
    
    
    NOTA: para la instalación es requerido tener conexión con BRIDGE API de la tienda debido a que es quien replica la información necesaria de la base de datos de la tienda a la base de datos local del POS offline.

Una vez configurado, presionar botón "Verificar" o el botón "Siguiente" para continuar

(4) Paso: Opciones avanzadas

Este paso sólo se muestra si se selecciona en el paso previo Opciones avanzadas = Sí.

Completar:

• • Instalar EMVKit: indicador si se instala o no la librería de VTOL con EMV.
  • Instalar Fiscal Flow: indicador si se instala con conexión al servidor de factura electrónica Fiscal Flow
  • ¿Desea instalar los agentes de Director?: indicador si se trabajará con Director (actualizador de versiones)
  • ¿Desea ejecutar el punto de venta a pantalla completa?: se debe indicar si el POS se inicia como pantalla completa o en modo ventana.

NOTA: de requerir configurar al POS para resolución cuadrada y no wide, se podrá configurar posteriormente a la instalación desde el archivo run.bat o deberá personalizarlo el proyecto para que se incluya esta configuración por defecto al instalar (ver punto BPOS - Configuraciones)

Una vez configurado, presionar botón "Verificar" o el botón "Siguiente" para continuar

(5) Paso: Configuración de la base de datos offline

• • Offline SI = Información que se utiliza para crear una base de datos NUEVA en el servidor del POS.

Si la opción seleccionada fue de Offline SI el título de la pantalla es "Offline Database configuration"

• • • Host de la base de datos: identificación del servidor de instalación del POS (localhost).
    • Puerto de la base de datos: por defecto es el puerto 27017.
    • Nombre de la Base de datos: identificador de la base de datos. Se utiliza para crear una base nueva al realizar la instalación. NOTA: No debe existir una base previa con este nombre.
    • Usuario de la base de datos: se utiliza para dar de alta un usuario de la base de datos.
    • Contraseña de la base de datos: clave del usuario de la base de datos a ser creada.

VERIFICAR CONEXION CON LA BASE DE DATOS

La opción "Verificar conexión con la base de datos" realizará distintas validaciones

(5. Sin offline) Paso: Configuración de la base de datos de Bridge Manager

La información a proporcionar en esta sección dependerá de si quiere poder funcionar offline (seleccionado en el paso anterior o no):

Offline NO = Información de la base de datos de la tienda a la que se conectará el POS.

• • Host de la base de datos: 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 de la base de datos: por defecto es el puerto 27017.
  • Nombre de la Base de datos: correspondiente a la base de datos detallada en la instalación de BMT.
  • Usuario de la base de datos: nombre del usuario detallado al realizar la instalación de BMT.
  • Contraseña de la base de datos: clave del usuario detallado al realizar la instalación de BMT.

  • Mecanisco de autentificación: usuario contraseña*
    * NOTA: se podrá modificar el mecanismo de autentificación a LDAP, siendo este mecanismo un proceso que valida la combinación de usuario y contraseña contra un servidor de directorio como MS Active Directory, OpenLDAP o OpenDJ.

    

VERIFICAR CONEXIÓN CON LA BASE DE DATOS

La opción "Verificar conexión con la base de datos" realizará distintas validaciones

(6) Paso: Install Director

• • Si fue configurado en "Opciones avanzadas"
    • 
  • Se solicitará la configuración de la URL donde se encuentra instalado Director

(7) Paso: ¿Desea configurar algún dispositivo JPOS / Fiscal?

• • Si fue configurado en "Opciones avanzadas"
  • Se podrán configurar dispositivos del POS
    

Completar:

• • ¿Desea configurar los dispositivos?: Si se selecciona "Si" se habilita un paso adicional a continuación, para completar la información de los dispositivos.
  • 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". Ver configuración adicional en sección Configuración del presente manual.

1. 1. 1. Epson TM-U220AF Hera
      2. Epson TM-U220AF Demeter
      3. Epson TM-T900AF: nueva generación.
      4. Hasar 330
      5. Hasar 435
      6. Hasar 441
      7. Hasar 250: nueva generación, solicitará datos adicionales en el paso siguiente.

• • 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?: En el caso de no disponer de dispositivos físicos conectados a la terminal, se podrá utilizar el emulador de los dispositivos para poder operar en el POS simulando su operación. Estos emuladores son iniciados al momento de iniciar la aplicación POS. Su finalidad es simulación de dispositivos en laboratorio.

Pasos siguientes si configura dispositivos

(8) Paso: Opciones de instalación obligatorias - Instalación EMVKit

Este paso sólo se muestra si se selecciona en el paso previo Instalar EMVKit = Sí.

Permite la configuración de la librería EVM para Argentina. De no ser utilizada no es requerida su configuración.

Completar:

• • 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
  • Configuración si se activa SSL

(8.a) Paso: Configuración del driver del Pinpad

Este paso sólo se muestra si se selecciona en el paso previo Instalar EMVKit = Sí.

De no ser utilizado no es requerida su configuración.

Completar:

• • Puerto del pinpad
  • Driver del pinpad: opciones disponibles:
    
    • POSNET A0600
    • POSNET A0700 3DES
    • POSNET A0803
    • POSNET A0809
    • VISA 306B06

(9) Paso: Configuración Fiscal Flow

Este paso sólo se muestra si se selecciona en pasos previos Instalar Fiscal Flow = Sí 

Completar:

• • Ingrese la URL del Servidor Fiscal Flow
  • Ingrese el puerto del Agente de Fiscal Flow
  • Ingrese la URL del Servidor FTP Fiscal Flow (utilizado para el envío de archivos fiscales de las impresoras 2G)

Fiscal Flow DEMO:

Para la opción Napse DEMO, el sistema precargará la siguiente información:

(10) Paso: Progreso de la instalación

Una vez completada toda la información de los pasos anteriores se accede a esta pantalla final.

También se acceda a esta pantalla en caso de NO haber tildado la opción de aceptación de términos y condiciones.

Seleccionar "Instalar" para iniciar la instalación.

Durante la instalación informa el progreso de la siguiente manera:

Durante y post instalación, al presionar "Enseñar det..." permite ver el log de la instalación y el detalle de los errores.

Al finalizar la instalación exitosamente informa:

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

(1) Paso: Napse Demo

• • Tildar la opción DEMO

(2) Paso: Bienvenido al instalador de BRIDGE POS

Definir:

• • Directorio de instalación: indicar el directorio en que se desee ubicar los archivos de la instalación. Puede ser un directorio nuevo o uno existente.
  • Directorio Java: se debe configurar con el directorio en el cual se encuentra instalada la máquina virtual de Java (INCLUYENDO el directorio bin dentro del directorio a configurar). Por ejemplo: c:\JDK\bin

  • Código de la tienda: (ver Napse Demo Cloud - Instalación y accesos)

  • Código de terminal: gestionado previamente desde BMT DEMO. Se pueden verificar las terminales existentes desde el menú Administración/Negocio/Terminales de Bridge Manager Tienda (columna “código”).
  • Tipo de Punto de Venta: Tienda:
  • ¿Desea operar en forma offline?: SI
  • Configuración avanzada: NO
  • Ubicación archivo clintPOS.zip: Este archivo contiene imágenes y recursos para un cliente en particular. Si no existe el archivo se instalarán las imágenes y recursos predeterminados debe tener la siguiente estructura:

• • • El nombre del archivo debe ser: clientPOS.zip (es importante que el archivo se comprima directamente en formato zip, no basta con cambiar la extensión de un .rar)
    • Dentro del archivo debe informarse la ruta exacta del archivo a Modificar/Agregar: Ej: "\bridge\app\config\vouchers\templates\sales"
    • Para este ejemplo se crea la siguiente estructura de carpetas
      
      
    • Una vez creada las carpetas se debe guardar el archivo o los archivos como muestra la siguiente imagen:
      
      

• • • Una vez que se encuentran los archivos a modificar se debe guardar en formato .zip
    • Al avanzar con la instalación, se debe colocar la ubicación del archivo .zip para que el instalador lo tome y reemplace luego los archivos en las carpetas de instalación.
    • Para modificar archivos de imágenes del POS: El archivo "clientPOS.zip" debe contener en su interior la siguiente estructura: "bridge\app\config\views\themes\synthesis" + "\archivo a modificar"
    • Se puede modificar o agregar cualquier archivo, para eso se debe especificar la ruta correspondiente y el nombre del archivo.

Nota: Se pueden cargar multiples archivos en diferentes rutas, lo unico que hay que respetar es la misma estructura de datos que contiene el POS.

Una vez configurado, presionar botón "Siguiente" para continuar

(3) Paso: Modo offline

• • • • Al haber seleccionado en el paso anterior ¿Desea operar en forma offline? = Si, se informará la URL DE BRIDGE API (entorno DEMO)

• • • • Presionar el botón "Siguiente" para continuar

• • • • Una vez configurado correctamente, presionar botón "Verificar" y el botón "Siguiente" para continuar
      • Se verificará que haya conexión con la tienda DEMO para la copia de la BD offline de la terminal, informando con un mensaje de confirmación.

NOTA: para la instalación es requerido tener conexión con BRIDGE API de la tienda debido a que es quien replica la información necesaria de la base de datos de la tienda a la base de datos local del POS offline.

(4) Paso: Configuración de la base de datos offline

En la pantalla "Offline Database configuration" se requiere el ingreso de los datos de la base de datos local

• • • • • Host de la base de datos: localhost
        • Puerto de la base de datos: 27017
        • Nombre de la base de datos: bridgeOffline
        • Usuario de la base de datos: bridge
        • Contraseña de la base de datos: nosotros
        • Mecanismo de autentificación: USUARIO CONTRASEÑA *
          
          

* NOTA: se podrá modificar el mecanismo de autentificación a LDAP, siendo este mecanismo un proceso que valida la combinación de usuario y contraseña contra un servidor de directorio como MS Active Directory, OpenLDAP o OpenDJ.

• • • • Presionar el botón "Siguiente". Se verificará que haya conexión con la base de datos informando mediante mensaje:

(5) Paso: Progreso de la instalación

Una vez completada toda la información de los pasos anteriores se accede a esta pantalla final. Presionar el botón "Instalar" para iniciar la instalación.

Durante la instalación informa el progreso de la siguiente manera:

Durante y post instalación, al presionar "Enseñar det..." permite ver el log de la instalación y el detalle de los errores.

Al finalizar la instalación exitosamente informa:

Servicios

Terminado el proceso de instalación podrá chequearse en los servicios del sistema la existencia de nuevos servicios que ya estarán ejecutandose de manera automática, lo cual permite indicar la correcta instalación y puesta en funcionamiento:

Servicios Bridge

1. 1. 1. 1. Napse Bridge Api (napse-bridge-api)
         2. NapseBridgeApi_XXX

Servicios Fiscal Flow

1. 1. 1. 1. Napse Fiscal Flow (napse-fiscal-flow-agent)

Servicios VTOL

1. 1. 1. 1. EmvKitAr (EmvKitAr)

Servicios Director

1. 1. 1. 1. Napse Bridge Pos Director (BridgePosDirector)
         2. BridgeManagerDirector
         3. EmvKitArDirectorService (EmvKitArDirectorService)

Estructura de directorios

Luego de haber completado el proceso 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).

• • • • 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 sub carpeta \themes* se encuentran las carpetas utilizadas para otros formatos de pantalla y resolución de imágenes.
        • En la sub carpeta \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.
        • vouchers: contiene los archivos de configuración de los templates de los comprobantes a imprimir en Bridge POS.
        • lib: contiene las librerías utilizadas por Bridge POS (.jar)
        • 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.

• • • • bridge
        • app
        • audit
        • electronicJournal: se guardan los archivos que permiten generar luego los reportes de auditoría desde el Bridge Manager.
      • director: archivos y librerías requeridas para el agente de Director (actualizador de versiones).

Ejemplo de estructura de una instalación en Windows:

Iniciar la aplicación

Para iniciar la aplicación se debe ejecutar el archivo pos.bat que se encuentra en el directorio raíz de la instalación.

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.

Detalle de los pasos a realizar para desinstalar la aplicación.

Paso: Dar de baja los servicios

Para iniciar la desinstalación, abrir la ventana de línea de comando en modo administrador:

Navegar hasta el directorio en donde se haya realizado la instalación, directorio /cmds

Ejecutar el desinstalador indicando: removeServices.bat

De esta forma, se irán dando de baja los servicios que se encuentran ejecutándose.

Ejemplo:

Si el BPOS esta instalado en la siguiente carpeta

C:\Users\carla.escalera\AMBIENTES\PLAYA7154_OFF1448TIENDA1

Con el CMD se deberá ir a la ruta C:\Users\carla.escalera\AMBIENTES\PLAYA7154_OFF1448TIENDA1\bridgeapi y ahi ejecutar el removeServices.bat

Paso: Base de datos

Se requiere remover manualmente las bases de datos creadas en la instalación.

En el caso de no utilizar el motor de base de datos para otros fines, se sugiere desinstalarla:

2) Desinstalar MongoDB (desde la opción del sistema operativo para quitar aplicaciones).

3) Borrar la carpeta donde se encuentra instalado MongoDB, dado que mantiene configuraciones previas y no se elimina automáticamente al desinstalar.

Paso: Eliminar archivos

Eliminar manualmente los archivos que se generaron en el directorio de instalación.

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 o ajustar algún parámetro por default del sistema.

Para esto se requiere primero detener la aplicación, realizar los cambios requeridos y luego volver a iniciarla.

Configuraciones de inicio

En el archivo que se utiliza para iniciar la aplicación se encuentran la mayoría de los parámetros configurados durante la instalación.

Modificando los valores del archivo, puede modificarse la configuración.

El archivo en cuestión es el siguiente, que se encuentra en el directorio de instalación:

\bridge\app\run.bat

A continuación se detalla cada parámetro configurable:

Base de datos

Deberá editarse el siguiente archivo que se encuentra la siguiente ruta, a partir del directorio de instalación:

\bridge\app\config\hibernate.cfg.xml

Los parámetros que pueden editarse son:

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. 1. 1. 1. –DfiscalMode=true (de no especificarse o configurarse con un valor distinto a "true" no se iniciará la impresora fiscal)
         2. –DfiscalDriver=epson (los parámetros permitidos son Epson o Hasar)

Copiar el archivo dll en la ruta "...\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
      • 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:

• • • •  Puerto que le asigne la PC para la conexión de la printer fiscal:

<param name="port" value="COM4"/>

• • • • 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" />

• • • • 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" />

• • • • Micro código de la printer fiscal. En el caso de la Epson puede ser "Demeter" o "Hera":

<param name="printerFirmwareName" value="Hera" />

• • • • Ajustar 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 contenido para período de inactividad

Pasado el tiempo configurado en el parámetro IDLE_TIME_LIMINT del archivo run.bat el POS pasa a mostrar imágenes y videos que deben ser colocadas en:

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 log

El archivo log4j.xml es el archivo que contiene la configuración de los archivos log del POS ubicado en el directorio \bridge\app\config.

En este archivo se puede modificar la configuración de:

• • • • Directorio de logs: en el parámetro File se podrá configurar/modificar el directorio donde se grabarán los archivos logs.
      • Nombre del archivo de log:
        
        • Por defecto está definido como: log.YYYY-MM-DD
        • Se define en el parámetro File
      • Nivel de log: 
        • Se puede configurar/modificar con qué nivel de detalle se registrarán las excepciones en el archivo de log.
        • Los niveles de log soportados son, en orden descendente:

1. 1. 1. 1. 1. 1. ALL
               2. DEBUG
               3. INFO
               4. WARN
               5. ERROR
               6. FATAL
               7. OFF
               8. TRACE

Para mayor detalle de cada uno de los niveles, referenciar el siguiente link: https://www.tutorialspoint.com/log4j/log4j_logging_levels.htm

Configuración modalidad SefOrder

Para la definición de la pantalla a utilizar en el SelfOrder, se deberá configurar desde BMC la plantilla de ventas con las categorías (botones) y artículos a vender por categoría, 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.

En caso de que se haya instalado la modalidad de punto de venta "SelfOrder", se puede observar en run.bat el parámetro: com.synthesis.bridge.selforder.XBridgeSelfOrderApplication

A diferencia de la utilizada para instalación standard de "tienda": com.synthesis.bridge.pos.XBridgePosApplication

Configuración modalidad Supermercado

Requiere configurar 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.

En caso de que se haya instalado la modalidad de punto de venta "Supermercado", se puede observar en run.bat el parámetro: com.synthesis.bridge.supermarket.XBridgeSupermarketApplication

A diferencia de la utilizada para instalación standard de "tienda": com.synthesis.bridge.pos.XBridgePosApplication

Configuración modalidad Playa

Requiere configurar 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.

En caso de que se haya instalado la modalidad de punto de venta "Playa", se puede observar en run.bat el parámetro: com.synthesis.bridge.forecourt.XBridgeForecourtApplication

A diferencia de la utilizada para instalación standard de "tienda": com.synthesis.bridge.pos.XBridgePosApplication

Para que se visualicen los botones se tiene que agregar el valor "-Dtheme=synthesis-square" antes de com.synthesis.bridge.forecourt.XBridgeForecourtApplication

Configuración Fiscal Flow

Cada instalador de producto tiene configurado por default el puerto de Fiscal Flow.

En caso de requerir realizar una modificación consultar: Fiscal Flow - Cambiar la configuración del agente sin reinstalar

Las configuraciones de Fiscal Flow ingresadas durante la instalación de Bridge POS también podrán modificarse desde el directorio instalación BridgePOS: 

• • • • Ejemplo: C:\synthesis\pos_\fiscalflow\config\default.json
        
        

{
"app": {
"credentials": {
"companyCode": "mirgor",
"storeCode": "7390",
"terminalCode": "25"
},
"server": {
"endPoint": "http://23.96.32.127:80",
"port": "9999",
"useProxy": false,
"proxyHost": "10.1.33.110",
"proxyPort": "80"
},
"serverFtp": {
"endPointIP": "http://23.96.32.127:80",
"endPointPort": "22"
}

}
}

Configuración para quitar algún botón del menú de operaciones

• • • • Se detalla como ajustar el archivo de configuración que se puede editar para que quede oculto un botón.
        • Ejemplo: “Informe caja” (del menú NO VENTA) en los POS físicos (por favor, probarlo previamente en un POS de Lab) Toma el cambio de configuración luego de reiniciado el POS. Esto quita de la pantalla el botón pero no reacomoda el resto
        • En el archivo selection.fxml, en la carpeta directorio de instalación\bridge\app\config\views\themes\synthesis\selection,
        • En la siguiente línea agregar los parámetros visible = false y managed = true
        • <Button fx:id="boxReportButton" managed="true" maxHeight="1.7976931348623157E308" maxWidth="1.7976931348623157E308" mnemonicParsing="false" onAction="#onReceivedPaymentsReport" prefHeight="120.0" prefWidth="258.0" text="INFORME CAJA" textAlignment="CENTER" visible="true" />

Depuración de archivos de log

La aplicación registra diversos eventos dentro del archivo de log, los cuales, 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.

Los mismos se encuentran en la siguiente ruta, a partir del directorio de instalación:

\bridge\app\log

Asignación de memoria

Al operar el POS se puede detectar que es requerido asignarle más memoria.

Deberá editarse el siguiente archivo que se encuentra en la siguiente ruta, a partir del directorio de instalación:

\bridge\app\run.bat

Agregando el parámetro -Xmx512m en la última línea ejecutable, quedando de la siguiente manera:

"C:/Program Files/Java/jre1.8.0_25/bin/java" %DEBUG_OPTIONS% -Xmx512m -cp %CLASSPATH%...

Aplicación no envía transacciones al servidor o no se conecta a la base de datos de tienda

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. 1. 1. 1. Obtener nombre de dominio e IP del servidor.
         2. Editar el fichero "C:\Windows\System32\drivers\etc\host" (con permiso de administrador) 
         3. Agregar la línea " IPServidorNombreServidor"
         4. Guardar fichero.

Ejemplo:

C:\Windows\System32\drivers\etc

Se debe abrir el archivo en Modo administrador y editarlo. Agregar la línea 13.90.230.178 LNXPROMOCON02 y guardar el archivo.