El presente manual tiene por finalidad la capacitación de los usuarios que deseen utilizar la consola de administración del producto Director. Brinda la información necesaria, con el nivel suficiente de detalle para que el usuario pueda monitorear el estado del sistema, así como también obtener información sobre el procesamiento de operaciones y realizar las tareas de administración correspondientes.
1.2 Referencias tipográficas
En este manual se utilizarán las siguientes convenciones:
Numeración (1., 2., 3...)
Indica la secuencia de pasos a seguir dentro de un procedimiento
Viñetas (•)
Indican opciones y características
Signo mayor (>)
Se utiliza para especificar los niveles de menú (Ej.: Archivo>Abrir)
Estilo de fuente "negrita"
Indica los nombres de elementos interface (Ej.: botónAceptar) y de cualquier otro ítem que requiera énfasis
Estilo de fuente"cursiva"
Se utilizará para mencionar a los ejemplos
Recuadro "Consejo práctico:"
Se utilizará para resaltar tips o accesos rápidos para la operatoria o procedimiento que se encuentre realizando
Recuadro "Nota:"
Se utilizará para resaltar aclaraciones sobre el tema en curso
Recuadro"Importante:"
Se utilizará para indicar al usuario sobre precauciones / cuestiones relevantes que deberá tener en cuenta el usuario
2. Introducción
2.1 ¿Qué es Director?
Director es una solución de Napse que permite gestionar, administrar, distribuir y monitorear de manera centralizada y eficiente nuevas versiones de productos Napse en la red de tiendas de un retailer. Además, posee la funcionalidad de monitorear en forma remota las terminales publicando múltiple información de las mismas.
2.2 Componentes
Director se encuentra constituido por los siguientes componentes:
Director Server Ubicado de forma centralizada en un servidor, permite y efectúa la gestión, administración, coordinación e integración del sistema. Le ofrece al usuario una consola web de operación.
Consola de administración Por medio de la interfaz gráfica web, el usuario puede acceder a la solución para administrar los productos Napse y sus versiones y monitorear las terminales de los locales.
GIT Se encarga de llevar a cabo el control y la gestión de versiones de los productos definidos en el sistema.
Agente Se encuentra integrado en cada producto de una terminal, Entre sus principales funciones se encuentran: informar periódicamente el estado del producto, actualizar el producto a nuevas versiones vigentes e informar datos de una terminal.
3. Consola de Administración
3.1 Acceso
Por medio de la interfaz gráfica web, el usuario puede acceder a la solución para dar de alta compañías, administrar los productos Napse y sus versiones y monitorear las terminales de los locales.
La consola de administración es una herramienta Web, accesible a través del uso de un browser como Internet Explorer, Mozilla Firefox o Chrome.
Para conectarse a la consola es necesario utilizar el siguiente enlace:
https://IP-SERVER:PORT/director
Donde:
IP-SERVER: corresponde a la dirección IP o nombre del server donde se está ejecutando el servidor Director (ejemplo: 10.4.203.58)
PORT: corresponde al puerto del servidor web utilizado por Director (ejemplo: 8080)
Finalizada la inicialización del sistema, en la parte superior derecha de la pantalla, el sistema muestra las opciones disponibles:
Iniciar sesión: acceso a la consola de administración.
Integración: acceso a los manuales de integración.
3.2 Login
Al iniciar sesión, se solicitarán las credenciales de acceso, con lo cual se deberá ingresar el usuario y clave en los campos habilitados.
Director concede por defecto una cuenta de acceso a la consola de administración para la compañía napse, (soporte), y para la compañía del retail deberá ingresarse con el usuario indicado en el proceso de alta de Compañía. Este usuario tendrá los permisos necesarios para poder gestionar los usuarios del sistema.
3.3 Flujo Operativo
En este apartado se explicará el flujo o secuencia normal de configuración y operatoria en la consola de Director:
Creación de la compañía (apartado 4.1 Compañías) Se debe crear la entidad con mayor jerarquía en la red del negocio del retailer. La compañía contendrá un conjunto de tiendas.
Creación del Tienda (apartado 4.3 Tiendas) Una tienda pertenece a una compañía y posee un conjunto de terminales.
Creación de las terminales (apartado 4.5 Terminales) Las terminales son las unidades lógicas que representan una caja. En las mismas se ejecutan los productos que se actualizarán mediante Director.
Creación del producto (apartado 5.1 Administración de Productos) Es preciso definir en el sistema el producto de software que se utiliza en las terminales y la ruta en GIT en donde se almacenarán las versiones. Un producto poseerá varias versiones.
Alta de versión para el producto creado previamente (apartado 5.2 Administración de Versiones) Se define en el sistema la versión vigente del producto creado previamente.
Monitoreo y gestión de versiones por producto y por terminales (apartado6.1 Monitoreo de Versiones). En estas pantallas, se gestionan las versiones de los productos por terminales y se monitorean las características que poseen cada una de las terminales.
4. Negocio
4.1 Compañías
Una compañía o empresa es una asociación que posee una o varias tiendas.
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Compañías" dentro de "Negocio" (Negocio > Compañías).
Descripción de la página:
Logueandose con el usuario administrador asignado a Napse, a través de esta página será posible efectuar el alta, consulta edición y desactivación de las compañías que se manejarán en el sistema, como así también la visualización de las tiendas que se encuentran asociadas a las mismas.
Para el caso del perfil de cliente administrador de una compañía, a través de esta pagina sera posible visualizar los detalles de la compañía del retail,
La información de esta sección será utilizada para la ejecución de los servicios de alta de compañías en Promo, Vtol, Fiscal Flow y Director, como así también para la obtención de el archivo .properties que será utilizado para la instalación de Bridge Manager Central.
BMC y Director
Al momento de ejecutar la instalacion del BMC no se realizara la instalacion ni configuración del agente de Director. Las actualizaciones del BMC son llevadas a cabo por el equipo de Soporte de Napse.
4.1.1 Alta de compañías
Las compañías en Director pueden ser creadas únicamente por los usuarios de la empresa napse.
Para crear una compañía se deberá presionar en "Nuevo" ante lo cual se presentará un formulario de alta dividido en diferentes solapas.
Información general:
Esta información es utilizada para la confección de los servicios de alta de compañías de Promo, Vtol y Fiscal Flow, como así también información común entre los productos como ser el código, nombre, usuario y contraseña.
¿Modo testing?IMPORTANTE: Permite tíldar la opción en caso de encontrarse configurando una nueva compañía para el entorno de testing exclusivamente. Este campo aplicara, en caso de integracion con Fiscal Flow al tildarse para la creación de una compañía de test, la cual operara con certificados sus certificados de Homologación correspondientes.
País (dato requerido): selección del país en donde se instalarán los productos Napse, pudiendo elegir entre Argentina, Chile, Colombia y México. En base al país aquí seleccionado se habilitaran los campos de entornos que estén habilitados para ese país, permitiendo seleccionar solo los entornos definidos para el pais seleccionado
Entorno Promo: permite seleccionar la url del servidor de Promo.
Entorno Vtol: permite seleccionar la url del servidor de Vtol.
Entorno Fiscal Flow: permite seleccionar la url del servidor de Fiscal Flow.
Código de Compañía (dato requerido): Código de la compañía a generar en todos los productos de la Suite Napse (Director, Promo, Vtol, Fiscal Flow). Campo alfanumérico.
Nombre de Compañía (dato requerido): Nombre de la compañía a generar en Director y en los productos de la Suite Napse por servicio. Campo alfanumérico.
Usuario Administrador (dato requerido): Usuario administrador de Productos Napse. El campo se autocompletará a modo de ayuda (cuando se defina el campo "Código de compañía") con el código de compañía seguido de Admin (<companyCode>_Admin). El usuario podrá editarlo en caso de querer definir otro usuario administrador. Este usuario administrador sera el utilizado por el retailer para loguearse en BMC, BMT, así como también en la consola de Promo, Vtol, Fiscal Flow y Director de su compañía.
Contraseña (dato requerido): Contraseña del administrador de Productos Napse. El campo se autocompletara a modo de ayuda con la contraseña "Napse1234", pudiendo el usuario cambiarla. Esta contraseña de administrador sera el utilizado por el retailer para loguearse en BMC, BMT, así como también en la consola de Promo, Vtol, Fiscal Flow y Director de su compañía.
Provincia (dato requerido): Provincia de la compañía. El campo mostrara el catalogo de provincias en base al país seleccionado.
Ciudad (dato requerido) Ciudad de la compañía. El campo mostrara el catalogo de ciudades en base a la provincia seleccionada.
Comuna: en caso de aplicar, en base al país, provincia y ciudad seleccionados se listarán las comunas.
Dirección (dato requerido): dirección legal de la compañía.
Teléfono (dato requerido): Número. de teléfono de la compañía
Email de la compañía. Campo de texto. Aquí se validara que los datos ingresados tengan formato de email. (***@***.com)
Categoría impositiva (dato requerido): selección de la condición impositiva frente al IVA de la compañía en base al pais donde se este dando de alta la compañía.
Rubro (dato requerido); Rubro de la compañía.
Descripción: Descripción o datos adicionales de la compañía.
¿Activo?: Informa el estado de la compañía. Por defecto el check estará tildado.
Regionalización
En base al país donde se este definiendo la compañía, se podrán presentar mas o menos campos, en base a los datos requeridos por los productos de la suite Napse requeridos para el alta de la compañía en ese país.
Opciones de instalación:
Host/IP (dato requerido): Host/Ip de la maquina donde se va a instalar Bridge Manager Central. Aquí deberá definirse la IP o HOST del entorno donde estará alojado el BMC, a fin de que las configuraciones post instalacion queden correctamente definidas al momento de que una tienda se instale y conecte al BMC.
Directorio de instalación(dato requerido): Directorio donde se instalará Bridge Manager Central.
Ubicación de la JVM (dato requerido) Directorio donde se encuentra instalado Java (se deberá incluir el directorio bin).
Puerto sobre el cual se va a instalar el BMC (dato requerido): puerto donde se Instalará Bridge Manager Central. Combo desplegable con las opciones de puerto disponibles.
Importante
el puerto por defecto es el 8080, pero también se podrán optar por otros dentro de la lista de selección desplegable. Otras aplicaciones que se encuentren en el mismo servidor, no deben utilizar el mismo puerto que se desea configurar (por ejemplo si el Bridge Manager Central se encuentra instalado en el mismo servidor que Bridge Manager Tienda, ambos deberán instalarse en puertos diferentes) Se validará que no se encuentre en uso al momento de la instalación. las opciones que se desplegaran son:
8080
8180
8280
8380
scripts.zip:Directorio donde se encuentra el archivo scripts.zip propios del proyecto.
Configuración de la base de datos:
Host/IP (dato requerido): Host/Ip del servidor de MongoDB.
Puerto (dato requerido): Puerto de la base de datos.
Nombre (dato requerido): Nombre de la base de datos a generar durante la instalación del BMC.
Usuario (dato requerido): Usuario de la base de datos con permisos para crear la base de datos.
Contraseña (requerido): Contraseña del usuario de base de datos.
Método de autenticación (dato requerido): selección del tipo de autenticación contra la base de datos, pudiendo elegir entre USER_PASSWORD y LDAP.
Importante
Al momento de pulsar el botón "Guardar", Director validara que todos los campos requeridos del formulario estén completo.
Al presionar el botón "Guardar", Director ejecutara los servicios de creación de compañía en Promo Vtol y Fiscal Flow (en base a los productos que se hayan seleccionado para integración), tomando la configuración de los entornos definidos en la sección Configuración > "Productos" y en base a la información ingresada en la solapa de Información General.
Al guardar, se solicitara una confirmación de inicio del proceso con el siguiente mensaje: “¿Desea continuar con la creación de Compañías? Esta acción creara una compañía en PROMO, FISCAL FLOW, VTOL y DIRECTOR con los datos aquí declarados.” Al presionar en OK, se continuara con el proceso de creación de compañías, caso contrario, de presionarse "Cancelar", se volverá a la pantalla de crear compañía sin guardar ningún cambio.
4.1.2 Edición de compañías
Para modificar una compañía en particular previamente cargada, se debe presionar el botón "Opciones>Editar". En el formulario de edición, se mostrarán los datos cargados y se podrán modificar sus propiedades. Sin embargo, los siguientes valores no podrán ser editados:
Información general:
País
Entornos de prueba
Código de compañía
Usuario administrador
Contraseña
Opciones de instalación
Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalacion del BMC.
Configuración de base de datos
Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalacion del BMC.
4.1.3 Detalle de compañías
Para visualizar el detalle y estado de las compañías dadas de alta en los diferentes productos de la Suite Napse se debe presionar el botón "Opciones> Detalle".
Se podrá visualizar
El listado de productos Napse.
El log en caso de ocurrir un error durante la creación de la compañía en alguno de los productos Napse.
El estado de creación. En caso de que el alta de la compañía haya sido exitosa se mostrará un icono verde , en caso de error en la ejecución de los servicios en todos los productos, se mostrará un icono rojo y en caso de que el error se haya presentado solo en alguno de ellos se mostrara en naranja.
En caso de ocurrir algún error, el la columna de Acciones se contará con el icono de reintento, el cual podrá volver a ejecutarse luego de corregido el error reportado.
4.1.4 Descargar .Properties de compañía
Para descargar el archivo .properties con los parámetros a definidos en el formulario de alta de compañías, se debe presionar el botón "Opciones> Descargar .Properties".
Este archivo deberá ser utilizado al momento de instalar Bridge Manager Central
.properties - BMC
El archivo .properties que se descargue desde director contendrá toda la información declarada y necesaria para la instalacion del Bridge Manager Central de la nueva compañía. Este archivo deberá ubicarse, al momento de la instalacion del BMC junto con los archivos .jar y .bat provistos por Napse a fin de ejecutar la instalacion simplificada del Bridge Manager Central.
Para acceder al listado del histórico de cambios de la compañía, se debe presionar el botón "Opciones > Auditoría".
Se visualizará la siguiente información:
Fecha
Usuario
Nivel
Acción
Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.
4.2 Divisiones Operativas
Una división operativa es una agrupación o una segmentación de tiendas.
La estructura de agrupación es abierta y determinable por el usuario: por región geográfica, por tipo de local, etc.
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Divisiones Operativas" dentro de "Negocio" (Negocio >Divisiones Operativas).
Descripción de la página:
A través de esta página, será posible efectuar el alta, consulta y edición de las divisiones operativas que se manejarán en el sistema, como así también la visualización de las tiendas que se encuentran asociadas a las mismas.
4.2.1 Alta de división operativa.
Para crear una nueva división operativa, desde la pantalla de Gestión de divisiones operativas, presionar en el botón "Nuevo".
Se informará el código de compañía en la cual se encuentra logueado el usuario, sin posibilidad de edición, y se deberán ingresar los siguientes campos:
Código: obligatorio y único
Nombre: obligatorio
Presionar el botón"Guardar"para finalizar la creación de la división operativa o"Volver"para regresar a la pantalla de gestión de divisiones operativas.
4.2.2 Modificación de divisiones operativas
Para modificar una división operativa se debe presionar el botón "Opciones>Editar"correspondiente a la división operativa en cuestión.
En el formulario de edición, se mostrarán los datos cargados y se podrá modificar únicamente el nombre de la división operativa.
4.2.3 Registros de auditoría de división operativa
Para acceder al listado del histórico de cambios de la división operativa, se debe presionar el botón "Opciones > Auditoría".
Se visualizará la siguiente información:
Fecha
Usuario
Nivel
Acción
Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.
4.3 Tiendas
Una tienda o un local es un establecimiento físico o virtual que posee terminales para poder efectuar transacciones.
Las Tiendas pueden pertenecer o no a una división operativa en particular, pero siempre pertenecerán a una compañía preexistente.
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Tiendas" dentro de "Negocio" (Negocio > Tiendas).
Descripción de la página:
A través de esta página es posible efectuar el alta, consulta, edición y eliminación de las Tiendas que se manejarán en el sistema.
Creacioin automatica de compañías
Cuando la instalacion del Bridge Manager Tienda se ejecute por medio del proceso de instalacion "Wizard" o "auto", y indique durante este proceso que la Tienda se actualizara vía Director, dicha tienda sera identificada en la grilla de tiendas con un icono azul en la columna de "Productos". En caso de editarse la Tienda desde Director, deberán de cargarse los datos requeridos en el formulario de Tienda para poder guardar los datos correctamente.
4.3.1 Alta de tienda
Una vez dada el alta la compañía en los diferentes productos de la Suite Napse, se deberá crear la/las tiendas asociadas a dicha compañía.
Para crear una tienda se deberá presionar en "Nuevo" ante lo cual se presentará un formulario de alta dividido en diferentes solapas.
Información general:
En esta sección se solicitaran los datos referentes al alta de Tienda en los productos de la suite Napse ( Promo, Vtol, Fiscal Flow), como así también información común entre los productos como ser el código y nombre.
Compañía: se mostrará precargado el código de compañía a la cual pertenecerá la Tienda a crear, sin posibilidad de edición.
Código (dato requerido): Código de la tienda a generar en todos los productos de la Suite Napse. El código es único, al guardar el formulario se validara que ya no haya creada otra tienda con el mismo código. En caso de que el código de la tienda se encuentre ya definido, se presentará el mensaje de que no se pudo crear la tienda por estar el código duplicado.
Nombre (dato requerido): Nombre de la tienda en Director y en los productos de la Suite Napse por servicio.
País: Se autocompletará con el país al que pertenece la compañía de la que dependerá la tienda. El campo no podrá modificarse.
Provincia (dato requerido): Provincia de la Tienda. El campo mostrara el catalogo de provincias en base al país seleccionado.
Ciudad (dato requerido) Ciudad de la Tienda. El campo mostrara el catalogo de ciudades en base a la provincia seleccionada.
Comuna: en caso de aplicar, en base al país, provincia y ciudad seleccionados se listarán las comunas.
Dirección (dato requerido): dirección legal de la Tienda.
Email (dato requerido): Email de la Tienda. Campo de texto. Aquí se validara que los datos ingresados tengan formato de email. (***@***.com)
División Operativa: Sección a la que pertenecerá la tienda a generar dentro de las categorizaciones de Director.
¿Activo?: Informa el estado de la Tienda. Por defecto el check estará tildado.
Opciones de instalación:
Host/IP (dato requerido): Host/Ip de la maquina donde se va a instalar Bridge Manager Tienda. Aquí deberá definirse la IP o HOST del entorno donde estará alojado el BMT, a fin de que, las configuraciones post instalacion, queden correctamente definidas al momento de que un punto de ventas se instale y conecte al BMT.
Directorio de instalación(dato requerido): directorio donde se instalará Bridge Manager Tienda.
Ubicación de la JVM (dato requerido): directorio donde se encuentra instalado Java (se deberá incluir el directorio bin).
Puerto sobre el cual se va a instalar el BMT (dato requerido): puerto donde se Instalará Bridge Manager Tienda. Combo desplegable con las opciones de puerto disponibles.
Importante
el puerto por defecto es el 8180, pero también se podrán optar por otros dentro de la lista de selección desplegable. Otras aplicaciones que se encuentren en el mismo servidor, no deben utilizar el mismo puerto que se desea configurar (por ejemplo si el Bridge Manager Central se encuentra instalado en el mismo servidor que Bridge Manager Tienda, ambos deberán instalarse en puertos diferentes) Se validará que no se encuentre en uso al momento de la instalación. Sera removido del combo el numero de puerto que se haya definido para el BMC.
Las opciones que se desplegaran son:
8180
8280
8380
8480
8580
scripts.zip: directorio donde se encuentra el archivo scripts.zip propios del proyecto.
Configuración de la base de datos:
Host de la base de datos: Identificación del servidor de instalación de la terminal. Campo texto, requerido. Valor por defecto: 127.0.0.1
Puerto de la base de datos: Puerto donde se encuentra la base de datos de la terminal. Campo texto, requerido. Por defecto es el puerto 27017.
Nombre de la base de datos: Identificador de la base de datos de la terminal. Se utiliza para crear una base nueva al realizar la instalación. No debe existir una base previa con este nombre. Campo texto, requerido. Valor por defecto: bridgeOffline
Usuario de la base de datos: Usuario con que se conectara a la base de datos. Campo texto, requerido. valor por defecto admin.
Contraseña de la base de datos: Contraseña de acceso a la base de datos. Campo texto, requerido. El campo estará vacío por default.
Mecanismo de autenticación: Forma de autenticación del usuario en la base de datos. Campo combo. Requerido. Valores a mostrar: "Usuario y Contraseña" y "LDAP".
Importante
Al momento de pulsar el botón "Guardar", Director validara que todos los campos requeridos del formulario estén completo.
Al presionar el botón "Guardar", Director ejecutara los servicios de creación de la Tienda en Promo Vtol y Fiscal Flow (en base a los productos que asociados la compañía a la que pertenecerá la tienda a generar)
Al guardar, se solicitara una confirmación de inicio del proceso con el siguiente mensaje: “¿Desea continuar con la creación de la Tienda? Esta acción creara una Tienda en PROMO, FISCAL FLOW, VTOL y DIRECTOR con los datos aquí declarados.” Al presionar en OK, se continuara con el proceso de creación de Tiendas, caso contrario, de presionarse "Cancelar", se volverá a la pantalla de crear tienda sin guardar ningún cambio.
4.3.2 Edición de Tienda
Para modificar una Tienda en particular previamente cargada, se debe presionar el botón "Opciones>Editar". En el formulario de edición, se mostrarán los datos cargados y se podrán modificar sus propiedades. Sin embargo, los siguientes valores no podrán ser editados:
Información general
Compañía
Código
País
Opciones de instalación
Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalacion del BMT.
Configuración de la base de datos
Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalacion del BMT.
4.3.3 Detalle de tienda
Para visualizar el detalle y estado de las Tiendas dadas de alta en los diferentes productos Napse, se debe presionar el botón "Opciones>Editar"correspondiente a la tienda en cuestión.
Se podrá visualizar
El listado de productos Napse.
El log en caso de ocurrir un error durante la creación de la tienda en alguno de los productos Napse.
El estado de creación. En caso de que el alta de la Tienda haya sido exitosa se mostrará un icono verde , en caso de error en la ejecución de los servicios en todos los productos, se mostrará un icono rojo y en caso de que el error se haya presentado solo en alguno de ellos se mostrara en naranja.
En caso de ocurrir algún error, el la columna de Acciones se contará con el icono de reintento .
4.3.4 Descargar .properties de la tienda
Paradescargar el archivo .properties con los parámetros a definidos en el formulario de alta de tienda,se debe presionar el botón "Opciones> Descargar .Properties".
Este archivo deberá ser utilizado al momento de instalar Bridge Manager Tienda.
.Properties Tienda
Paso
Linea
Propiedad
Parámetro
Valores
Observaciones
Valores para el instalador
1
Valores necesarios para el instalador
basedir=/tmp/antinstall/
NO MODIFICAR
2
Valores necesarios para el instalador
ant.install.config.version=0.0
NO MODIFICAR
Componentes a instalar
3
Tipo de instalación
installType=store
central
store
Su valor dependerá del tipo de componente a instalar.
Directorio de instalación
4
Directorio donde se va a instalar
installDir=/usr/synthesis/bridgeTienda
installDir=C\:\\napse\\bridgeTienda
Base de datos
5
Nombre de la base de datos
datasource.dbname=bridgeTienda
bridgeTienda
6
Host/Ip del servidor de mongodb
datasource.dbhost=localhost
localhost
7
Puerto del servidor de mongodb
datasource.dbport=27017
27017
8
Usuario con permisos para crear la base de datos
datasource.username=admin
admin
9
Contraseña del usuario de base de datos
datasource.password=Nosotros123
Nosotros123
10
Tipo de Autentificación contra la base de datos
authMechanism=USER_PASSWORD
USER_PASSWORD
Puertos de BM
11
Puerto sobre el cual se va a instalar el Bridge Manager.
port = 8180
Entre 8080 y 8090
Se asume que el Puerto +1 será para BridgeApi y Puerto +2 será para Bridge Core Server
Configuraciones
12
Método de encriptación de la contraseña
encryption=SHA-1
SHA-1
No Modificar
13
Host/Ip donde se va a instalar Bridge
ruleWebservicePos.host=10.4.108.70
En ambientes productivos deberá reemplazarse por la IP del host productivo.
JAVA
14
Ubicación de la JVM
javaHome=/usr/java/jre1.8.0_221/bin
Regionalización
15
Pais sobre el cual se quiere instalar
dataEnviroment=install-a-central-argentina
Personalización
16
Directorio sobre el cual esta el archivo scripts.zip para ejecutar scripts propios del proyecto
clientDirScripts= /instaler/scripts.zip
17
Directorio sobre el cual esta el archivo client.zip para agregar/reemplazar archivos de images/vourches etc del proyecto
Para acceder al listado del histórico de cambios de la tienda, se debe presionar el botón "Opciones > Auditoría".
Se visualizará la siguiente información:
Fecha
Usuario
Nivel
Acción
Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.
4.4 Categorías
Se considera categoría al agrupador de una o más terminales que pertenecen a una misma tienda.
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Categorías" dentro de "Negocio" (Negocio > Categorías).
Descripción de la página:
A través de esta página, será posible efectuar el alta, consulta y edición de las categorías que se manejan en el sistema, como así también la visualización del conjunto de cajas que se encuentran asociadas a una nueva categoría específica.
4.4.1 Alta de categorías.
Para crear una nueva categoría, desde la pantalla de Gestión de categorías, presionar en el botón "Nuevo".
Se informará el código de compañía en la cual se encuentra logueado el usuario, sin posibilidad de edición, y se deberán ingresar los siguientes campos:
Código: obligatorio y único
Nombre: obligatorio
Presionar el botón"Guardar"para finalizar la creación de la categoría o"Volver"para regresar a la pantalla de gestión de categorías.
4.4.2 Modificación de categorías
Para modificar una categoría se debe presionar el botón "Opciones>Editar"correspondiente a la división operativa en cuestión en cuestión.
En el formulario de edición, se mostrarán los datos cargados y se podrá modificar únicamente el nombre de la categoría.
4.4.3 Registro de auditoría de categoría
Para acceder al listado del histórico de cambios de la división operativa, se debe presionar el botón "Opciones > Auditoría".
Se visualizará la siguiente información:
Fecha
Usuario
Nivel
Acción
Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.
4.5 Terminales
Se considera Terminal a la unidad lógica que representa una caja física.
Una vez dada el alta la Tienda en los diferentes productos de la Suite Napse, se deberán crear las Terminales asociadas a dicha Tienda.
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Terminales" dentro de "Negocio" (Negocio > Terminales).
Descripción de la página:
A través de esta página será posible efectuar el alta, consulta y edición de las Terminales que se manejan en el sistema.
Creacioin automatica de compañías
Cuando la instalacion del Puinto de venta Bridge se ejecute por medio del proceso de instalacion "Wizard" o "auto", y indique durante este proceso que el punto de ventas y sus productos se actualizaran via Director, dicho punto de ventas sera identificado en la grilla de Terminales con un icono azul en la columna de "Productos". En caso de editarse la terminal desde Director, deberan de cargarse los datos requeridos en el formulario de terminal para poder guardar los datos correctamente.
4.5.1 Alta de terminal
Una vez dada la tienda en los diferentes productos de la Suite Napse, se deberá crear la/las terminales asociadas a dicha tienda.
Para crear una terminal se deberá presionar en "Nuevo" ante lo cual se presentará un formulario de alta dividido en diferentes solapas.
Información general:
Esta información es utilizada para la confección de los servicios de alta de terminales en Promo, Vtol y Fiscal Flow, como así también información común entre los productos como ser el código y nombre.
Compañía: se mostrará precargado el código de compañía pertenece la terminal que se esta dando de alta, sin posibilidad de edición.
Tienda (dato requerido): se deberá selecciona el nombre de la Tienda a a la que pertenecerá la Terminal.
Código de Terminal (dato requerido): código unico de Terminal en Director, Promo, Vtol, Fiscal Flow y Bridge. Campo numerico y no acepta como valor "0" (cero).
Creacion de nro de terminal en BM Tienda
Al momento de ejecutarse el instalador de la terminal, se generará en la tienda asignada, el código de la terminal declarado en el formulario, evitando de esta formar tener que dar de alta la terminal en la tienda asignada como prerrequisito.
Nombre de Terminal (dato requerido): nombre identificatorio de Terminal en Director, Promo, Vtol, Fiscal Flow y Bridge.
Tipo de punto de venta: se deberá seleccionar el tipo de punto de venta a instalar, pudiendo seleccionar entreTienda (defecto), Self Order, Supermercado, playa, Verificador de precios, Self Scan, Self CheckOut,
Modo Cuadrado: Determinara la forma de la pantalla del pos operador al momento de iniciar. Define la resolución cuadrada o wide de la pantalla del punto de ventas.
¿Ejecuta el POS en pantalla completa?: Indicara si el POS se inicia como pantalla completa o en modo ventana. Las opciones disponibles son: "Pantalla Completa" (defecto) y "Modo Ventana"
¿Utiliza emuladores en los dispositivos?: Podra indicarse aqui si el punto deventa opera con emuladores de dispositivos, o bien si se deben configurar los dispositivos con los que operara el punto de ventas
Categoría (código): Se considera categoría al agrupador de una o más terminales que pertenecen a una misma tienda. Campo combo que se cargara con lo definido en Director desde las opciones de menu Negocio >> Categorias
¿Activo?: campo check. por defecto estará tildado. indicara si la terminal a generar estará activa o no
Opciones de instalación:
Opera en Modo Offline: Permite realizar operaciones en la terminal sin tener conexión a Bridge Manager Tienda. De indicar NO, deberá de indicarse la ruta, puerto y nombre de la base de datos online de la tienda (en la solapa de "Configuración de la base de datos") y en caso de no tener conexión el pos no podrá ser operado.
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 vacía o no existir para evitar conflictos en la instalación.
Ubicación de la JVM: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:\Program Files\Java\jre1.8.0_351\bin.
Puerto donde se va a instalar el BridgeApi de la Terminal: por defecto será el puerto 10000.
clietPOS.zip: Este archivo contiene imágenes y recursos para un cliente en particular. Campo de texto, vacío por default. La ruta a definir aquí no debe incluir \clientPos.zip (Ejemplo C:\users\admin\documents).
Ingrese el puerto para el pinpad: por defecto será el puerto COM9
Seleccione el driver del pinpad: se deberá indicar el modelo de driver para el pinpad.
Configuración de la base de datos:
Host de la base de datos:dirección IP del servidor de base de datos o el nombre del host (localhost en caso que resida en el mismo servidor). Campo texto, requerido. Valor por defecto: 127.0.0.1
Puerto de la base de datos: Puerto donde se encuentra la base de datos. Campo texto, requerido. 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. No debe existir una base previa con este nombre. Campo texto, requerido. Valor por defecto: bridgeOffline
Usuario de la base de datos: Usuario con que se conectara a la base de datos. Campo texto, requerido. valor por defecto admin.
Contraseña de la base de datos: Contraseña de acceso a la base de datos. Campo tecto, requerido. El campo estara vacio por default.
Mecanismo de autenticación: Forma de autenticación del usuario en la base de datos. Campo combo. Requerido. Valores a mostrar: "Usuario y Contraseña" y "LDAP".
Importante
Al momento de pulsar el botón "Guardar", Director validará que todos los campos requeridos del formulario estén completos.
Al presionar el botón "Guardar", Director ejecutará los servicios de creación de la terminal en Promo, Vtol y Fiscal Flow (en base a los productos que asociados la compañía a la que pertenecerá la terminal a generar).
Al guardar, se solicitará una confirmación de inicio del proceso con el siguiente mensaje: “¿Desea continuar con la creación de la terminal? Esta acción creará una terminal en PROMO, FISCAL FLOW, VTOL y DIRECTOR con los datos aquí declarados.” Al presionar en OK, se continuará con el proceso de creación de la terminal, caso contrario, de presionarse "Cancelar", se volverá a la pantalla de crear la terminal sin guardar ningún cambio.
4.5.2 Edición de terminal
Para modificar una terminal se debe presionar el botón "Opciones>Editar"correspondiente a la terminal en cuestión.
En el formulario de edición, se mostrarán los datos cargados y se podrán modificar sus propiedades. Sin embargo, el código de compañía no podrá ser editado.
Información general
Compañía
Opciones de Instalacion
Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalacion del punto de ventas.
Configuracion de la base de datos
Todos los campos podrán ser editados, al guardar los cambios estos se verán reflejados en el .properties de instalacion del punto de ventas.
4.5.3 Productos de la terminal
Para acceder al detalle de los productos que tiente instalados la terminal y conocer el estado de los mismos, se debe presionar el "Opciones >Productos de la terminal".
4.5.4 Detalle de terminales
Para visualizar el detalle y estado de las terminales dadas de alta en los diferentes productos de la Suite Napse, se debe presionar el botón "Opciones> Detalle".
Se podrá visualizar
El listado de productos Napse.
El log en caso de ocurrir un error durante la creación de la Terminal en alguno de los productos Napse.
El estado de creación. En caso de que el alta de la Terminal haya sido exitosa se mostrará un icono verde , en caso de error se mostrará un icono rojo .
En caso de ocurrir algún error, el la columna de Acciones se contará con el icono de reintento .
4.5.5 Descargar .Properties de terminales
Paradescargar el archivo .properties con los parámetros a definidos en el formulario de alta de terminales,se debe presionar el botón "Opciones> Descargar .Properties".
Este archivo deberá ser utilizado al momento de instalar Bridge POS.
Para acceder al listado del histórico de cambios de la terminal, se debe presionar el botón "Opciones > Auditoría".
Se visualizará la siguiente información:
Fecha
Usuario
Nivel
Acción
Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.
5 Monitoreo
5.1 Monitoreo de Versiones
Las versiones de los productos que están instaladas en los terminales se podrán controlar y actualizar de forma centralizada. El proceso de actualización de versiones de productos consta de dos etapas:
Descarga: Descarga en la terminal la versión disponible de un producto
Instalación: Con la descarga finalizada de archivos correspondientes a la versión y disponibles en la terminal, se efectúa la instalación automática
Cada uno de los pasos de la actualización en cada terminal es ejecutado e informado por el componente Director Agent. Ambas etapas de actualización se realizan bajo demanda desde la pantalla de "Monitoreo de Versiones" de Director.
Acceso: Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Monitoreo de Versiones" dentro de "Monitoreo" (Monitoreo >Monitoreo de Versiones).
Descripción de la página:
En esta página, se logran ejecutar los procesos de descarga e instalación de versiones. En la cuadrilla se logra visualizar todas las terminales con sus productos instalados, conocer la versión que poseen y la versión que tienen descargada para actualizar el producto, como así también si poseen una tarea asignada a la terminal (tanto de descarga como de instalación). Además, se informa el estado de la terminal (activo o desconectada) y el estado del producto que se ejecuta en la terminal (en funcionamiento o detenido).
5.1.1 Búsqueda
Los filtros ofrecidos para monitorear las versiones instaladas en las terminales son los siguientes:
Producto (obligatorio)
División operativa
Tienda
Categoría
Terminal
Actual
Descargada
Ultimo estado (mayor)
Ultima tarea
Con error
Sin error
Versión de agente
Presionar el ícono de "Buscar" para que la búsqueda se lleve adelante. Al hacer esto, en la tabla se mostrará como resultado las terminales por tienda y por producto.
5.1.2 Descarga de versión
El proceso de descarga permite que en una terminal se descargue remotamente desde un repositorio central una versión seleccionada por el usuario para posteriormente efectuar el proceso de instalación de la versión descargada.
Paradescargaruna versión a una o más terminales, se debe tildar la/las mismas y luego presionar el botón de “Descargar”, donde se mostrará un diálogo con un resumen de la cantidad de terminales seleccionadas y una lista de versiones disponibles para descargar a las terminales seleccionadas con el objetivo de que el usuario pueda confirmar la acción deseada.
Adicionalmente se le pedirá que indique las opciones de planificación
indicando fecha y hora
o bien que la descarga se haga ni bien la terminal se reporte al servidor
Es importante destacar:
La opción de planificación: ya que la misma implica que 1 o más terminales realicen la descarga de una versión pudiendo afectar el ancho de banda de la red. Entonces con la opción de planificación se puede tener mayor control sobre cuando realizar ésta tarea, quizás en un día y horario donde la red no tenga tanto uso o bien, la descarga no genere mayor impacto sobre otros sistemas.
Por último se le pedirá al usuario que ingrese un comentario (obligatorio) asociado a la acción de descarga y que generará un registro de auditoria en el sistema.
Dada esta acción se verá se verá en la/las terminales un número de tarea asignado y ya no se podrá seleccionar dicha terminal-producto para realizar otra acción hasta que la misma culmine
Una vez finalizada la descarga de la versión en la/las terminales a la hora y fecha programada, se mostrará en la columna "Estado" la leyenda Disponible y en la columna "Descargada" el código de versión actualizado.
El paso siguiente es generar la instalación de la versión descargada en la terminal.
5.1.3 Instalación de versión
Una vez realizado exitosamente el proceso de descarga, se procede a ejecutar también de forma remota la instalación de la versión en la terminal.
Para actualizar una o más terminales se deben tildar y presionar el botón"Instalar".
Se abrirá un diálogo con un resumen de de la cantidad de terminales seleccionadas, un agrupamiento de cantidades de terminales que se instalarán X versión y un comentario obligatorio.
A diferencia de la descarga, el proceso de Instalación se ejecutará tan pronto el agente (componente cliente de la solución Director) se reporte al servidor. El agente ejecutará una serie de pasos y los informará a Director Server para que sea mostrado en la pantalla.
Finalizada la etapa de instalación, se informará en la columna "Estado" la leyenda Disponible, en la columna "Actual" la versión instalada.
6. Administración
6.1 Ejecución de procesos
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Ejecución de procesos" dentro de "Administración" (Administración >Ejecución de procesos).
Descripción de la página:
A través de esta página es posible conocer el detalle de cada ejecución de cada proceso, pudiendo filtrar por estado o proceso:
El listado de ejecuciones de procesos brinda la siguiente información:
Estado: OK u Error.
Nombre: nombre identificador del proceso. Para ver el listado completo de procesos consultar la sección "Estado de procesos".
Notas: en el caso de haber finalizado el proceso con un error, permite ver su descripción.
Fecha U. Actualización: fecha de última ejecución del proceso.
6.2 Estado de procesos
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Estado de procesos" dentro de "Administración" (Administración >Estado de procesos).
Descripción de la página:
A través de esta página es posible ver el listado completo de procesos del sistema.
El listado de procesos brinda la siguiente información:
Estado:
Running: actualmente siendo ejecutado.
Ready: lista para ser ejecutado.
Stopped: proceso detenido.
Nombre
U. Actualización: fecha de última ejecución.
6.2.1 Cambiar Estado
Esta opción permite detener un proceso listo para ser ejecutado (Ready => Stopped) o activar un proceso detenido (Stopped => Ready).
6.2.2 Ejecutar
Esta opción ejecuta el proceso seleccionado
6.3 Alertas Generadas
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Alertas generadas" dentro de "Administración" (Administración >Alertas Generadas).
Descripción de la página:
6.4 Logs Servidor
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Logs Servidor" dentro de "Administración" (Administración >Logs Servidor).
Descripción de la página:
Desde esta sección se permite acceder al log del servidor. Esta información es importante para poder identificar la causa de los errores que puedan ocurrir en el servidor.
El log del servidor se registra por año, Fecha, Hora y Tipo, como muestra la siguiente imagen.
Se podrá distinguir 2 tipos de log:
info
error
6.4.1 Descargar
Se cuenta con la funcionalidad de poder descargar los archivos de log, a través del boto "Descargar" que aparece sobre cada log listado.
6.5 Auditoría
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Auditoría" dentro de "Administración" (Administración >Auditoría).
Descripción de la página:
La aplicación registra constantemente la información de las acciones realizadas sobre las distintas entidades que contiene, identificando el usuario que realizó dicha acción y la fecha.
Desde esta página es posible realizar una búsqueda de las acciones efectuadas por medio de la consola de administración, filtrando por:
Para ello se deben completar los filtros deseados y luego presionar el botón "Buscar".
En el listado de registros de auditoría se puede consultar la siguiente información:
Acción:
LOGIN
CREATE: entidad creada.
UPDATE: entidad modificada.
DELETE: entidad eliminada.
Entidad:
Compañía
Plantilla
Procesos
Terminal
Tienda
Unidad de negocio
Usuario
Usuario
Código de compañía
Nivel
Fecha
6.5.1 Ver detalle de acción auditada
Para ver el detalle de una acción auditada se debe presionar el botón "Detalle"correspondiente al registro en cuestión.
7. Configuración
7.1 Configuración
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Configuración" dentro de "Configuración" (Configuración >Configuración).
Descripción de la página:
A través de esta página se permite configurar las propiedades del sistema.
7.1.1 Opciones de Configuración
Opciones de Configuración
Código
Nombre
Tipo
Tipo de dato
Valor
Detalle
1
companyTestMode
Multi-compañía: Configuración para una nueva compañía para el entorno de Testing exclusivamente.
server
boolean
false
Indica si Director opera en modo testing exclusivamente
2
consoleSessionExpirationInSeconds
Duración de sesión de usuario en consola (en segundos)
server
number
3600
indica cual es el tiempo que debe encontrarse el usuario sin actividad en la consola de director para su desconexión automática.
3
director.url
Multi-compañía: URL de la consola desde la que opera director.
Se configura la url propia de Director (se usa luego para los .properties)
4
directorConfiguration.agentDateTimeFormat
Multi-compañía: Formato de fecha y hora para comunicarse con el agente.
server
string
yyyyMMddHHmmSSZ
Formato de fecha de los agentes (no se toca)
5
directorConfiguration.agentUpdateRootFolder
Multi-compañía: Directorio raíz de actualizaciones del agente.
server
string
Directorio para subir una actualización masiva de los agentes que se reportan a la consola
6
directorConfiguration.consoleTmpDir
Multi-compañía: Ruta base para archivos temporales.
server
string
temp
Directorio temporal donde se baja al file system todos los archivos (sería el directorio de instalación /tmp), aca va a estar los archivos separado por compañía (luego vamos a tener internamente una carpeta por producto, clientPos, versiones de productos subidas, etc)
Multi-compañía: Path creación de la compañia del producto vtol.
server
string
:8787/register/addCompany
30
vtol.PathStore
Multi-compañía: Path creación de la tienda del producto vtol.
server
string
:8787/register/addStore
31
vtol.PathTerminal
Multi-compañía: Path creación de la terminal del producto vtol.
server
string
:8787/register/addNode
32
vtol.PathToken
Multi-compañía: Path de obtención de token del producto vtol.
server
string
:8484/customer/oauth/token
7.1.2 Búsqueda de configuración
Es posible realizar una búsqueda de las acciones efectuadas por medio de la consola de administración, filtrando por
Para ello se deben completar los filtros deseados y luego presionar el botón"Buscar".
7.1.3 Edición de configuración
Para editar la configuración presionar sobre el botón de opciones > editar. A continuación ingresar el nuevo valor y presionar guardar.
Para los usuarios de la compañía Napse se contará con las opciones de configuración de GIT, en las cuales se deberá definir la url, password y usuario para realizar la conexión con GitLab.
Del mismo modo, el usuario de la compañía Napse podrá definir los path desarrollados por los productos Promo, Fiscal Flow y Vtol para la obtención de Token y para la creación de compañía tienda y terminal.
7.2 Entornos
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Entornos" dentro de "Configuración" (Configuración >Entornos).
De acceso exclusivo de Napse
Esta opción del menú de Configuración solo será visible por el super usuario asignado a Napse
Descripción de la página:
A través de esta página se permite configurar los entornos de la suite Napse con los que se integrará Director. Al acceder a Configuración > "Entornos" se mostrará el listado de productos dados de alta hasta el momento, en donde se observará la siguiente disposición de la información:
Estado: Indicara el estado de la consola de producto configurada. Mostrando las disponibles en verde y en rojo las consolas cuya conexión no este disponible. Solo podrá seleccionarse, al momento de dar de alta una compañía, de entre las consolas de producto disponibles.
Nombre: Nombre único identificador del producto. El nombre deberá ser único, validándose al momento de guardar que no exista otro producto con el mismo nombre dado de alta previamente.
Código de Producto: Código identificador del producto. El código deberá ser único, validándose al momento de guardar que no exista otro producto con el mismo código dado de alta previamente.
URL: Dirección URL donde se encuentra el producto.
País: País al que pertenecerá el producto a dado de alta.
Botón Opciones: Este botón desplegara la opción "Editar" desde la cual se podrá acceder al formulario de edición del producto, y a la opción "Detalle" que mostrará un resumen del producto.
Botón Nuevo: Por medio de este botón podrá accederse al formulario de alta de nuevo producto.
Integracion de Director con la Suite Napse
Los datos aquí expuestos corresponden a los solicitados para la creación por servicio de la compañía en los productos de Promo, Fiscal Flow y Vtol.
Botón Opciones:
Al presionar en el botón Opciones de un producto se mostrarán las siguientes opciones:
Editar: por medio del cual se accederá al formulario de edición de un entorno. (Ver sección Edición de Entorno)
7.2.1 Nuevo entorno
Al acceder con el super usuario asignado a Napse será posible definir nuevos entornos
La integración de productos de la suite Napse requiere que en Director se pueda definir los path desarrollados por los productos Promo, Fiscal Flow y Vtol para la obtención de Token y para la creación de compañía tienda y terminal.
Estos datos deberán de indicarse en la sección de Configuración. (Ver Configuración > Configuración)
Se presentara el formulario de creación de nuevo producto, donde se solicitarán los siguientes datos:
Producto: Campo combo donde podrá seleccionarse entre los productos de la suite Napse a darse de alta. Mostrará las siguientes opciones:
No Especificado (En caso de que al presionar "Guardar" el campo "Código de producto" tenga esta opción seleccionada se mostrará un popUp indicando que debe indicarse el producto que se desea definir ya que el campo es requerido)
Fiscal Flow
Promo
Vtol
Nombre (*): Nombre único del producto. Campo requerido.
URL (*): Url donde se encuentra la consola del producto. Campo requerido.
País (*): Campo combo que mostrará los posibles países a los que un producto puede pertenecer. Las opciones podrán ser: "Argentina", "México", "Colombia" y "Chile".
Productos por país
Los productos aquí definidos, serán los que se propongan al momento de generar una nueva compañía (Ver: "Negocio" > "Compañías") en base al país que se indique donde operará la compañía se mostrarán los productos definidos para ese país en los combo de "Entornos Promo", "Entorno Vtol" y "Entorno Fiscal Flow".
7.2.3 Edición de entorno
Al presionar en la opción "Editar" se mostrará la siguiente pantalla donde podrán editarse los campos del producto seleccionado. Todos los campos podrán ser editados.
7.3 Alertas
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Alertas" dentro de "Configuración" (Configuración >Alertas).
Descripción de la página:
A través de esta página se podran visualizar las alertas del sistema.
8 Seguridad
8.1 Usuarios
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Usuarios" dentro de "Seguridad" (Seguridad >Usuarios).
Descripción de la página:
A través de esta página es posible efectuar el alta, edición y eliminación de los usuarios que se manejarán en el Sistema, como así también cambiar la contraseña y visualizar los roles a los que se encuentra asociado el usuario.
8.1.1 Búsqueda de usuarios
Los usuarios cargados en el sistema se podrán localizar mediante los siguientes filtros:
Usuario
Email
Nombre
Rol
Una vez completado alguno de dichos campos, se debe presioanar el ícono de "Buscar" para que la búsqueda se lleve a cabo y se puedan visualizar los registros que posean una coincidencia igual o parcial.
Al hacer esto en la tabla se mostrarán sólo aquellos usuarios que posean una coincidencia igual o parcial.
8.1.2 Alta de usuarios
Para crear un usuario, presionar el botón"Nuevo"ante lo cual se desplegará la siguiente pantalla:
Se deberán ingresar los siguientes campos:
Usuario: obligatorio y único, no podrá ser modificado.
Nombre y Apellido: obligatorio.
Email: obligatorio
Contraseña: obligatorio.
Corroboración de contraseña:
Rol al que se asociará el usuario
Activo: estado del producto, por defecto estará tildado que significa habilitado
Presionar botón"Guardar"para finalizar la creación del usuario o"Volverpara volver a la pantalla principal.
8.1.3 Modificación de usuarios
Para modificar un usuario se debe presionar el botón "Opciones >Editar"correspondiente al usuario en cuestión. A través de la pantalla de edición se podrá modificar las propiedades del usuario, a excepción del usuario.
Una vez efectuada las modificaciones presionar"Guardar"para guardar los cambios o"Volver"para volver a la pantalla principal.
8.1.4 Modificar contraseña de usuarios
Para modificar la contraseña de un usuario se debe presionar el botón "Acciones>Cambiar contraseña"correspondiente al usuario en cuestión.
Una vez efectuada las modificaciones presionar"Guardar"para guardar los cambios o"Volver"para volver a la pantalla principal.
En el próximo acceso del usuario, el sistema automáticamente le pedirá el ingreso de una nueva contraseña, para comenzar a operar la aplicación.
8.1.5 Registro de auditoría
Al ingresar desde el botón de "Opciones > Auditoría", se accederá al listado del histórico de cambios realizados sobre el usuario seleccionado, indicando nombre de usuario, nivel, acción y fecha.
Al acceder a la opción "Detalle" se puede ver la información original y la modificada, identificándose en forma resaltada los datos modificados.
8.2 Clientes Api
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Clientes Api" dentro de "Seguridad" (Seguridad >Clientes Api).
Descripción de la página:
A través de esta página, es posible crear clientes para acceder a los servicios de la api. Cada cliente pertenece a una compañía en particular y posee un id y un Secret, el cual debe proporcionar para autenticarse.
8.2.1 Alta de Cliente Api
Para dar de alta un cliente no se requiere ningún dato. Se genera automáticamente y puede consultarse desde el listado, al ordenar por fecha de creación.
8.3 Roles
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Roles" dentro de "Seguridad" (Seguridad > Roles).
Descripción de la página:
A través de esta página, se permite definir los roles de usuarios, los cuales se definen a través de un conjunto de permisos.
8.3.1 Alta de rol
Para crear un rol, presionar el botón"Nuevo"ante lo cual se desplegará un formulario en el cual se deberán completar los siguientes campos:
Nombre: descripción del rol.
Rol: código del rol, no podrá ser editado.
Activo: permite activar o inactivar un rol.
Permisos: seleccionar los permisos del listado de permisos.
8.3.2 Modificación de rol
Para modificar una categoría se debe presionar el botón "Editar"correspondiente a la división operativa en cuestión en cuestión.
En el formulario de edición, se mostrarán los datos cargados y se podrán modificar las propiedades del rol, a excepción del código de rol.
8.4 Permisos
Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Permisos" dentro de "Seguridad" (Seguridad > Permisos).
Descripción de la página:
A través de esta página, se permite conocer todos los permisos disponibles en el sistema y las url afectadas por los mismos.
9. Versiones
9.1 Administración de Productos
Un producto es una solución de software instalada en las terminales de una empresa. Director permite definir y gestionar los productos de forma única para su posterior uso en el sistema.
Acceso: Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Administración de Productos" dentro de "Versiones" (Versiones >Administración deProductos).
Descripción de la página:
A través de esta página es posible efectuar el alta, consulta y edición de los productos que operará el retailer.
Por defecto, al realizar el alta de la compañía se darán de alta los siguientes códigos de productos:
BManager
FiscalFlow
BApiT
BApi
BridgePOS
EMVKITAR
9.1.1 Alta de productos
Crear en GitLab (previamente configurado) un repositorio para el nuevo producto.
Al momento de dar de alta en repositorio en gitLab se debe tener en cuenta las siguientes consideraciones:
ElProject namedeberá ser el nombre de la compañía + el código del producto (respetando mayúsculas y minúsculas del código de compañía y del código de producto).
ElProject slugdeberá ser exactamente igual alProject name(respetando mayúsculas y minúsculas).
EnProject URL,el usuario deberá serroot.
El Nivel de visibilidad deberá ser público.
Una vez creado el repositorio, ya podemos crear un producto en Director Server. Presionar el botón "Nuevo" del formulario "Administración de Productos". Se desplegará la siguiente pantalla:
Se informará el código de compañía en la cual se encuentra logueado el usuario, sin posibilidad de edición y se deberán ingresar los siguientes campos:
Código: obligatorio y único
Nombre: obligatorio
Nombre repositorio GIT: el nombre del repositorio en GIT se autocompletará con el código de la compañía y el código del producto ingresado por el usuario. El nombre de repositorio deberá ser previamente creado en GIT.
Descripción: detalle descriptivo opcional del producto
Activo: estado del producto, por defecto estará tildado que significa habilitado
Presionar el botón"Guardar"para finalizar la creación del producto o"Cancelar"para regresar a la pantalla de administración de productos. Una vez registrado el producto se generará en forma automática una versión base, la cual se utilizará como punto de partida para una futura versión que se desee instalar en una o más tiendas/terminales.
Director integrado con la Suite Napse
Cuando la instalacion de un producto se realice por medio del procedimiento SMB ( Director integrado con la Suite Napse) los productos seran dados de alta automaticamente en GitLab, por lo que solamente sera requerida la creacion del producto en Director a fines de actualizacion
9.1.2 Modificación de productos
Para modificar un producto en particular previamente cargado, se debe presionar el botón "Opciones >Editar".
En el formulario de edición, se mostrarán los datos cargados y se podrán modificar los siguientes valores:
Nombre
Descripción
Estado
Presionar "Guardar" para guardar los cambios o "Volver" para descartarlos y volver a la pantalla principal.
9.1.3 Modificación de producto Bridge POS
A partir de Director 2.0 es posible incorporar al crear un nuevo producto, la posibilidad de gestionar los archivos de personalización del punto de ventas por medio de la asociación del archivo ClientPos.Zip,
Este archivo contiene imágenes y recursos para un cliente en particular, como ser imágenes tipografías y colores propios de la marca de un cliente.
En esta sección se describe al usuario final el paso a paso par ala gestión y actualización del producto (BridgePos) con archivos de personalización ClientPos.zip.
Actualmente el archivo ClientPos.Zip, contiene archivos de la personalización y mantiene el look and feel del punto de venta (BridgePOS) de cada cliente.
Cuando se realiza algún desarrollo nuevo o se incorpora un Fix sobre el POS la, y la actualización del producto se gestiona desde Director, al momento de ejecutar la actualización de producto es posible indicar que se incluye en la actualización el archivo de personalización ClientPos.Zip.
El archivo ClientPos.zip es incorporado manualmente en el proceso de actualización del producto desde la consola de Director, para que al momento de que el cliente realice la actualización del punto de venta no se superponga el archivo y quede con la tipografía, colores y logos por defecto.
La gestión del ClientPos.zip solo intervendrán en procesos de actualización del punto de venta, por lo que es importante incorporarlos al crear el producto que gestionara la actualización de un punto de venta que ya opere con archivos de personalización.
Los campos de definicion del archivo ClientPOs.zip solo estarán disponibles en la edición del producto y no al momento de la generación de un nuevo.
Gestión del ClientPos.zip
Para la incorporación del archivo ClientPos.zip en el proceso de actualización de un punto de ventas desde director, sera necesario acceder a la consola de Director, logueandose con las credenciales de la compañía a la que pertenece el punto de ventas a actualizar.
Accediendo desde el Menú a la opción "Versiones" > "Administración de productos" se mostrara la siguiente grilla con todos los productos que al momento la compañía gestiona desde Director, y seleccionaremos el código del producto "BridgePos", el cual administra las actualizaciones de los puntos de venta de la compañía y presionaremos en "Editar".
Accederemos al formulario de "Crear / Editar producto". Aquí encontraremos los datos de definicion del producto, y se mostrara al pie de la pantalla las opciones para la gestión del ClientPos.zip en el proceso de actualización del producto.
Los campos disponibles son:
Ya se adjuntaron imágenes y recursos particulares para el cliente: Este campo quedara tildado y sin posibilidad de edición una vez se haya guardado de manera correcta el archivo clienPos.zip. En caso de que el producto aun no tenga asociado un archivo clientPos.zip el check estará destildado y sin posibilidad de edición.
Choose File: Permite adjuntar el archivo ClientPos.Zip, que contiene las imágenes de personalización del punto de ventas de un cliente.
Importar: Permite importar el paquete actualizador con las imágenes de personalización del punto de ventas de un cliente.
IMPORTANTE
Se aplicara el archivo clientPos.zip solamente al producto BridgePOS.
Si al momento de crear el producto, el usuario no adjunta un clientPos.zip, se dará mensaje de aviso informando que no se están subiendo los archivos de personalización con las imágenes del cliente, por lo cual el producto, en caso de ser actualizado mantendrá el look and feel del producto base. (logos Napse)
Si el usuario adjunta un clientPos.zip y la validación mínima de estructura es correcta, el producto se guardará con dicha personalización. Posteriormente, el usuario solamente podrá importar un nuevo archivo ClientPos.zip en caso de que el look and feel del cliente haya tenido modificaciones.
Proceso de actualización - Bridge POS
Cuando se requiera realizar una actualización del producto BridgePos, ya sea por la incorporación de nuevas funcionalidades o por correcciones de fix, se ejecutaran los pasos de actualización de producto descritos en el capitulo9.2 Administración de Versionesdel mal manual de usuarios de Director 2.0.
IMPORTANTE
Cuando se suba una nueva versión del producto BridgePos y ese producto este gestionando los archivos de personalización, Director realizará una comparación entre el archivo clientPos.zip que posee la versión a actualizar y el archivo clientPos.zip que Director posee en el repositorio de dicho producto, en caso de haber diferencias, en la actualización del producto se incluirá el archivo de personalización clientPos.zip para que las nuevas imágenes sean cargada por el punto de ventas.
El proceso de depurationFileSystemno borrará el clientPos.zip, solamente se encargará de eliminar viejas versiones del producto que ya se encuentran alojadas en GitLab.
clienPOS.zip - Detalle
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
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.
9.2 Administración de Versiones
Los productos evolucionan en forma de versiones para otorgar nuevas funcionalidades. Con Director, las versiones de los productos se alojan en un repositorio central para luego ser distribuidas en todas las terminales de un retail de manera remota.
Acceso: Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Administración de Versiones" dentro de "Versiones" (Versiones >Administración de Versiones).
Descripción de la página:
A través de esta página es posible efectuar el alta, consulta y edición de las versiones de los productos registrados en el sistema.
9.2.1 Búsqueda de versiones
Las versiones cargadas en el sistema se pueden localizar mediante los siguientes filtros:
Nombre del producto
Código de la versión
Una vez completado alguno de dichos campos, se debe presionar el ícono de "Buscar" para que la búsqueda se lleve a cabo y se puedan visualizar los registros que posean una coincidencia igual o parcial.
9.2.2 Alta de versiones
Para crear una versión de un producto, presionar el botón "Nuevo" del formulario "Administración de Versiones". Se desplegará la siguiente pantalla:
Se informará el código de compañía en la cual se encuentra logueado el usuario, sin posibilidad de edición, y se deberán ingresar los siguientes campos:
Código: obligatorio y único
Descripción: detalle descriptivo opcional de la versión
Producto
Versión anterior: Versión (Código) de la cual hereda la nueva versión
Activo: estado del producto, por defecto estará tildado que significa habilitado
Backup base de datos: permite realizar un backup automático de la base de datos
Seleccionar versión: el archivo a adjuntar debe ser formato zip y contener la versión del producto con la siguiente estructura de directorios:
Importar: presionar en el botón importar para importar la versión.
Una vez cargado y validado el archivo, se informarán los cambios que se efectuaron en el repositorio tras la carga de una nueva versión.
Presionar el botón"Aceptar"para continuar. Finalmente, presionar"Guardar"para registrar la versión en el sistema o"Volver"para volver a la pantalla de administración de versiones.
10. Actualización masiva de agentes
10.1 Descripción
A través de Director se pueden descargar y actualizar versiones de aplicaciones. Este proceso se lleva a cabo gracias a la interacción entre un componente cliente llamado "agente", desplegado en cada terminal que posee software actualizable, y el componente servidor o Director Server. No obstante, para actualizar el agente en sí, no es posible hacerlo de la misma manera que se hace con una aplicación. Sin embargo, la solución posee un mecanismo para distribuir los binarios de los agentes en toda la cadena, por ejemplo cuando:
Se agregan nuevas funcionalidades
Se corrigen issues
Hay algún binario queda corrupto
Etc.
10.2 ¿Cómo funciona?
Cuando inicia el agente, antes de iniciar la aplicación, le consulta al Director Server si sus binarios son los mismos que él tiene, utilizando para ello un número de versión.
Si dicha versión es la misma, el proceso continúa con el inicio normal.
Si no son iguales, se hace una comparación entre lo que tiene el cliente/agente y lo que tiene el servidor. Con éste delta, se hace la transferencia automática de las diferencias, la cuales son aplicadas en el cliente para luego, si continuar con el proceso normal de inicio
10.3 ¿Cómo se activa?
Para activar ésta funcionalidad se debe crear una carpeta en el servidor donde se ejecuta Director Server que contenga todos los binarios del Agente.
Por ejemplo:
Luego crear un archivo de texto llamado "update.config" que contenga la siguiente propiedad
application.version=N
DondeNes un número incremental que se debe incrementar cada vez que se haya introducido algún cambio a dicha carpeta (agregar, renombrar o quitar archivos)
El valor inicial debe ser 0
Una vez creada, ingresar a la consola de administración de Director Server e ir a la sección "Configuración → Configuración". Luego buscar la propiedad "Directorio raíz de actualizaciones del agente". Dicha propiedad debe indicar el directorio creado en el paso anterior, donde se encuentran los binarios del agente que se quieren sincronizar.
Importante
La propiedad "Directorio raíz de actualizaciones del agente" solo será visible para los usuarios de la compañía napse.
10.4 ¿Cómo evidenciar el funcionamiento?
Realizada la configuración de los pasos anteriores, al iniciar cada agente, notará que se logea así con la siguiente explicación:
10.5 ¿Cómo desplegar una versión nueva?
Para desplegar una versión nueva se debe
agregar/reemplazar/eliminar los archivos deseados de la carpeta "monitoreada" por Director Server (propiedad "Directorio raíz de actualizaciones del agente")
abrir el archivo "update.config" de dicho directorio
incrementar el valor de la propiedad "application.version"