MANUAL DE INSTALACIÓN

PROMO 7.0

Índice

...

• Wildfly 9.
• PromoSimEngine x.x (motor de simulación)
• MongoDB 34.62

Los servicios de MongoDB, Wildfly y PromoSinEngine quedaran instalados y podrá optarse al momento de la instalación si se ejecutan al terminar el proceso de instalación o bien si se iniciaran a mano, en caso de ser necesario realizar configuraciones previas el inicio de los servicios. 
Respecto del servicio Wildfly, inicialmente vendrá configurado por defecto el directorio sugerido, ocupando el puerto 8080
Al finalizar el instalador se crearán todos los servicios y directorios correspondientes.

...

• synthesis\promo\images: directorio de las imágenes
• \synthesis\promo\images\profile
• \synthesis\promo\images\barcode: contiene las imágenes de códigos de barras asociados a cupones emitidos.
• \synthesis\promo\images\promotion: contiene las imágenes que se asocien a las promociones
• \synthesis\promo\logs: información sobre las trazas de ejecución de la aplicación, incluyendo información técnica ante cualquier falla.
• \synthesis\promo\backup: backups de la base de datos MongoDB
• \synthesis\promo\import: directorio donde deberán alojarse los mapas para la importación de promociones.
• \synthesis\promo\mdb: aquí se encuentran las funciones utilizadas en la base de datos.
• \synthesis\promo\engine: el motor de promociones que utiliza la consola para la simulación de las mismas.
• \synthesis\promo\catalogs: directorio donde se alojaran los archivos de catálogo (.catalogs) que se importaran al iniciar la aplicación. Deberán generarse de manera manual las carpetas correspondientes a cada compañía, indicando en el nombre del directorio el ID de la compañía. (Ej.: \synthesis\promo\catalogs\22 donde 22 corresponde al ID de la nueva Ccia)
• \synthesis\promo\export: (a partir de Promo v7.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.

Âncora
_Toc472761279 _Toc472761279

Âncora
_Toc473099930 _Toc473099930

Âncora
_Toc513638201 _Toc513638201

Instalación Linux (CentOS 7)

Es requisito que antes de realizar la instalación de la consola estén instaladas los siguientes componentes:

• MongoDB 34.62
• JDK 1.8.0_25

Junto con la consola de PROMO, durante el proceso se instalarán el motor de simulación y Wildfly.

Âncora
_Toc441587758 _Toc441587758

Âncora
_Toc472761280 _Toc472761280

Âncora
_Toc473099931 _Toc473099931

Âncora
_Toc513638202 _Toc513638202

Instalación MongoDB

...

4.

...

2

Se pueden seguir los pasos en la documentación de instalación online de Mongo.

Linux: https://docs.mongodb.com/v3v4.42/tutorial/install-mongodb-on-red-hat/

...

<!--Directorio de trabajo del cache de datos interno utilizado por el motor, en caso de no especificarse el motor usa "./data" -->
<cachedata>
 <directory>data</directory>
</cachedata>

Optimización de carga de mapas en motor

...

(a partir de Promo v7.1)

Esta mejora consiste en habilitar la utilización de mapas pre-compilados, significa que el motor, luego de procesar un mapa xml generado por consola, guardará archivos compilados de mapas, promociones e indices en el directorio indicado, para que en caso de reiniciar el motor, cargar los mapas compilados en vez de cargarlos desde el xml, lográndose con esto un mejora de tiempo sustancial en mapas grandes.

...

	Módulo	Clave	Valor	Descripción
1	Promo	operative.system	windows	Sistema operativo
2	Promo	soap.url	http://10.4.13.108:8280/bridge/services/bridgeCoreSOAP?wsdl	Dirección de web service de bridge.
3	Negocio	lang	es_AR (Argentina)	General: idioma de la aplicación (etiquetas)
4	Negocio	backupDirectory	C:/synthesis/promo/backup	General: de backup
5	Negocio	mongoDBDirectory	C:/synthesis/promo/mdb/bin	General: directorio base de datos
6	Negocio	mongoDBHostname	localhost	8	General	Host de la base de datos
7	Negocio	mongoDBPort	27017	Puerto de la base de datos
.  En caso de poseer una configuracion en replicaset el formtao de configuracion es: "replicaName/node1:port1,node2:port2" Se destaca que deberá de definirse el campo mongoDBPort vacío cuando se utilice la función de Backup en Clusters
7	Negocio	mongoDBPort	27017	Puerto de la base de datos.  En caso de replicaset este parametro es ignorado.
8	General	auditDateCleaner	30	Eliminar registros de las tablas de importación.
9	General	importReceiptDateCleaner	30	Eliminar registros de las tablas de importación.
10	General	ticketGeneratorSeconds	2	DEMO: cantidad de segundos de generación de ticket para demos
11	Negocio	charsMaximumAlphabetical	20	Cantidad máxima de caracteres alfabéticos
12	Negocio	charsMaximumNumerical	20	Cantidad máxima de caracteres numéricos
13	Negocio	charsMaximumQuantity	20	Cantidad máxima de caracteres totales
14	Negocio	charsMaximumSpecial	20	Cantidad máxima de caracteres especiales
15	Negocio	charsMinimumQuantity	7	Cantidad mínima de caracteres totales
16	1Negocio	charsMinimumUser	3	Cantidad minima de caracteres en el nombre de usuario
17	Negocio	maximumLoginFailedCount	3	Cantidad máxima de reintentos de login fallidos sucesivos
18	Negocio	numberQuantity	1	Cantidad mínima de caracteres numéricos
19	Negocio	passwordExpirationDays	30	Días de expiración de la contraseña del usuario
20	Negocio	specialCharsQuantity	0	Cantidad mínima de caracteres especiales
21	Negocio	stringQuantity	1	Cantidad mínima de caracteres alfabéticos
22	Negocio	userBlockDays	90	Bloqueo de usuario - días de inactividad
23	Negocio	userLockTime	30	Periodo de bloqueo de la cuenta de usuario (en minutos)
24	Promo	engineSalesPath	C:/synthesis/promo/engine/sales/	Directorio de Mapas del Motor

...

20

Modulo	Clave	Valor	Descripción
1	Cupones	barcodePath	C:/synthesis/promo/images/barcode/	Directorio imagenes de codigos de barra2
Cupones	barcodeUrl	http://localhost:8080/promo/assets/barcode/	Url imagenes de codigos de barra3
Promo	fileDirectory	C:/synthesis/promo/catalogs/napse\	Importación de catálogo: directorio donde estarán los archivos4
Negocio	moneySymbol	$	Símbolo de moneda
5	Tarjetas de fidelidad	max.qty	999	Cantidad máxima de tarjetas a generar por cada operación de alta masiva
6	Tarjetas de fidelidad	isEditableAfterCardsGeneration	false	Permitir la edición del tipo de tarjeta luego de haber generado una tarjeta activa
7	Tarjetas de fidelidad	prefix.active	false	Utilizar prefijo númerico incremental para tipos de tarjeta
8	Cupones	CODE128	PPPSSSTTTnnnnnnnnnnnnnnnnnn	Formato de código de barras CODE1289
Cupones	EAN13	PPPSSSTTTnnnc	Formato de código de barras EAN13
10	Cupones	UPCA	PPPSSSTTTnnc	Formato de código de barras UPCA11
Cupones	max.qty	999	Cantidad maxima de generación Masiva de Cupones por transacción12
Cupones	prefix.active	true	Utilizar prefijo númerico incremental para tipos de cupón13
Cupones	amountFormat	%.02f	Formato en el que se imprimen los montos de los cupones14
Promo	applicationMethod	resume	Promociones: valor por defecto en el método de aplicación
15	Promo	divisionMethod	proportional	Promociones: valor por defecto en el método de división
16	Promo	divisionPrice	benefited-price	Promociones: valor por defecto el tipo de precio beneficiado17
Promo	fileList.txt.Separator	,	Importación de catálogo: separador
18	Promo	fileList.xls.ColStart	0	Importación de catálogo: columna de comienzo de la importación de catálogo19
Promo	fileList.xls.Direction	vertical	Importación de catálogo: forma de importación
Promo	fileList.xls.RowStart	0	Importación de catálogo: fila de comienzo de la importación de catálogo21
Promo	separator	|	Importación de catálogo: separador de columnas
22	Promo	terminatedOnError	true	Termina la importación de catalogo, si al menos uno fallo. Si es false, no termina e informa los catalogos fallidos
23	Promo	updateSize	100	Importación de catálogo: tamaño de subida
24	Negocio	charsMaximumAlphabetical	20	Cantidad máxima de caracteres alfabéticos
25	Negocio	charsMaximumNumerical	20	Cantidad máxima de caracteres numéricos26
Negocio	charsMaximumQuantity	20	Cantidad máxima de caracteres totales
27	Negocio	charsMaximumSpecial	20	Cantidad máxima de caracteres especiales28
Negocio	charsMinimumQuantity	7	Cantidad mínima de caracteres totales29
Negocio	charsMinimumUser	3	Cantidad minima de caracteres en el nombre de usuario30
Negocio	maximumLoginFailedCount	3	Cantidad máxima de reintentos de login fallidos sucesivos
31	Negocio	numberQuantity	1	Cantidad mínima de caracteres numéricos32
Negocio	passwordExpirationDays	30	Días de expiración de la contraseña del usuario33
Negocio	specialCharsQuantity	0	Cantidad mínima de caracteres especiales34
Negocio	stringQuantity	1	Cantidad mínima de caracteres alfabéticos35
Negocio	userBlockDays	90	Bloqueo de usuario - días de inactividad36
Negocio	userLockTime	30	Periodo de bloqueo de la cuenta de usuario (en minutos)37
Promo	distributionThreadPool	10	Cantidad de hilos creados para la distribución simultánea38
Promo	path	C:/synthesis/promo/import/	Directorio para la importacion de Mapas de Promociones.
39	Promo	benefit.active	false	Utilizar campo numérico incremental para beneficios
40	Promo	promotion.code.active	false	Utilizar campo numérico incremental para promociones
41	Cupones	default.from	[email protected]	Email por defecto con el que se enviaran los correos42
Cupones	default.insertImages	false	Indica si acepta o no barcodes
43	Cupones	default.subject	Promo Test Mail	Asunto por default44
Cupones	host	smtp.gmail.com	Host del proveedor de email45
Cupones	password	**************	Contraseña de la cuenta de email46
Cupones	port		Puerto de conexión47
Cupones	smtp.auth	true	Habilitar Auth SMTP
48	Cupones	smtp.port	587	Puerto SMTP
49	Cupones	smtp.socketFactory.class	javax.net.ssl.SSLSocketFactory	nombre de la clase SSLSocketFactory
50	Cupones	smtp.socketFactory.fallback	false	Fallback de socketFactory51
Cupones	smtp.socketFactory.port	465	Puerto SMTP de socketFactory
52	Cupones	smtp.starttls.enable	true	Habilitar Start TLS53
Cupones	username	[email protected]	Usuario o nombre de la cuenta de email54
Promo	use.item.catalog	1	Mapas: algoritmo de cálculo de colisiones55
Promo	cleanEngineStatusHistory	7	Tiempo en días que la consola mantendrá el historial de estados del motor56
Promo	deployedEditable.enabled	false	Habilita la edición de promoción con el estado Deployed.
57	Promo	promotion.enginestatus.communication	600	Tiempo que transcurre desde el último informe de estatus del motor o consola, para considerarlo offline. Si en ese tiempo no informó se lo considera offline.
58	Promo	promotion.images.height	250	Promociones: alto default de las imagenes59
Promo	promotion.images.path	C:/synthesis/promo/images/promotion/	Promociones: directorio para almacenamiento de imágenes
60	Promo	promotion.images.width	250	Promociones: ancho default de las imagenes61
Promo	reportParticipants	false	Promociones: valor global que determina si la promoción informa participantes62
Promo	reportParticipantsVisible	true	Determina si se visualiza o no, la opción reportar participantes63
Promo	method.of.payment	NOTHING=No calcular promociones por medio de pago	Promocion Codificada: NOTHING, ON_ITEMS_PAID, ON_PAYMENT_MADE64
Promo	method.of.payment.onItemsPaid.class	com.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsGSPromotion	Promocion Codificada: nombre de la promoción por medio de pago basada en ítems.
65	Promo	method.of.payment.onItemsPaid.name	Promociones basadas en items	Promocion Codificada: nombre de la promoción por medio de pago basada en ítems.
66	Promo	method.of.payment.onItemsPaid.tenderMethodPropertyKey	promo.configuration.tenderMethod.itemMethod	Promocion Codificada: nombre de la promoción por medio de pago basada en ítems.
67	Promo	method.of.payment.onPaymentMade.class	PartialPaymentsSSPromotion	Promocion Codificada: nombre de la promoción por medio de pago basada en ítems.68
Promo	method.of.payment.onPaymentMade.name	Promociones basadas en pagos	Promocion Codificada: nombre de la promoción por medio de pago basada en ítems.
69	Promo	method.of.payment.onPaymentMade.tenderMethodPropertyKey	promo.configuration.tenderMethod.paymentMethod	Promocion Codificada: nombre de la promoción por medio de pago basada en ítems.70
Promo	ldapAuthentication	false	Determina si se autentica contra un Directory Service71
Promo	ldapAuthentication.autheticationMode	DIGEST-MD5	Es el modo de seguridad que se autentica, usar "DIGEST-MD5" como valor default dado que este modo encripta la información contra el Directory Service.72
Promo	ldapAuthentication.urlServer		URL del server contra el que se autentica.
73	Promo	testEnginePORT	3001	Simulación: puerto en el que corre el motor para simulación
74	Promo	testEngineRetries	2	Simulación: reintentos de conexión al motor
75	Promo	testEngineSalesPath	C:/synthesis/promo/engine/sales/	Simulación: ruta del motor76
Promo	testEngineTimeout	8000	Simulación: timeout de conexión al motor
77	Redes sociales	facebook.appId	1068803576479010	Id de la aplicación de facebook78
Redes sociales	facebook.permissions	[publish_actions, manage_pages]	Permisos de la aplicación de facebook79
Redes sociales	facebook.secret	dfa5ffe6aa6306fc49472dbcba3c16a9	Clave secreta de la aplicación de facebook80
Redes socialesfacebook.secure	https	Protocolo de conexión segura a la aplicación de facebook	81	Redes sociales	twitter.accessToken	2848331890-D2geAfGVL9u2bD6TrD1LxH5fUsXlBnHLa3FOziK	Token de acceso a twitter
82	Redes sociales	twitter.accessTokenSecret	NHd6JbcoLaBK5QEfrKgmOaQwwxmbwlEtOYlQni3Fx6H3y	Token secreto de acceso a twitter
83	Redes sociales	twitter.consumerKey	HTPKOHdatasoDsm2Ud7ULnUapAKFXoC	Clave consumer key de twitter84
Redes sociales	twitter.consumerSecret	X1plqdQWK0nRCGz6KFxm37IZTzp4O7w9BjLSspIr4mYWLZsrOy	Clave consumer secret de twitter
85	Tarjetas de fidelidad	continueOnError	true	Permitir continuar la importación de catálogo de tarjetas ante un error86
Tarjetas de fidelidad	insertionOption	INSERT_OR_UPDATE	Describe la opción de inserción para la importación del catálogo de tarjetas87
Transacciones	cleanTransactions	90	Cantidad de días que permanecerán los registros de transacciones en la base de datos88
Lista de precios	priceList.distribution.items.batch.size	1000	Cantidad de Precios a enviar al motor desde la consola en la distribución de precios (por comunicacion).
89	Lista de precios	priceList.job.cleanPriceListSchedule.time	30	Cantidad de días a mantener los items de la lista de precios futuros procesados90
Lista de precios	priceList.lockForUpate	15	Minutos para poder desbloquear Lista cero en el proceso rest91
Lista de precios	priceList.mongo.bulk.insertOrUpdate	200	Cantidad de registros a insertar por lote en el proceso rest

...

Informações
title NOTA 2
Se asume que si existe, en el archivo promoplus/promoconfig.properties, una contraseña no encriptada (grails.mongodb.password) no debe existir la entrada de contraseña encriptada (grails.mongodb.encryptedPassword) y viceversa. La entrada no deseada se puede eliminar o comentar.

...

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 Added

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 Added

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.

Âncora
_Toc473121731 _Toc473121731

Âncora
_Toc513638228 _Toc513638228

Configuración de Redes Sociales

Para trabajar con redes sociales PROMO posee una serie de opciones de configuración que se describen a continuación. También es importante aclarar que los servicios de redes sociales están en constante evolución y cambio por lo cual aquí se hace referencia al sitio del servicio en cuestión para obtener la información actualizada al respecto.

...

Desde la consola de cada compañía, accediendo con el usuario administrador, y accediendo a "Administración Información de configuración" se encontraran las siguientes configuraciones que serán necesarias completar para la correcta publicación en la red social.

Image Removed

Los datos presentes en esta imagen son solo de carácter ilustrativo y deberán ser reemplazados por las credenciales adquiridas con los usuarios de desarrollo de cada aplicación.

Image Added

• Generación de Aplicación en Facebook

Para poder utilizar la publicación en Facebook se deberá ingresar a https://developers.facebook.com/, darse de alta como desarrollador de Aplicaciones Facebook y agregar una nueva aplicación siguiendo los pasos indicados en la página.
Esto aplica a la versión de App Facebbok 2.9, pero es importante notar que al crear una aplicación para Facebook Al crear una aplicación para Facebook, se comienza en estado de desarrollo y para poder realizar publicaciones hay que dar los permisos de "Administrador" al usuario de FB que realizara las publicaciones.

Por otra parte, si se quiere compartir o que otro usuario pueda realizar publicaciones, es necesario ser amigos entre los usuarios agregarlo al grupo de contactos (amigos) y darle permisos de administrador"Administrador".

Al acceder a la URL indicada más arriba, se accederá a la sección de "Facebook for Developers" de Facebook.

Se deberá dar clic en "Mis Aplicaciones" que figura arriba a la derecha, junto al icono de usuario.
Image RemovedApps".Image Added

Una vez allí, habrá que dar clic en el botón verde de "Agregar una nueva aplicaciónCrear app".
Image Removed Se solicitara ingresar un nombre y un correo electrónico de contacto para dar de alta la app. Luego de ingresados los datos solicitados, presionar en "Crear identificador de la aplicación".
Image Removed La siguiente pantalla presentara los datos de la nueva aplicación recién generada.
Image Removed Aquí se mostraran los datos requeridos para la configuracion de la aplicación en el archivo promoplus.propertis que son:

Identificador de la aplicación >> grails.plugin.facebooksdk.app.id
Clave secreta de la aplicación >> grails.plugin.facebooksdk.app.secret

Sera necesario tener una pagina de Facebook dada de alta y asociada a la cuenta de usuario de facebook para poder realizar las publicaciones en esta pagina.
Desde el perfil de usuario con el que se haya generado la app de Facebbok, se deberá dar clic en el menú desplegable de la cual se tendrá acceso a las configuraciones y paginas.
En este menú dar clic en "Crear pagina", y generarla en base al perfil del negocio siguiendo los pasos indicados por facebok
Una vez generada la pagina y configurados los datos en el archivo de configuracion aportados por la aplicación generada, se podrá reiniciar la consola y proceder a la publicación de las promociones en la red social.

...

Desde la consola de cada compañía, accediendo con el usuario administrador, y accediendo a Administración Información de configuración se encontraran las siguientes configuraciones que serán necesarias completar para la correcta publicación en la red social.

Image Removed

Los datos presentes en esta imagen son solo de carácter ilustrativo y deberán ser reemplazados por las credenciales adquiridas con los usuarios de desarrollo de cada aplicación.

...

Deberá accederse a la URL https://developer.twitter.com/ y presentara la siguiente pantalla:
Image Removed

Deberá darse clic en el botón correspondiente al usuario logueado en Twitter,  se desplegara un menú y se dará clic en "Apps"

Se presentara la siguiente pantalla y debera darse clic en "Create an app"
Image Removed

...

Para obtener los Ids y Tokens deberá darse clic en la solapa "Keys and Tokens" donde se visualizaran los datos necesarios para configurar correctamente los permisos de acceso desde Promo.

Image Removed

Integración con Syslog/QRADAR

La implementación del envío de eventos a QRadar se apoya en el sistema de logueo log4j utilizado por Promo, agregando un appender específico para syslog "SysLogAppender" disponible en el paquete log4j, y el desarrollo de un clase que presta servicio a tal fin denominada "SysLogService" la cual formatea los mensages en otra clase "SysLogMessageFactory".

Para habilitar el envío a QRadar, se debe editar el archivo de configuracion de logueo "log4j.xml" insertando las siguientes entradas antes del final:

<appender name="syslogappender" class="org.apache.log4j.net.SyslogAppender">
    <param name="syslogHost" value="myserver:myport"/>
    <param name="facilityPrinting" value="false"/>
    <param name="facility" value="AUTHPRIV"/>
    <param name="header" value="false"/>
    <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%d{yyyy-MM-dd'T'HH:mm:ss.SXXX} %m%n"/>
    </layout>
 </appender>
 
 <logger name="sts.console.audit.SysLogService" additivity="false">
    <level value="info"/>
    <appender-ref ref="syslogappender"/>
 </logger>

</log4j:configuration>

Cambiar en el parámetro "syslogHost" , el valor "myserver:myport", por el correspondiente a la dirección ip y port del syslog server QRadar.  Ejemplo: localhost:514

Luego re-deployar la consola de Promo para que tome la configuración.

Tipos de eventos :

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.

...

Desinstalación

...

1- Bajar servicios

1. • PromoSImEngine
   • Wildfly
   • MongoDB
   • PromoEngine (si se instaló el motor)
   • PromoEngineDirector (si se instaló el motor)

2- Borrar directorio C:\Synthesis (ruta donde se instaló la consola)

3- Desinstalar MongoDB

4- Borrar los servicios de PromoSinEngine, Wilfly y MongoDB, y PromoEngine, PromoEngineDirector si se instaló el motor

Reverso de actualizaciones ante problemas en el proceso

Ante algun problema durante la actualizacion de una version de consola o motor, debera de bajarse los servicios involucrados y colocar el archivo .war o .jar anterior,  segun se trate de una actualizacion de consola o motor respectivamente y volver a subir los servicios.

Luego de reesablecido el sistema contactar a Sericios de Atencion al Cliente para poner en conocimiento de lo sucedido con el proceso de actualizacion.Image Added

Se presentara el siguiente popUp donde se deberá seleccionar el tipo de app que se desea crear. En este caso, seleccionaremos "Negocio", y se deberá presionar "Continuar".
Image Added

En el siguiente popUp se deberán ingresar los datos solicitados para dar nombre a la app que se esta creando y presionar el botón "Crear app"
Image Added

Una vez creada la app se mostrara la siguiente pantalla, desde donde podrá accederse, desde la opción "Configuración" >> "Básica", a los datos de identificación de la aplicación recientemente creada.

Image Added

Los datos a considerar y completar en esta sección serán:

• Identificador de la app: Sera requerido en Promo para poder configurar los datos de conexión a la app de Facebook (Los datos mostrados en las imágenes son de carácter ilustrativo y no son validos para la configuracion de ninguna app)
• Clave secreta de la app: Sera requerido en Promo para poder configurar los datos de conexión a la app de Facebook. La clave se mostrará enmascarada y se solicitara la clave de usuario de FB para mostrarla.
• Nombre para mostrar: Sera el nombre de al app que se mostrara a los usuarios de FB.
• Dominio de la app: Deberá indicarse el dominio donde se encuentra Promo.
• Correo electrónico de contacto: Deberá indicarse el mail de contacto para la app.
• URL de la Política de privacidad: Deberá indicarse la política de privacidad de la compañía que desea publicar en FB desde Promo.

Sera necesario tener una pagina de Facebook dada de alta y asociada a la cuenta de usuario de Facebook para poder realizar las publicaciones en esta pagina.

Desde el perfil de usuario con el que se haya generado la app de Facebook, se deberá dar clic "Paginas" que se encuentra a la izquierda de la pagina.

Image Added

Se presentara la siguiente pagina, donde se deberá dar clic en "Crear nueva pagina"

Image Added

Al presionar en "Crear nueva pagina", se mostrará la siguiente pantalla, donde deberá de completarse la información solicitada en el margen izquierdo.

Image Added

Una vez generada la pagina e ingresados los datos de configuracion aportados por la aplicación generada, se podrá proceder a la publicación de las promociones en la red social. (ver Manual de usuario Promo 7 - "Distribución">> "Redes Sociales")

Aviso
title IMPORTANTE
Https obligatorio para la publicacion en Facebbok Facebook sólo se integra con sistemas que funcionen con https. Promo tendrá que tener configurado su wildfly con https Para la cunfiguracion de wildfly con https sera necesario editar el archivo "standalone.xml" ubicado en ...\synthesis\promo\appserver\standalone\configuration Alli sera requerido agregar los siguientes tags en: <security-realm name="ApplicationRealm"/> Bloco de código language xml theme Emacs title Para Promo sobre Wildfly 9 <security-realm name="ApplicationRealm"> <server-identities> <ssl> <keystore path="server.keystore" relative-to="jboss.server.config.dir" keystore-password="Promo2020" alias="jbossWildFly" key-password="Promo2020" /> </ssl> ... </server-identities> Image Added Bloco de código language xml theme Emacs title Para Promo sobre Wildfly 12 <security-realm name="ApplicationRealm"> <server-identities> <ssl> <keystore path="server.keystore" relative-to="jboss.server.config.dir" keystore-password="Promo2020" alias="jbossWildFly" key-password="Promo2020" generate-self-signed-certificate-host="localhost"/> </ssl> ... </server-identities> <server name="default-server"/> Bloco de código language xml theme Emacs <https-listener name="https" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/> Image Added También sera necesario generar y colocar el archivo "server.keystore" en el directorio ...\synthesis\promo\appserver\standalone\configuration. ( Como son claves de encriptación, tienen que ser generadas dentro del ambiente de instalación. Desde Napse se utilizó la herramienta de pruebas "keytool" de Java para la generación del mismo) Una vez guardados los cambios en el standalone.xml y colocado el archivo "server.keystore.txt" en el directorio indicado, deberá de reiniciarse el wildfly para que los cambios sean tomados correctamente.

Âncora
_Toc473121733 _Toc473121733

Âncora
_Toc513638230 _Toc513638230

Configurar Twitter

Desde la consola de cada compañía, accediendo con el usuario administrador, y accediendo a Administración >> Información de configuración se encontraran las configuraciones que serán necesarias completar para la correcta publicación en la red social.

Image Added

• Generación de perfil en Twitter
  
  

Deberá accederse a la URL https://developer.twitter.com/ y presentara la siguiente pantalla:
Image Added

Deberá darse clic en el botón correspondiente al usuario logueado en Twitter,  se desplegara un menú y se dará clic en "Apps"

Se presentara la siguiente pantalla y debera darse clic en "Create an app"
Image Added

Sera necesario completar los campos con los datos solicitados para poder crear la aplicación en base a las políticas de seguridad de Twitter.

Completos todos los campos, dar clic en "Create" y se mostraran las configuraciones disponibles para la nueva aplicación recientemente generada:
Image Added

Para obtener los Ids y Tokens deberá darse clic en la solapa "Keys and Tokens" donde se visualizaran los datos necesarios para configurar correctamente los permisos de acceso desde Promo.

Image Added

Una vez ingresados los datos de configuracion aportados por la aplicación generada, se podrá proceder a la publicación de las promociones en la red social. (ver Manual de usuario Promo 7 - "Distribución">> "Redes Sociales")

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

(a partir de Promo 6.5)

Se disponibiliza la posibilidad de poder indicar por configuracion 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 Added

Integración con Syslog/QRADAR

La implementación del envío de eventos a QRadar se apoya en el sistema de logueo log4j utilizado por Promo, agregando un appender específico para syslog "SysLogAppender" disponible en el paquete log4j, y el desarrollo de un clase que presta servicio a tal fin denominada "SysLogService" la cual formatea los mensages en otra clase "SysLogMessageFactory".

Para habilitar el envío a QRadar, se debe editar el archivo de configuracion de logueo "log4j.xml" insertando las siguientes entradas antes del final:

<appender name="syslogappender" class="org.apache.log4j.net.SyslogAppender">
    <param name="syslogHost" value="myserver:myport"/>
    <param name="facilityPrinting" value="false"/>
    <param name="facility" value="AUTHPRIV"/>
    <param name="header" value="false"/>
    <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%d{yyyy-MM-dd'T'HH:mm:ss.SXXX} %m%n"/>
    </layout>
 </appender>
 
 <logger name="sts.console.audit.SysLogService" additivity="false">
    <level value="info"/>
    <appender-ref ref="syslogappender"/>
 </logger>

</log4j:configuration>

Cambiar en el parámetro "syslogHost" , el valor "myserver:myport", por el correspondiente a la dirección ip y port del syslog server QRadar.  Ejemplo: localhost:514

Luego re-deployar la consola de Promo para que tome la configuración.

Tipos de eventos :

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.

Âncora
_Toc513638231 _Toc513638231

Resolución de problemas

Durante su funcionamiento, la Consola de administración podrá informar errores inesperados. Los errores que puedan a llegar a ocurrir utilizando la aplicación serán informados mediante un pop-up en rojo indicando la causa del mismo. Asimismo, el log de la aplicación que se encuentra en \synthesis\promo\log indicará más detalle acerca del mismo.
Si el error es por un tema de permisos o página no encontrada, se informará mediante una pantalla aclaratoria con el problema ocurrido.

Desinstalación

Para proceder con la des-instalación de la consola y motor de PROMO se deberá:

1- Bajar servicios

1. • PromoSImEngine
   • Wildfly
   • MongoDB
   • PromoEngine (si se instaló el motor)
   • PromoEngineDirector (si se instaló el motor)

2- Borrar directorio C:\Synthesis (ruta donde se instaló la consola)

3- Desinstalar MongoDB

4- Borrar los servicios de PromoSinEngine, Wilfly y MongoDB, y PromoEngine, PromoEngineDirector si se instaló el motor

Reverso de actualizaciones ante problemas en el proceso

Ante algun problema durante la actualizacion de una version de consola o motor, debera de bajarse los servicios involucrados y colocar el archivo .war o .jar anterior,  segun se trate de una actualizacion de consola o motor respectivamente y volver a subir los servicios.

Luego de reesablecido el sistema contactar a Sericios de Atencion al Cliente para poner en conocimiento de lo sucedido con el proceso de actualizacion.

Herramienta para métricas de fidelidad

(A partir de Promo 7.2) Con el objetivo de medir los tiempos de proceso de elementos de fidelidad, se han incorporado métricas en el log de aplicación.

Se implementa la actualización en el log a nivel INFO tanto del lado consola como del motor, de las siguientes operaciones:

• LoyaltyValidation
• LoyaltyActivation
• LoyaltyTransfer
• LoyaltyVoid
• LoyaltyAssign
• FINISH
• COMMIT
• ROLLBACK
• TransactionRequest
• ReturnFinish
• CatalogRedeemValidation

• LOYALTYVALIDATIONEX

• FINISHEX
• Prices
• voidTotal
• blackList

Para habilitar los cambios realizados se agregaron las siguiente propiedades en los archivos correspondientes al logging tanto del lado consola como del motor:

Habilitar logueo en consola, ir a : ..\synthesis\promo\appserver\modules\system\layers\base\com\synthesis\configuration\main\log4j.xml

Valor por defecto ERROR, pasar a INFO para habilitar la funcionalidad.

<category name="grails.app.services.sts.console.api.ApiService">
<priority value="ERROR" />
</category>

Habilitar logueo en motor, ir a: ...\synthesis\promo\engine\conf\logging.properties

Valor por defecto SEVERE, pasar a INFO para habilitar la funcionalidad.

engine.operation.level = INFO

Adicionalmente, una vez actualizado el valor de la propiedad engine.operation.level,  se cambia el nivel de logging de SEVERE a INFO de las siguientes propiedades:

• java.util.logging.FileHandler.level = INFO
• java.util.logging.ConsoleHandler.level = INFO

Resultado del cambio:

15,52,20,949 INFO [sts.console.api.ApiService@http-nio-8080-exec-2] -->loyaltyTransfer
15,52,20,974 INFO [sts.console.api.ApiService@http-nio-8080-exec-2] <--loyaltyTransfer 0.025 seconds
15,52,23,334 INFO [sts.console.api.ApiService@Actor Thread 5] ApiService.status.mapActives Starting processing at Fri Jul 23 15:52:23 ART 2021
15,52,23,335 INFO [sts.console.api.ApiService@Actor Thread 3] ApiService.status.mapActives processed Finish at Fri Jul 23 15:52:23 ART 2021
15,52,23,357 INFO [sts.console.api.ApiService@http-nio-8080-exec-8] -->processEngineRequest: checking on console type:DYNAMIC_ATTRIBUTES ...
15,52,23,380 INFO [sts.console.api.ApiService@http-nio-8080-exec-1] -->processEngineRequest: checking if console has any pending to be process on engine...
15,52,29,749 INFO [sts.console.api.ApiService@http-nio-8080-exec-2] -->commit
15,52,29,752 INFO [sts.console.api.ApiService@http-nio-8080-exec-2] <--commit 0.003 seconds

INFORMACIÓN: -->OperationFinish:remoteEvaluation
jul 23, 2021 3:54:52 PM engine.operation.Operation loggerTimeStop
INFORMACIÓN: <--OperationFinish:remoteEvaluation 0.913 seconds -><?xml version="1.0" encoding="UTF-8"?><message ack="0" companyId="napse" engine="7.1.4-SNAPSHOT" mapversion="44" messageId="1" store="napse" terminal="1" transaction="napse_napse_1_20210723100025">
  <loyalty>
    <loyaltycards>
      <loyaltycard ack="0" amount="1800.00" id="550003" seq="1" type="tdf_001"/>
    </loyaltycards>
    <coupons/>
    <errors/>
    <customers/>
    <redeemTable/>
  </loyalty>
</message>
 
jul 23, 2021 3:55:04 PM engine.operation.Operation loggerTimeStart
INFORMACIÓN: -->OperationCommit:remoteEvaluation
jul 23, 2021 3:55:04 PM engine.operation.Operation loggerTimeStop
INFORMACIÓN: <--OperationCommit:remoteEvaluation 0.053 seconds
jul 23, 2021 4:13:57 PM engine.operation.Operation loggerTimeStart
INFORMACIÓN: -->OperationLoyaltyValidation:remoteEvaluation
jul 23, 2021 4:13:57 PM engine.operation.OperationLoyaltyvalidation validation
INFORMACIÓN: Se valida que el cuerpo del mensaje no este vacio en LoyaltyValidation
jul 23, 2021 4:13:57 PM engine.operation.Operation loggerTimeStop
INFORMACIÓN: <--OperationLoyaltyValidation:remoteEvaluation 0.373 seconds

...

Apéndice A: Autenticación de Usuarios Externos (SAML2)

...