Desenvolvimento Millen-29132 – Integração Linx Notifica Mais
Release 103
Versão 5
Autor Jaciara Silva
Processo: Utilitários
Nome do Processo: Linx Notifica Mais
Motivação
Desenvolvida integração com o Linx Notifica+ , que consiste em uma consulta periódica, realizada pelo sistema para que busque as notificações (NPS, publicidades, comunicados em geral, etc) via API, permitindo sua exibição de acordo com o perfil de cada usuário.
As notificações serão inseridas no sistema como uma tarefa, sendo que as do tipo pesquisa (NPS) serão mostradas na página inicial do sistema.
Ao visualizar a notificação, a tarefa é finalizada automaticamente, para que o usuário não tenha que visualizar várias vezes a mesma notificação.
Três formas de utilizar o Linx Notifica +
1.Na versão 5.103 e posteriores, os módulos "millenium_notificamais.minst", "wtsworkflow!notificamais.minst" e todos os arquivos necessários serão instalados automaticamente via instalador "B5ServerIBX.exe". Então, após a execução do instalador "B5ServerIBX.exe", basta executar o DBDIC (instalador "B5DbDicIBX.exe").
2.Instalando os módulos "millenium_notificamais.minst" e "wtsworkflow!notificamais.minst" em versões anteriores a 5.103
Neste caso, as notificações do tipo NPS não aparecerão na tela inicial, por ser uma alteração do core do sistema. Todas as notificações serão visualizadas normalmente via tela de Lista de Tarefas. Nesta opção, caso o DBDIC já tenha sido executado na instalação dos módulos, as tabelas serão criadas automaticamente. Caso contrário, será necessário executar DBDIC, após instalação dos módulos.
3.Através do instalador "B5NotificaMais.exe"
Este contém todos os arquivos necessários para seu correto funcionamento, podendo ser instalado em versões anteriores a 5.103. A página inicial do sistema mostrará as notificações do tipo NPS. Nesta opção, após executar o instalador, é obrigatório executar o DBDIC.
Atenção! Este recurso acompanha a versão do sistema a partir da versão 5.103. Para utilizá-lo nas versões anteriores, solicite aos nossos consultores que forneçam o módulo para instalação. Caso você não consiga fazer a instalação, entre em contato com nosso departamento comercial e solicite a visita de um consultor.
Parâmetros
Instalar os módulos millenium_notificamais.minst e wtsworkflow!notificamais.minst. Para informações sobre como fazer a instalação de módulos no e-Millennium acesse o Manual de instalação de módulos no e-Millennium.
Em Utilitários\Administrador\Configurações Gerais:
- Localize a opção Notifica+ e no campo Ambiente selecione a opção Produção;
- Salve as configurações.
Entradas
Habilitar link no e-Millennium
No Gerenciador de Usuários do sistema, liberar os links de acesso as telas do recurso:
- Utilitários\Administrador\Usuários Notifica +
- Vendas\Visualizar Notificação
Vincular perfil de Notificações aos usuários do sistema
Por padrão, as notificações serão exibidas para todos os usuários que fazem parte do Grupo Mestre do gerenciador.
Caso a empresa decida que um grupo específico de usuários deve receber as notificações de um determinado perfil, será necessário fazer o vínculo entre o perfil e o grupo de usuários.
Atenção! No caso das notificações, não segue a regra de hierarquia de acessos dos usuários no gerenciador. Somente os usuários que estiverem incluídos no Grupo Mestre receberão as notificações, se não houver nenhuma configuração de vínculo de perfil.
O Perfil de Notificações é inserido automaticamente no banco de dados do e-Millennium, via API, através de uma rotina que é executada, também automaticamente, em períodos pré-definidos no sistema. O operador do e-Millennium não tem acesso à criação desses perfis, que são criados pela Linx, com base em situações em que seja identificada a necessidade de comunicar uma informação ao usuário do sistema.
Para criar um vínculo entre o perfil de notificação e um grupo de usuário, siga os passos:
Utilitários\Administrador\Usuários Notifica +\Incluir Vínculo de Perfil
- Selecione o perfil, cujas notificações devem ser exibidas;
- Selecione os grupos de usuários que devem receber as notificações;
- Salve o cadastro.
Recebendo Notificações
As notificações recebidas e que não foram visualizadas ainda, serão exibidas na tela do sistema, assim que o usuário fizer seu acesso. As notificações recebidas são tratadas como tarefas designadas ao usuário e após serem visualizadas serão automaticamente finalizadas pelo sistema. Este procedimento é necessário para que as notificações visualizadas não sejam exibidas novamente todas as vezes que o usuário se logar no sistema. 
Visualizando Tarefas
Para rever uma notificação já finalizada, é possível acessá-la pelo ícone de tarefas, no topo direito da tela. Observe que a tarefa está com situação "Fechada", isso porque o usuário já abriu a tela e visualizou a notificação enviada.
A notificação que consta com "Aberta" ainda não foi acessada pelo usuário para visualização do conteúdo.
Para ver novamente a notificação, basta selecioná-la e clicar em Visualizar Notificação.
Validações e Saídas
O sistema irá consultar se houve envio de notificações para os usuários em intervalo de tempo determinado e exibirá as novas notificações na tela de abertura, assim que o usuário fizer login no sistema.
Para toda comunicação com a API será gravado log no arquivo "wtsBrokerNotificaMais_Api_XXXX.txt" na pasta wts\trace. Caso o usuário deseje verificar a comunicação entre a API e o sistema, basta abrir o arquivo e conferir os dados de request e response.
A tarefa de notificação será finalizada automaticamente após ser visualizada pelo usuário do sistema.
Caso o usuário tente forçar o fechamento de tarefa que seja uma notificação, o sistema bloqueará a ação e emitirá uma mensagem de alerta, informando que é necessário visualizar a notificação para que seja finalizada.
