Histórico da Página
Conteúdo
...
Índice
...
style square
...
01. VISÃO GERAL
O objetivo é notificar os usuários em seus dispositivos sobre comunicados de rotinas do aplicativo Meu RH e também comunicados internos relevantes para a organização.
...
- Realizar a atualização dos ambientes:
- Instalação do Patch 12.1.2310.110 123 ou superior;
- Execução do RM-Atualizador;
- Atualizar o aplicativo MEU RH:
- Android: Através da Play Story Store para a versão 3.00.04, sendo necessário se tornar um testador beta: Como se tornar um testador Betaúltima versão publicada;
- IOS: Disponível em breveAtravés da Apple Store para a última versão publicada.
- Habilitar o recebimento de notificações nas configurações do dispositivo.
- Marcar o parâmetro: 'Utiliza push notification', localizado em: 'Configurações >> Parametrizador >> Push Notification';
- Liberação das permissões: Configurar Permissões;
- Configurar o ambiente para acessar os serviços WebServices Configurando HttpPort e ApiPort (Exclusivo para utilizar a gestão de comunicados);
- Iniciar o host da aplicação como administrador.
OBS: As permissões indicadas são para os processos dentro do ERP. Para os processos realizados dentro do MEU RH é considerado apenas o parâmetro ' 'Utiliza push notification', exceto para o menu 'Comunica RH' que verifica também o permissionamento.
Caso possua alguma restrição de segurança pode ser necessário realizar a liberação dos seguintes endereços: https://fcm.googleapis.com/fcm/send e https://api-hrplatform.totvs.app/hrplatform/api/firebase-access-token.
03
...
. VISUALIZAR NOTIFICAÇÕES NO MEU RH
Tem como objetivo demonstrar as notificações enviadas aos colaboradores através do gatilho.
O sino de notificações passará a exibir as notificações relacionadas ao Push Notification e deixará de exibir as aprovações, que serão movidas para um novo menu 'Aprovações'.
Caso não esteja utilizando push notification o sino de notificações irá direcionar para o menu de 'Aprovações' e continuará sendo exibido apenas para gestores e/ou substituto de gestores.
O sino de notificações irá exibir um contador com as notificações que ainda não foram lidas pelos usuários, uma vez lida esta notificação não será considerada no contador.
O indicativo que a notificação não foi lida é o contorno do Card, caso esteja contornado indica que a notificação ainda não foi lida.
Ao clicar no sino de notificações serão exibidas as notificações daquele usuário, considerando a coligada, chapa ou codigo de externo daquele contexto.
Serão exibidas dez notificações por página.
Caso o usuário tenha sua chapa alterada, as notificações referentes a chapa antiga não são mais exibidas;
As notificações são ordenadas pela data de envio decrescente.
- Notificações do Gestão de Comunicados:
- Ao clicar duas vezes no Card será exibido os detalhes daquele comunicado;
- Uma vez visualizada esta notificação passará a ser lida.
- Notificações do Envelope de Pagamento Disponível:
- Ao clicar duas vezes no Card será direcionada para a aba de 'Envelope de Pagamento', desde que possua a permissão necessária, caso não possua permissão será redirecionado para a tela principal;
- Uma vez visualizada esta notificação passará a ser lida.
Se clicar duas vezes no Card do Gestão de Comunicados:
Caso não possua notificações, será exibida a imagem abaixo:
Caso clique em alguma notificação do gestão de Comunicados em que o comunicado correspondente tenha sido inativado ou excluído, será exibida a imagem abaixo:
04. NOTIFICAÇÃO PARA DISPONIBILIDADE DO ENVELOPE DE PAGAMENTO
Tem como objetivo enviar uma notificação para o usuário em seu dispositivo, informando que o envelope de pagamento está disponível para consulta.
...
Exemplo de Job criado ao executar o processo:
...
05. NOTIFICAÇÃO PARA DISPONIBILIDADE DOS COMUNICADOS DE RH
O objetivo é permitir enviar comunicados/notificações diversos para os colaboradores.
Para visualizar os comunicados cadastrados por aquele usuário deve acessar o módulo de Folha de Pagamento no menu 'Configurações >> Gestão de Comunicados'. Os registros são exibidos ordenados por data de criação decrescente.
São exibidos dez registros por página.
Não serão criados comunicados e/ou notificações para funcionários:
- Demitidos;
- Com admissão para o próximo mês;
- Com data de demissão ou data fim no caso de externos preenchida;
- Com data de admissão ou data de inicio no caso de externos maior que a data atual.
Para cadastrar um novo comunicado, deve-se seguir o processo demonstrado abaixo:
Caso não existam registros cadastrados por aquele usuário, a imagem abaixo será exibida:
Para cadastrar um novo comunicado clique em 'Novo Comunicado', e informe um título e um texto para o comunicado, pode selecionar caso deseje uma imagem, podendo escolher entre os formatos vertical ou Horizontal, caso opte por não escolher como prefere a imagem, esta será exibida por default como Horizontal. Poderá inserir apenas formatos .png, .jpg, .gif.
Caso insira um formato inválido irá apresentar a mensagem abaixo:
Poderá clicar em 'Visualizar Comunicado' para verificar a exibição do comunicado antes de finalizar o cadastro:
Clique em 'Elaborar Push' para seguir com o processo:
notificar os usuários sobre o novo comunicado publicado pelo RH.
Para criar um gatilho para notificar os usuários do novo comunicado deverá ser parametrizado na etapa da criação do Comunicado de RH, para a documentação completa do Comunicado de RH, acesse 33.0 Comunicados para o RH
Após a elaboração do Comunicado, avançar no "Avançar"
Preencha o título e subtítulo que será enviado na notificação:
Clique em 'Escolher DestinatáriosAvançar' para selecionar os filtros de envio:
Será obrigatório selecionar ao menos a coligada para envio. Apenas a coligada do contexto do usuário que está realizando o cadastro será exibida para a seleção.
Ao selecionar a coligada os campos de 'Função' e 'Filial' serão habilitados para seleção, porém não são obrigatórios;
Caso selecione uma filial, será habilitado o campo 'Departamento' que não será obrigatório.
Caso selecione o departamento é obrigatório ter uma Filial selecionada.
É obrigatório selecionar uma data e hora de publicação (deve ser maior que a data e hora atual) ou deve marcar a flag 'Enviar agora?'.
Se desejar enviar o comunicado para os externos deve marcar a flag 'Enviar para externos?';
É exibida uma mensagem de alerta informando que se estiver em um ambiente local, as notificações serão enviadas imediatamente, esta mensagem é apenas informativa e não impede de seguir com o processo.
Clique em 'Criar Comunicado' e confirmar em 'Sim, estou ciente'.
Aguarde enquanto é processado (esta ação pode levar um tempo a depender da quantidade de funcionários do filtro selecionado).
O comunicado será salvo com o status 'Aguardando', após o envio da notificação o status será alterado para 'Enviado'.
É possível que o cadastro seja realizado com uma data e hora de publicação e ao ser enviado esta data e hora ser modificada, isso ocorre em caso de utilizar ambiente local, onde a notificação é enviada de forma imediata, desta forma é alterada para a data e hora que ocorreu o envio do Job.
Caso deseje atualizar a tela do 'Gestão de Comunicados', deve clicar com botão direito do mouse em algum local da tela e clicar na opção 'Atualizar' como mostra a imagem abaixo:
Para que a notificação seja enviada corretamente para os colaboradores em seu dispositivo é necessário observar as seguintes regras:
- Possuir um token válido:
- O usuário deve ter acessado o aplicativo ao menos uma vez após a atualização do MEU RH, pois através deste acesso será definido um token para o dispositivo;
- O token será salvo na tabela: PUSERSDEVICESPUSHNOTIFICATION;
- Este token é definido por aparelho e único por pessoa, caso o usuário troque de dispositivo este token será substituído após o primeiro acesso ao MEU RH, com o novo dispositivo.
- Caso o aplicativo do Meu RH esteja aberto no momento do envio da notificação, o usuário não irá receber a notificação, no entanto será mantido o salvamento do log;
- Possuir um comunicado com status 'Aguardando' ou 'Enviado'.
Exemplo do Job criado:
Exemplo da notificação:
05. BUSCA AVANÇADA NOS COMUNICADOS DO ERP
O objetivo é filtrar os comunicados por código, título, data de criação, status e/ou responsável.
Para realizar a busca avançada após acessar a aba de 'Gestão de Comunicados', clicar em 'Busca Avançada':
06. VISUALIZAR DETALHES DOS COMUNICADOS NO ERP
Para visualizar os detalhes dos comunicados, acessar a aba de 'Gestão de Comunicados', clicar nos três pontinhos (...) e clicar na opção 'Visualizar':
Horizontal
Vertical
07. APAGAR COMUNICADOS NO ERP
Somente comunicados que estejam com o status 'Aguardando' ou 'Rascunho' podem ser excluídos.
Caso exclua um comunicado cujo o Job vinculado a ele já esteja em execução, os usuários ainda receberão as notificações, caso o Job não tenha iniciado os usuários não receberão as notificações.
Deletar o comunicado não deleta a notificação.
Para excluir, acessar a aba de 'Gestão de Comunicados', clicar nos três pontinhos (...) e clicar na opção 'Apagar':
Caso o status seja diferente do permitido será apresentada uma mensagem de erro:
Se o status permitir apagar:
08. INATIVAR COMUNICADOS NO ERP
Somente comunicados que estejam com o status 'Enviado' podem ser inativados.
Caso inative um comunicado cujo o Job vinculado a ele já esteja em execução, os usuários ainda receberão as notificações, caso o Job não tenha iniciado os usuários não receberão as notificações.
Inativar o comunicado não inativa a notificação.
Para inativar, acessar a aba de 'Gestão de Comunicados', clicar nos três pontinhos (...) e clicar na opção 'Inativar':
Se o status não permitir inativar, será apresentado uma mensagem de erro:
09. EDITAR COMUNICADOS NO ERP
Disponível em breve.
10. VISUALIZAR NOTIFICAÇÕES NO MEU RH
Tem como objetivo demonstrar as notificações enviadas aos colaboradores.
O sino de notificações passará a exibir as notificações relacionadas ao Push Notification e deixará de exibir as aprovações, que serão movidas para um um novo menu 'Aprovações'.
Caso não esteja utilizando push notification o sino de notificações irá direcionar para o menu de 'Aprovações' e continuará sendo exibido apenas para gestores e/ou substituto de gestores.
O sino de notificações irá exibir um contador com as notificações que ainda não foram lidas pelos usuários, uma vez lida esta notificação não será considerada no contador.
O indicativo que a notificação não foi lida é o contorno do Card, caso esteja contornado indica que a notificação ainda não foi lida.
Ao clicar no sino de notificações serão exibidas as notificações daquele usuário, considerando a coligada, chapa ou codigo de externo daquele contexto.
Serão exibidas dez notificações por página.
Caso o usuário tenha sua chapa alterada, as notificações referentes a chapa antiga não são mais exibidas;
As notificações são ordenadas pela data de envio decrescente.
...
- Ao clicar duas vezes no Card será exibido os detalhes daquele comunicado;
- Uma vez visualizada esta notificação passará a ser lida.
06. APAGAR NOTIFICAÇÕES NO MEU RH
Tem como objetivo
- Notificações do Envelope de Pagamento Disponível:
- Ao clicar duas vezes no Card será direcionada para a aba de 'Envelope de Pagamento', desde que possua a permissão necessária, caso não possua permissão será redirecionado para a tela principal;
- Uma vez visualizada esta notificação passará a ser lida.
Se clicar duas vezes no Card do Gestão de Comunicados:
Caso não possua notificações, será exibida a imagem abaixo:
Caso clique em alguma notificação do gestão de Comunicados em que o comunicado correspondente tenha sido inativado ou excluído, será exibida a imagem abaixo:
11. APAGAR NOTIFICAÇÕES NO MEU RH
Tem como objetivo apagar as notificações recebidas pelo usuário.
...
Deve selecionar as notificações que deseja apagar e clicar em 'Apagar Notificações':
12. VISUALIZAR COMUNICADOS NO MEU RH
Tem como objetivo exibir os comunicados do gestão de comunicados, independente dos colaboradores terem recebido a notificação em seus dispositivos.
Serão exibidos dez comunicados por página.
Os comunicados são ordenadas pela data de publicação decrescente.
É necessário que se tenha uma data de publicação cadastrada no comunicado e que esta seja menor ou igual a data atual, para que o comunicado seja visualizado.
Apenas comunicados com status 'Aguardando' ou 'Enviado' são exibidos.
Poderá realizar uma busca pelos comunicados através da data de publicação.
Serão exibidos os comunicados daquele colaborador de acordo com o contexto selecionado.
Para acessar ir na aba 'Comunica RH'. Esta aba somente será exibida se estiver utilizando push notification.
Caso não possua registros será apresentado a imagem abaixo:
Caso possua resultados:
Caso clique na opção de 'Visualizar'
Caso não possua imagem:
Caso busque comunicados por data, deve selecionar uma data de inicio e fim e clicar em 'Filtrar'. Somente após preencher as datas será habilitado o botão de 'Filtrar'. Para limpar os filtros poderá clicar em 'Limpar Filtros'.
13. APAGAR COMUNICADOS NO MEU RH
Para apagar os comunicados basta clicar no ícone abaixo:
OBS: Esse processo exclui apenas o registro da tabela: PCOMMUNICATECOLLABORATOR.
Disponível a partir da versão 12.1.2310.115 ou superior.
...
07. VISUALIZAR OS REGISTROS DE ENVIO DAS NOTIFICAÇÕES NO ERP
Será possível visualizar os logs das mensagens enviadas aos usuários através do menu 'Configurações >> Log das Mensagens Enviadas', conforme demonstra o print abaixo:
Também será possível excluir os registros selecionados.
OBS: Opção liberada no Patch 12.1.2310.117 ou superior.
...
08. VISUALIZAR O TOKEN DO DISPOSITIVO DOS USUÁRIOS NO ERP
Será possível visualizar o token dos usuários através do menu 'Configurações >> Token do Dispositivo dos Usuários', conforme demonstra o print abaixo:
Também será possível excluir os registros selecionados.
OBS: Não será possível excluir o token se existir logs de mensagens enviadas vinculados a este token. Caso opte por excluir o token deve excluir antes o log das mensagens enviadas daquela pessoa.
Opção será disponibilizada no Patch da versão 12.1.2310 do dia 24/11/2023.
...
.
09. LIMPEZA DE DADOS NO ERP
Processo responsável pela limpeza dos dados, podendo realizar a limpeza completa ou filtrando através de um intervalo de datas. Os dados abaixo podem ser apagados através do processo:
- Log das Mensagens Enviadas: Considera a tabela: PSCHEDULEMESSAGESLOGPUSH. Irá apagar os logs das notificações de push enviadas. O usuário não irá visualizar as mensagens
no sino de notificações. Se filtrar pela data será considerado o campo: SENTDATE para a filtragem. - Token do Dispositivo dos Usuários: Considera a tabela: PUSERSDEVICESPUSHNOTIFICATION. Irá apagar o token dos usuários sendo necessário que este acesse novamente o aplicativo para gerar um novo token e assim receber as novas notificações. Se filtrar pela data será considerado o campo: RECCREATEDON para a filtragem.
- Comunicados do Colaborador: Considera a tabela: PCOMMUNICATECOLLABORATOR. Irá apagar os comunicados enviados para os colaboradores, independentemente do status. O usuário não irá visualizar os comunicados no Comunica RH. Se filtrar pela data será considerado o campo: RECCREATEDON para a filtragem.
OBS: Somente será possível realizar a limpeza do token do Dispositivo dos usuários caso não tenha nenhum log vinculado a ele. Caso tenha é necessário deletar estes logs.
O processo fica localizado no módulo Folha de pagamento na aba de 'Configurações':
Ambiente Local
Ambiente N camadas: Poderá realizar o agendamento da execução deste processo.
Deve preencher um intervalo de datas para executar o processo ou marcar a flag 'Limpar todos os dados', caso não preencha uma das opções e tente seguir com o processo será exibido o erro abaixo:
É necessário selecionar algumas das opções de dados para realizar a limpeza, caso não selecione e tente seguir com o processo será exibido o erro abaixo:
Caso selecione a opção 'Token dos Usuários' será apresentada a mensagem abaixo:
O processo é irreversível e desta forma será apresentado um alerta ao seguir:
Caso esteja com parâmetro 'Utiliza push notification' desmarcado será apresentada a mensagem abaixo e não será possível seguir com o processo:
Exemplo de logs gerados ao final da execução:
10. PRINCIPAIS DÚVIDAS E ERROS CONHECIDOS
1. O que acontece caso não execute o RM-Atualizador?
- Não conseguirá seguir com os processos relacionados ao Push Notification;
- No Meu RH não exibirá os dados das notificações e comunicados;
- No ERP irá apresentar as mensagens abaixo ao tentar executar os processos:
2 2. O que fazer quando a notificação não está chegando no dispositivo do colaborador?
- Verifique os logs gerados no Job do processo, pois podem indicar qual foi o problema encontrado;
- Verifique se o usuário está com a versão atualizada do MEU RH;
- Verifique se o token foi gerado corretamente na tabela: PUSERSDEVICESPUSHNOTIFICATION;
- Verifique se o usuário está com o MEU RH aberto no momento do envio da notificação;
- Caso seja notificação do envelope de pagamento disponível verificar as parametrizações necessárias no tópico 3 deste documento.
3. O que fazer se apresentar a mensagem abaixo na execução do processo de Gatilho Envelope de Pagamento e/ou após criar um Job este não estiver sendo iniciado:
Siga as orientações do: Fila de processos não é lida;
44. O que fazer se ao reiniciar um Job aparecer o erro semelhante ao erro abaixo:
Esta situação acontece quando um Job do mesmo tipo é reiniciado mais de uma vez e esta reinicialização foi feita antes do Job anterior finalizar a execução, sendo o mesmo Job ele utiliza os mesmos arquivos de logs e desta forma é necessário que sejam executados um por vez.
5. O que fazer se acontecer o erro abaixo ao clicar em 'Gestão de Comunicados'?
Verifique se o Host do servidor foi iniciado corretamente como administrador;
Verifique se foi realizada a configuração das portas corretamente no Host como indicado no item 2 deste documento.
6. O que fazer se acontecer o erro abaixo ao tentar excluir o token de um usuário?
Verifique se existe algum log de mensagem enviada para esta pessoa, pois para excluir o token deve excluir os logs vinculados a ele.
Para excluir os logs das mensagens enviadas para este usuário consulte o item 14 deste documento.
6. O que fazer se acontecer o erro abaixo ao tentar enviar a notificação?
Este erro pode acontecer caso tenha alguma restrição de segurança, desta forma libere o acesso ao endereço: https://fcm.googleapis.com/fcm/send.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas