MANUAL DE INSTALACIÓN
PROMO 7.1
...
- Manual de Instalación
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
Âncora | ||||
---|---|---|---|---|
|
...
Informações | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||
Es requisito que antes de realizar la instalación de la consola estén instaladas instalados los siguientes componentes:
Linux: https://www.mongodb.com/docs/v4.2/tutorial/install-mongodb-on-red-hat/ Luego de que mongo se encuentra encuentre instalado se debe configurar la seguridad del mismo de la siguiente forma:
2. Ejecutar el comando mongo 3. El sistema quedará dentro de la consola de Mongo, con lo cual allí mismo se deberá ejecutar los siguientes comandos:
4. Salir de la consola mediante el comando "exit" 5. Ejecutar el comando >service mongod stop para frenar la ejecución de mongo. 6. Editar el archivo /etc/mongod.conf y descomentar el tag "Security" para habilitar la seguridad, colocando la siguiente línea como se muestra en la imagen: |
...
A continuación se detallan los requisitos mínimos para la instalación de la Consola de Administración de PROMO que operara con una (1) compañía.
Los requerimientos mínimos de hardware se proveen como una guía para el sizing de un ambiente no productivo. Para instalaciones en ambientes productivos con requerimientos específicos de performance y volumen de datos se requiere un sizing particular para estimar la configuración apropiada.
Considerar que la siguiente configuración sería la necesaria para utilizar un mapa no mayor a 1 MB y sin utilizar funciones de loyalty, de lo contrario debe analizar cuánta memoria debe utilizar.
Se describe la instalación de la base de datos y del Jdk en Referencias Prácticas
...
Aviso | ||
---|---|---|
| ||
Adicionalmente se deberá agregar el JDK a la variable de entorno %PATH%. (ver8 Apendice B: Variables de Entorno) |
Ejecución del Instalador (Windows)
...
Documentación relacionada
PROMO 7.1 -Guía Inicial de Integración
PROMO 7.1 - Manual de Integración - Motor
PROMO 7.1 - Manual de Integración - Servicios
PROMO 7.1 - Manual de Integración - Colas de Mensajes
PROMO 7.1 - Manual del Administrador
PROMO 7.1 - Manual de Lenguaje de Promociones
PROMO 7.1 - Manual de Usuario Promo Lite
Ejecución del Instalador (Windows)
Deberá ejecutarse como administrador desde modo comando el Instalador "promo-console-installer-7.1.3.jar" para proceder a la instalación y configuración de la consola y motor de simulación de PROMO. Para esto deberá ejecutarse el comando java –jar promo-console-installer-7.1.3.jar
También se instalarán los siguientes componentes indispensables para el correcto funcionamiento de la aplicación:
...
Se presentara la siguiente pantalla donde se deberá presionar "Siguiente":
Luego se solicitará la aceptación de los términos y condiciones de uso de la aplicación.
Luego de aceptados los términos y condiciones, se solicitará que se identifique el nombre del usuario y el e-mail de quien (empresa o persona) está realizando la instalación.
Presione el botón siguiente.
A continuación se deberá indicar la ruta de acceso a Java (JDK) y el directorio donde se realizara la instalación de Promo. Por default se propone "c:\synthesis\Promo". Tambien También se deberá indicar el directorio donde se instalara la base de datos (MongoDb)
...
Se solicitara se informe si se desea instalar o solo activar los servicios que se instalan con PROMO.
Ya sea que haya instalado el motor como aplicación o como servicio continuará con los siguientes pasos:
En la siguiente pantalla que se presente, habrá que presionar el botón "Instalar" a fin de dar comienzo al proceso de instalación de PROMO y sus componentes.
Finalizada la instalación se mostrara la siguiente ventana donde se informara la correcta instalación de la consola de PROMO y se solicitara dar Clic en "OK" para terminar con el proceso.
Âncora | ||||
---|---|---|---|---|
|
...
Âncora | ||||
---|---|---|---|---|
|
404 – ERROR de Inicializacion Inicialización en Instalador
Este error pude se produce al no iniciarse la instalación de la consola desde una pantalla de comando ejecutada como administrador. Se deberá ejecutar como administrador, en modo comando el instalador de PROMO (promo-console-installer-6.x.x.jar)
...
Se provee un archivo promo-gengine-installer-X.X.X.jar donde X.X.X es la versión del motor que se está instalando (Ej. : 7.1.3x).
Se deberá ejecutar como administrador, en modo comando el instalador del Motor de PROMO (Ej: java –jar promo-gengine-installer-7.1.3x.jar)
Al ejecutarse el instalador aparecerá la siguiente ventana:
Presionar "Siguiente" para continuar.
...
Se deberán aceptar los términos y condiciones para continuar con la instalación del motor de PROMO.
Presionar en "Aceptar" para continuar.
...
Luego de aceptados los términos y condiciones, se solicitara que se identifique el nombre del usuario y el e-mail de quien (empresa o persona) está realizando la instalación.
Presionar "Siguiente" para continuar.
...
Se podrá indicar aquí, por medio del check "Instalar Servidor REST (Default TCP/IP)", para que se instale el motor como SERVIDOR REST sino se instalara por default en modo TCP/IP.
Aviso |
---|
Importante: Verificar de No instalar el motor donde se instalo previamente el motor de simulacion simulación de la consola (el motor de simulación se instala por default en \synthesis\promo\engine) de ocurrir eso no funcionará correctamente. |
Presionar "Siguiente" para continuar.
Si se desea instalar el motor como aplicacionaplicación, se debe tildar el cheeckbox
...
Si no se elige la opción de Instalar el motor como aplicacion aplicación al presionar el botón Siguiente, en el siguiente Pop-UP se deberá indicar la URL de acceso a "Director" para futuras actualización y el código de tienda que tomara el motor A continuación se deberá indicar
...
En la siguiente pantalla que se presente, habrá que presionar el botón "Instalar" a fin de dar comienzo al proceso de instalación del motor de PROMO y sus componentes.
Finalizada la instalación se mostrara la siguiente ventana donde se informara la correcta instalación del motor de PROMO. Se solicitara dar Clic en "Aceptar" y luego en "Salir" para terminar con el proceso.
Terminado el proceso de instalación del motor de promociones podrá chequearse en los servicios del sistema la existencia de dos nuevos servicios correspondientes al motor de promociones y al agente Director que ya estarán ejecutándose de manera atomística, hecho que marcara la correcta instalación y puesta en funcionamiento del nuevo motor de PROMO.
...
Tag/Parámetro | Descripción | Valor por defecto |
---|---|---|
simulation | Indica si el motor opera para simulaciones desde la consola o no. Valor por defecto "False" (No simulación) | false |
compatibilityMode | indica si el motor opera en modo compatible con el antiguo motor (Integraciones 4690) agrupando o no los beneficios en la respuestas dadas por el motor. Por default el parámetro viene definido en "False" (No compatblecompatible) por lo que en este modo agrupara los beneficios (motor nuevo). En caso de definir el beneficio en "True", no se agruparan los beneficios (compatibilidad con antiguo motor). | false |
mapIdentifiers | identificaran las carpetas por las cuales el motor irá en búsqueda del mapa para evaluar la promoción. Deberán definirse en una lista separada por comas. | companyId |
ticketIdentifiers | indicara por qué atributo se identificara al ticket cuando el motor opere como multiempresa. | store, terminal |
disableLoyalty | El valor por default de este parámetro será "false" indicando que el motor mantiene una comunicación con PROMO central para la gestión de elementos de Fidelidad. En caso de configurar en "true" este parámetro, se deshabilitara la comunicación con PROMO central, por lo que un status de Finish, commit, rollback, etc etc . se evaluara como un status "sales" (método de evaluación previo a Fidelidad). | false |
disablePrices | El valor por default de este parámetro será "false" indicando que el motor utiliza preciadores, esto habilitara la funcionalidad de precios (desde la consola se generan listas de precios y seran serán distribuidos al motor) y se disponibilizara el status de prices y en caso de utlizar utilizar en los tickets items con ítems con unitPrice=0 los buscara los precios de los preciadores (listas de precios). En caso de configurar en "true" este parámetro indica que NO esta habilitada esta funcionalidad. | false |
engineId | identificador único del motor. Deberá configurarse cuando se desee que el motor reporte su mapa activo a la consola de PROMO. | 0 |
engineName | Nombre único del motor. Junto con el "EnginerId" deberá configurarse cuando se desee que el motor reporte su mapa activo a la consola de PROMO. | |
stores | Reservado | |
promotionCacheMode | Activa el modo de trabajo "Cache de Promociones" del motor. Reservado para SOLO este modo de trabajo particular. | false |
useExactLimitValue | Otorgamiento de beneficio con límites: true otorga el saldo(default), false no otorga beneficio si el apply supera el saldo | true |
negativeDiscount | Permite o no que los descuentos otorgados superen el valor del producto | true |
adjustCalculatedCoupon | Limita (cuando esta en true) dentro de un mismo paso que un cupon cupón no de mas del 100% de un producto, (descuentosMonetarios + valor del cupon > cupón > xprice) recorta el valor del cupon cupón para que no supere el 100% (a partir de 7.1) | false |
fetchLimitsSync | Indica si los limites se actualizarán de modo sincrónico o asincrónico. Esto modifica los tiempos de respuesta al iniciar una transacción y al realizar un loyaltyValidation de cliente. | true |
...
Tag/Parámetro | Descripción | Valor por defecto |
---|---|---|
directory | Indica el directorio local donde se descargaran los archivos de lista de precios en caso de contingencia. Estos archivos se pueden generar en consola y enviarlos por algun algún medio alternativo (por ej. mail) para ser descargado en los motores | prices |
check | Intervalo de tiempo en segundos en que el motor verificará si existen archivos nuevos en el mencionado directorio. | 10 |
...
Los parámetros de configuración de la sección Response afectan a la respuesta y calculos cálculos internos del motor. Estos son:
Tag/Parámetro | Descripción | Valor por defecto |
---|---|---|
roundDecimals | Indica la cantidad de decimales a utilizar en las cantidades decimales. Esto es: magnitud y montos como precio unitario | 2 |
roundCountables | Indica la cantidad de decimales a utilizar en las cantidades contables. Esto es: cantidad | 3 |
roundPoints | Indica la cantidad de decimales a utilizar en la cantidad informada de puntos. | 2 |
roundPointsMethod | Metodo de redondeo para acotar los valores de puntos segun según la cantidad de decimales configurada. Los valores posibles son roundDown o roundMath | roundDown |
roundPointsTotalOnly | Indica que el redondeo de Puntos se aplique solo en el total del beneficio y no en los detalle de aplicación | false |
roundPointsTotalCalcDecimals | Indica la cantidad de decimales a utilizar cuando se informa la cantidad de puntos totales en el beneficio | 2 |
Los parámetros de configuración de la sección Server, afectan la comunicación del motor como servvidorservidor. Estos parámetros son:
Tag/Parámetro | Descripción | Valor por defecto |
---|---|---|
useHttps | Activa el modo https del motor de Promo | false |
keyStore | Si se activa el modo https, indica el keystore a utilizar | ./conf/keystore |
keyStorePassword | Indica la clave de acceso al keystore | nosotros |
useRoleAccessRestrictions | Activa el modo con usuario/clave para seguridad del motor | false |
usersDefinition | Indica el archivo donde se definen los usuarios y roles que se conectarán al motor de Promo | ./conf/engineUsers.properties |
configurationDirectory | donde se encuentra la carpeta que contiene al archivo de asignación de roles a recursos web.xml | ./conf |
rest | Puerto de escucha del motor en modo REST Server | 8888 |
socket | Puerto de escucha del motor en modo TCP/IP Server | 3000 |
...
Tag/Parámetro | Descripción | Valor por defecto |
---|---|---|
url | Dirección donde se encuentra la consola de promo | http://localhost:8080/promo |
user | usuario para realizar el login OAUTH2 de la consola | sender |
password | Clave para realizar el login OAUTH2 de la consola | mate |
timeout | Define el timeout en segundos de comunicacion comunicación con la consola central si se especifica este aplica en general y anula a los otros dos. | - |
connectionTimeout | Define el timeout en segundos de conneccion con la consola Central. | - |
communicationTimeout | Define el timeout en segundos de comunicacion comunicación con la consola Central. | - |
companyId | Descomentar en el caso que la mensajeria mensajería no lo implemente y se requiere el envio de un valor fijo | - |
...
Los parámetros de configuración de la sección Extensions afectan la definicion definición e entidades que manejará el motor. Los parámetros son:
...
Los parámetros de configuración de la sección cacjeData cacheData son:
Tag/Parámetro | Descripción | Valor por defecto |
---|---|---|
directory | Directorio de trabajo del cache de datos interno utilizado por el motor, en caso de no especificarse el motor usa "./data" | data |
...
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 índices 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.
...
- [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 | ||
---|---|---|
|
...
Exibir filhos | ||
---|---|---|
|
Âncora | |||
---|---|---|---|
|
...
Configuraciones disponibles para el Usuario Principal:
Módulo | Clave | Valor | Descripción |
---|
Promo | operative.system | windows | Sistema operativo |
Promo | soap.url | http://10.4.13.108:8280/bridge/services/bridgeCoreSOAP?wsdl | Dirección de web service de bridge. |
Negocio | lang | es_AR (Argentina) | General: idioma de la aplicación (etiquetas) |
Negocio | backupDirectory | C:/synthesis/promo/backup | General: de backup |
Negocio | mongoDBDirectory | C:/synthesis/promo/mdb/bin | General: directorio base de datos |
Negocio |
mongoDBHostname | localhost | Host de la base de datos. En caso de poseer una |
configuración en replicaset el |
formato de |
configuración 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 |
Negocio | mongoDBPort | 27017 | Puerto de la base de datos. En caso de replicaset este |
parámetro es ignorado. |
General | auditDateCleaner | 30 | Eliminar registros de las tablas de importación. |
General | importReceiptDateCleaner | 30 | Eliminar registros de las tablas de importación. |
General | ticketGeneratorSeconds | 2 | DEMO: cantidad de segundos de generación de ticket para demos |
Negocio | charsMaximumAlphabetical | 20 | Cantidad máxima de caracteres alfabéticos |
Negocio | charsMaximumNumerical | 20 | Cantidad máxima de caracteres numéricos |
Negocio | charsMaximumQuantity | 20 | Cantidad máxima de caracteres totales |
Negocio | charsMaximumSpecial | 20 | Cantidad máxima de caracteres especiales |
Negocio | charsMinimumQuantity | 7 | Cantidad mínima de caracteres totales |
1Negocio | charsMinimumUser | 3 | Cantidad |
mínima de caracteres en el nombre de usuario |
Negocio | maximumLoginFailedCount | 3 | Cantidad máxima de reintentos de login fallidos sucesivos |
Negocio | numberQuantity | 1 | Cantidad mínima de caracteres numéricos |
Negocio | passwordExpirationDays | 30 | Días de expiración de la contraseña del usuario |
Negocio | specialCharsQuantity | 0 | Cantidad mínima de caracteres especiales |
Negocio | stringQuantity | 1 | Cantidad mínima de caracteres alfabéticos |
Negocio | userBlockDays | 90 | Bloqueo de usuario - días de inactividad |
Negocio | userLockTime | 30 | Periodo de bloqueo de la cuenta de usuario (en minutos) |
Promo | engineSalesPath | C:/synthesis/promo/engine/sales/ | Directorio de Mapas del Motor |
Configuraciones disponibles para el Usuario Admin. de cada compañía:
Modulo | Clave | Valor | Descripción |
---|---|---|---|
Cupones | barcodePath | C:/ |
napse/ |
promo71/images/barcode/ | Directorio |
imágenes de |
códigos de barra | |||
Cupones | barcodeUrl | http://localhost:8080/promo/assets/barcode/ | Url |
imágenes de |
códigos de barra |
Cupones | rabbitMQ.couponHistory.endpointName | Nombre de la cola de RabbitMQ para el posteo de datos de tipo CouponHistory | |
Cupones | CODE128 | PPPSSSTTTnnnnnnnnnnnnnnnnnn | Formato de código de barras CODE128. Más detalle ver en: _Formato_de_Código |
Cupones | EAN13 | PPPSSSTTTnnnc | Formato de código de barras EAN13. Más detalle ver en: _Formato_de_Código |
Cupones | UPCA | PPPSSSTTTnnc | Formato de código de barras UPCA. Más detalle ver en: _Formato_de_Código |
Cupones | max.qty | 999 | Cantidad |
máxima de generación Masiva de Cupones por transacción | |||
Cupones | prefix.active | true | Utilizar prefijo |
numérico incremental para tipos de cupón | |||
Cupones | isEditableCouponTypeDistributed | false | Habilita la edición de tipos de cupones en estado "Distribuidos" |
Cupones | visibleDigits | Cantidad de dígitos visibles del código de cliente que se verán en los cupones | |
Cupones | amountFormat | %.02f | Formato en el que se imprimen los montos de los cupones |
Cupones |
nameInfoPos0 |
Indistinto | Descripción de las opciones para el POS | ||
Cupones | nameInfoPos1 | Campo 1 | Descripción de las opciones para el POS |
Cupones | nameInfoPos2 | Campo 2 | Descripción de las opciones para el POS |
Cupones | externalAmountAttributeCodeOfitemAdd | calCouponVal | Atributo que se utilizará en la etiqueta item-add para indicar el monto externo del cupón |
Cupones | default.from | [email protected] | Email por defecto con el que se enviaran los correos |
Cupones | default.insertImages | false | Indica si acepta o no barcodes |
Cupones | default.subject | Promo Test Mail | Asunto por default |
Cupones | host | smtp.gmail.com | Host del proveedor de email |
Cupones | password | ************** | Contraseña de la cuenta de email |
Cupones | port | Puerto de conexión | |
Cupones | smtp.auth | true | Habilitar Auth SMTP |
Cupones | smtp.port | 587 | Puerto SMTP |
Cupones | smtp.socketFactory.class | javax.net.ssl.SSLSocketFactory | nombre de la clase SSLSocketFactory |
Cupones | smtp.socketFactory.fallback | false | Fallback de socketFactory |
Cupones | smtp.socketFactory.port | 465 | Puerto SMTP de socketFactory |
Cupones | smtp.starttls.enable | true | Habilitar Start TLS |
Cupones | smtp.ssl.trust | * | Nombre de host de certif de confianza (* todos) |
Cupones | username | [email protected] | Usuario o nombre de la cuenta de email |
Lista de precios | priceList.distribution.force.offline | false | Habilita la acción descargar contingencia en todo momento |
Lista de precios | priceList.job.cleanPriceListSchedule.time | 90 | Cantidad de días a mantener los ítems en la lista de precios pendientes de impresión |
Lista de precios | priceList.lockForUpate | 15 | Minutos para poder desbloquear Lista cero en el proceso rest |
Lista de precios | priceList.mongo.bulk.insertOrUpdate | 200 | Cantidad de registros a insertar por lote en el proceso rest |
Lista de precios | priceList.distribution.print.before | true | Requiere Impresión previa para poder distribuir Precios. |
Lista de precios | priceList.requiresActivation | false | Parámetro para configurar si requiere activación de listas de precios |
Negocio | moneySymbol | $ | Símbolo de moneda |
Negocio | charsMaximumAlphabetical | 20 | Cantidad máxima de caracteres alfabéticos |
Negocio | charsMaximumNumerical | 20 | Cantidad máxima de caracteres numéricos |
Negocio | charsMaximumQuantity | 20 | Cantidad máxima de caracteres totales |
Negocio | charsMaximumSpecial | 20 | Cantidad máxima de caracteres especiales |
Negocio | charsMinimumQuantity | 7 | Cantidad mínima de caracteres totales |
Negocio | charsMinimumUser | 3 | Cantidad mínima de caracteres en el nombre de usuario |
Negocio | maximumLoginFailedCount | 3 | Cantidad máxima de reintentos de login fallidos sucesivos |
Negocio | numberQuantity | 1 | Cantidad mínima de caracteres numéricos |
Negocio | passwordExpirationDays | 30 | Días de expiración de la contraseña del usuario |
Negocio | publishedDays | 7 | Cantidad de días de antigüedad de precios publicados de competidores |
Negocio | specialCharsQuantity | 0 | Cantidad mínima de caracteres especiales |
Negocio | stringQuantity | 1 | Cantidad mínima de caracteres alfabéticos |
Negocio | userBlockDays | 90 | Bloqueo de usuario - días de inactividad |
Negocio | userLockTime | 30 | Periodo de bloqueo de la cuenta de usuario (en minutos) |
Negocio | competitors.images.path | C: |
\synthesis |
\promo\images\custom\competitors\ | Directorio para |
almacenamiento de |
imágenes de |
competidores |
Negocio |
competitorsPricesItems.images. |
path | C:\synthesis\promo\images\custom\competitorsPricesItems\ | Directorio para almacenamiento de imágenes de precios publicados de competidores | |
Promo | fileDirectory | C:/napse/promo71/catalogs/2\ | Importación de catálogo: directorio donde estarán los archivos |
Promo | decimalSeparator | . | Separador de decimales, solo para Lista de precios y para PromoLite. Para el resto lo toma de la configuración de la máquina. |
Promo | groupingSeparator | , | Separador de miles, solo para Lista de precios y para PromoLite. Para el resto lo toma de la configuración de la máquina. |
Promo | mapFunctionMaxDiscount | false | Agrupar promociones en el mapa dentro de una función con Máximo Descuento para PromoLite. |
Promo | storesLimit | 4 | Límite de tiendas activas disponibles para PromoLite. |
Promo | userLimit | 4 | Límite de usuarios activos disponibles para PromoLite. |
Promo | applicationMethod | resume | Promociones: valor por defecto en el método de aplicación |
Promo | divisionMethod | proportional | Promociones: valor por defecto en el método de división |
Promo | divisionPrice | benefited-price | Promociones: valor por defecto el tipo de precio beneficiado |
Promo | requiredBothSuppliers | false | Promociones: valor por defecto si requiere ambos proveedores del beneficio |
Promo | fileList.txt.Separator | , | Importación de catálogo: separador |
Promo | fileList.xls.ColStart | 0 | Importación de catálogo: columna de comienzo de la importación de catálogo |
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álogo |
Promo | separator | | | Importación de catálogo: separador de columnas |
Promo | updateSize | 100 | Importación de catálogo: tamaño de subida |
Promo | validate.autocomplete.existing | false | Valida que los campos autocomplete de catálogos SOLO permita valores existentes |
Promo | validateRelatedEntities | true | Validar catálogos relacionados al catálogo de clientes |
Promo | attribute.relationship.validation.required | false | Requiere validación de datos de atributos de ítem en la condición de promociones |
Promo | customer.required | false | La promoción requiere condición de Cliente para considerarse completa |
Promo | dateTime.required | false | La promoción requiere condición de Fecha con hora para considerarse completa |
Promo | transaction.required | false | La promoción requiere condición de Transacción para considerarse completa |
Promo | valid.date.couponType | false | Valida si la vigencia de la promoción esta contemplada dentro de la vigencia del cupón |
Promo | distributionThreadPool | 10 | Cantidad de hilos creados para la distribución simultánea |
Promo | promocache.enabled | false | Habilita la generación de cache de ítems participantes en promociones |
Promo | promocache.engineHost | localhost | Servidor en el que corre el motor de cache de promociones |
Promo | promocache.enginePort | 3002 | Puerto en el que corre el motor de cache de promociones |
Promo | promocache.engineRetries | 2 | Reintentos de conexión al motor de cache de promociones |
Promo | promocache.engineTimeout | 8000 | Timeout de conexión al motor de cache de promociones |
Promo | promocache.imagesURL | PromoCache: URL Imágenes Promociones. | |
Promo | promocache.salesPath | C:/napse/promo71/cache/sales/ | Directorio de mapas del motor de cache de promociones |
Promo | promocache.tasksQuantity | 10 | Cantidad de hilos de ejecución del cache de promociones. |
Promo | scheduled.enabled | false | Generación y distribución programada de mapas. |
Promo | scheduled.filter.enable | false | Filtrar promociones por tienda para la distribución programada. |
Promo | scheduled.mapVersion | true | Incrementar la versión del mapa para la distribución programada. |
Promo | microsoft.crm.clientId | Identificador del cliente de Microsoft Dynamics CRM | |
Promo | microsoft.crm.clientSecret | Client Secret de Microsoft Dynamics CRM | |
Promo | microsoft.crm.coupon.batch.size | 1000 | Cantidad de Cupones a enviar por lote a Microsoft Dynamics CRM (Máximo 1000) |
Promo | microsoft.crm.coupon.endpoint | Endpoint de cupones de Microsoft Dynamics CRM | |
Promo | microsoft.crm.enabled | false | Habilita la funcionalidad de exportación a Microsoft Dynamics CRM |
Promo | microsoft.crm.host | Url de host de Microsoft Dynamics CRM | |
Promo | microsoft.crm.tentantId | TenantId de Microsoft Dynamics CRM | |
Promo | microsoft.crm.urlAuth | https://login.microsoftonline.com/ | Url de autenticación de Microsoft Dynamics CRM |
Promo | path | C:/napse/promo71/import/ | Directorio para la importación de Mapas de Promociones. |
Promo | benefit.active | false | Utilizar campo numérico incremental para beneficios |
Promo | promotion.code.active | false | Utilizar campo numérico incremental para promociones |
Promo | redeemedPoints | 0 | Determina el mínimo de puntos para beneficios de redención |
Promo | use.item.catalog | true | Mapas: algoritmo de cálculo de colisiones |
Promo | cleanEngineStatusHistory | 7 | Tiempo en días que la consola mantendrá el historial de estados del motor |
Promo | dateEditableIfActive | true | Habilita la edición de la fecha de inicio de vigencia de la promoción |
Promo | defeatedEditable.enabled | true | Habilita la edición de promociones vencidas |
Promo | deployedEditable.enabled | false | Habilita la edición de promoción con el estado Deployed. |
Promo | file.xls.header.rowStart | 1 | Alta masiva de promociones: número de fila donde se va a ubicar la cabecera de la plantilla de promoción. |
Promo | message.printer.maxLength | Recortar mensaje para la impresora. | |
Promo | promo.name.code | false | Indica si el código de una promoción, debe ser concatenado al nombre de la misma. |
Promo | promotion.codeKey | false | Campo código de promoción clave. |
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. |
Promo | promotion.images.height | 250 | Promociones: alto default de las imágenes |
Promo | promotion.images.path | C:/napse/promo71/images/promotion/ | Promociones: directorio para almacenamiento de imágenes |
Promo | promotion.images.width | 250 | Promociones: ancho default de las imágenes |
Promo | rabbitMQ.SSL.enabled | false | Activar SSL |
Promo | rabbitMQ.cardhistory.endpointName | Nombre de la cola de RabbitMQ para el posteo de datos de tipo CardHistory | |
Promo | rabbitMQ.enabled | false | Propiedad que indica si está habilitado rabbitMQ |
Promo | rabbitMQ.endpointName | Nombre de la cola de rabbitMQ | |
Promo | rabbitMQ.enginestatus.endpointName | Nombre de la cola de RabbitMQ para el posteo de datos de tipo EngineStatus | |
Promo | rabbitMQ.host | Dirección (host) del RabbitMQ server | |
Promo | rabbitMQ.limitstatus.endpointName | Nombre de la cola de RabbitMQ para el posteo de datos de tipo LimitStatus | |
Promo | rabbitMQ.password | Password para acceder al rabbitMQ | |
Promo | rabbitMQ.port | Puerto del server rabbitMQ | |
Promo | rabbitMQ.producer.SSL.enabled | true | Activar SSL para el posteo de datos |
Promo | rabbitMQ.producer.enabled | false | Propiedad que indica si esta habilitado rabbitMQ para el posteo de datos. |
Promo | rabbitMQ.producer.host | Dirección (host) de RabbitMQ server para el posteo de datos. | |
Promo | rabbitMQ.producer.manual.promotion.enabled | false | Habilitar el posteo manual de datos desde la promoción. |
Promo | rabbitMQ.producer.password | Password para acceder al RabbitMQ server para el posteo de datos. | |
Promo | rabbitMQ.producer.port | Puerto del RabbitMQ server para el posteo de datos | |
Promo | rabbitMQ.producer.uri | URI de conexión completa RabbitMQ server para el posteo de datos | |
Promo | rabbitMQ.producer.username | Usuario para acceder a RabbitMQ server para el posteo de datos | |
Promo | rabbitMQ.producer.virtualHost | Virtual Host RabbitMQ server para el posteo de datos | |
Promo | rabbitMQ.promotion.endpointName | Nombre de la cola de RabbitMQ para el posteo de datos de tipo Promotion | |
Promo | rabbitMQ.promotionsCache.endpointName | Nombre de la cola de RabbitMQ para el posteo de datos de tipo PromotionsCache | |
Promo | rabbitMQ.transaction.endpointName | Nombre de la cola de RabbitMQ para el posteo de datos de transacciones. | |
Promo | rabbitMQ.uri | URI de conexión completa rabbitMQ | |
Promo | rabbitMQ.username | Usuario para acceder al rabbitMQ | |
Promo | rabbitMQ.virtualHost | virtual Host al rabbitMQ | |
Promo | reportParticipants | false | Promociones: valor global que determina si la promoción informa participantes |
Promo | reportParticipantsVisible | true | Determina si se visualiza o no, la opción reportar participantes |
Promo | vtol.url | Url para obtener los planes de pago de Vtol | |
Promo | bankRefundBenefit.method.of.payment | NOTHING= No calcular promociones por medio de pagos. ON_ITEMS_PAID= Calcular promociones sobre ítems pagados ON_PAYMENT_MADE=Calcular promociones sobre pago realizado | Reintegro bancario: Opciones de cálculo de reintegro |
Promo | bankRefundBenefit.method.of.payment.onItemsPaid.class | com.synthesis.promo.engine.partialPayment.hardcoded.promotion. BankRefundPartialPaymentGSPromotion | Reintegro bancario: Clase de la promoción basada en ítems. |
Promo | bankRefundBenefit.method.of.payment.onItemsPaid.name | Promociones basadas en ítems - Reintegro bancario | Reintegro bancario: Nombre de la promoción basada en ítems. |
Promo | bankRefundBenefit.method.of.payment.onItemsPaid.tenderMethodPropertyKey | promo.configuration.tenderMethod.itemMethod | Reintegro bancario: Propiedad basada en ítems a utilizar. |
Promo | bankRefundBenefit.method.of.payment.onPaymentMade.class | com.synthesis.promo.engine.partialPayment.hardcoded.promotion. BankRefundPartialPaymentSSPromotion | Reintegro bancario: Clase de la promoción basada en pagos. |
Promo | bankRefundBenefit.method.of.payment.onPaymentMade.name | Promociones basadas en pagos - Reintegro bancario | Reintegro bancario: Nombre de la promoción basada en pagos. |
Promo | bankRefundBenefit.method.of.payment.onPaymentMade.tenderMethodPropertyKey | promo.configuration.tenderMethod.paymentMethod | Reintegro bancario: Propiedad basada en pagos a utilizar. |
Promo | method.of.payment | NOTHING= No calcular promociones por medios de pago. ON_ITEMS_PAID = calcular promociones sobre ítems pagados. ON_PAYMENT_MADE = Calcular promociones sobre pago realizado. | Promoción Codificada: NOTHING, ON_ITEMS_PAID, ON_PAYMENT_MADE. |
Promo | method.of.payment.onItemsPaid.class | com.synthesis.promo.engine.partialPayment.hardcoded.promotion. PartialPaymentsGSPromotion | Promoción Codificada: nombre de la promoción por medio de pago basada en ítems. |
Promo | method.of.payment.onItemsPaid.name | Promociones basadas en ítems | Promoción Codificada: nombre de la promoción por medio de pago basada en ítems. |
Promo | method.of.payment.onItemsPaid.tenderMethodPropertyKey | promo.configuration.tenderMethod.itemMethod | Promoción Codificada: nombre de la promoción por medio de pago basada en ítems. |
Promo | method.of.payment.onItemsPaid.class | com.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsGSPromotion | Promoción Codificada: nombre de la promoción por medio de pago basada en ítems. |
Promo | method.of.payment.onPaymentMade.name | Promociones basadas en pagos | Promoción Codificada: nombre de la promoción por medio de pago basada en ítems. |
Promo | method.of.payment.onPaymentMade.tenderMethodPropertyKey | promo.configuration.tenderMethod.paymentMethod | Promocion Codificada: nombre de la promoción por medio de pago basada en ítems. |
Promo | ldapAuthentication | false | Determina si se autentica contra un Directory Service. |
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. |
Promo | ldapAuthentication.urlServer | URL del server contra el que se autentica. | |
Promo | testEngineADDR | localhost | Simulación: Dirección del motor para simulación. |
Promo | testEnginePORT | 3001 | Simulación: puerto en el que corre el motor para simulación |
Promo | testEngineRetries | 2 | Simulación: reintentos de conexión al motor |
Promo | testEngineSalesPath | C:/napse/promo71/engine/sales/ | Simulación: ruta del motor. |
Promo | testEngineTimeout | 8000 | Simulación: timeout de conexión al motor. |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de marcas ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de categorías ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de canales ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de compañia crediticia ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de clientes ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de tipos de clientes ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de transacciones ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de tipos de transacción ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de tipos de familia ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de formatos ante un error |
Promo | continueOnError | true | Permitir continuar la importación del catálogo de información financiera de lista de precios ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de items ante un error |
Promo | continueOnError | true | Permitir continuar la importación del catálogo de stock ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de tipos de Departamento ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de bancos ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de pagos (Código) ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de prefijos ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de tipos de pagos ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de códigos de barra ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de código de productos ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de perfil de cliente ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de Canje de Puntos por Catalogo ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de tiendas ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de cadenas ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de sub categorías ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de subzonas ante un error |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de proveedores ante un error. |
Promo | continueOnError | true | Permitir continuar la importación de catálogo de zonas ante un error. |
Redes sociales | facebook.appId | Id de la aplicación de facebook | |
Redes sociales | facebook.permissions | [ |
pages_show_list, pages_read_engagement, pages_manage_posts] | Permisos de la aplicación de facebook |
Redes sociales | facebook.secret |
Clave secreta de la aplicación de facebook | |||
Redes sociales | twitter.accessToken | 2848331890-D2geAfGVL9u2bD6TrD1LxH5fUsXlBnHLa3FOziK | Token de acceso a twitter |
Redes sociales | twitter.accessTokenSecret | NHd6JbcoLaBK5QEfrKgmOaQwwxmbwlEtOYlQni3Fx6H3y | Token secreto de acceso a twitter |
Redes sociales | twitter.consumerKey | HTPKOHdatasoDsm2Ud7ULnUapAKFXoC | Clave consumer key de twitter |
Redes sociales |
.consumerSecret | X1plqdQWK0nRCGz6KFxm37IZTzp4O7w9BjLSspIr4mYWLZsrOy | Clave consumer secret de twitter | |
Tarjetas de fidelidad | max.qty | 999 | Cantidad máxima de tarjetas de fidelidad a generar por cada operación de alta masiva |
Tarjetas de fidelidad | isEditableAfterCardsGeneration | false | Permitir la edición del tipo de tarjeta luego de haber generado una tarjeta activa. |
Tarjetas de fidelidad | prefix.active | false | Utilizar prefijo numérico incremental para tipos de tarjeta |
Tarjetas de fidelidad | code.active | false | Utilizar código numérico incremental para tipos de tarjeta |
Tarjetas de fidelidad | card.nominated.default.option | No | Tipo de tarjetas de fidelidad: Crear por defecto nominadas (default: false = no) |
Tarjetas de fidelidad | continueOnError | true | Permitir continuar la importación |
del catálogo de tarjetas de fidelidad ante un error. | |||
Tarjetas de fidelidad | insertionOption | INSERT_OR_UPDATE | Describe la opción de inserción para la importación del catálogo |
de tarjetas de fidelidad. | |||
Transacciones | cleanTransactions | 90 | Cantidad de días que permanecerán los registros de transacciones en la base de datos |
Podrán existir cambios correspondientes a:
...
Al acceder a la URL indicada más arriba, se accederá a la sección de "Facebook for Developers" de Facebook.Se
Debe iniciar sesión, desde el botón correspondiente:
Al ingresar, se deberá dar clic en "Mis Apps".
Una vez allí, habrá que dar clic en el botón verde de "Crear app".
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".
...
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.
Aviso | ||
---|---|---|
| ||
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. |
...
Informações | ||
---|---|---|
| ||
Se deberá ser administrador tanto de la pagina como de la aplicación generada en Facebook para poder realizar las publicaciones desde PROMO. |
Aviso | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||
Https obligatorio para la publicacion publicación en FacebbokFacebook 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
<security-realm name="ApplicationRealm"/>
<server name="default-server"/>
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. |
...
Parámetro | Valor por defecto | Descripción | |
---|---|---|---|
promo.general.cvvOnlyForConsume | false | Ver Validar CVV solo cuando se realiza un consumo en una Tarjeta de Fidelidad | |
promo.delimiters | space | Ver Configuración Atributos con espacios en Condiciones Simples | |
promo.allowNonExistingCustomers | false | Ver Alta de cliente durante la transacción | |
promo.transaction.batch.size | 1000 | Cantidad | maximamáxima de transacciones que se procesarán cada vez que se ejecute la tarea programada (default 30 segs.). Este parámetro puede afectar la performance del sistema. |
promo.general.pauseQuartz | false | En ambientes multinodo, permite desactiva la ejecución de las tareas programadas en alguno de dichos nodos. Esta opción permite que nodos con poca capacidad de procesamiento ejecuten tareas que requieran mayor cantidad de recursos. | |
promo.lv.enableUpsertCustomers | true | Permite la creación o actualización de clientes durante el LoyaltyValidation. Esto es, cuando se envia a validar un cliente y se especifican datos clave, se intentara crear o actualizar dicho cliente. | |
promo.lv.returnCustCards | true | Indica que la respuesta a un loyaltyValidation de cliente debe retornar las tarjetas asociadas al mismo. | |
promo.lv.returnCustCoupons | true | Indica que la respuesta a un loyaltyValidation de cliente debe retornar los cupones asociados al mismo. | |
promo.lv.returnSegments | true | Indica que la respuesta a un loyaltyValidation de cliente debe retornar los segmentos asociados al mismo. | |
promo.lv.returnContracts | true | Indica que la respuesta a un loyaltyValidation de cliente debe retornar los contratos asociados al mismo. | |
promo.backupOptions | --gzip | indica que el backup va a ser comprimido a nivel colección. Si tiene un valor diferente la base no va a comprimir a nivel colección. | |
promo.card.customersNonNominated | true | Permite que al validar que se considere al CPF como si fuera una tarjeta nominada. | |
promo.transaction.flatten.batch.size | 250 | Indica la cantidad de transacciones a aplanar por cada corrida del job aplanado |
Âncora 1. Validar CVV solo cuando se realiza un consumo en una Tarjeta de Fidelidad 1. Validar CVV solo cuando se realiza un consumo en una Tarjeta de Fidelidad
...
Se disponibiliza la posibilidad de poder indicar por configuracion configuración que el CVV de una tarjeta de Fidelidad solo sea validado cuando se realiza un consumo de saldos en ella.
...
Reverso de actualizaciones ante problemas en el proceso
Ante algun algún problema durante la actualizacion actualización de una version versión de consola o motor, debera de deberá bajarse los servicios involucrados y colocar el archivo .war o .jar anterior, segun según se trate de una actualizacion actualización de consola o motor respectivamente y volver a subir los servicios.
Luego de reesablecido reestablecido el sistema contactar a Sericios Servicios de Atencion Atención al Cliente para poner en conocimiento de lo sucedido con el proceso de actualizacionactualización
...
Apéndice A: Autenticación de Usuarios Externos (SAML2)
Por medio de la implementacion implementación en PROMO de SAML2 se lograra la integración de PROMO con un sistema de autenticacion externos autenticación externos de usuarios de la consola de PROMO.
...
Aviso | ||
---|---|---|
| ||
Al utilizar un sistema de autenticacion autenticación externos los usuarios dados de alta en la consola no deberán poseer ningún tipo de configuracion configuración de políticas de seguridad de PROMO. |
...