PROMO - Manual de Instalação 6.5

1. Introdução

O PROMO é uma solução que permite separar o gerenciamento das promoções do ponto de venda.
Possui dois componentes principais: o " Motor de Promoção ", encarregado de calcular as promoções participantes quando uma transação é feita no ponto de venda e informá-las assim que o cálculo for concluído; e o " Console de administração ", encarregado de fornecer uma ferramenta de administração centralizada.
Este manual ilustra como instalar os componentes e as diferentes opções que podem ser configuradas para operação.

Console de Administração - PROMO

1. Introdução

O console de administração é o componente da web para administração e criação de promoções, cupons, cartões de fidelidade e mapas que o PROMO possui. Através desta ferramenta, você pode, entre outras coisas, criar promoções e definir suas condições, cupons, cartões, combos e benefícios. Você também pode criar os mapas que contêm as promoções e, em seguida, gerar os arquivos de configuração que serão carregados no " Motor de Promoção ", para que os tickets possam ser avaliados e as promoções calculadas com base nas definições geradas no Console.

Requisitos pré-sistema

Os requisitos mínimos para a instalação do PROMO Management Console que operará com uma (1) empresa estão detalhados abaixo.
Os requisitos mínimos de hardware são fornecidos como um guia para dimensionar um ambiente não produtivo. Para instalações em ambientes produtivos com requisitos específicos de desempenho e volume de dados, é necessário um dimensionamento específico para estimar a configuração apropriada.

EXECUTANDO O INSTALADOR (WINDOWS)

O Instalador " promo-console-installer-6.5.0.jar " deve ser executado como administrador no modo de comando para continuar com a instalação e configuração do console PROMO e do mecanismo de simulação. Para isso, o comando java –jar promo-console-installer-6.5.0.jar deve ser executado.Os seguintes componentes essenciais para a operação correta do aplicativo também serão instalados:

• Wildfly 9.
• PromoSimEngine xx (mecanismo de simulação)
• MongoDB 3.6

Os serviços do MongoDB, Wildfly e PromoSinEngine serão instalados e poderão ser escolhidos no momento da instalação se forem executados no final do processo de instalação ou se forem iniciados manualmente, caso seja necessário fazer configurações anteriores no início dos serviços. 
Em relação ao serviço Wildfly, o diretório sugerido será inicialmente configurado por padrão, ocupando a porta 8080.
No final do instalador, todos os serviços e diretórios correspondentes serão criados.

INSTALE O APLICATIVO

O instalador do PROMO deve ser executado como administrador, no modo de comando ( promo-console-installer-xxxjar )

A seguinte tela aparecerá onde você deve pressionar " Next ":

Em seguida, será solicitada a aceitação dos termos e condições de uso do aplicativo.

Após aceitar os termos e condições, você será solicitado a identificar o nome do usuário e o e-mail de quem (empresa ou pessoa) está executando a instalação.

Em seguida, o caminho para Java (JDK) e o diretório em que a instalação do Promo será realizada devem ser indicados. Por padrão, " c: \ synthesis \ Promo " é proposto . O diretório em que o banco de dados será instalado (MongoDb) também deve ser indicado.

Se os diretórios não existirem, será solicitada autorização para criar os diretórios necessários para a instalação do PROMO.

Você será solicitado a indicar o diretório em que o Wildfly será instalado.

Se o diretório não existir, será solicitada autorização para criá-lo.

 Você será solicitado a se informar se deseja instalar ou ativar apenas os serviços que são instalados com o PROMO.

Na próxima tela exibida, você terá que pressionar o botão " Instalar " para iniciar o processo de instalação do PROMO e seus componentes.

Quando a instalação estiver concluída, a seguinte janela será exibida onde a instalação correta do console do PROMO será relatada e será solicitado que você clique em " OK " para concluir o processo.

ESTRUTURA DE DIRETÓRIOS

Após a instalação do console de administração, uma estrutura de diretório semelhante à seguinte permanecerá no diretório de instalação (por exemplo: "c: \ synthesis \ promo").
Os seguintes diretórios e arquivos são alguns dos que devem ser considerados:

• síntese \ promo \ images : diretório de imagens
• \ synthesis \ promo \ images \ profile
• \ synthesis \ promo \ images \ barcode - Contém as imagens de código de barras associadas aos cupons emitidos.
• \ synthesis \ promo \ images \ promotion: contém as imagens associadas às promoções
• \ synthesis \ promo \ logs: informações sobre os rastreamentos da execução do aplicativo, incluindo informações técnicas sobre qualquer falha.
• \ synthesis \ promo \ backup: backups do banco de dados MongoDB
• \ synthesis \ promo \ import: diretório em que os mapas para importação de promoções devem ser armazenados.
• \ synthesis \ promo \ mdb: aqui estão as funções usadas no banco de dados.
• \ synthesis \ promo \ engine: o mecanismo de promoções usado pelo console para simulá-los.
• \ synthesis \ promo \ catalogs: diretório em que os arquivos de catálogo (. catálogos ) que serão importados ao iniciar o aplicativo serão armazenados. As pastas correspondentes a cada empresa devem ser geradas manualmente, indicando o ID da empresa no nome do diretório. (Ex: \ synthesis \ promo \ catalogs \ 22, em que 22 corresponde ao ID da nova Ccia)

