DT Melhorias Fase 2 Dashboard

01. DADOS GERAIS

Produto:	TOTVS RH
Linha de Produto:	Linha Protheus
Segmento:	RH
Módulo:	PONTO ELETRÔNICO (SIGAPON)
Função:	DASHBOARD (PONDASH) rh.dashboard.ponapidsb.tlpp PONA480A.PRW
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :	DRHJORNPRT-5492

02. SITUAÇÃO/REQUISITO

1º - Incluir o filtro de Gestor, para que o Dashboard busque os funcionários que respondem diretamente a um Gestor.
2º - Incluir a validação de funcionários que são isentos de marcação.
3º - Incluir a opção de gerar uma planilha do Excel com as informações do Dashboard.
4º - Incluir a opção de enviar e-mail com as informações do Dashboard para os gestores.

03. SOLUÇÃO

Importante

Para utilização das novas melhorias será necessário a aplicação do pacote de fontes e pacote de dicionário liberadas na Expedição Contínua do RH a partir de 01/12/2023.
Para que seja possível gerar a planilha do Excel, será necessário realizar a instalação do TOTVS Printer além de ter os pacotes da Expedição Contínua do RH a partir de 01/12/2023 aplicados. Para mais informações do TOTVS Printer acesse o link TOTVS Printer - Instalação

Filtro de Gestor no Dashboard. Para utilizar o filtro será necessário utilizar o parâmetro MV_ORGCFG. Por padrão o filtro irá exibir os gestores de acordo com a configuração do parâmetro, por exemplo:
1. MV_ORGCFG = 0. O gestores exibidos nos filtros serão aqueles que estão como responsáveis por um departamento, para isso será necessário informar a Filial e Matricula do responsável no cadastro do departamento.
2. MV_ORGCFG = 1. O gestores exibidos nos filtros serão aqueles que estão cadastrados na visão por postos, para isso será necessário realizar o cadastro da estrutura por posto.
3. MV_ORGCFG = 2. O gestores exibidos nos filtros serão aqueles que estão como responsáveis por um departamento, obedecendo a visão por departamentos, para isso será necessário realizar o cadastro da estrutura por departamentos.
Isentos de Marcação
1. O Dashboard não irá trazer os funcionários que são isentos de marcações, caso o funcionário seja 100% isento no período selecionado no filtro. Por exemplo, o funcionário passou a ser isento de marcações no dia 10/11/2023, caso seja selecionado o período inicial 10/11/2023 e final 20/11/2023 o funcionário não será exibido mais.
2. Quando o funcionário possuir pelo menos 1 dia que precisa realizar as marcações no período selecionado, o mesmo será exibido no Dashboard. Por exemplo, o funcionário passou a ser isento de marcações no dia 10/11/2023 e nos filtros de período foram selecionados 09/11/2023 à 20/11/2023, o funcionário será exibido.
3. A mesma regra anterior se aplica para período posteriores a isenção de marcação do funcionário. Por exemplo, o funcionário deixou de ser isento de marcações no dia 10/11/2023 e nos filtros de período foram selecionados 09/11/2023 à 20/11/2023, o funcionário será exibido.
Planilha do Excel
1. Incluído o botão "Gerar Excel" que ao clicar será gerado a planilha contendo as informações que estão sendo apresentadas no Dashboard.
2. Caso o filtro seja alterado e não seja atualizado o Dashboard a planilha do Excel conterá os dados da ultima atualização.
Enviar E-mail Gestores
1. Incluído o botão "Enviar E-mail Gestores". Ao clicar no botão será enviado e-mail para os gestores, onde o e-mail conterá a imagem do Dashboard e a planilha do Excel contendo os dados separados por gestor. Por exemplo, caso seja selecionado o Gestor A e Gestor B, e clicando no botão, o Gestor A receberá o e-mail com a imagem e planilha do Excel apenas com os funcionários que respondem diretamente a ele, a mesma regra se aplica para o Gestor B, ele receberá um e-mail com as informações apenas dos funcionários que respondem diretamente a ele.
2. Caso o filtro seja alterado e não seja atualizado o Dashboard o e-mail conterá os dados da ultima atualização.
3. Para que o gestor receba o e-mail, será necessário cadastrar o e-mail no cadastro de funcionário do gestor, preenchendo o campo End. E-mail (RA_EMAIL).
4. Caso o sistema não encontre nenhum e-mail no campo informado anteriormente, o Dashboard não irá realizar o disparo do e-mail para o gestor. Será exibida uma mensagem no console.log informando qual é a filial e matrícula do gestor que está sem e-mail cadastrado.

