Image Modified

PROMO 7.4 - Manual de Instalación

Introducción

PROMO es una solución que permite separar el manejo de promociones del punto de venta.
Cuenta con dos grandes componentes: el "Motor de promociones", encargado de calcular las promociones participantes cuando se realiza una transacción en el punto de venta e informarlas al mismo una vez finalizado el cálculo; y la "Consola de administración", encargado de brindar una herramienta centralizada de administración.
El presente manual ilustra sobre cómo realizar la instalación de ambos componentes y las diferentes opciones que pueden ser configuradas para su funcionamiento.

...

<server>
	<useRoleAccessRestrictions>false</useRoleAccessRestrictions>
	<usersDefinition>./conf/engineUsers.properties</usersDefinition>
	<configurationDirectory>./conf</configurationDirectory>
</server>

Archivo  de Usuarios (engineUsers.properties)

El formato del archivo de usuarios cumple el siguiente patrón:

...

• [promo.MIDDLEWARE.MESSAGING]- WARNING: INVALID TICKET: cvc-datatype-valid.1.2.1: 's250.0' is not a valid value for 'double'.
  Indica que se ha recibido una petición o ticket que posee un valor o tipo de dato inválido. En este caso, el motor dará un mensaje de respuesta con un código de error (ver "Manual de mensajería – Promo").

Âncora
_Toc513638226 _Toc513638226

Información de Configuración - CONSOLA DE PROMO

Existen parámetros de configuración que pueden ser modificados para personalizar el comportamiento de PROMO.
Algunos de estos parámetros solo estarán disponibles en la consola de PROMO Principal y otros podrán ser editados desde la consola de PROMO de cada compañía.
Estos parámetros se encuentran en la Consola de PROMO, Menú "Administración" >> "Información de Configuración" y son:

...

...

...

Los eventos que serán enviados a QRadar en una primera instancia son los correspondientes a usuario: login, logout, login failed, nuevo usuario, modificación de usuario.

PROMOPLUS.PROPERTIES - Parámetros Base de Configuración de Ambiente

En esta sección se enumeran detallan las opciones de configuración que afectan al funcionamiento del ambiente definen el comportamiento del sistema en su totalidad y se realiza desde el . Estas configuraciones se gestionan a través del archivo promoplus.properties.

...

promo.general.pauseQuartz

...

1. Validar CVV solo cuando se realiza un consumo en una Tarjeta de Fidelidad

Se disponibiliza la posibilidad de poder indicar por configuración que el CVV de una tarjeta de Fidelidad solo sea validado cuando se realiza un consumo de saldos en ella.

La tarjeta debe de tener activa la opción de CVV requerido en su tipo de tarjeta.

Para habilitar esta opción deberá definirse en el archivo "promoconfig.properties" el parametro promo.general.cvvOnlyForConsume = true

Image Removed

...

2. Configuración Atributos con espacios en Condiciones Simples

En Promo 7 por default no se puede ingresar en Condiciones Simples atributos con espacios, al ingresar el espacio toma como completo el nombre del atributo ingresado, como cuando se presiona la barra espaciadora:

Image Removed

Por configuración se puede cambiar y permitirá ingresar espacios en blanco en los atributos ingresados. Para eso debe editar el archivo promoplus.properties y agregar la siguiente línea:

promo.delimiters = no-space 

Con esta configuración para que interprete que se terminó de escribir el elemento debe presionar la tecla tab.

Image Removed

Si ingresa el parámetro: promo.delimiters = space funciona como viene por default, que no permite ingresar espacios dentro del texto ingresado en los atributos.

...

3. Alta de cliente durante la transacción

Para que el alta de clientes pueda efectuarse al momento de procesarse una transacción, deberá de habilitarse en el archivo de configuraciones de la Consola de Promo (“promoplus.properties”) el siguiente atributo:

...

 # Habilita el alta de clientes on the fly

promo.allowNonExistingCustomers = true

Una vez actualizado, deberá de reiniciarse el Wildfly para que los cambios sean tomados correctamente.

Los clientes serán creados utilizando el estado "loyaltyValidation" en el caso de enviarse los datos mínimos y al mismo tiempo Promo detecte que el cliente no existe.  Los datos mínimos mencionados son (marcados en Rojo): 

<customer-add seq="1" id="10090504" identifier="10090504" type="test" name="pepe" lastName="rodrigues" identifierType="cpf" email="mimail@test.com" />

