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);

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 (Necessário solicitar o Secret Token para o Suporte / Engenharia e Framework Agro)
  • 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

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

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.  (Necessário solicitar o Secret Token para o Suporte / Engenharia e Framework Agro)
  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)