Importante

Caso não exista qualquer estrutura de gestores, seja por visão por postos ou por departamentos, o filtro do gestor será desativado no Dashboard.
O Dashboard irá buscar os gestores da filiais onde o usuário logado possui acesso. Caso exista qualquer gestor será exibido o filtro, caso contrário o filtro será desativado.

Quando for selecionado selecionado 1 gestor, o dashboard irá exibir apenas as informações dos funcionários que respondem diretamente a ele.

Quando for selecionado 2 gestores, os funcionários que respondem a ambos serão exibidos no Dashboard.

Importante

Caso sejam selecionados todos os gestores, o Dashboard irá ignorar o filtro por gestor, pois assim ele irá exibir todos os funcionários, até aqueles que não possuem um gestor vinculado.

Caso não existam gestores cadastrados, o filtro será bloqueado e não será utilizado para listar os funcionários. Para verificar se o filtro está desativado, basta posicionar o mouse em cima do filtro de Gestor que exibirá a seguinte mensagem:

Para que o Dashboard consiga identificar quais são os funcionários isentos de marcação, será necessário alterar o cadastro da Regra de Apontamento seguindo a documentação abaixo:
DT Funcionários Isentos de Marcação

Após realizar toda a configuração e vincular a regra de apontamento para um funcionário, o Dashboard conseguirá identificar se o funcionário é isento e se deve ocultar o mesmo. No exemplo abaixo, temos um funcionário que é isento de marcações apenas entre os dias 05/10/2023 à 10/11/2023.

Como existem dias que o funcionário precisa realizar sua marcação do ponto no período selecionado no Dashboard (01/11/2023 à 21/11/2023) o funcionário foi exibido. Porém quando for selecionado o período em que o funcionário não precisa realizar suas marcações, o mesmo não será exibido no Dashboard.

Importante

Para que seja possível gerar a planilha do Excel será necessário realizar a instalação do TOTVS Printer além de ter os pacotes da Expedição Contínua do RH a partir de 01/12/2023 aplicados. Para mais informações do TOTVS Printer acesse o link TOTVS Printer - Instalação

Antes de clicar no botão "Gerar Excel" é necessário atualizar o Dashboard caso exista alguma alteração nos filtros.

Após atualizar os Dashboard com os filtros utilizados, clique no botão "Gerar Excel".

Será aberta uma janela, para escolher o local onde será salvo a planilha gerada.

Ao abrir a planilha gerada, teremos 3 abas com os dados do Dashboard.

1º Indicadores Funcionários - Informações de todos os funcionários mais a informação da situação do ponto (Ponto completo, Ponto incompleto e Sem marcações)

2º Pontos Incompletos - Todas as ocorrências de funcionários que foram contabilizados como Ponto Incompleto.

3º Indicadores Clock In - Todas as informações das marcações no período seleciona mais uma coluna que indicará o status da marcação (Marcação processada, Integração Pendente e Marcação sem NSR).

No envio do e-mail, agora será possível receber uma imagem com os indicadores do Dashboard e a planilha do Excel com os dados dos indicadores. O envio do e-mail terá dois botões "Enviar E-mail" "Enviar E-mail Gestores".

Enviar E-mail - Será enviado uma imagem com os indicadores do Dashboard e uma planilha do Excel com o dados, onde o destinatário será o conteúdo do parâmetro MV_GPEMAIL.
Enviar E-mail Gestores - Será enviado uma imagem com os indicadores do Dashboard e uma planilha do Excel com o dados, onde o destinatário será o próprio gestor, utilizando o campo End. E-mail (RA_EMAIL). Caso selecionado mais de um gestor, o Dashboard irá separar os funcionários de cada um para gerar a imagem e a planilha do Excel, assim cada gestor receberá o Dashboard apenas com as informações dos funcionários que respondem diretamente a ele.

Observações

Antes de enviar e-mail para os gestores, será necessário validar o cadastro de cada um deles para verificar se o e-mail está cadastrado no campo End. E-mail (RA_EMAIL).