Instalação do Linux (CentOS 7)

Os seguintes componentes são necessários antes de instalar o console:

• MongoDB 3.6
• JDK 1.8.0_25

Juntamente com o console PROMO, o mecanismo de simulação e o Wildfly serão instalados durante o processo.

INSTALAÇÃO DO MONGODB 3.4

As etapas podem ser seguidas na documentação de instalação online do Mongo.

Linux: https://docs.mongodb.com/v3.4/tutorial/install-mongodb-on-red-hat/

Após a instalação do mongo, sua segurança deve ser configurada da seguinte maneira:

1. Execute o serviço Mongo usando o serviço sudo mongod start

2. Execute o comando mongo

3. O sistema estará dentro do console do Mongo, com o qual os seguintes comandos devem ser executados ali:

4. Saia do console usando o comando " exit "

5. Execute o comando> service mongod stop para interromper a execução do mongo.

6. Edite o arquivo /etc/mongod.conf e remova o comentário da tag " Security " para ativar a segurança, colocando a seguinte linha, conforme mostrado na imagem:

INSTALAÇÃO DE APLICATIVOS (CONSOLE PROMOCIONAL)

O instalador entregue na linha de comandos deve ser executado como root da seguinte maneira:

Onde XXX Corresponde ao número da versão do PROMO que está sendo instalado.

Depois que o instalador for executado, o arquivo começará a descompactar para iniciar a instalação,

Após a descompressão, será solicitada autorização para prosseguir com a instalação do aplicativo, clique em " Avançar "

Na próxima tela, você deve aceitar os termos e condições de uso, depois de lidos, se concordar, clique em " Aceitar " para continuar.

É necessário fornecer um nome (pessoa ou organização natural) e um email para registrar o aplicativo e prosseguir com a instalação, além de solicitar a confirmação da aceitação dos termos e condições.
Preencha os campos, pressione " Avançar ":

Em seguida, o caminho para Java (JDK) e o diretório em que a instalação do Promo será realizada devem ser indicados. Por padrão, " / usr / local / promo / " é proposto . O diretório em que o banco de dados será instalado também deve ser indicado (MongoDb)

Se os diretórios não existirem, será solicitada autorização para criar os diretórios necessários para a instalação do PROMO.

Pressione " Sim "

Na próxima janela, você será solicitado a indicar o diretório em que o Wildfly será instalado. Se o diretório não existir, será solicitada autorização para criá-lo. Clique em "Yes"

Para iniciar a instalação, na próxima tela, você deverá pressionar o botão " Instalar " para iniciar o processo de instalação do PROMO e seus componentes.

Durante a instalação, será apresentada uma janela de progresso, na qual é possível visualizar os componentes que estão sendo instalados e seu progresso. Quando o processo estiver concluído, será exibido um pop-up do processo finalizado, onde você deve pressionar " Aceitar " e depois " Sair " para finalizar o processo.

Após a instalação do console, será necessário iniciar o Wildfly, o que pode ser feito manualmente, executando " sudo ./standalone.sh " ou o Wildfly pode ser configurado como um serviço no Linux, seguindo as etapas indicadas na Web para esse fim.

CONFIGURAR O SIMULATION ENGINE COMO UM SERVIÇO NO LINUX

Um arquivo deve ser gerado a partir de qualquer editor de texto chamado " promo.service " e deve conter as seguintes linhas:

Depois que o arquivo é gerado, ele deve ser salvo em  / etc / systemd / system e execute o seguinte comando para notificar o sistema:

Você precisará habilitá-lo para executar na inicialização com o seguinte comando:

Se for necessário atuar no serviço, os seguintes comandos podem ser executados:

systemctl iniciar promo  → iniciar serviço
systemctl parar promo → parar serviço
systemctl reiniciar promo → reiniciar serviço
systemctl status promo   → exibir serviço status1

PROMO - PONTE

Durante a instalação do console de promoções, será possível indicar se ele funcionará integrado ou não com o Bridge.
Nesse caso, será necessário ter o Bridge Manager instalado anteriormente, pois o Promo usará os serviços e visualizações do Bridge.

Para instalar o console integrado ao Bridge, durante o processo de instalação, no Windows ou no Linux, a opção "Instalar integração com o Bridge" deve ser verificada na janela Opções de instalação

Com o qual, ao pressionar "Next", o próximo popUp será exibido como o caminho para o Wildfly, o diretório em que o Bridge App Server está instalado.
Também deve ser observado que o arquivo de configuração para conexões com a base Bridge, entre outras configurações específicas do PROMO, será " promoconfig.properties ".

Neste arquivo, além de encontrar as opções de configuração básica da promoção (mongoDB) e a estrutura de diretórios padrão, você também encontrará os valores de configuração para integração com o Bridge, esteja usando um banco de dados SQL ou Oracle.


Exemplo: Se um esquema de banco de dados ou outro for usado, a opção correspondente precisará ser decomposta e configurada.

CONFIGURAR O ENVIO DE PREFIXOS DE CUPOM E CARTÃO PARA O BRIDGE

1- No console da PROMO. Vá para Administração> Informações de configuração.

2- Procure por " soap.url " (chave) da categoria promo.bridge .

O valor deve ser a URL para o serviço Bridge Manager que espera receber os prefixos. Exemplo: http: //10.x.1x.1x: 8180 / bridge / services / bridgeCoreSOAP? Wsdl .

3 Para forçar a execução do serviço pode executar o trabalho "Tipos Export cartão e cupons Bridge (SOAP)" Administração> T áreas programadas.

Execução do Sistema

ACESSE O CONSOLE DE ADMINISTRAÇÃO

Depois de instalado, o console do PROMO pode ser acessado em alguns dos seguintes navegadores suportados pelo Promo: Firefox ou Google Chorme ,

Digite o seguinte URL na barra de endereços do navegador :

http: // servidor de IP : 8080 / promo

Onde IP-SERVER é o endereço IP ou DNS do computador em que o servidor de aplicativos está em execução.

ERROS DE INSTALAÇÃO DO CONSOLE

• 404 - ERRO de inicialização do instalador

  
  
  
  Este erro pode ocorrer quando a instalação do console não inicia em uma tela de comando executada como administrador. O instalador do PROMO deve ser executado como administrador, no modo de comando (promo-console-installer-6.xxjar)

ERROS DE INICIALIZAÇÃO DO CONSOLE

• 404 - ERRO (ao iniciar o aplicativo WEB)
  Esse erro pode ocorrer porque o serviço WildFly não foi iniciado. Ele deve ser verificado nos serviços do sistema que o serviço WildFly está executando. Caso contrário, inicie-o, atualize a página do navegador e tente novamente.Outra
  razão pela qual esse erro pode ocorrer é que o aplicativo não foi descompactado corretamente, para corroborá-lo, você deverá verificar a síntese de diretório de instalação \ promo \ appserver \ standalone \ deployments se houver um arquivo chamado " promo.war.failed ". Se esse arquivo for encontrado, isso indicará que ocorreu um erro na inicialização do aplicativo. Entre em contato com o administrador do sistema para obter sua solução.

Motor de Promoções

1. Introdução

Conforme mencionado no ponto anterior, o mecanismo de promoção é o componente PROMO encarregado de receber os ingressos diretamente do ponto de venda, processá-los e, finalmente, relatar as promoções que participaram e os itens afetados.
A instalação do mecanismo de promoção é feita em conjunto com a instalação do console Promo, quando o instalador do aplicativo é executado. A comunicação é estabelecida através de mensagens XML enviadas usando TCP / IP, REST ou Pipes (IBM 4690).

Requisitos pré-sistema

A tabela a seguir detalha os requisitos mínimos e recomendados para a instalação do mecanismo de promoção:

Instalação (Linux / Windows)

INSTALAÇÃO DO MECANISMO PROMO A PARTIR DO INSTALADOR

Um arquivo promo-gengine-installer-XXXjar é fornecido em que XXX é a versão do mecanismo que está sendo instalado ( 6.5.0 ).
O instalador do PROMO Engine deve ser executado como administrador, no modo de comando ( promo-gengine-installer-XXXjar )

Quando o instalador for executado, a seguinte janela aparecerá:

Pressione "Next" para continuar.

Os termos e condições devem ser aceitos para continuar com a instalação do mecanismo PROMO.

Clique em " Aceitar " para continuar.

Após aceitar os termos e condições, será solicitado que o nome do usuário e o e-mail de quem (empresa ou pessoa) esteja executando a instalação sejam identificados.

Pressione " Next " para continuar.

Em seguida, o caminho para Java (JDK) e o diretório em que a instalação do mecanismo PROMO será executada devem ser indicados. Por padrão, " c: \ synthesis \ gengine " é proposto . 

Pode ser indicado aqui, por meio da verificação "Instalar servidor REST (TCP / IP padrão)", para que o mecanismo seja instalado como REST SERVER, se não estiver instalado por padrão no modo TCP / IP.

Pressione " Next " para continuar.

No próximo pop-up, você deve indicar o URL de acesso a "Diretor" para atualizações futuras e o código de loja utilizado pelo mecanismo.

Pressione " Next " para continuar.

Na próxima tela exibida, você deverá pressionar o botão " Instalar " para iniciar o processo de instalação do mecanismo PROMO e de seus componentes.

Após a instalação, a seguinte janela será exibida onde a instalação correta do mecanismo PROMO será relatada. Você será solicitado a clicar em " Aceitar " e depois em " Sair " para finalizar o processo. 

Após a conclusão do processo de instalação do mecanismo de promoções, é possível verificar a existência de dois novos serviços correspondentes ao mecanismo de promoções e ao Agente de Gerenciamento nos serviços do sistema, que já estarão em execução atomisticamente, fato que marcará a instalação e o comissionamento corretos do Novo mecanismo da PROMO.

INSTALAÇÃO DE VERSÕES ANTERIORES DO MECANISMO PROMO

Um arquivo g-engine-xxx-installer.zip é fornecido em que xxx é a versão do mecanismo que está sendo instalado. Para instalar:

1. Crie uma pasta onde o mecanismo será executado (tenha cuidado para ter permissões de alfabetização)
2. Descompacte o conteúdo do zip na pasta.
3. Modifique o arquivo conf / config.xml com os parâmetros de configuração corretos de acordo com o ambiente no qual ele estará executando.
4. Execute no modo de comando como administrador " tcp.bat " no Windows ou " sudo ./tcp.sh " no Linux.

Configurações gerais do mecanismo:

ARQUIVOS DE CONFIGURAÇÃO

CONFIG.XML

</simulation> : indica se o mecanismo opera para simulações no console ou não. Valor padrão "False" (sem simulação)
</compatibilityMode> : indica se o mecanismo opera em um modo compatível com o mecanismo antigo (4690 Integrations) ou não, agrupando os benefícios nas respostas fornecidas pelo mecanismo. Por padrão, o parâmetro é definido como "False" (Incompatível), portanto, nesse modo, agrupa os benefícios (novo mecanismo). Se o benefício estiver definido como "Verdadeiro", os benefícios não serão agrupados (compatibilidade com o mecanismo antigo).
</ mapIdentifiers >: identificará as pastas pelas quais o mecanismo pesquisará o mapa para avaliar a promoção. Eles devem ser definidos em uma lista separada por vírgula.
<>: indica por qual atributo o ticket será identificado quando o mecanismo funcionar como uma empresa múltipla.
</disableLoyalty>: o valor padrão deste parâmetro será "false", indicando que o mecanismo mantém comunicação com o PROMO central para o gerenciamento de elementos de lealdade. Se esse parâmetro for definido como "true", a comunicação com o PROMO central será desativada, para que um status de Concluir, confirmar, retroceder etc. seja avaliado como um status de "vendas" (método de avaliação anterior ao Fidelity).

</disablePrices>: o valor padrão deste parâmetro será "false", indicando que o mecanismo usa avaliadores, isso permitirá a funcionalidade de preços (as listas de preços são geradas a partir do console e serão distribuídas ao mecanismo) e o status de preços e, no caso de usar itens com unitPrice = 0, ele procurará os preços dos preciosos (listas de preços) . Se definido como "true", este parâmetro indica que essa funcionalidade NÃO está ativada.
</engineId>: identificador exclusivo do mecanismo. Ele deve ser configurado quando você desejar que o mecanismo relate seu mapa ativo no console do PROMO. </engineName>:
Nome exclusivo do mecanismo. Juntamente com o "EnginerId", ele deve ser configurado quando você deseja que o mecanismo relate seu mapa ativo no console do PROMO.


Configuração de operação off-line do motor:

Configuração dos preços de operação (contingência) do Motor:

Diretório onde você fará os mapas:

Definir decimais na resposta:

<roundPoints>2</roundPoints>
<!-- decimais na resposta de pontos:  roundDown/roundMath (default) v6.5.9 -->
<roundPointsMethod>roundMath</roundPointsMethod>

</response>

Portas

Conexão com o PROMO Central

LOGGING.PROPERTIES

Nesse arquivo, os níveis de log do console podem ser configurados, com o nível SEVERE sendo o nível padrão e TODO o nível de log para depuração.

MECANISMO DE VÁRIAS LOJAS

O Motor de Promoção tem a capacidade de pegar e ler mapas de diferentes diretórios. Cada diretório corresponderá a uma loja diferente e em cada diretório você poderá listar um conjunto de mapas.
O modo Multi-store é ativado por configuração, sendo desativado por padrão. As mensagens associadas ao mecanismo não serão alteradas pela ativação do modo Multi-store.

CONFIGURAÇÃO MULTI-STORE

Para que o mecanismo de promoção funcione no modo Multi-Store, o arquivo "... \ conf \ Config.xml" deve ser editado e a seguinte tag deve ser editada:

Onde em <mapIdentifiers> </ mapIdentifiers> serão identificadas as pastas pelas quais o mecanismo pesquisará o mapa para avaliar a promoção. Eles devem ser definidos em uma lista separada por vírgula.
No caso de você ter elementos em <ticketIdentifiers> </ ticketIdentifiers> deve ser definido apenas "terminal" porque no bilhete será sempre ser identificado pela concatenação de <mapIdentifiers> e <ticketIdentifiers>
Para alterações para ser devidamente deveriam salve as alterações e reinicie o mecanismo de promoção.

Manutenção - Motor

DEPURANDO ARQUIVOS DE LOG

Como mencionado acima, os arquivos em que os eventos que ocorrem no mecanismo de promoção são registrados são armazenados em um ou mais arquivos de log. Esses arquivos podem aumentar de tamanho dentro do disco rígido, ocupando espaço que o usuário pode usar para outros fins. Portanto, alguns desses arquivos podem precisar ser removidos para liberar espaço.
Para excluir os arquivos de log, será necessário consultar o arquivo de configuração de log ( ../conf/logging.propertiesl ). Ele especificará as políticas, arquivos e diretórios de log destinados a esse fim.

