Histórico da Página

...

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.

...

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ção definições de filtros, gerando um acompanhamento dinâmico, de fácil e rápido entendimento. 

Os indicadores apresentam status representam determinados estados das marcações dentro do produto TOTVS Datasul, e caso exista uma a integração com a Carol Clock In esteja configurada, são apresentados indicadores

deste ambiente também.

Podemos enviar estas informações As informações demonstradas no Dashboard podem ser enviadas por e-mail para um grupo de pessoas.   

...

• Para o perfeito funcionamento do aplicativo 2C é necessário que o broker SQL esteja habilitado para a comunicação entre as Plataformas. Se ainda não estiver é necessário solicitar ao seu Administrador de Banco de Dados para conceder essa permissão. Isso se faz necessário porque na configuração do aplicativo 2C (via Web) a informação da porta que está configurado o banco DTHRPYC (banco que está definida a tabela utilizada no 2C) deverá ser inserida na parametrização do aplicativo. Se o broker não estiver habilitado o 2C não poderá ser configurado.

• O campo PIS CODE e REP CODE na Plataforma Carol é obrigatório para a integração correta com o Datasul pois se trata de uma informação chave para o sistema.

• A informação do PIS code pode ser consultada na plataforma da Carol, https://dominioCliente.carol.ai/totvsdatasul/carol-ui/explore/employee/search, selecionar o funcionário e consultar o campo PIS code.

