SIGAPON - Dashboard Ponto

ÍNDICE

01. VISÃO GERAL

O Dashboard do ponto reúne alguns indicadores para sinalizar de que será necessário realizar alguma manutenção no ponto de um funcionário ou verificar a integração das marcações do Clock In. No total temos 8 indicadores, que são:

1. Total de funcionários
2. Funcionários com o ponto completo
3. Funcionários com o ponto incompleto
4. Funcionários sem marcações
5. Total de marcações no período
6. Marcações processadas
7. Marcações existentes para integração
8. Marcações sem NSR

02. INDICADORES

No Dashboard o indicadores estarão agrupados de acordo com seu grupo. Atualmente temos 2 grupos, que são os Indicadores de Funcionários e Indicadores de Marcações do Clock In.

O grupo Indicadores de Funcionários irá exibir informações dos funcionários cadastrados no Protheus e trazer as informações do Ponto. Com isso será possível identificar a quantidade de funcionários que utilizam o ponto eletrônico, funcionários com o ponto completo, incompleto e sem qualquer marcação realizada no período. As informações que serão exibidas são com base nas tabelas de marcações (SP8 e SPG) .

Neste grupo teremos no total 4 indicadores que são:

Total de funcionários: Informa a quantidade total de funcionários que utilizam o ponto eletrônico. Para que um funcionário seja contabilizado, ele deverá ter preenchido em seu cadastro o Turno, Regra de Apontamento e Sequencia inicial.

Funcionários com o ponto completo: Informa a quantidade de funcionários com o ponto completo no período selecionado. Por exemplo um funcionário precisa realizar a marcação do ponto 4 vezes ao dia (entrada jornada, saída para o almoço, volta do almoço e saída da jornada). Na semana o funcionário trabalha de segunda à sexta, então teremos 5 dias trabalhados, onde cada dia o funcionário precisa bater o ponto 4 vezes totalizando 20 marcações na semana. Se o funcionário possuir 20 ou mais marcações o sistema irá contabilizar como ponto completo

Funcionários com o ponto incompleto: Informa a quantidade de funcionários com o ponto incompleto no período selecionado. Por exemplo um funcionário precisa realizar a marcação do ponto 4 vezes ao dia (entrada jornada, saída para o almoço, volta do almoço e saída da jornada). Na semana o funcionário trabalha de segunda à sexta, então teremos 5 dias trabalhados, onde cada dia o funcionário precisa bater o ponto 4 vezes totalizando 20 marcações na semana. Se o funcionário possuir menos de 20 marcações o sistema irá contabilizar como ponto incompleto

Funcionários sem marcações: Informa a quantidade de funcionários que não possuem uma única marcação no período.

O grupo Indicadores de Marcações do Clock In irá exibir informações referente a integração das marcações. O Dashboard fará uma consulta na Carol para verificar o total de marcações que existem e informar quais delas já foram integradas, quantas estão pendentes de integração e marcações sem NSR. Com isso será possível identificar se será necessário realizar a integração das marcações ou gerar a NSR no Clock In. As informações que serão exibidas são com base nas marcações existentes no Clock In e nas tabelas de integração (RR1 ou MSA_CONTROL_MARCAC).

Neste grupo teremos no total 4 indicadores que são:

Total de marcações no período: Informa a quantidade total marcações existentes no Clock In no período selecionado.

Marcações processadas: Informa a quantidade total de marcações que foram integradas, ou seja, as marcações que estão presentes na tabela RR1 ou MSA_CONTROL_MARCAC

Marcações existentes para integração: Informa a quantidade total de marcações que não foram integradas e já estão prontas para a integração, ou seja, as marcações que já foram geradas a NSR no Clock In e não estão presentes na tabela RR1 ou MSA_CONTROL_MARCAC

Marcações sem NSR: Informa a quantidade total de marcações que não possuem NSR gerada.

Atenção

Os indicadores do Clock In irão apresentar algum número apenas se todos os parâmetros de integração estiverem preenchidos. Caso o Clock In não seja utilizado ou os parâmetros de integração não estiverem preenchidos os indicadores serão zerados.

Para informações de como preencher os parâmetro acesse a documentação abaixo:
Integração Protheus x Carol - Importação de Batidas

03. CONFIGURAÇÃO

3.1. PORTA MULTIPROTOCOLO

Para que seja possível utilizar o Dashboard será necessário habilitar a Porta Multiprotocolo. Ao acessar a rotina do Dashboard caso a porta não esteja habilitada será exibida uma mensagem informando que será necessário habilitar a Porta Multiprotocolo.

Para habilitar a porta será necessário alterar o arquivo appserver.ini, na sessão General deverá ser incluída a chave App_Environment e seu conteúdo deverá ser o nome do ambiente configurado.

Exemplo de configuração da Porta Multiprocolo:

Para verificar se a Porta Multiprotocolo está habilitada, ao acessar o Protheus, a tela de login deverá ser a mesma da imagem abaixo:

Observação

Para habilitar a Porta Multiprotocolo, o Application Server precisa ser a partir da versão 19.3.0.1.

Para mais informações de como realizar a configuração da Porta Multiprotocolo acesse o link abaixo:
Application Server - Porta Multiprotocolo

3.2. ENVIO DO E-MAIL

No Dashboard temos a opção de tirar uma fotografia dos indicadores e enviar por e-mail, mas para que o e-mail seja enviado corretamente teremos que realizar algumas configurações como por exemplo a configuração do servidor de e-mail como endereço do servidor, usuário, senha e etc.

Para realizar as alterações necessárias siga os passos abaixo:

Acesso o módulo Configurador (SIGACFG) e acesse a rotina Configurar do e-mail.

Após isso preencha os campos conforme o servidor de e-mail que será utilizado.

Após a configuração do e-mail, teremos que preencher o conteúdo do parâmetro MV_GPEMAIL, este parâmetro será responsável por armazenar o destinatário do e-mail contendo as informações do Dashboard.

MV_GPEMAIL
Preencher com o destinatário do e-mail, caso ele não seja preenchido o sistema irá utilizar o MV_RELAUSR. Caso o MV_GPEMAIL e o MV_RELAUSR não estiverem preenchidos o sistema não irá enviar o e-mail.

3.3. ENVIO DO E-MAIL SCHEDULER

Para a utilização do Scheduler para o envio do e-mail com as informações do Dashboard, teremos que utilizar 2 parâmetros e realizar a configuração mencionada no item 3.2, como o preenchimento do servidor de e-mail, usuário, senha e etc.

Após realizar todo os preenchimento utilizando o configurador, teremos que preencher o conteúdo do parâmetro MV_GPEMAIL e MV_PONREST.

MV_GPEMAIL
Preencher com o destinatário do e-mail, caso ele não seja preenchido o sistema irá utilizar o MV_RELAUSR. Caso o MV_GPEMAIL e o MV_RELAUSR não estiverem preenchidos o sistema não irá enviar o e-mail.

Exemplo:

MV_PONREST

Preencher com o endereço do servidor Rest configurado no Protheus.

Configuração E-mail

Para mais informações sobre a configuração do envio do e-mail, acesse os links abaixo:

MP - FRAME - Configurar o SMTP para envio de relatórios por e-mail
Application Server - Uso de e-mail com GMail

04. EXEMPLOS DE UTILIZAÇÃO

Podemos utilizar o Dashboard de duas maneiras, a primeira dela será via interface, ou seja, é possível acessar o Dashboard pelo Protheus e segunda maneira é através do Scheduler. Ao configurar a rotina PONA480A no Scheduler, será enviado um e-mail contendo as informações do Dashboard, desta maneira não há a necessidade de ficar acessando o Protheus para verificar os indicadores.

Para acessar o Dashboard certifique que o pacote da expedição contínua a partir da data 01/12/2023 está aplicado em seu ambiente, tanto o pacote de fontes como o pacote de dicionário de dados. Após isso basta acessar o módulo do ponto (SIGAPON) e acessar a rotina Dashboard (PONA480) em Relatórios → Mensal → Dashboard.

Importante

O filtro do gestor e o botão "Enviar E-mail Gestores" só estarão disponíveis caso exista a estrutura de departamentos ou postos, utilizando o parâmetro MV_ORGCFG. Se o ambiente não possuir uma estrutura cadastrada, isso não afetará o Dashboard. O filtro do gestor será desativado e não será feito para buscar as informações dos funcionários. Serão considerado apenas os filtros de Data de Início, Data de Término e Filial.

Caso o ambiente não possua a estrutura, será exibida as mensagens abaixo no filtro e no botão "Enviar E-mail Gestores" ao pocisionar o mouse sobre o filtro ou o botão

Inicialmente o sistema sempre irá carregar o filtros com conteúdos padrões, por exemplo da Data de Inicio será 2 dias anteriores a date de hoje, a Data de Término 1 dia anterior a data de hoje e as filias serão preenchida com o filtro Todos, ao invés de uma filial em específico. Para realizar a alteração do filtro basta alterar os campos do filtro (Data de Início, Data de Término, Selecione a Filial e Selecione o Gestor) e posteriormente clicar em atualizar.

Cada vez que o filtro for atualizado clicando em Atualizar, a data e hora informados no campo superior direto em "Última atualização às" será atualizado, com isso poderemos ver em qual dia e hora o Dashboard foi atualizado.

Será possível realizar a alteração dos filtros informando a data inicial e final do período em que o sistema irá buscar as informações dos indicadores, porém o intervalo do período não poderá ser superior a 60 dias. Por exemplo ao preencher a Data de Inicio com 01/09/2023 e Data de Término 21/11/2022, o filtro Data de Término ficar em destaque com a cor vermelha e caso clicado em atualizar será exibida a seguinte mensagem.

Caso todos os filtros estejam corretos será possível realizar a atualização do Dashboard.

Ao clicar no campo "Selecione a Filial", será aberta um checklist possibilitando escolher mais de uma filial. Para facilitar na seleção de uma filial em específico é possível realizar a busca de filiais digitando pela filial.

Seleção de Filiais

Regras de utlização do filtro de filiais:

1º - Se for selecionada apenas 1 filial, o Dashboard irá exibir apenas os grupos Funcionários e Marcações Clock In da filial selecionada.
2º - Se for selecionada todas as filiais, o Dashboard irá exibir apenas os grupos Funcionários e Marcações Clock In totalizando os números de todas as filiais.
3º - Se for selecionada 1 ou mais filiais, desde que não seja todas as filiais, o Dashboard irá exibir os grupos Funcionários e Marcações Clock In seprados por filial e um totalizador com o resultado de todas as filiais selecionadas.

Ao clicar em algum indicador, será aberta uma nova janela onde serão exibidos os funcionários ou marcações do indicador selecionado.

Indicadores de funcionários:

Para o indicador de funcionários com Pontos Incompletos, será possível verificar as inconsistências do ponto por funcionário, ou seja, teremos um detalhamento de quais dias, quais as marcações previstas e realizadas pelo funcionário que gerou a inconsistência. Para isso, basta acessar o indicador de Pontos Incompletos e posteriormente clicar em visulizar.

Indicadores de Marcações Clock In:

Seleção de Gestores

Regras de utlização do filtro de gestores:

1º - Se for selecionado apenas 1 gestor, o Dashboard irá exibir no grupo de Indicadores de Funcionários os funcionários que respondem diretamente ao gestor selecionado.
2º - Se for selecionado todos os gestores, o Dashboard irá exibir no grupo de Indicadores de Funcionários todos os funcionários, independentemente se o funcionário possui um gestor ou não, retirando os gestores da lista de funcionários.
3º - Se for selecionado 1 ou mais gestores, desde que não seja todos os gestores, o Dashboard irá exibir no grupo de Indicadores de Funcionários todos os funcionários que respondem diretamente para os gestores selecionados.

Selecionando 1 Gestor.

Apenas os funcionários que respondem para o gestor de São Paulo foram listados no Dashboard.

Quando selecionado mais de um gestor, todos os funcionários que respondem diretamente aos gestores selcionados serão exibidos.

Após a atualização dos indicadores, é possível enviar um e-mail utilizandos os botões "Enviar E-mail" e "Enviar E-mail Gestores", se as configurações mencionadas no item 3.2 estiverem corretas.

No envio do e-mail, é 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 infomações dos funcionários que respondem diretamente a ele.

Importante

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

Abaixo está um exemplo do e-mail utilizando o botão "Enviar E-mail":

Abaixo está um exemplo do e-mail utilizando o botão "Enviar E-mail Gestores":

E-mail enviado para o gestor da M SP 01.

Os funcionários exibidos são apenas aqueles que respondem diretamente para o gestor da M SP 01.

