Páginas filhas
  • TOTVS Agro Notificações & Alertas


Esta página apresenta e descreve o uso de TOTVS Agro Notificações & Alertas para produtos:

  • TOTVS Agro Bioenergia (a partir da release 12.1.2406);
  • TOTVS Agro Multicultivo (a partir da release 12.1.2406);

A criação, manutenção e publicação de conteúdos de Notificações & Alertas é realizado por meio do TOTVS Agro Plataforma (link), conforme descrito neste documento.




TOTVS Agro Plataforma | painel de gestão de Notificações & Alertas

Objetivo: Mantenedor geral das Notificações & Alertas para os produtos Multicultivo e Bioenergia.

Principais funcionalidades: Visualização, cadastro, edição, remoção, cancelamento e publicação.

Link de acesso: https://agro.totvs.app/

Solicitar acesso (novo usuário e/ou alteração de senha): Entrar em contato com Guilherme de Cleva Farto <[email protected]>


1. Acesso (login) ao TOTVS Agro Plataforma

  • Para realizar o acesso ao TOTVS Agro Plataforma, deve-se ter disponível dados de acesso, que são eles
    1. Login e/ou E-mail
    2. Senha
  • Acesso ao TOTVS Agro Plataforma:


  • Para sair do perfil, clicamos no botão Logout:

2. Criação de nova Notificação & Alerta

  • Para realizar uma nova criação de uma Notificação & Alerta, devemos entrar na página Notificações e Alertas:

  • Podemos criar vários tipos de notificações, dependendo das opções selecionadas: 
    • Título da Notificação (Obrigatório): O título que vai aparecer no Card da notificação.
    • Tipo de Notificação (Obrigatório)O tipo de notificação que vai aparecer no Card da notificação.
    • Período de Início/Fim: O período que vai aparecer a notificação, se não ter período, vai aparecer em qualquer período, quando ocorrer o sincronismo do cliente.
    • Clientes: Escolha quais clientes vai a notificação, se não selecionar nenhum, vai para todos os clientes.
    • Releases: Escolha quais releases vai a notificação, se não selecionar nenhum, vai para todas as releases.
    • Produtos (Obrigatório)Escolha qual produto (Multicultivo e/ou Bioenergia) vai a notificação.
    • Módulos: 
    • URL Externa: URL Externa vai ficar disponível no Card da notificação, se aplicado.
    • Mensagem (Obrigatório): Mensagem que vai aparecer no Card da notificação.
  • Exemplos de notificações:
    • Notificação para todos os clientes com Bioenergia em todas as Releases:


    • Notificação para todos os clientes com Multicultivo apenas na Release 12.1.2406:

3. Publicação de Notificação & Alerta

  • Para realizar a publicação da notificação, devemos acessar a listagem de notificações e Alertas:


  • Após o acesso a listagem de notificações e alertas, escolhemos qual notificação vai ser publicado, lembrando que, depois de publicado, não poderemos mais editar ou remover:

4. Cancelamento de Notificação & Alerta

  • Para realizar o cancelamento de uma notificação, devemos acessar a listagem de notificações e alertas:


  • Após o acesso a listagem de notificações e alertas, escolhemos qual notificação vai ser cancelado, lembrando que, depois de cancelado, não poderemos mais publicar, editar ou remover:




TOTVS Agro Bioenergia | Exibição de Notificação & Alerta

Objetivo: Visão geral das notificações e alertas no TOTVS Agro Bioenergia

Principais funcionalidades: Parâmetros necessários, central de notificações e exibição dos alertas

Release: a partir da 12.1.2406 (junho de 2024)


1. Configurações para utilização de Notificação & Alerta

  • Configurações dos parâmetros necessários para utilização de Notificações & Alertas, através do aplicativo PAR_PIMS
    • Seção: GERAIS | Entrada: TCODE - Código do Cliente na TOTVS
    • Seção: NOTIFICACOES | Entrada: CLIENT_SECRET_TOKEN - Secret Token, valor disponibilizado pela equipe TOTVS
    • Seção: NOTIFICACOES | Entrada: TIMER_MS - Tempo em ms de exibição da notificação
    • Seção: NOTIFICACOES | Entrada: URL_BASE_NOTIFICACOES_ALERTAS - Url Base Plataforma Agro


Atenção

Necessidade de liberação de acesso da estação / servidor onde são executadas as aplicações do bioenergia para a url do Plataforma Agro: https://agro.totvs.app/

2. Novas Tabelas

É necessária a criação de duas novas tabelas na base de dados, sendo elas ENG_SYNC_NOTIF_ALERT e ENG_USER_NOTIF_ALERT. As mesmas podem ser criadas de diversas formas, sendo elas: 

  • Automaticamente ao utilizar o instalador a partir da release 12.1.2406;
  • Realizando a importação do dicionário de dados da release 12.1.2406 e realizando a verificação de BD;
  • Utilizando o script abaixo disponibilizado também no ALTER_ORA.SQL


Script para criação das tabelas
create table ENG_SYNC_NOTIF_ALERT (
    ID        varchar2(36)    NOT NULL,
    TIMESTAMP        date,
    APPLICATION        varchar2(500),
    RELEASES        varchar2(200),
    STATUS        varchar2(50),
    START_PERIOD        date,
    END_PERIOD        date,
    CONTENT        clob,
    CONTENT_TYPE varchar2(50),
    CONTENT_TITLE varchar2(255),
    CONTENT_MESSAGE varchar2(1000),
    CONTENT_URL varchar2(255),
    CONSTRAINT ENG_SYNC_NOTIF_ALERT_PK PRIMARY KEY (ID));

create table ENG_USER_NOTIF_ALERT (
    ID        varchar2(36)    NOT NULL,
    USER_IDENTIFIER        varchar2(10)    NOT NULL,
    CREATED_AT        date,
    NOTIFIED_AT        date,
    VIEWED_AT        date,
    CANCELED_AT        date,
    CONSTRAINT ENG_USER_NOTIF_ALERT_PK PRIMARY KEY (ID,USER_IDENTIFIER));

alter table ENG_USER_NOTIF_ALERT add constraint ENG_USER_NOTIF_ALERT1_FK_ENG_S foreign key  (ID) references ENG_SYNC_NOTIF_ALERT;


3. Sincronismo de Notificações & Alertas

  • O sincronismo das Notificações & Alertas com o Plataforma Agro, ocorre de forma automática após realizar o login na aplicação.


4. Carregamento e exibição de Notificações & Alertas

  • Ao realizar o login na aplicação, serão exibidas as notificações ao usuário relacionadas ao TOTVS Agro Bioenergia e ao aplicativo que ele esteja executando.


  • Na exibição da notificação, ao fechar "X", será marcado como lido e não exibirá novamente.
  • O botão "Abrir" será habilitado caso tenha alguma URL externa para mais informações.
  • Caso o card não tenha sido fechado após o tempo configurado via parâmetro, ele irá desaparecer.


5. Painel "Central de Notificações"

  • No painel "Central de Notificações" é possível visualizar o histórico de notificações recebidas para o TOTVS Agro Bioenergia e para aplicativo em execução.

  • As mensagens "não lidas" serão exibidas no topo.
  • O botão "Abrir" serve para notificações que possui links externos, caso não tenha será bloqueado.
  • Na central de Notificações é possível marcar uma Notificação não lida como lida, e uma notificação lida como não lida.
  • A central de notificações pode ser acessado através do sino no rodapé do TOTVS Agro Bioenergia.





TOTVS Agro Multicultivo | Exibição de Notificação & Alerta

Objetivo: Visão geral das notificações e alertas no TOTVS Agro Multicultivo

Principais funcionalidades: Parâmetros necessários, central de notificações e exibição dos alertas

Release: a partir da 12.1.2406 (junho de 2024)


1. Configurações para utilização de Notificação & Alerta

  • As configurações necessárias  no grupo Notificações e Alertas (58) das configurações gerais.
    1. Client secret token:  Será necessário informar o valor disponibilizado pela equipe TOTVS.
    2. Data de última sincronização das notificações/alertas: Será preenchido automaticamente pelo processo agendado de sincronismo.
    3. URL Base do TOTVS Agro Plataforma (Notificações/Alertas): Deve-se preencher o valor padrão do TOTVS Agro Plataforma (valor padrão): https://agro.totvs.app/


  • As configurações necessárias no grupo Gerais (44) das configurações gerais.
    1. Informe o TCode (Código do cliente TOTVS): Será necessário informar o código do cliente (disponibilizado pela equipe TOTVS)


2. Sincronismo de Notificações & Alertas

  • O sincronismo das notificações e alertas ocorre via processo agendado, configurado para executar a cada 1 hora. A configuração está centralizada no arquivo multicultivo/pimsmc/start.xml no WildFly.

    			<service name="SincronizarNotificacoesAlertas"
    					method="syncNotificationAlerts"
    					schedule="0 0 0/1 * * ?"
    					durable="true"
    					cluster-name="PIMSGRAOS"
    					group-name="PRX">
    			</service>

3. Carregamento e exibição de Notificações & Alertas

  • Durante a navegação no TOTVS Agro Multicultivo, será exibido os cards das novas notificações e não lidas.


  • Na exibição da notificação, ao fechar "X", será marcado como lido e não exibirá novamente.
  • O botão "Abrir" será habilitado caso tenha alguma URL externa para mais informações.
  • Caso o card não tenha sido fechado após 1 minuto, ele irá desaparecer e ser exibido novamente após 5 minutos.

4. Painel "Central de Notificações"

  • A central de notificações pode ser acessado através do sino no rodapé do TOTVS Agro Multicultivo.
  • As mensagens "não lidas" estarão no topo e serão exibidos os cards durante a navegação do produto.
  • O botão "Abrir" serve para notificações que tem links externos, caso não tenha será bloqueado.
  • O botão "Ver mais notificações" efetuará o carregamento de mais 5 notificações.





Framework e Engenharia TOTVS Agro

Release 12.1.2406 (Junho/2024)



  • Sem rótulos