• Importante destacar que a Carol também disponibiliza uma função para a exportação dos arquivos de marcação no formato AFD (http://www.trtsp.jus.br/geral/tribunal2/ORGAOS/MTE/Portaria/P1510_09.html). Essa função é uma outra alternativa manual que o usuário pode utilizar para fazer a importação das batidas do funcionário para a base Datasul. Para maiores detalhes em como efetuar a exportação do arquivo AFD, consulte a documentação: Download das marcações usando layout AFD

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

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 . 

Image Added

...

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.

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.

Image Added

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.

Image Added

Após clicar no botão Atualizar, primeiramente são apresentados os indicadores totalizando as informações de todos os estabelecimentos selecionados.

Image Added

Em seguida, são apresentados os indicadores de cada estabelecimento selecionado.

Image Added

Image Added

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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. 

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

Image Added

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.

Image Added 

Abertura do anexo.

Image Added

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

Image Added

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

Image Added

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.

Image Added

03. PRÉ-REQUISITOS

•  A criação destes parâmetros está disponível a partir da 12.1.29.3 (versão mínima Progress 11.7.5). 
•  Necessária a utilização do módulo de Controle de Frequência do sistema Datasul.
•  Apenas funcionários parametrizados para considerar no cálculo do ponto (PE1700) serão listados no dashboard.
•  Somente funcionários de origem contratação empresa (FP1500) devem ser considerados.

04. PARAMETRIZAÇÃO DATASUL

a. Acesso a estabelecimentos

Para que o usuário consiga listar informações no Dashboard é necessário permissão nos estabelecimentos.

Os estabelecimentos são considerados a partir da empresa em que o usuário está trabalhando e que tem acesso concedido por meio da parametrização do programa FP0590.

Colocar o FP0590.

Image Removed

 A partir desta configuração, é ativada a função FP9696 permitindo que seja possível selecionar e definir quais funcionários tem perfil de coordenador.

b. Funcionários

Serão considerados para serem listados nos indicadores do Dashboard os funcionários que estiverem com a seguintes parametrizações:

O funcionário deve estar cadastrado no FP1500 - Funcionários.

Image Removed

No PE1700 - Manutenção de Funcionário Ponto Eletrônico, os funcionários que serão considerados pelo Dashbaord de Marcações devem estar cadastrados com os seguintes critérios:

Origem Contrato = Empresa

Considerar Cálculo do Ponto = Marcado

Data de Demissão = Não preenchida, caso preenchida será considerado a depender se a data relacionada no Dashbaord for menor a data de demissão.

Image Removed

Image Removed

Image Removed

 A inclusão/exclusão de coordenadores nesta função efetua o envio dos dados destes para atualização do ambiente na Carol.

c. Parametrização Carol Clock In

Para empresas que adquiriram a plataforma Carol Clock In é possível integra-la com o TOTVS Datasul. Para isso o primeiro passo é parametrizar no FP0540 os dados da Carol Clock In. 

O Dashboard utiliza estes dados para fazer a conexão com a Carol Clock In e consultar os dados para preenchimento dos indicadores.

Caso o campo xxxx não esteja marcado o Dashboard não inicia o processo de consulta de marcações.

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

Image Removed

d. Parametrização e-mail

Para que seja possível utilizar o recurso de envio de e-mail do Dashboard de Marcações de Ponto é necessário que as seguintes parametrizações sejam feitas:

No PE0200 temos a parametrização do grupo de e-mail, que nos permite indicar grupos que foram previamente cadastrados FP0930. 

Image Removed

05. Dashboard de Marcações de Ponto

...

Após completar o carregamento dos dados, podemos filtrar as informações de maneira personalizada utilizando os campos:

Data de início: data de início para que os dados das marcações sejam considerados para preenchimento dos indicadores. 

Data de Término: data de término para que os dados das marcações sejam considerados para preenchimento dos indicadores. 

Selecione o Local: Permite definir qual o estabelecimento o usuário deseja visualizar os dados. 

Atualizar: Ao clicar no botão atualizar, conforme dados preenchidos nos campos de filtros a pagina será atualizada.

Enviar E-mail: Ao clicar no botão enviar e-mail, será enviado por e-mail um print do dashboard conforme o que está sendo exibida na tela.

Os indicadores estão dívidas em duas áreas:

Indicadores de funcionários: Está parte do dashboard exibe informações de dados que estão são de origem do produto ou que constam após o processo de integração de marcação de ponto. 

• • Total de Funcionários: Apresenta total de funcionários parametrizados para considerar o cálculo do ponto, que estejam ativos no período filtrado e que não estejam em afastamento (férias, atestado, entre outros) durante o período. 

Funcionários transferidos serão contabilizados na empresa de destino.

Não são considerados funcionários que geram ponto automaticamente.

• • Funcionários com pontos completos: Apresenta total de funcionários que possuem um par de marcações de ponto igual ou maior a quantidade de batidas que o funcionário precisa realizar.

Considera marcações que já foram importadas por meio do PE7100 ou PE2000.

Funcionários parametrizados para não bater entrada/saída não deve ser considerado.

A jordana cadastrada para o funcionário é consultada para validar se deve considerar ou não intervalo, auxiliando na validação se o ponto está completo ou não.

• • Funcionários com pontos incompletos: Apresenta total de funcionários que possuem um número impar de marcações de ponto menor que a quantidade de batidas que o funcionário precisa realizar no dia.

Considera marcações que já foram importadas por meio do PE7100 ou PE2000.

Funcionários parametrizados para não bater entrada/saída não deve ser considerado.

A jordana cadastrada para o funcionário é consultada para validar se deve considerar ou não intervalo, auxiliando na validação se o ponto está completo ou não.

• • Funcionários sem marcações no período: Apresenta o total de funcionários não que possuem nenhuma marcação nos dias do período que foi feito o filtro.

Image Removed

a. Envio de e-mail do Dashboard

Ao finalizar a execução, o PE9696 gera um log de execução das etapas do processo de baixa das marcações da Carol Clock-in para o Totvs Datasul, reportando os status e erros, caso ocorram. 

Image Removed

O Log de execução é composto por 4 colunas:

Código: Organiza e identifica as mensagens.

Tipo: Identifica a informação como Erro ou Status do processo feito pelo programa.

Descrição:  Identifica de forma resumida à que se refere a mensagem.

Detalhe/Observação: Traz mais detalhes sobre a mensagem conforme o ponto do processamento.

b. Relatório Excel com as Marcações Importadas

Ao final da execução do PE9696 será gerado um arquivo com extensão '.csv' com todas as marcações baixadas e, que ainda não foram processadas pelo PE7100.

Ex:

Image Removed

c. Arquivo de Log Detalhado

Na aba Parâmetros é possível indicar que se deseja gerar o arquivo de log detalhado.  Quando selecionado este campo, é obrigatório que seja informado o diretório para a geração deste arquivo.

Image Removed

...

O nome do arquivo de log detalhado é composto pelas seguintes informações:

• • Texto Fixo: ‘PE9696_log_detalhado’ +
  • Data Geração +
  • Hora geração +
  • Extensão ‘.txt’

Ex: PE9696_log_detalhado_220322_094547.txt 

No arquivo gerado constarão informações detalhadas sobre os processos executados durante a baixa de marcações da Carol/Clockin para o Datasul, possibilitando a identificação e avaliação de possíveis problemas que possam ter ocorrido. 

Ex:

• • Quantos dispositivos foram localizados para importação;
  • Quantos dispositivos foram validados com sucesso e serão considerados para a baixa de marcações.
  • Quantas batidas foram integradas;
  • Quantas batidas já estavam integradas;
  • Quantas batidas ainda estão pendentes de importação (não processadas).

d. Arquivo de Log Técnico

Na aba Parâmetros é possível indicar que se deseja gerar o arquivo de log técnico.  Quando selecionado este campo, é obrigatório que seja informado o diretório para a geração deste arquivo.

Image Removed

...

• O nome do arquivo de log técnico é composto pelas seguintes informações:
  • Texto Fixo: ‘PE9696_log_técnico’ +
  • Data Geração +
  • Hora geração +
  • Extensão ‘.txt’

Ex: PE9696_log_tecnico_280322_141253.txt 

•  Caso tenha sido selecionado os campos para gerar o arquivo de log detalhado e o arquivo de log técnico, estes dois arquivos terão a mesma data e hora na composição do seu nome.

No arquivo gerado constarão informações detalhadas sobre as requisições/retornos dos dispositivos e marcações executados durante a baixa de marcações da Carol/Clockin para o Datasul, possibilitando a avaliação de possíveis problemas que possam ter ocorrido. 

Ex:

• • URL e parâmetros das requisições de dispositivos e marcações.
  • Informações do arquivo JSON da requisição de dispositivos (apenas para baixa de marcações por lote de dispositivos).
  • Informações do arquivo JSON de retorno da requisição de dispositivos.
  • Informações do arquivo JSON da requisição de marcações.
  • Informações do arquivo JSON do retorno da requisição de marcações.

Image Removed

A tabela abaixo demonstra a relação das mensagens exibidas no arquivo de log técnico.

...

Indica a URL executada:

• para a busca de dispositivos;
• para a baixa das marcações.

...

Indica os parâmetros enviados na requisição:

• para a busca de dispositivos;
• para a baixa das marcações.

...

06. CLIENTLOG

Também foram implementados alguns logs para auxiliar o atendimento na identificação de algum eventual problema na integração. Para consultar os log da integração pode-se buscar por #clockin no clientlog.

Segue uma tabela com as mensagens que podem estar no clientlog e alguns motivos da origem destas mensagens.

...

...

...

...

Esta mensagem é originada quando o retorno das marcações do clockin possui alguma inconsistência de formato ou não existência dos campos, neste caso deve-se verificar com o Totvs Labs.

Caso aconteça alguma falha de comunicação com o servidor (falta de internet por exemplo) pode originar essa mensagem.

Neste caso é importante também verificar os certificados de importação.

...

07. INTEGRANDO COM TOTVS CAROL

Para conhecer os principais serviços e saber como construir uma integração para envio e consumo de dados da Carol, acesse a página Integrando com TOTVS Carol.  

Os subtópicos podem ser acessados através da árvore da página conforme exemplo abaixo:

Image Removed

...

Essa funcionalidade foi criada pela TOTVS LABS.

Qualquer dúvida em relação a esta funcionalidade entre em contato com o atendimento da Carol [email protected].

...

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...