PROMO - Manual de Usuario Principal 7.0

MANUAL DE USUARIO PRINCIPAL

PROMO 7.0

Cambios por revisiones

Fecha Revisión

Cambios – Motivo Autor

08/05/2018

1 Creación del documento Gala Higgins

04/09/2020

2 Copia del Manual de Usuario Principal 6.1 y modificación para crear el Manual de Usuario Principal 7.0 Mariel De Marco

29 Sep 2020  

3 Actualización de pantallas: de logueo, menú principal, menú Administración, menú Seguridad. Se agrega: Módulo Informes, Reportes Programados, Atributos de elementos. Seguridad ([20P_70_EX_J4666])_ANF_Seguridad: Refactor Permisos y Roles

Mariel De Marco

Índice

Capítulo 1 - Acerca del manualPropósito y alcanceContenidoReferencias prácticasDocumentación de PROMO

Capítulo 2 - Introducción¿Qué es PROMO?Componentes de PROMOFuncionalidadLimitacionesConceptos básicos

Compañía PrincipalCompañíasMódulosPromociónBeneficios

Capítulo 3 - Consola de AdministraciónIntroducciónConexión a la consolaMenú de Navegación - PROMO PRINCIPALConsideraciones generales

Modificación de los elementosBotonesPaginado

Módulo de InformesMenú de InformesReportes Programados

Capítulo 4 - Módulo de NegocioMenú de NegocioCompañías

Capítulo 5 - Módulo de AdministraciónMenú de AdministraciónTareas ProgramadasInformación de configuraciónRegistros de auditoriasAtributos de elementos

Capítulo 6 - Módulo de SeguridadMenú de Seguridad

Configuración para Eliminación de datos del cliente:Administración de usuarios

Creacón de UsuarioEdición de UsuarioEliminación de Usuario

Configuración de rolesNuevo RolEditar rolEliminar rol

Configuración de AccesosCapítulo 7 - Módulo de Soporte

Menú de SoporteInicializar configuracionesGestor de backups de BBDD

Log de la ConsolaConfiguración de Motores

Capítulo 8 - ApéndicePreguntas frecuentes

No se visualiza en forma correcta la aplicación de la consola en el browserNo puedo ingresar a la consola con mi usuarioerror 404 – Pagina No Encontrada

Capítulo 1 - Acerca del manual

Propósito y alcance

El presente manual de usuario tiene como finalidad la capacitación de quien desee utilizar para la administración centralizada de las compañías o empresas que utilizaran luego sus consolas de PROMO para la PROMOgeneración de promociones. Este documento provee de instrucciones detalladas paso a paso para la creación y administración de las compañías a través de la consola de así como también detalla los conceptos y definiciones de cada PROMOcomponente este producto.

Contenido

Capítulo 1 - Acerca del manualContiene descripciones generales sobre el contenido de este manual.

Capítulo 2 - IntroducciónContiene una introducción del producto y sus componentes.PROMO

Capítulo 3 - Consola de AdministraciónContiene instrucciones sobre el uso de la consola de , forma de acceso y la navegación en los menús.PROMO

Capítulo 4 - Módulo de NegocioContiene los conceptos relacionados con el alta, baja u modificación de compañías dentro de la consola de .PROMO

Capítulo 5 - Módulo de AdministraciónDescribe las configuraciones disponibles para la consola de .PROMO

Capítulo 6 - Módulo de SeguridadSe describe la operatoria de administración y configuración de usuarios, roles y accesos en la consola de .PROMO

Capítulo 7 - Módulo de SoporteAquí se detallaras las opciones de gestión de base de datos y soporte propias de la consola de .PROMO

 -Capítulo 8  ApéndiceProvee información sobre preguntas consideradas como frecuentes.

Referencias prácticas

se utilizará para resaltar aclaraciones sobre el tema en curso. Nota: se utilizará para indicar al usuario sobre precauciones que se deberán contemplar.Importante:

Documentación de PROMO

provee la siguiente documentación:PROMO

" "Manual de Instalación ("MANUAL DE INSTALACIÓN – PROMO V6.1.doc").

Este documento describe los procedimientos para instalar los componentes de Motor y Consola, la creación e inicialización de la Base de Datos y los requerimientos necesarios para el correcto funcionamiento de dichos componentes.

" "Manual de Integración ("MANUAL DE INTEGRACIÓN – PROMO V6.1.doc").

Este documento describe detalladamente los mensajes que deben ser enviados al Motor de Promociones y la forma de interpretar los mensajes de respuesta que éste devolverá ante un requerimiento.

" "Manual de Usuario Final ("MANUAL DE USUARIO FINAL– PROMO V6.1.doc"). Este documento tiene como finalidad servir de referencia y herramienta de consulta para todo usuario que desee utilizar PROMO para la administración de sus promociones, cupones y tarjetas de fidelidad.

" "Manual de Usuario Principal ("MANUAL DE USUARIO PRINCIPAL– PROMO V6.1.doc"). El presente manual de usuario detallara los conceptos y procedimientos que deberá seguir cualquier usuario habilitado que desee utilizar , para la gestión de compañías o empresas que se servirán luego de para la generación de sus promociones.PROMO PROMO

Capítulo 2 - Introducción

¿Qué es PROMO?