Caso o e-mail do gestor não seja encontrado será exibido no log essa informação.

Para o envio do e-mail todos os indicadores deverão ter sido carregados, caso exista qualquer indicador sendo carregado o e-mail não será enviado.

Para a utilização do Scheduler para o envio do e-mail do Dashboard, certifique que o pacote da expedição contínua a partir da data 01/12/2023 está aplicado em seu ambiente, tanto o pacote de fontes como o pacote de dicionário de dados.

Caso o ambiente esteja atualizado, teremos a rotina PONA480A, ela será responsável por realizar o envio do e-mail com as informações do Dashboard.

Importante

A rotina PONA480A deverá ser executada apenas pelo Scheduler. Não será possível utiliza-la pelo menu do Protheus.

Preencha no Scheduler o campo rotina com PONA480A

Ao clicar em parâmetros será possível definir o filtro que será utilizado para trazer os indicadores do Dashboard.

Para a configuração existem 3 campos, que são:

1. Filial
2. Período (Mensal, Semanal, Quinzenal e Qtde Dias)
3. Quantidade de Dias
4. Gestor

Novo Filtro Filial

A partir da atualização do pacote de fontes e pacote de dicionário da Expedição Contínua liberado em 22/05/2023 o campo Filial foi alterado para que seja possível selecionar mais de uma filial.

Novo Filtro Gestor

A partir da atualização do pacote de fontes e pacote de dicionário da Expedição Contínua liberado em 01/12/2023 é possível realizar o filtro por gestor.

1 - Filial

Filial que será utilizada para a realização do filtro do Dashboard.

Se o pacote de fontes e o pacote de dicionário estiver atualizado com a data de 22/05/2023 será possível selecionar várias filias e até mesmo definir um range das filiais para a utilização do filtro.

Abaixo está um exemplo selecionando a filial D MG 01 e utilizando o range da M SP 01 à M SP 04.

2 - Período:

1. Mensal
Para a data inicial será considerado o primeiro dia do mês atual e para a data final o dia de hoje. Por exemplo, hoje é dia 11/08/2022, então a data inicial será 01/08/2022 e a data final 11/08/2022.
2. Semanal
Para a data inicial será considerada a segunda-feira da semana atual e para a data final o dia de hoje. Por exemplo, hoje é dia 11/08/2022, a segunda-feira da semana atual é 08/08/2022, então a data inicial será 08/08/2022 e a data final 11/08/2022.
3. Quinzenal
Para a data inicial será considerado a quinzenal atual e para a data final o dia de hoje. Por exemplo, hoje é dia 11/08/2022, a data inicial será 01/08/2022 e a data final 11/08/2022. Caso a data de hoje seja superior ao dia 15, será utilizada a segunda quinzena do mês. Por exemplo, hoje é dia 25/08/2022, então a data inicial será 15/08/2022 e a data final 25/08/2022.
4. Qtde Dias
Para a data inicial será considerado a quantidade de dias preenchida no 3º parâmetro menos o dia de hoje e a data final será o dia de hoje. Por exemplo, no parâmetro Quantidade de Dias está preenchido com 5 e a data de hoje é 11/08/2022, então a data inicial será dia 06/08/2022 e a data final 11/08/2022

3 - Quantidade de dias

Quantidade de dias que será utilizada para subtrair com a data de hoje, para utilização da data inicial do filtro do Dashboard. Este parâmetro só deverá ser preenchido caso a Opção do período seja "Qtde Dias", caso contrário este parâmetro será ignorado.

Observação

Caso a quantidade de dias informado no terceiro campo Quantidade de dias for superior a 60, o sistema automaticamente irá utilizar 60, mesmo que o campo esteja preenchido com 70, por exemplo.

4 - Gestor

Selecione o Gestor para que seja enviado os indicadores do Dashboard com uma imagem e uma planilha do Excel para o gestor selecionado.

Importante

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

Observação

Gestor não preenchido - 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.
Gestor preenchido - 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).
Para enviar e-mail para mais de um gestor será necessário cadastrar um novo agendamento para o gestor. Cada agendamento será único por gestor.

Após a configuração do Scheduler a rotina irá enviar o e-mail de acordo com a periodicidade definida e o parâmetros serão utilizados no filtro do Dashboard. Abaixo está um exemplo do e-mail enviado.