ERROS DE INICIALIZAÇÃO

A seguir estão os erros que podem ocorrer ao iniciar o mecanismo de promoção:

• java.io.FileNotFoundException: \ log \ 669comm.log (O sistema não pode encontrar o caminho especificado)
  • Indica um erro na configuração do arquivo de log. O erro indica que ele não pode encontrar o caminho ou o arquivo '\ log \ 669.comm.log'. Para corrigi-lo, é recomendável verificar o arquivo de configuração config / log4j.xml.

• Exceção no segmento "main" java.lang.NoClassDefFoundError:…
  • Este erro ocorre quando há erros no caminho de classe.

• java.net.BindException: Endereço em uso: JVM_Bind
  • Este erro ocorre quando a porta de comunicação que o Motor de Promoção usará é reservada ou está sendo usada por outro aplicativo. Isso só pode acontecer em uma comunicação TCP / IP. Para resolvê-lo, é recomendável determinar qual aplicativo está usando a porta e fechá-lo ou configurá-lo para usar outro, ou modificar as configurações do Mecanismo de Promoção para estabelecer suas comunicações por uma porta diferente (por meio do arquivo de configuração, propriedade PromoCommunication. .port ).

ERROS DE PROCESSAMENTO

Durante sua operação, o mecanismo de promoções pode relatar erros semelhantes aos listados abaixo:

• [promo.MIDDLEWARE] ERRO DE VALIDAÇÃO DO PROMOENGINE: [P01] componente combinado: uso inválido de critérios de pedidos com este conjunto
  Indica que ocorreu um erro na validação de qualquer mapa que você está tentando carregar. O valor entre colchetes indica em qual promoção o erro ocorreu. Se os colchetes não existirem, significa que ocorreu um erro na definição da coexistência das promoções encontradas no mapa. O texto após os colchetes descreve o tipo de erro que ocorreu. Da mesma forma, antes dessa linha de log, é encontrado o mapa que foi tentado carregar.

• [promo.MIDDLEWARE.MESSAGING] Mensagem não aceita: exceção do analisador que analisa a mensagem de entrada: o conteúdo não é permitido no prólogo.
  Indica que uma solicitação ou ticket foi recebido que não respeita o formato definido para o sistema de mensagens. Nesses casos, o mecanismo responderá ao terminal que enviou a solicitação com uma mensagem de resposta com um código de erro (consulte "Manual de Mensagens - Promoção").

• [promo.MIDDLEWARE] Não há PromoEngine disponível para processar esta solicitação.
  Essa mensagem é emitida quando o Mecanismo de Promoção recebe uma solicitação indicando o uso de uma versão de mapa inexistente. Como no caso anterior, como não pode resolver a solicitação, ela responderá com uma mensagem que especificará um código de erro (consulte "Manual de referência técnica - API promocional").

• [promo.MIDDLEWARE.MESSAGING] - AVISO: BILHETE INVÁLIDO: cvc-datatype-valid.1.2.1: 's250.0' não é um valor válido para 'double'.
  Indica que uma solicitação ou ticket foi recebido com um valor ou tipo de dados inválido. Nesse caso, o mecanismo enviará uma mensagem de resposta com um código de erro (consulte "Manual de mensagens - Promoção").

Documentação relacionada

1. MANUAL DE INTEGRAÇÃO Documento - PROMO 6.5.doc
2. Documento MANUAL DO USUÁRIO PRINCIPAL - PROMO 6.5.doc
3. Documento MANUAL DO USUÁRIO FINAL - PROMO 6.5.doc

Informações de configuração

Existem parâmetros de configuração que podem ser modificados para personalizar o comportamento do PROMO.
Alguns desses parâmetros estarão disponíveis apenas no console principal do PROMO e outros podem ser editados no console do PROMO de cada empresa.
Esses parâmetros são encontrados no console da PROMO, menu " Administração " >> " Informações de configuração " e são:

Configurações disponíveis para o usuário principal :

Configurações disponíveis para usuário administrador. de cada empresa :

Pode haver alterações correspondentes a:

• atualização do console de administração (se houver alguma atualização, a documentação correspondente e a maneira de instalá-la serão fornecidas),
• Depuração de backup do BD.

Depurando arquivos de backup do banco de dados

O aplicativo registra um backup automático diário do banco de dados MongoDB. É por isso que é necessário realizar algumas manutenções, consistindo em depurá-las periodicamente para que a pasta de backup não ocupe muito no disco.

Senha do banco de dados de máscara

A chave do banco de dados mascarado é gerada pela ferramenta promocional de criptografia que será fornecida.

O programa pega a chave a ser criptografada como entrada e retorna a chave criptografada a ser colocada no arquivo promoplus.properties em uma entrada chamada grails.mongodb.encryptedPassword (por exemplo, grails.mongodb.encriptedPassword = lYYBAfxLR40 =).

No caso de usar grails.mongodb.encryptedPassword, considere comentar ou excluir o grails.mongodb.password anterior, pois, se ambos existirem, você sempre usará grails.mongodb.password. Caso o arquivo promoplus.properties não exista, será utilizado, por padrão, como v9vbhV.

