CONTEÚDO
01. OBJETIVO
Disponibiliza uma funcionalidade que permite acompanhar de forma dinâmica o processo de marcações de ponto eletrônico, facilitando a gestão e monitoramento.
Importante!
Este documento, assim como esta funcionalidade, somente terá utilidade para clientes que utilizam o ponto eletrônico.
02. VISÃO GERAL
O Dashboard de Marcação de Ponto permite acompanhar os status de marcações de ponto eletrônico por meio de indicadores que são exibidos conforme definições de filtros, gerando um acompanhamento dinâmico, de fácil e rápido entendimento.
Os indicadores representam determinados estados das marcações dentro do produto TOTVS Datasul, e caso a integração com a Carol Clock In esteja configurada, são apresentados indicadores
deste ambiente também.
As informações demonstradas no Dashboard podem ser enviadas por e-mail para um grupo de pessoas. Esta operação pode ocorrer de duas formas:
- Manual: através da tela do próprio Dashboard de Marcações ou
- Automática: a partir de um agendamento de recorrência através da função Agendamento E-mail Dashboard - PE9600.
03. PRÉ-REQUISITOS
- O Dashboard de Marcação de Ponto está disponível a partir das versões 12.1.34.15, 12.1.2205.10 e 12.1.2209.5 .
- Necessária a utilização do módulo de Controle de Frequência do sistema Datasul.
04. PARAMETRIZAÇÃO DATASUL
a. Estabelecimentos
Para que o usuário consiga visualizar informações no Dashboard é necessário ter permissão nos estabelecimentos da empresa.
Serão considerados os estabelecimentos da empresa em que o usuário estiver logado e, nos quais ele possua acesso concedido por meio da parametrização na função Manutenção Usuário Segurança Estabelecimento - FP0590 e, que possuam funcionários ativos.
b. Funcionários
Os funcionários a serem considerados nos indicadores do Dashboard de Marcações de Ponto precisam atender às seguintes regras:
- Serem considerados no cálculo do ponto, através de parametrização na função Manutenção do Funcionário Ponto Eletrônico - PE1700.
- Baterem Entrada/Saída, podendo bater ou não bater intervalo, parametrização realizada na função Manutenção do Funcionário Ponto Eletrônico - PE1700.
- Possuírem origem de contratação Empresa, ou seja, o seu cadastro tem que ser realizado na função Manutenção Funcionário - FP1500.
- Estarem ativos no período da consulta. Funcionários desligados são considerados até a data de seu desligamento.
c. Integração Carol Clock In
O Dashboard utiliza os dados de integração com a plataforma Carol Clock In informados na função FP0540 para consultar as informações que compõem os indicadores de marcações do Clock In.
Para mais detalhes da do processo de parametrização da Carol Clock In no TOTVS Datasul, acesse: Integração Datasul x Carol - Importação de Batidas Ponto
Informação
Quando executado o Dashboard e a configuração da Carol Clock In estiver parametrizada, o processo feito em relação as marcações de ponto são apenas de consultas, não sendo realizada a baixa de marcações para o TOTVS Datasul.
d. Envio de e-mail
Para que seja possível utilizar o recurso de envio de e-mail do Dashboard de Marcações de Ponto e a função Agendamento E-mail Dashboard - PE9600 é necessário que as seguintes parametrizações sejam feitas:
Parâmetros de e-mail
O produto Datasul possui um cadastro de parâmetros de e-mail (BTB962ZB). Mais informações quanto a parametrização estão disponíveis em: Parâmetros Email Foundation (BTB962ZB).
O produto RH também possui a função Manutenção Parâmetros Globais e Módulos - FP0003 onde são informados alguns parâmetros para o envio de e-mail: Servidor E-mail, Utiliza Servidor Exchange e Número Porta Servidor.
Remetente
Na função Manutenção de Usuário (SEC000AA) , pasta Geral botão Compl RH, o usuário deve possuir um funcionário/pessoa física relacionado.
Na função Manutenção Pessoa Física - FP1440, a pessoa física relacionada ao funcionário do usuário, deve possuir na pasta Endereço, o campo E-mail preenchido.
Destinatários
Na função Manutenção Grupos de Email - FP0903 deve ser cadastrado um grupo de e-mail, no qual deverão ser relacionados os funcionários, com seus respectivos e-mails. Estas serão as pessoas que receberão as informações do Dashboard por e-mail.
Na função Manutenção dos Parâmetros do Ponto Eletrônico - PE0200 é necessário informar o grupo de e-mail que será utilizado pelo Dashboard e pela função de agendamento de e-mail .
05. Dashboard de Marcações de Ponto
Ao executar o Dashboard de Marcações de Ponto inicialmente são apresentadas as informações referentes ao período do dia anterior até a data atual para todos os estabelecimentos nos quais o usuário tem permissão de acesso.
Após completar o carregamento dos dados, podemos filtrar as informações de maneira personalizada utilizando os seguintes campos:
- Data de início: data de início para que os dados das marcações sejam consideradas para consulta dos indicadores.
- Data de Término: data de término para que os dados das marcações sejam consideradas para consulta dos indicadores.
- Selecione o Local: permite definir o(s) estabelecimento(s) para o qual(is) se deseja visualizar os dados. São exibidos para escolha apenas estabelecimentos em que o usuário tem permissão de acesso e que possuem funcionários ativos.
- Atualizar: ao clicar no botão Atualizar as informações dos indicadores serão atualizadas conforme dados preenchidos nos campos de filtro.
Importante
Período de Consulta das Informações
Será possível realizar a alteração da data de início e término 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.
Informações "Última Atualização às"
Cada vez que o filtro for alterado, ao clicar em Atualizar, a data e hora exibidas no campo superior direto em "Última atualização às" serão atualizadas, com isso poderemos ver em qual dia e hora o Dashboard foi atualizado.
Abaixo demonstramos um exemplo da tela do Dashboard de Marcações de Ponto.
Até os patches 12.1.2301.7, 12.1.2209.12 e 12.1.2205.17
Os indicadores demonstram as informações para um estabelecimento em específico (informado no filtro) ou demonstram a totalização para todos os estabelecimentos que o usuário possui acesso.
A partir dos patches 12.1.2301.8, 12.1.2209.13 e 12.1.2205.18 e versão 12.1.2307
É possível selecionar mais de um estabelecimento para a consulta dos indicadores.
Após clicar no botão Atualizar, primeiramente são apresentados os indicadores totalizando as informações de todos os estabelecimentos selecionados.
Em seguida, são apresentados os indicadores de cada estabelecimento selecionado.
Seleção de Estabelecimentos
Regras do filtro de estabelecimentos:
1) Se for selecionado apenas um estabelecimento, o Dashboard irá exibir apenas os indicadores de Funcionários e Marcações Clock In do estabelecimento selecionado.
2) Se for selecionada a opção Selecionar Todos ou se for selecionado cada um dos estabelecimentos apresentados no filtro, o Dashboard irá exibir apenas os indicadores de Funcionários e Marcações Clock In totalizando os números de todos os estabelecimentos.
3) Se for selecionado 1 ou mais estabelecimentos, desde que não sejam todos os estabelecimentos, o Dashboard irá exibir os indicadores de Funcionários e Marcações Clock In totalizando os números de todos os estabelecimentos e também separados por estabelecimento.
Ao clicar sobre cada indicador é aberta uma janela que demonstra as informações dos funcionários ou marcações que foram contabilizados para o mesmo.
Detalhamento Indicador Total de Funcionários
São apresentadas as informações:
- Código e nome do estabelecimento
- Matrícula do funcionário
- Nome do funcionário
- Descrição da unidade de lotação do funcionário
Detalhamento Indicador Funcionários com Pontos Completos
São apresentadas as informações:
- Código e nome do estabelecimento
- Matrícula do funcionário
- Nome do funcionário
- Descrição da unidade de lotação do funcionário
Detalhamento Indicador Funcionários com Pontos Incompletos
São apresentadas as informações:
- Código e nome do estabelecimento
- Matrícula do funcionário
- Nome do funcionário
- Descrição da unidade de lotação do funcionário
Clicando em Visualizar é apresentada a tela abaixo com as seguintes informações:
- Código e nome do estabelecimento
- Matrícula do funcionário
- Nome do funcionário
- Data na qual falta marcação
- Motivo do ponto estar incompleto
- Horário previsto para as marcações
- Marcações realizadas
Detalhamento Indicador Funcionários sem Marcações
São apresentadas as informações:
- Código e nome do estabelecimento
- Matrícula do funcionário
- Nome do funcionário
- Descrição da unidade de lotação do funcionário
Detalhamento Indicador Total de Marcações no Período
São apresentadas as informações:
- CNPJ do estabelecimento
- CPF funcionário
- PIS funcionário
- Nome do estabelecimento
- Nome do funcionário
- Código do dispositivo
- NSR da marcação
- Data e hora da marcação
Detalhamento Indicador Marcações Processadas
São apresentadas as informações:
- CNPJ do estabelecimento
- CPF funcionário
- PIS funcionário
- Nome do estabelecimento
- Nome do funcionário
- Código do dispositivo
- NSR da marcação
- Data e hora da marcação
Detalhamento Indicador Marcações Existentes para Integração
São apresentadas as informações:
- CNPJ do estabelecimento
- CPF funcionário
- PIS funcionário
- Nome do estabelecimento
- Nome do funcionário
- Código do dispositivo
- NSR da marcação
- Data e hora da marcação
Detalhamento Indicador Marcações Sem NSR
São apresentadas as informações:
- CNPJ do estabelecimento
- CPF funcionário
- PIS funcionário
- Nome do estabelecimento
- Nome do funcionário
- Código do dispositivo
- NSR da marcação
- Data e hora da marcação
Sobre os Indicadores do Dashboard de Marcações
Os indicadores do Dashboard estão divididos em dois grupos:
- Indicadores de Funcionários: exibe informações das marcações que estão no produto TOTVS Datasul, após o processo de integração de marcação de ponto (PE2000 e/ou PE7100).
- Indicadores de Marcações Clock In: exibe informações que constam na Carol Clock In. Para iniciar a busca de informações na Carol Clock In o campo "Integra Carol Clock In" e os dados para conexão do FP0540 devem estar corretamente informados, caso contrário, os dados destes indicadores serão carregados com o valor zero.
| Grupo | Indicador | Regra | Regra |
|---|---|---|---|
Indicadores de Funcionários | Total de Funcionários | Apresenta o total de funcionários que :
Importante Funcionários transferidos serão contabilizados na empresa de destino. Não são considerados funcionários que batem ponto por Exceção. | |
| Funcionários com Pontos Completos | Apresenta o total de funcionários que:
Importante No caso de haver integração com Suricato ou Clock in é necessário que já tenha sido executado o programa PE7100, para que o dia seja considerado como ponto completo para o funcionário, pois a verificação das marcações é realizada na tabela de marcações do ponto (PE3700). | ||
| Funcionários com Pontos Incompletos | Apresenta o total de funcionários que:
| ||
| Funcionários sem Marcações | Apresenta o total de funcionários que:
| ||
Indicadores de Marcações Clock In | Total de Marcações no Período | Apresenta o total de marcações existentes no Clock In de acordo com o filtro informado no Dashboard (período e estabelecimento). | |
| Marcações Processadas | Apresenta o total de marcações existentes no Clock In, de acordo com o filtro informado, que estão com NSR gerado e que foram integradas com o TOTVS Datasul (PE9696). Importante Caso as marcações do Clock In tenham sido integradas para o Datasul através da importação do arquivo AFD (PE2000), estas não são contabilizadas como marcações processadas. | ||
| Marcações Existentes para Integração | Apresenta o total de marcações existentes no Clock In, no período selecionado, e que estão disponíveis para integração, ou seja, estão com NSR gerado e ainda não foram integradas com o TOTVS Datasul (PE9696). | ||
| Marcações sem NSR | Exibe o total de marcações existentes no Clock In no período selecionado e que não possuem o NSR gerado. |
Importante
Client-log Dashboard de Marcações de Ponto.
Este programa estruturalmente consta com API's de comunicação entre a tela do Dashboard de Marcação de Ponto, o TOTVS Datasul e com a Carol Clock In.
Para que seja possível um acompanhamento do processo foram criadas mensagens que são impressas no arquivo de log do APPServer.
Os acompanhamentos das funcionalidades estão dividas e podem ser identificadas da seguinte forma:
- #APIFilial : lista os passos dos programas envolvidos na busca e envio de informações dos estabelecimentos.
- #APIFunc : lista os passos dos programas envolvidos na busca e envio de informação dos indicadores de funcionários para a tela do Dashboard.
- #APIClock: lista os passos dos programas envolvidos na busca e envio de informações dos indicadores de marcações de ponto da Carol Clock In.
- #APIE-mail : lista os passos dos programas envolvidos no envio de e-mail do Dashboard.
a. Envio de E-mail do Dashboard
Para envio de e-mail, conforme explicado no início deste documento, é necessário efetuar as configurações do remente e do grupo de e-mail que contém os destinatários.
O Dashboard de Marcação de Ponto tem uma funcionalidade que nos permite enviar por e-mail, o conteúdo que estamos visualizando em tela, para um grupo de pessoas.
Após realizar a parametrização do filtro e clicar em Atualizar, é necessário apenas clicar em "Enviar E-mail" .
No e-mail enviado constam as seguintes informações:
- Assunto: Dashboard Datasul.
- Descrição: Informações do Dashboard gerado em data às horas, onde a data e hora apresentam o dia e horário do envio do e-mail.
- Anexo: arquivo com a imagem da tela do Dashboard que permite a conferência dos indicadores de funcionários e das marcações do Clock In.
Abertura do anexo.
b. Agendamento de Envio de E-mail
Esta funcionalidade permite que mesmo sem acessar o programa do Dashboard de Marcações de Ponto, as informações deste sejam enviadas por e-mail para um grupo de pessoas.
O agendamento do envio de e-mail é realizado através da função Agendamento E-mail Dashboard - PE9600 , podendo ter execução On-line ou Batch e, para este último pode-se ainda parametrizar uma periodicidade do pedido de execução (para mais informações acesse a documentação Repetir Pedido de Execução (BTB911ZC) ).
Com base no(s) estabelecimento(s) e período de consulta informados, o programa realiza a consulta das informações dos indicadores de funcionários e marcações do Clock in (caso utilizado) e gera um arquivo com a imagem da tela do Dashboard de Marcações do Ponto, enviando como anexo no e-mail direcionado aos funcionários relacionados no grupo de e-mail informado no programa PE0200, pasta Dashboard.
Pasta Parâmetros - até os patches 12.1.2301.7, 12.1.2209.12 e 12.1.2205.17
Pasta Parâmetros - a partir dos patches 12.1.2301.8, 12.1.2209.13 e 12.1.2205.18 e versão 12.1.2307
| Campo/Quadro | Descrição | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Filtro de Estabelecimentos | Disponível somente a partir dos patches 12.1.2301.8, 12.1.2209.13 e 12.1.2205.18 e versão 12.1.2307 Permite selecionar os estabelecimentos a serem considerados na consulta dos indicadores do Dashboard. Possui as opções:
| |||||||||||||||
| Estabelecimento | Até os patches 12.1.2301.7, 12.1.2209.12 e 12.1.2205.17 Permite informar um estabelecimento em específico para a consulta das informações ou informar "*" para indicar que devem ser considerados todos os estabelecimentos. A partir dos patches 12.1.2301.8, 12.1.2209.13 e 12.1.2205.18 e versão 12.1.2307 Esta faixa fica habilitada somente quando estiver selecionada a opção Selecionar no quadro Filtro de Estabelecimentos. Com base na faixa informada será realizada a carga dos estabelecimentos na pasta Seleção. | |||||||||||||||
| Período Consulta Informações | Permite selecionar o período que se deseja filtrar para a consulta dos indicadores do Dashboard. De acordo com a opção escolhida, as datas de início e término do período variam, conforme explicação abaixo:
|
Pasta Seleção - a partir dos patches 12.1.2301.8, 12.1.2209.13 e 12.1.2205.18 e versão 12.1.2307
Esta pasta somente fica habilitada quando estiver selecionada a opção Selecionar no quadro Filtro de Estabelecimentos (pasta Parâmetros).
Os registros apresentados são os estabelecimentos compreendidos na faixa informada na pasta Parâmetros.
É obrigatório escolher quais estabelecimentos serão considerados na consulta dos indicadores.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas