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
- Login e/ou E-mail
- 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: A URL Externa vai ficar disponível no Card da notificação, se aplicado.
- Mensagem (Obrigatório): A 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
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.
- Client secret token: Será necessário informar o valor disponibilizado pela equipe TOTVS.
- Data de última sincronização das notificações/alertas: Será preenchido automaticamente pelo processo agendado de sincronismo.
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)