Para criptografar uma chave, você deve usar a ferramenta promocional de criptografia da seguinte maneira em um console: 

o bem

Nos dois casos, a senha criptografada será obtida na tela.

Configurações de rede social

Para trabalhar com redes sociais, o PROMO possui uma série de opções de configuração descritas abaixo. Também é importante esclarecer que os serviços de rede social estão constantemente evoluindo e mudando; portanto, aqui é feita referência ao site do serviço em questão para obter informações atualizadas a esse respeito.

CONFIGURAR O FACEBOOK

No console de cada empresa, o acesso ao usuário administrador e o Acesso às Informações de Configuração da Administração encontrarão as seguintes configurações que deverão ser concluídas para a publicação correta na rede social.

Os dados nesta imagem são meramente ilustrativos e devem ser substituídos pelas credenciais adquiridas com os usuários de desenvolvimento de cada aplicativo.

• Geração de aplicativo para Facebook

Para usar a publicação no Facebook, você deve inserir https://developers.facebook.com/ , registrar-se como desenvolvedor de aplicativos do Facebook e adicionar um novo aplicativo seguindo as etapas indicadas na página.
Isso se aplica à versão do App Facebbok 2.9, mas é importante observar que, ao criar um aplicativo para o Facebook, ele começa no estado de desenvolvimento e, para fazer publicações, você deve conceder permissões de administrador ao usuário do FB que fará as publicações. Por outro lado, se você deseja compartilhar ou que outro usuário possa postar, você precisa ser amigo dos usuários e conceder permissões de administrador. Ao acessar o URL indicado acima, você acessará o "Facebook para desenvolvedores "do Facebook.

Você deve clicar em "Meus aplicativos" que aparece no canto superior direito, ao lado do ícone do usuário.

Uma vez lá, você terá que clicar no botão verde " Adicionar um novo aplicativo ".

Você será solicitado a inserir um nome e um e-mail de contato para registrar o aplicativo. Após inserir os dados solicitados, clique em " Criar identificador de aplicativo ".

A tela a seguir apresentará os dados do aplicativo recém-gerado.

Aqui, os dados necessários para a configuração do aplicativo serão exibidos no arquivo promoplus.propertis, que são:

Identificador do aplicativo >> grails.plugin.facebooksdk.app.id Chave secreta do aplicativo >> grails.plugin.facebooksdk.app.secret

Será necessário ter uma página do Facebook registrada e associada à conta de usuário do Facebook para poder fazer as publicações nesta página.
No perfil do usuário com o qual o aplicativo Facebbok foi gerado, você deve clicar no menu suspenso no qual terá acesso às configurações e páginas.
Nesse menu, clique em " Criar página " e gere-a com base no perfil de negócios, seguindo as etapas indicadas pelo facebok.
Depois que a página for gerada e os dados no arquivo de configuração fornecido pelo aplicativo gerado forem configurados, o console poderá ser reiniciado. e proceda à publicação de promoções na rede social.

CONFIGURAR O TWITTER

No console de cada empresa, o acesso ao usuário administrador e o Acesso às Informações de Configuração da Administração encontrarão as seguintes configurações que deverão ser concluídas para a publicação correta na rede social.

Os dados nesta imagem são meramente ilustrativos e devem ser substituídos pelas credenciais adquiridas com os usuários de desenvolvimento de cada aplicativo.

• Geração de perfil no Twitter
  
  

O URL https://developer.twitter.com/ deve ser acessado  e apresentará a seguinte tela:

O botão correspondente ao usuário conectado no Twitter deve ser clicado, um menu será exibido e "Apps" será clicado

A tela a seguir será exibida e você deve clicar em "Criar um aplicativo"

Será necessário preencher os campos com os dados solicitados para criar o aplicativo com base nas políticas de segurança do Twitter.

Preencha todos os campos, clique em "Criar" e as configurações disponíveis para o aplicativo recém-gerado serão exibidas:

Para obter os IDs e Tokens, clique na guia "Chaves e Tokens", onde os dados necessários serão exibidos para configurar corretamente as permissões de acesso da Promoção.

Resolução de problemas

Durante a operação, o console de administração pode relatar erros inesperados. Quaisquer erros que possam ocorrer usando o aplicativo serão relatados por meio de um pop-up vermelho indicando a causa do erro. Além disso, o log do aplicativo encontrado em \ synthesis \ promo \ log indicará mais detalhes sobre ele.
Se o erro for devido a um problema de permissão ou página não encontrada, ele será relatado através de uma tela explicativa com o problema que ocorreu.

Desinstalar

Para continuar com a desinstalação do console e do mecanismo PROMO, você deve:

1- Serviços de Download

1. • PromoSImEngine
   • Wildfly
   • MongoDB
   • PromoEngine (se o motor estiver instalado)
   • PromoEngineDirector (se o motor estiver instalado)

2- Exclua o diretório C: \ Synthesis (caminho em que o console foi instalado)

3- Desinstalar o MongoDB