es la herramienta indicada para gestionar compañías, empresas o proveedores que luego utilizaran de manera independiente unas de otras para la generación de sus promociones. PROMO PROMODesde la consola de podrán darse de alta nuevas compañías con los módulos, elementos y atributos que cada compañía haya adquirido, pudiéndose así administrar una amplia gama de perfiles de PROMO PRINCIPALcompañías desde una sola aplicación.Podrá también gestionarse desde los usuarios y accesos a cada una de las compañías de manera centralizada. PROMOLas compañías que utilicen para la gestión de sus promociones descubrirán que es una solución que permite separar el manejo de promociones del punto de venta. Permite definir una amplia gama de PROMO PROMOpromociones y es extensible sin la necesidad de realizar modificaciones en los puntos de venta.

permitirá a cada compañía eliminar la codificación y la dependencia del mantenimiento, reduciendo los tiempos de implementación y de prueba. Contaran con una interfaz gráfica a la cual llamaremos PROMO Consola de , que facilita el alta de una promoción convirtiéndola en un proceso rápido e intuitivo. Esta cualidad acelera el proceso de salida de una promoción. Administración - PROMO

está pensado como una herramienta sumamente útil y sencilla de usar orientada a los Retailers para que administren, de forma centralizada, las promociones vigentes en las distintas regiones y locales. PROMOLas compañías, utilizando podrán construir promociones por composición de condiciones (combos), promociones definidas por condiciones simples, crear beneficios, otorgar cupones y puntos de fidelidad, pudiendo PROMOconfigurar los parámetros correspondientes a cada promoción según se requiera. También permite el armado de promociones modelos que puedan ser utilizadas como plantillas, ahorrando tiempo de creación y mayor confianza en la coherencia de la promoción. Se podrán definir reglas de convivencia y órdenes de aplicación entre promociones vigentes. Estos parámetros serán utilizados, mediante algoritmos de alta eficacia, para determinar el conjunto de promociones que participan de una determinada venta. Estas promociones serán informadas al punto de ventas, quien será el encargado de aplicar las promociones informadas por en el ticket.PROMO

Componentes de PROMO

Consola de administración PROMO Principal:

Herramienta WEB para la administración compañías o empresas. Desde esta consola también podrán gestionarse las configuraciones de base de datos, usuarios de todas las compañías y tareas programadas.

Consola de administración PROMO Para Compañías:

Herramienta WEB para la administración de promociones, cupones y tarjetas de fidelidad. Es el componente encargado de generar el archivo de definición de reglas de negocio (mapa de promociones) que será utilizado por el motor de promociones para la evaluación de éstas. Es el encargado de gestionar la emisión y redención de cupones de manera centralizada, así como también se encarga de la gestión de las tarjetas de fidelidad, pudiendo crearlas, asociarlas a clientes, visualizar su historial y gestionar saldos.

Motor de promociones:

Es el componente de encargado de resolver e informar las promociones participantes en un Ticket según las definiciones (promociones) que se hayan generado a través de la consola. También es el nexo entre el PROMOpunto de ventas y la consola de administración central para todo lo referente a la gestión de elementos de Loyalty.

Funcionalidad

Las funciones que se podrán llevar a cabo desde la consola de son:PROMO PRINCIPAL

Definir y administrar compañías. Componente responsable: la consola de administración . PROMO

Administrar tareas programadas. Componente responsable: la consola de administración . PROMO

Administrar configuraciones y backups de base de datos. Componente responsable: la consola de administración . PROMO

Definir y administrar roles de usuario de la consola de promociones de todas las compañías. Componente responsable: la consola de administración.

Administrar configuraciones generales y de negocio. Componente responsable: la consola de administración . PROMO

Limitaciones

Desde la consola de se definen promociones sino que es la consola de de cada compañía la que las define.PROMO Principal no PROMO

Desde la consola de se definen ni generan mapas, sino que es la consola de de cada compañía la que lo hace.PROMO Principal no PROMO

PROMO Principal administrará una única base de datos donde se alojaran todas las promociones y mapas identificados cada uno con el id de compañía al que pertenezca.

Conceptos básicos

Compañía Principal

La "Compañía Principal" será la encargada de dar de alta nuevas compañías o empresas dentro de la consola de . PROMO PRINCIPALSolo podrá haber una "Compañía Principal" por instalación de de . PROMO PRINCIPALSolo los usuarios con perfil de podrán loguearse a la "Compañía Principal" de y dar de alta nuevas compañías.Usuario Principal PROMO PRINCIPAL

Compañías

Una Compañía es la responsable final de la generación y administración de sus propias promociones y mapas. Cada compañía tendrá habilitados determinados módulos y cada módulo otorgara a la compañía un conjunto de elementos y atributos que podrán incluirse o no en las consolas de de cada compañía, dependiendo PROMOde los requerimientos y licencias adquiridas por cada una de ellas.

Módulos

Los Módulos son unidades funcionales que se ofrece desde para gestionar promociones, cupones, tarjetas de fidelidad, KPI´s y redes sociales.PROMODesde la "Compañía ¨Principal" se podrán habilitar o deshabilitar módulos según los requerimientos o licencias que haya adquirido cada compañía que será dada de alta en la consola de . PROMO PRINCIPALLos Módulos disponibles son:

Negocio: Por defecto este módulo se encontrara habilitado y no podrá deshabilitarse. Este módulo habilita funcionalidades tales como la gestión y , , Regiones Tiendas Registros de Auditoria Administración de Usuari, , y configuraciones dentro de cada nueva compañía dada de alta en la consola de . os Accesos Catálogos PROMO PRINCIPAL