<?xml version="1.0" encoding="UTF-8"?>
<message companyId="napse" store="1" terminal="1" date-time="2020-11-03 11:11:22" init-tck="true" messageId="1" void-trx="false" response="true" status="loyaltyValidation" evaluate="true" map-version="2" tckpath="Y" suggest="true">
<customer-add seq="1" id="47001517" identifier="47001517" type="test" name="bruno" lastName="Lopez" identifierType="cpf" email="[email protected]" />
</message>

Nota: Para mas información ver "Manual de Integración 7.3 - Motor" - LoyaltyValidation.

...

, un archivo clave que controla aspectos críticos del entorno, como el acceso a la base de datos, parámetros de conexión, rutas de almacenamiento de archivos y otras configuraciones necesarias para el funcionamiento óptimo de la consola de PROMO.

Cada parámetro dentro de este archivo permite ajustar y personalizar la instancia de la consola, facilitando su integración en diferentes entornos y requisitos del negocio. Es fundamental que los administradores y técnicos responsables de la instalación y mantenimiento de la consola comprendan el impacto de cada uno de estos parámetros, ya que algunos de ellos controlan la comunicación con servicios externos, la seguridad de los datos, y el rendimiento general del sistema.

El archivo promoplus.properties también puede ser utilizado para realizar ajustes iniciales y actualizaciones del sistema, garantizando que las configuraciones predeterminadas establecidas por la empresa se mantengan, mientras se permite flexibilidad para personalizaciones específicas según sea necesario. A continuación, se presenta una lista completa de los parámetros disponibles, junto con sus valores por defecto y descripciones, que deben ser revisados y, en su caso, modificados antes de iniciar la operación del sistema.

Acceso a base de datos

Valores de Configuración por defecto (solo primera ejecución)

Configuración de Twitter

Configuraciones Generales

Parámetros Loyalty Generales

REST API para Audience

PROMOPLUS.PROPERTIES - Parámetros Adicionales para Personalización del Sistema

En esta sección se detallan los parámetros adicionales que pueden ser configurados en el archivo promoplus.properties para adaptar el comportamiento de la consola de PROMO según los requerimientos específicos de cada cliente. Estos parámetros permiten modificar elementos clave relacionados con programas de fidelización, gestión de clientes, procesamiento de transacciones y presentación de datos en la consola. Los valores configurados en esta sección otorgan flexibilidad al sistema, permitiendo personalizar aspectos como la validación de datos de clientes, la ejecución de tareas en segundo plano, y la manera en que se gestionan las respuestas de servicios externos. Ajustar estos parámetros correctamente asegura que la consola funcione de acuerdo con las necesidades específicas del entorno en el que se despliega.

<?xml version="1.0" encoding="UTF-8"?>
<message companyId="napse" store="1" terminal="1" date-time="2020-11-03 11:11:22" init-tck="true" messageId="1" void-trx="false" response="true" status="loyaltyValidation" evaluate="true" map-version="2" tckpath="Y" suggest="true">
<customer-add seq="1" id="47001517" identifier="47001517" type="test" name="bruno" lastName="Lopez" identifierType="cpf" email="[email protected]" />
</message>

Configuración de CAPTCHA en promoplus.properties

El CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart) es una medida de seguridad diseñada para proteger la consola de PROMO contra accesos automatizados o bots malintencionados. Su objetivo es asegurar que solo usuarios humanos puedan interactuar con ciertos elementos del sistema, evitando posibles ataques automatizados y garantizando la seguridad de las transacciones.

En PROMO, el CAPTCHA se puede personalizar a través del archivo promoplus.properties, permitiendo ajustar elementos como el tamaño y tipo de fuente, y definir si la solución del CAPTCHA se almacena en la sesión o en las cookies. Estas configuraciones ofrecen flexibilidad en la implementación del CAPTCHA, asegurando que se adapte a las necesidades específicas de cada entorno, manteniendo un equilibrio entre seguridad y usabilidad para los usuarios.

A continuación, se detallan las propiedades disponibles para la configuración del CAPTCHA:

...

CONFIGURACIONES PARA EL ALTA DE CLIENTE DE REGISTRO BÁSICO (pre-fidelizado)

...

INTEGRACIÓN CON DIRECTOR

Se debe utilizar la versión de Director 2.0 que no es compatible con la versión 1.

...

Âncora
_Toc513638231 _Toc513638231

Resolución de problemas

...