4- Exclua os serviços PromoSinEngine, Wilfly e MongoDB e PromoEngine, PromoEngineDirector se o mecanismo estiver instalado

Apêndice A: Autenticação de Usuário Externo (SAML2)

Através da implementação do SAML2 em PROMO, será alcançada a integração do PROMO com um sistema de autenticação externa dos usuários do console do PROMO.

Deve-se levar em consideração que, no console, existem funções de usuário que permitem o acesso às diferentes funcionalidades que devem ser mantidas no console. 

 Sempre será necessário que o usuário seja criado no banco de dados para acessar o console e realizar a autenticação.

Para que a promoção use saml2, os arquivos de propriedades correspondentes devem ser adicionados ao diretório em que os .properties permanecem. Estes são

1. saml.properties - arquivo de configuração principal.
2. saml-keymanager-passwords.properties
3. saml-metadata-providers.properties - Arquivo correspondente à configuração do provedor de identidade.

4. saml-metadata-sp-defaults.properties - Arquivo correspondente à configuração que o PROMO utilizará para gerar seu arquivo xml de metadados.
   
   

   A operação do console ocorre quando você efetua login ou logout. Ao usar o saml, o login do PROMO é substituído pelo login do provedor de identidade.

   
   

   Considerações sobre Teste de Integração

   Para realizar os testes, https://capriza.github.io/samling/samling.html foi usado  

   
   

   1. Registro de usuários no console do PROMO por meio do serviço de descanso correspondente ( createOrUpdateUsers ). Eles também podem ser registrados manualmente no console. Nos dois casos, deve-se ter em mente que os usuários não devem receber restrições quanto às políticas de segurança da PROMO.
   2. Obtenha seu XML de metadados no menu IDP ( https://capriza.github.io/samling/samling.html# )  e salve-o em um arquivo xml (de preferência  idp.xml ). Deve ser apontado na configuração por propriedades.
   3. Salve o arquivo  idp.xml em  C: \ synthesis \ promo \ idp.xml
   4. Edite o arquivo saml-metadata-providers.properties especificando  lá  o caminho absoluto em que o arquivo idp.xml foi colocado  
   5. Inicie o PROMO (Wildfly) com as quatro propriedades  correspondentes ao saml.
   6. Gere o xml do PROMO acessando http: // localhost: 8080 / promo / saml / metadata , salve-o em um xml (de preferência  sp.xml ).
   7. Sp.xml salvo em  C: \ synthesis \ promo \ sp.xml
   8. Edite o arquivo saml.properties especificando  lá  o caminho absoluto em que o arquivo sp.xml foi colocado   
   9. Edite o arquivo saml-metadata-sp-defaults.properties especificando o caminho da promoção http: // localhost: 8080 / promo 
   10. Pare PROMO (wildfly)
   11. Exclua os diretórios \ temp e \ data encontrados no diretório \ standalone da instalação do PROMO.
   12. Iniciar PROMO (wildfy)
   13. Ao acessar o console do PROMO, em vez da tela de login, a tela de amostragem será exibida. Essa tela permite configurar o que você deseja enviar para o provedor de serviços, que neste caso é PROMO. Modifique apenas, dentro de " Saml Response Properties ", o campo " Name Identifier " com o nome de usuário com o qual você deseja acessar o PROMO.
   14. Pressione "NEXT"
       
       
       
       
   15. Na próxima tela exibida, pressione "Postar resposta"
       
       
       
       
   16. O console do PROMO será apresentado, logado com o usuário digitado:
       
       

   
   

   Se o usuário não corresponder a nenhum usuário registrado na PROMO, o login falhará e eles retornarão à tela do ponto 13 para tentar novamente inserir um usuário válido e poder efetuar login na PROMO.

   Se o usuário já existir, ele efetuará login no PROMO sem problemas, apresentando a tela Gerenciamento de Promoção.

   
   
   

   IMPORTANTE

   O Saml2 trabalha com a primeira empresa existente e não a principal. Todos os usuários serão verificados com a referida empresa. No caso de acesso com a empresa Synthesis, a síntese do usuário foi reservada, ou seja, se for necessário o acesso à empresa principal, a síntese do usuário deve ser utilizada. O cliente deve registrar esse usuário em seu provedor de identidade anteriormente.

   PROPRIEDADE:

   • saml.properties , você deve manter o caminho absoluto para o arquivo de metadados do provedor de serviços.

     # # Configuraciones para la utilización de SAML2 # Más info en https://sphoortia.github.io/grails-spring-security-saml/docs/guide/configuration.html # grails.plugin.springsecurity.saml.userGroupAttribute = memberOf grails.plugin.springsecurity.saml.metadata.sp.file = C:\\synthesis\\promo\\sp.xml grails.plugin.springsecurity.saml.metadata.sp.alias = promo_saml grails.plugin.springsecurity.saml.responseSkew = 60 grails.plugin.springsecurity.saml.idpSelectionPath = / grails.plugin.springsecurity.saml.loginFormUrl = /saml/login

   • saml-metadata-providers.properties , chave de ping, deve manter o caminho absoluto para o arquivo de metadados do provedor de identidade.

     ping=C:\\synthesis\\promo\\idp.xml

   • saml-metadata-sp-defaults.properties , chave entityBaseURL , deve manter o caminho da promoção.
     

     local=true alias=promo_saml entityBaseURL=http://localhost:8080/promo securityProfile=metaiop signingKey=ping encryptionKey=ping tlsKey=ping requireArtifactResolveSigned=false requireLogoutRequestSigned=false requireLogoutResponseSigned=false idpDiscoveryEnabled=false

     
     
     

   • saml-keymanager-passwords.properties

     #apollo = nalle123

   
   

   Para retornar ao sistema de log usual, sem usar o SAML2, apenas os 4 arquivos .propertis devem ser removidos do diretório \ main e reiniciar o PROMO (Wildfly).

   
   

   
   

   Apêndice B: OS4690

   Instalação do motor no OS4690

   As etapas a seguir devem ser seguidas para instalar corretamente o mecanismo PROMO em um OS4690:

   • Enviei o jar entregue para um controlador, para a raiz do disco F com o nome, por exemplo: promo-gengine-installer-xxxjar
   • Execute o instalador:   F: / install> javaebin: java -jar promo-gengine-installer-xxxjar
   • Dependendo da disponibilidade do modo gráfico, ele pode ser executado nesse modo ou no modo de texto. O modo gráfico é recomendado e é executado na pasta F: / install
   • Quando solicitado, indique estes valores: 

   Diretório Java: / opt / java / tdk8
   Diretório de instalação: / cdrive / f_drive / install / promo

   • Erros podem ocorrer ao instalar serviços. Isso ocorre devido às permissões do Linux4690, ignore.
   • Os arquivos são gerados:

   F: /instala/ant.install.log
   F: /instala/ant.install.properties

   • A pasta F é gerada: / install / promo
   • Revise e copie os seguintes arquivos: Modifique o config.xml (… promo / engine / conf) para especificar os caminhos corretos:

   
   

   <offline>     <!-Directorio donde se guardarán los tickets offline->     <directory>/cdrive/f_drive/promo/engine/offline</directory>     <!-Cantidad de segundos en los que chequea offline->     <check>60</check> </offline> <map>     <!-Directorio desde donde el motor lee los mapas->     <directory>/cdrive/f_drive/promo/engine/sales</directory>

           

   • Modifique logging.properties (… promo / engine / conf) para especificar os caminhos corretos: java.util.logging.FileHandler.pattern = / cdrive / f_drive / promo / engine / logs / promo
   • Configure o aplicativo em segundo plano: 

   Programa : shell
   Parâmetros: F: /promo/engine/tcp4690.bat (ou rest4690.bat para funcionar como um servidor tcp ip ou para o resto, conforme o caso). 

   
   

   •      Comece quando você é professor e quando você não é professor
   •      Ativar configuração e carregar o Controller 

   
   

   
   
   

   Apêndice C: Variáveis de ambiente

   Definir PATH JAVA_HOME no Windows

   
   Para que o aplicativo seja executado corretamente, será necessário definir a variável JAVA_HOME no Windows. Para fazer isso, vá ao Painel de Controle> Sistemas e Segurança> Sistemas e selecione "Configuração Avançada do Sistema"
   Na guia Opções Avançadas, clique em "Variáveis de Ambiente". Em Variáveis do sistema, posicione-se em JAVA_HOME e clique em "Editar" e coloque o caminho onde está o JAVA.

   
   

   
   

   
   

   Em Variáveis do sistema, procure por PATH, clique em "Editar" e adicione % JAVA_HOME% \ bin

   
   

   
   Clique em " OK " para salvar as alterações e que a variável esteja definida corretamente.

   
   

   
   
   

   Apêndice D: Atualizações do console

   
   

   Atualização para novos lançamentos

   
   Caso seja lançada uma nova retransmissão da versão do console, você poderá atualizar a versão PROMO seguindo estas etapas:

   1. Faça o download do serviço Wildfly (acesse a seção de serviços do sistema e pare o Wildfly)
   2. Acesse o diretório em que o console do PROMO está instalado (por padrão, em C: \ synthesis \ promo)
   3. Digite o diretório C: \ synthesis \ promo \ appserver \ standalone e exclua os diretórios "data" e "tmp"
   4. Digite o diretório C: \ synthesis \ promo \ appserver \ standalone \ deployments e substitua o arquivo promo.war existente pelo arquivo enviado pela equipe de Synthesis.
   5. Feito isso, inicie o serviço wilfly novamente.
      
      

   Depois que o serviço for iniciado após a substituição do arquivo promo.war, um arquivo chamado promo.war.isdeploying será gerado no diretório C: \ synthesis \ promo \ appserver \ standalone \ deployments, indicando que os arquivos de atualização estão sendo descompactados .

   
   

   Se o processo for concluído com êxito, esse arquivo será renomeado como promo.war.deployed.
   Se ocorrer um erro durante a descompactação da atualização, será gerado um arquivo chamado promo.war.failed, que deverá ser enviado à equipe de suporte para análise e subsequente resolução do problema para iniciar o console corretamente.