Promo: Por defecto este módulo se encontrara habilitado y no podrá deshabilitarse. Este módulo permite la generación y gestión de y , así como también la creación de , de Promociones Mapas Informes PlantillasPromociones y administración de y . Workflws Simulación de tickes

Redes Sociales: La habilitación de este módulo permite la publicación de promociones en distintas redes sociales a fin de agilizar las estrategias de marketing y mejorar la comunicación de promociones y beneficios a los potenciales clientes. 

Transacciones: Con la habilitación de este módulo, se podrá almacenar y gestionar la información proveniente de transacciones informadas desde los puntos de ventas y organizar estos datos en los distintos KPI´s de Este módulo habilita en la consola de (de cada nueva compañía que licencie este módulo), el menú de "Dashboard" donde por default se mostraran los Dashboard de Promociones y PROMO.   PROMOVentas y en caso haber adquirido cupones y tarjetas se habilitara los Dashboard de estos módulos. 

Cupones: Este módulo habilitara a una compañía definir, diseñar e importar cupones propios o externos desde su propia consola de , los cuales luego podrán ser emitidos y/o redimidos desde cada uno de PROMOsus puntos de venta. 

Tarjetas de Fidelidad: La habilitación de este módulo permitirá a una compañía gestionar los distintos tipos de tarjetas de fidelidad de manera centralizada desde , pudiéndose generar tarjetas del tipo PROMOGisftcard, Monederos o tarjetas de puntos, dependiendo de los atributos que se hayan seleccionado al momento de generarlas, como ser nominadas, que requieran CVV o que solo sean para consumo, entro otros. 

Clientes: Con este módulo se habilitara en la consola de cada compañía la gestión de clientes desde la consola de los cuales deberán ser importados o levantados desde un catálogo, pudiendo asociar a PROMO,los clientes cupones o tarjetas dadas de alta desde la consola de cada compañía. 

Promoción

La es el elemento de la mezcla de marketing utilizada para informar, persuadir y recordar la existencia de un producto o servicio a los consumidores potenciales, con la esperanza de influir en los sentimientos, Promocióncreencias o comportamiento del destinatario y estimular así la demanda. Las promociones tienen ciertas restricciones o condiciones que deben cumplirse para poder obtener los beneficios asociados a las mismas.Para PROMO, una promoción es una función que toma un contexto ( Contexto: son todos los elementos que forman parte de una transacción (producto, cupones, clientes, eventos, medios de pago) y los datos propios de la transacción (número de tienda, terminal, fecha y hora).) como ingreso y devuelve un nuevo contexto (con los beneficios resultantes y elementos beneficiados) como salida y los informa a la aplicación del punto de venta POS.

Beneficios

El es una ventaja económica o material que se le otorga a un cliente ante el cumplimiento de ciertas condiciones. beneficioLos beneficios se aplican sobre todo el contenido del ticket o sobre los subtickets que se hayan armado por condiciones simples o condiciones por composición. Comercialmente existen distintos tipos de promociones cuyo beneficio puede traducirse en:

Beneficios monetarios:):Devolución de efectivo (o descuentos Devolución de una parte del precio de compra de un producto al consumidor.

Paquetes promocionales (o rebajas): Precios rebajados directamente por el fabricante en la etiqueta o el paquete.

Beneficios no monetarios: Recompensas para los clientes: Recompensas en valores acumulables o de otro tipo por el uso regular de los productos o servicios de alguna compañía (como puntos o millas).Muestras: Obsequio de una pequeña cantidad de un producto para que los consumidores lo prueben.

:Cupones certificados que se traducen en ahorros para el comprador de determinados productos.:Premios Productos o servicios gratuitos o que se ofrecen a bajo costo como incentivo para la adquisición de algún producto.

Concursos, rifas y juegos: Eventos promocionales que dan al consumidor la oportunidad de ganar algo.

En , los beneficio sólo puede aplicarse sobre los elementos del y a cada compañía podrá habilitársele alguno o todos los beneficios Monetarios o No Monetarios según los módulos adquiridos por cada PROMO tipo productouna de ellas.

Capítulo 3 - Consola de Administración

Introducción

En los siguientes capítulos se describirá la funcionalidad completa de la consola de administración de , desde la creación de nuevas compañías, habilitación de módulos y elementos hasta la gestión de PROMO PRINCIPALconfiguraciones generales, base de datos y tareas programadas.

Conexión a la consola

La consola de administración es una herramienta Web, por lo tanto la conexión a la consola podrá ser remota o local, a través del uso de un browser como Chrome, o Firefox.

Para conectarse a la consola es necesario ingresar a la página donde:http://PROMO:puerto/promo

PROMO: deberá ser reemplazado por la dirección IP de la máquina en la cual se encuentre en ejecución el application Server JBoss (en la imagen ejemplo: ).jbossHostpuerto: es el puerto de conexión (Ej.,: 8080)

       

Una vez conectado a la consola, se deberá ingresar el , y a la que se desea conectarse. Por default, al iniciar PROMO por primera vez, será necesario loguearse a la consola de nombre de usuario contraseña compañía PRO , para ello las credenciales a ingresar serán (respetando mayúsculas y minúsculas): MO PRINCIPAL

Nombre de Usuario: synthesisCompañía: Synthesis

Menú de Navegación - PROMO PRINCIPAL

Consideraciones generales

Habrá datos que el usuario deberá ingresar en la consola y que son comunes a todos los componentes.

:Código Será el identificador univoco cada compañía en . El código "1" se encontrara reservado para la "Compañía Principal" no pudiéndose cambiar. PROMO

Nombre: por medio de este dato, se podrá identificar la compañía que se esté creando y será el nombre que se mostrará en los diferentes listados en los cuales pueda utilizarse. El campo nombre en todos los casos es un dato del tipo de hasta 255 caracteres.string

Descripción: por medio de este dato, se podrá ingresar una breve explicación aclaratoria de la compañía que se está creando. El campo descripción es en todos los casos un dato del tipo de hasta 255 stringcaracteres y cuyo ingreso es obligatorio.no

Modificación de los elementos

Todos los modelos de elementos que se encuentran definidos en (campañas, promociones, plantillas, condiciones, beneficios, cupones y mapas) contarán con la posibilidad de ser modificados. PROMOSe debe tener en cuenta que cuando se ejecutan los flujos de modificación, los cambios efectuados sólo tienen efecto sobre el modelo de elemento que se esté modificando. 

Botones

En las pantallas de la consola de se encuentran habilitados los siguientes botones:PROMO

Volver: botón que permite volver a la pantalla anterior.

Cancelar: botón cuya funcionalidad es la de cancelar el flujo operativo que se encontraba realizando el usuario. Mediante este botón el usuario cancela en cualquier momento el procedimiento que se encontraba en curso volviendo al inicio del menú con el cual se encontraba trabajando.Nuevo: botón que permite crear un nuevo componente, dependiendo de la ubicación del botón en la pantalla será el componente que se podrá crear.Editar: botón que permite editar todos los registros del componente seleccionado de la pantalla en la cual se ubique el botón.Guardar: botón que permite confirmar el procedimiento que se llevó a cabo.Buscar o Filtrar: botón que permite efectuar una búsqueda indicando los valores deseados para un conjunto de filtros.

Importante: Tener en cuenta que si se presiona cancelar en cualquiera de las pantallas de un flujo lo que se hace es cancelar totalmente el flujo que se estaba ejecutando.

Paginado

En todas las pantallas en las cuales se despliegue gran cantidad de registros, se contará con el paginado de la información, para facilitar su navegación. En la parte inferior de cada pantalla se mostrarán los números de las páginas que se encuentran disponibles para poder navegar entre las mismas.

Módulo de Informes

Menú de Informes

Desde este menú se podrá acceder a los "Reportes Programados".

Reportes Programados

Si un usuario con rol Administrador al presionar el botón "Exportación Masiva" en alguno de los  informes, lo lleva a la pantalla "Monitor de Exportación de Informes" pero en lugar de mostrarle información le muestra un cartel rojo " " Diríjase al capítulo 5-Módulo de Administración, sección "Información de Configuración", fileDirectory.La ruta no existe o es errónea. Contacte al Administrador.

Capítulo 4 - Módulo de Negocio

Menú de Negocio

Desde este menú se podrá acceder a la creación de nuevas "Compañías".

Compañías

Al loguearse un usuario habilitado en la "Compañía " accederá directamente a la pantalla de " " del módulo de > .   Solo desde la " se podrá Principal Administración de compañías Negocio Compañía Compañía Principal"acceder a este módulo.

Dentro la pantalla , se listaran las primeras 10 compañías que se encuentren dadas de alta en la base, independientemente de su estado, pudiéndose filtrar por el nombre de la compañía, Administración de CompañíasCUIT o estado (Activa o Inactiva). Desde esta pantalla podrán darse de alta, editarse o deshabilitarse compañías.

No podrán darse de alta nuevas compañías con perfil "PRINCIPAL", solo habrá una compañía con este perfil por instalación.

Por default, en el primer logueo a la consola de , se mostrara la compañía "Synthesis" que será la " ", a la cual podrá cambiársele el nombre, la descripción, asignársele un CUIT pero PROMO PRINCIPAL Compañía Principalno podrá deshabilitarse ni cambiar su código.

Para dar de alta una nueva compañía se deberá dar clic en el botón " " y se accederá a la ventana de " ".Nuevo Crear Compañía

Código: Se debe identificar un código de compañía. El dato es requerido para el alta de la nueva Compañía.

Nombre: Nombre propio con el cual se identificará esa compañía. El dato es requerido para el alta de la nueva Compañía.

Descripción: Podrán ingresarse datos adicionales referentes a la Compañía que se está creando.

CUIT: en caso de poseer, se indicara aquí el CUIT de la compañía.

Activo: Indica si la Compañía que se está creando estará Activa o no. Si se genera una Compañía y no se activa, ésta no aparecerá disponible para su selección en los distintos menús donde deba seleccionarse una Compañías. 

Módulos: Deberá indicarse para cada compañía que se dé de alta que módulos ha adquirido, los módulos de Negocio y Promo se encontraran tildados por default y no podrán destildarse.

Una vez completo todos los campos, se deberá presionar " " para que la compañía sea dada de alta. Se mostrara entonces la ventana de " " donde podrán customizarse los atributos de cada uno Guardar DEFINIR COMPAÑÍAde los elementos correspondientes a los módulos que se hayan habilitado.

Dependiendo de los módulos adquiridos se mostrarán más o menos elementos y atributos en la pantalla de "Definir Compañía" .

( : la opción está disponible a partir de la versión 7.0.18, por default viene desactivada. Para que el usuario final pueda utilizar el "Tipo de beneficio" "No Monetario", Clase de Beneficio "Monedero", se debe Nota Monederoactivar esta propiedad)

Luego de editados los elementos de la compañía a dar de alta, presionar "Guardar" y se mostrara en la pantalla " " la nueva compañía generada.Administración de Compañías

Capítulo 5 - Módulo de AdministraciónEl módulo de permite realizar ajustes dentro de la consola de permitiendo gestionar tareas programadas, configuraciones de base de datos, seteos comunes para todas las compañías Administración PROMO PRINCIPALasí como también visualizar los registros de auditoria de todas las compañías dadas de alta en PROMO.

Menú de Administración

Desde este menú se podrá acceder a las siguientes secciones:

Tareas Programadas

En esta sección se podrá configurar la frecuencia con que se ejecutaran distintos procesos que tiene como fin el mantenimiento de los datos manejados desde la consola.

Los procesos disponibles son:

Importación de Catálogos: Aquí podrá ejecutarse la tarea de importación de catálogos de manera manual así como también configurar la frecuencia con la que se ejecuta el proceso de búsqueda e importación de nuevos s de catálogos. 

Eliminar registros de las tablas de importación: Aquí podrá ejecutarse la tarea de eliminación de registros de las tablas de importación, así como también podrá configurarse la frecuencia con que se limpiaran las tablas de Importación de datos externos. 

Eliminar registros de auditoria: Podrá ejecutarse de forma manual el proceso de eliminación de registros de auditoria y también podrá configurarse la frecuencia con que se limpiaran las tablas de Auditoria de manera automática. 

Eliminar registros de transacciones y errores en reverso: Podrá ejecutarse de forma manual el proceso de eliminación de transacciones y errores en reverso así como también podrá configurarse la frecuencia con que se limpiaran estos registros de manera automática. 

Importación de Compañías: En el caso de que se esté trabajando con una integración de PROMO con Bridge esta tarea traerá desde el servidor configurado las compañías dadas de alta en Bridge y las dará de alta en PROMO con la configuración de compañía indicada y actualiza en Promo las tiendas importadas. 

Realiza un backup de la base de datos: Podrá ejecutarse de forma manual el proceso de backup de toda la base de datos de PROMO así como también podrá configurarse la frecuencia con que se corre este proceso de manera automática. 

Actualización de estados de entidades: Aquí se configura la frecuencia con que se realiza la actualización de los estados de tarjetas de fidelidad y cupones, así como correr el proceso de manera manual cuando se desee. 

Finalización de transacciones: Aquí podrá configurarse con qué frecuencia se procesaran las transacciones provenientes del motor así como también la actualización de datos provenientes de la emisión y redención de cupones e imputación o descuento de saldos de tarjetas de fidelidad y correr el proceso de manera manual cuando se desee. 

Proceso de vencimiento de puntos: Aquí se configura la frecuencia con que se corre el proceso que chequea los puntos a vencen de las tarjetas de fidelidad y los pasa a "Vencidos", así como correr el proceso de manera manual cuando se desee. 

Proceso de actualización de Limites: Aquí se configura la frecuencia con que se ejecutara el proceso de actualización y reinicio de los límites en las promociones, así como correr el proceso de manera manual cuando se desee. 

Importación de entidades: Aquí se configura la frecuencia con que se ejecutara el proceso de importación de datos de externos a la consola de PROMO, así como correr el proceso de manera manual cuando se desee. 

Proceso para recolectar información para las Views: Aquí se configura la frecuencia con la que se procesa la información que llega a PROMO para abastecer los gráficos de los Dashboard, así como correr el proceso de manera manual cuando se desee. 

Informa el estado de la Consola y Motor: (a partir de Promo 7.0.4) Este proceso se utiliza para el posteo del status de motor y consola en las colas RabbitMQ.  

Exportación de Tipos de Tarjetas y Cupones a Bridge (SOAP) – Solo En Integraciones con Bridge: (versiones anteriores a 7) En el caso de que se esté trabajando con una integración de PROMO con Bridge esta tarea informara a Bridge los prefijos de cupones y tarjetas generados en PROMO cada un determinado período configurado. 

Importante

El Job sts.console.job.ConsoleStatusJob por defecto se ejecutará cada 5 minutos, pudiendo modificar el tiempo de ejecución desde  .: (ingresando con el usuario principal):Administración ->Tareas programadas

Ingresando en la consola de Promo con el usuario administrador, la siguiente configuración debe ser mayor a la definida en el job (imagen anterior). Por ejemplo configurar el doble de tiempo:

(a partir de Promo 7.0.4):

Información de configuración

Dentro de éste módulo se podrán configurar distintas opciones, claves y valores de accesos propios de la consola de .PROMO PRINCIPAL

Las configuraciones disponibles son:

  Módulo

Clave Valor Descripción

1 Promo

Operative.system

Windows Sistema Operativo donde se encuentra operando Promo.

2 Negocio

lang es_AR Lenguaje en que operará la Consola. Actualmente hay tres opciones: es_AR (español Argentina, es_MX(español Mexico) y pt_BR (portugués Brasil). Esto afecta además del lenguaje, la configuración regional de la consola.

Nota: luego de que el super usuario cambia el idioma, el usuario (ej administrador) debe cerrar sesión y volver a loguearse para tomar correctamente todos los cambios).

3 Negocio

backupDirectory C:\synthesis\promo\backup Directorio donde se encuentran los ejecutables de mongodb (Suele ser el path de instalación + bin)

4 Negocio

mongoDBDirectory

C:\synthesis\promo\mdb\bin Directorio donde se encuentran los ejecutables de mongodb (Suele ser el path de instalación + bin)

5 Negocio

mongoDBHostname

localhost Host de la base de datos

6 Negocio

mongoDBPort 27017 Puerto de la base de datos

7 General

auditDateCleaner

30 Eliminar registros de las tablas de importación.

8 General

importReceiptDateCleaner

30 Eliminar registros de las tablas de importación.

9 General

ticketGeneratorSeconds

2 DEMO: cantidad de segundos de generación de ticket para demos

10 General

quartz.cronExpression.databaseJob

0 0 1 1/1 * ? * GENERAL: planificación de resguardo de la base de datos.

11 Promo Bridge

soap.url http://xx.x.xx.xx:8080/bridge/services/bridgeCoreSOAP?wsdl_

URL de conexión a la base de datos de Bridge por medio del servicio SOAP. Solo disponible en Instalación PROMO - BRIDGE

12 Promo

engineSalePath C:/synthesis/gengine/engine/sales/

Directorio de Mapas del Motor

13 Promo

fileDirectory C:\synthesis\promo\export\ (a partir de Promo v7.0.3 y 7.1 en adelante) en este directorio se van a bajar los archivos que se exportan con el botón "Exportación Masiva" que se encuentra en los informes. Este directorio se crea automáticamente al realizar la instalación de Promo. Pero debe tenerse en cuenta que si se hace una actualización en lugar de una instalación desde cero, debe crear a mano este directorio.

Registros de auditorias

Desde la consola de se permite llevar un control de auditorías filtrando por compañía, fecha desde y hasta, por un tipo de usuario, dependiendo el módulo y la operación o acción realizada. PROMO PRINCIPALDesde esta sección se podrán visualizar las acciones ejecutadas por los distintos de las consolas de promociones de cada cliente, pudiendo acceder al detalle de cada acción por medio del icono que se usuarios/compañíasencuentra al final de cada línea.

Atributos de elementos

Esta opción se utiliza para poder gestionar desde la consola de  todos los atributos de todos los elementos disponibles al momento de dar de alta promociones desde la consola de PROMO.PROMO PRINCIPAL 

La administración de se realiza ingresando a   con el  . Desde allí podrán darse de alta nuevos atributos para las compañías que estén presentes en la consola.Atributos Dinámicos PROMO PRINCIPAL Usuario Principal

Podrá habilitar la "Gestión de Atributos de los Elementos" para una una compañía, para un rol determinado,  .solo cuando ésta no comparta la instalación de Promo con otra compañía en un mismo servidor

Si el Usuario Principal habilita la "Gestión de Atributos de Elementos", el usuario con el rol al que se le hayan asignado los permisos, podrá ver y gestionar desde la consola de Promo los "Atributos de Elementos".

Para mas información acerca del los atributos de los elementos, ver " ".Manual de usuario Final Promo 7.0 - Modulo de Administración - "Atributos de los Elementos

Capítulo 6 - Módulo de Seguridad

Menú de Seguridad

Desde esta opción de menú se podrá asignar accesos a los roles disponibles y administrar los usuarios.

Al darse de alta una nueva , se generarán automáticamente los usuarios "Admin" y "TransactionTicket Sender".Compañía

IMPORTANTE

En caso de que la instalación de Promo sea compartida por mas de una compañía NO DEBERA HABILITARSE a los usuarios "admin" de las compañías los permisos de alta y edición de Atributos .Dinámicos

El usuario (nombre de usuario) "admin", nombre y apellido "Admin", será el usuario dado de alta por default que podrá loguearse en la nueva compañía y operar en ella generando promociones, mapas etc.

El usuario "sender" (TransactionTicket Sender) es el usuario generado por default para la comunicación cuando se tengan que gestionar datos de fidelidad y dashboards. Este usuario no será válido para Promo-Motorloguearse y operar en la consola.

Desde la consola de podrán darse de alta usuarios para todas las compañías.PROMO PRINCIPAL

Configuración para Eliminación de datos del cliente:

(A partir de la v 7.0.18) Ingresando a la Consola de Promo con el usuario Principal, podrá ver el  . Por defecto el usuario con rol administrador tendrá activo este permiso. Pero si alguna permiso "Eliminar datos del cliente"compañía desea no mostrar esta opción podrá ingresar con el usuario principal y sacar este permiso que viene por default al rol administrador y así nadie tendrá acceso a eliminar clientes o sus datos relacionados con fidelidad.

Administración de usuarios

Dentro de esta sección se podrán gestionar cada uno de los usuarios que provee la consola de por default, así como también podrán crearse nuevos usuarios o editar existentes, ya sea para la "PROMO PRINCIPAL Compa" como para las demás compañías dadas de alta en la consola de .ñía Principal PROMO PRINCIPAL

Creacón de Usuario

El usuario "Synthesis" (Usuario por default de la " ") o cualquier otro usuario que se dé de alta con el rol de " " no podrá deshabilitarse, siempre y cuando sea el único usuario de la "Compañía Principal Principal Compañía " activo.  De existir otro usuario de la " " activo podrá desactivarse el usuario "Synthesis".Principal Compañía Principal

Los usuarios que se den de alta con el rol de "Principal" solo podrán pertenecer a la " ", (Compañía Principal compañía 1, default "Synthesis").

Desde el botón " " que se encuentra al final de cada renglón que describe un usuario, podrá editarse el perfil del usuario o realizar el cambio de contraseña.Acciones

Para dar de alta nuevos usuario habrá que presionar en el botón " " y se presentará la siguiente pantalla:Nuevo

Deberán indicarse los siguientes datos para dar de alta un nuevo usuario correctamente:

Nombre de usuario: será el usuario de login para acceder a la consola. Es un campo obligatorio.

Password: Será la contraseña que deberá de ingresarse para acceder a la consola. Deberá ingresarse una contraseña entre 6 y 16 caracteres de longitud, y que contenga al menos una letra minúscula, una mayúscula y un número. Es un campo obligatorio.

Confirmar password: repetir contraseña ingresada en el paso anterior. Es un campo obligatorio.

Nombre y Apellido: Se deberá indicar nombre y apellido real del usuario que se está dando de alta. Es un campo obligatorio.

Correo electrónico: podrá ingresar el correo electrónico del usuario. Es un campo opcional.

¿Expiración de contraseña?: aquí podrá indicarse si la contraseña vence luego de un determinado período de tiempo, configurable, contabilizado desde la primera vez que accedió a la consola.

¿Bloquea sin actividad?: Indica si el usuario se bloquea luego de un determinado período de tiempo configurable, y luego deberá volver a loguearse.

¿Debe cambiar clave?: Indica si el usuario debe cambiar la clave al primer ingreso a la consola.

Habilitado: deberá tildarse para que el usuario que se está creando pueda acceder en la consola de PROMO.

Deshabilitar a partir del: podrá indicar a partir de que fecha este usuario quedará deshabilitado. Es un campo opcional. Si no ingresa una fecha, no se deshabilitará automáticamente el usuario.

Compañía: deberá indicarse a que compañía de las existentes pertenecerá el nuevo usuario.

Roles disponibles: Podrán asignarse uno de los siguientes roles disponibles:

Administrador: tiene accesos y permisos para todos los módulos de la consola de adquiridos por la compañía.PROMO

Principal: solo tendrá acceso a la consola de y podrá dar de alta nuevas compañías y usuarios.PROMO PRINCIPAL

Operador: podrá crear promociones, mapas, cupones.

Administrador de negocios: podrá acceder al modulo de negocios e informes.

TicketSender: usuario que comunicará consola de PROMO y Motor.

Asociación a Workflows: Podrán asignarse los Workflows a los cuales tendrá acceso el usuario. Si está logueado con el usuario principal, sólo verá en este listado el workflow general. Si está logueado con un usuario administrador, verá el listado con todos los workflows.

Edición de Usuario

En la pantalla "Administración de Usuarios" al seleccionar el botón Acciones\ Editar, se podrán modificar todos los datos del usuario a excepción del "Nombre de usuario" que aparecerá grisado y no será editable. 

Si se desea modificar el "Nombre de usuario" (como no está permitido hacerlo) deberá desactivar este usuario, sacándole el check "Habilitado" y crear un usuario nuevo.

Eliminación de Usuario

No está permitida la eliminación de usuarios por lo que si se desea hacer eso debe ingresar en la pantalla "Administración de Usuarios", seleccionar el botón Acciones\ Editar, y desactivar este usuario, sacándole el check "Habilitado".

Configuración de roles

La consola de permite configurar el ROL que le será asignado a cada usuario de una determinada compañía, (PROMO PRINCIPAL pudiendo a su vez, asignarle a cada ROL determinados accesos y restringirles otros).

El sistema logueará cuando se asignen nuevos permisos a un usuario, o se modifiquen o eliminen. Quedará guardado que usuario, en fecha y hora realizó modificaciones.

Desde el menú "Seguridad" –solo desde la – deberá clikearse sobre el título "Configuración de Roles" y accederá a la siguiente pantalla desde donde se podrán editar los distintos roles disponibles en "Compañía Principal"la consola de , así como también podrán darse de alta nuevos roles en caso de ser necesario.PROMO PRINCIPAL

Nuevo Rol

Para el alta de un nuevo rol deberá oprimirse el botón " " en la pantalla "Configuración de Roles" y se accederá a la siguiente pantalla:Nuevo

Campos a completar:

Código: puede ingresar un código compuesto por letras, números, espacios o _. Será el código que identificará a ese rol.

Descripción: ingresar un breve detalle del nuevo rol. 

Página de inicio: se debe seleccionar una de las siguientes páginas de inicio que será mostrada al usuario que tenga asociado ese rol, una vez que se loguea.

Permisos de Edición: debe ingresar un valor numérico entero mayor a 1. El valor ingresado en Permisos de Edición aplica entre los roles, indicando los permisos de edición de éstos, es decir que a mayor número, menores son los permisos de edición de roles del usuario que lo tenga asignado. Por ejemplo, un administrador con Permiso de Edición 1 podrá editar los roles que tengan permiso de edición 2, 3, 4, etc mientras que un usuario con Permisos de Edición 4 no podrá editar los roles que tengan permisos de edición 1, 2 o 3. Tener en cuenta que deberán darse los accesos correspondiente a cada nuevo rol para que el usuario al que se le asigne pueda acceder a la consola según los permisos otorgados.

IMPORTANTE

Al crear un nuevo Rol, por default el sistema le asignará a ese Rol, los mismos permisos que tiene definidos por default el usuario Operador.

Una vez completos los datos, oprimir el botón " " y el nuevo ROL estará creado.Guardar

Editar rol

Al seleccionar Seguridad\ Configuración de Roles\ botón "Acciones" sobre el rol deseado y luego opción " ", permitirá modificar la descripción de ese rol, la página de inicio y los permisos de edición que tiene.Editar

Al editar el ROL "Principal" (rol exclusivo de los usuarios de la "Compañía Principal") solo podrá asignársele como página de inicio "Creación de compañías" la cual es exclusiva para este ROL.

Eliminar rol

Al seleccionar Seguridad\ Configuración de Roles\ botón "Acciones" sobre el rol deseado y luego opción "Eliminar", solicitará confirmación para eliminar el rol seleccionado. Los roles Administrador y Principal no podrán eliminarse (la opción "Eliminar" se mostrará grisada). Si se intenta eliminar un rol que está en uso, ese rol no podrá ser eliminado.

Configuración de Accesos

Esta configuración permite restringir y asignar diferentes accesos a los distintos roles disponibles.

Al seleccionar Seguridad\ Configuración de Roles\ botón "Acciones" sobre el rol deseado y luego opción " " mostrará una pantalla como la siguiente: Configuración de accesos

En la  mostrará el código, descripción y permisos de edición del rol seleccionado. sección "Detalle del Rol"

En la   si está logueado con el usuario principal mostrará un combo seleccionable por compañía, de esta forma se podrán ir asignando y desasignando los permisos para el rol sección "Aplica a la Compañía"seleccionado por compañía. Si está logueado en una compañía solo podrá cambiar los permisos de esa compañía en la que está logueado y si es que tiene permisos para hacerlo.

En la   mostrará los combos seleccionables: "Categoría" y "Subcategoría", y a la derecha el campo "Permiso". A medida que se va escribiendo en este último campo, el sistema irá sección "Permisos asignados"mostrando debajo, los permisos con ese nombre. Si se selecciona una Categoría, en el campo Subcategoría mostrará las contenidas en la categoría seleccionada y en el listado mostrará sólo los permisos contenidos en esa Categoría y/o Subcategoría. A la derecha de cada permiso encontrará un check seleccionable para poder habilitar o deshabilitar cada permiso. En la parte superior de la columna donde se muestran los checks estará disponible el check "Selecc. Todos" que permite seleccionar o desmarcar todos los permisos listados.

Podrán seleccionarse " " y/o en los correspondientes cuadros de selección o checkbox (aclararemos que al " " sobre el recuadro de un rol disponible, se le estará otorgando el acceso a esa acción, tildando "des-tildando" tildary que al " " se le estará restringiendo el mismo).des-tildar

Para finalizar la configuración, deberá oprimirse el botón " " en la parte inferior izquierda de la pantalla.Guardar

Capítulo 7 - Módulo de Soporte

Menú de Soporte

Desde esta sección se podrán reiniciar configuraciones y gestionar backups de la base de datos.

IMPORTANTE

Una vez que se cambian los permisos a un usuario existente, este debe desloguearse y volver a loguearse para que los permisos sean efectivos.

Nota

ABM de Atributos de Elementos:  Solo el super usuario puede dar ese acceso a algún rol.  

(Opción Configuración de Motores a partir de Promo v7.1)

Inicializar configuraciones

Desde esta sección se podrán resetear permisos y configuraciones de acceso tanto de la consola de como de las consolas de de las compañías dadas de alta, a sus valores por defecto.PROMO PRINCIPAL PROMOEl Pop-Up que se mostrara cuando se presione en " " será la siguiente:Inicializar Configuraciones

Al realizar el reset, los permisos y configuraciones de todas las compañías volverán a sus valores por default.

Gestor de backups de BBDD

El gestor de backups permite realizar copias de seguridad de todas las acciones que se generan dentro de la consola tanto de como de las consolas de de cada una de las empresas dadas de PROMO PRINCIPAL PROMOalta, estas copias se realizaran una vez por día a las 00.00 hs

El backpup que se genera es de toda la base con los datos de todas las acciones de todas las compañías. Desde la siguiente ventana podrán restaurarse los backups generados en caso de ser necesario.

Log de la Consola

Mostrará detalle de los errores producidos en la consola de Promo. Permite descargar los archivos con el detalle del log seleccionándolo desde la columna "Descargar" y presionando el botón "Descargar".

Configuración de Motores

Para mas información acerca de la configuracion de Motores, ver " ".Manual de usuario Final Promo 7.0 - Modulo de Soporte- "Configuración de Motores

Capítulo 8 - Apéndice

Preguntas frecuentes

A continuación se listarán algunas preguntas que podrán surgirle mientras utilice la consola administradora.

No se visualiza en forma correcta la aplicación de la consola en el browser

Para una correcta visualización, verificar que la versión del browser o navegador utilizada sea igual o superior a las listadas a continuación:

FirefoxChrome

No puedo ingresar a la consola con mi usuario

Tanto el usuario como la clave y la compañía deben ser ingresados del mismo modo que se encuentre registrado. Si el usuario se registró con mayúsculas también deberá ingresarse en la consola de igual modo.

error 404 – Pagina No Encontrada

De presentarse una pantalla de error en conexión al momento de intentar loguearse a la consola de PROMO, deberá como primera medida chequearse la URL por la que se intenta acceder a la consola, así como también las conexiones de red del equipo desde el cual se está queriendo acceder. Si los puntos anteriores se encuentran correctos, beberá de contactarse al administrador de sistemas a fin de chequee que los servicios que se ejecutan cuando inicia PROMO estén corriendo correctamente. Los servicios que deberán estar ejecutándose son:

Wildfly (consola de PROMO)MongoDB (Base de datos de PROMO)PromoSimEngine (Motor de Simulación)PromoEngine (Motor de PROMO – atiende requerimientos de los puntos de ventas y demás servicios que lo invoquen)