Histórico da Página

...

01. OBJETIVO

Apresentar ao usuário Disponibiliza uma tela funcionalidade que permite acompanhar de forma dinamicamente 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.

04. PARAMETRIZAÇÃO DATASUL

a. Descentralização RH

A página de parâmetros da função FP0540 - Descentralização RH, permite a configuração das informações de integração com o Clock In/Carol.

Essas informações são necessárias para permitir a comunicação entre Datasul e Carol, sendo fornecidas na contratação e criação do ambiente na Carol.

Após o preenchimento dos dados é possível testar a comunicação com a Carol Clock In clicando no botão Image Removed.

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. Coordenadores Clock In/Carol

A função FP9696 - Coordenadores Clock In/Carol permite a identificação dos funcionários com papel de coordenador que utilizarão o aplicativo Clock In para realizar as marcações de seus funcionários.

Basta relacionar os funcionários (coordenadores) para que os dados destes sejam enviados para o ambiente da Carol.

Image Removed

Através do botão "Formar" será possível relacionar os coordenadores.

Será apresentada a seguinte tela:

Image Removed

Na coluna/browser da esquerda serão apresentados os funcionários da empresa corrente, e na coluna/browser da direita os coordenadores que já foram relacionados.

Caso o usuário queira relacionar funcionários de outras empresas, será necessário clicar no botão "Filtrar". Através desta tela é possível filtrar, além da empresa, por estabelecimento e matrícula. Caso contrário basta deixar os campos com o valor "0"(zero) para que sejam apresentados todos os estabelecimentos e matrículas da empresa informada:

Image Removed

Outra funcionalidade disponível nesta tela é a busca de funcionários pelo nome.

Basta informar no campo "Nome" e clicar no botão check verde.

Image Removed

Para os coordenadores que já estão relacionados, também é possível filtrar os funcionários que estão ativos, desligados ou ambos. 

Para salvar os registros, utilizar o botão central para movimentar da coluna esquerda para direita, em seguida clicar no botão "OK".

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. Manutenção Relógio Ponto

Para implementação do cadastro de relógio ponto, deve-se definir um código e sua respectiva descrição, informando o local onde o mesmo está relacionado e o tipo de batida que o mesmo aceita. Para maiores esclarecimentos acessar Manutenção do Relógio Ponto - PE0620.

Image Removed

• • O número do REP cadastrado no PE0620 deve ser o mesmo informado no campo REP CODE no cadastro dos dispositivos na Carol Clock-in. É uma informação obrigatória e necessariamente deve ser diferente de 0 (zero).
  • O cadastro do REP CODE no ambiente Carol/Clockin pode ser realizado pelo seguinte link: https://dominioCliente.carol.ai/totvsdatasul/apps/clockinapp/3.1.0-b/#/devices.
  • Para cadastrar um dispositivo é premissa ter o cadastro de empresa e localização já efetuados o Cadastro de código de dispositivo sem máscara.

05. IMPORTAÇÃO DAS MARCAÇÕES PONTO

...

Na aba Parâmetros é possível escolher entre duas opções de Baixa de Marcações:

• • Um Dispositivo por Vez - faz a baixa de marcações de um dispositivo por vez. Apresenta o limite de 200 registros por requisição/resposta.
    • Esta forma de baixar marcações apresenta vantagem quando há um número menor de dispositivos cadastrados e um melhor detalhamento do processo impresso no log de execução.
  • Por Lote de Dispositivos - faz a baixa de marcações de vários dispositivos em uma única requisição a Carol Clock In. Apresenta o limite de 1000 registros por requisição, obtendo as marcações de diversos dispositivos por resposta.
    • Esta forma de baixar marcações apresenta melhor performance, executando de forma mais rápida, principalmente quando existe um número maior de dispositivos.     

Image Removed

a. Log de Execução

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.

A tabela abaixo mostra todas as mensagens, e sua correlação de uso, situações de erro ou reporte.

...

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

Image Removed

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

...

Indica o número da requisição realizada para a busca dos dispositivos.

...

log 9997

...

log 9992

...

log 9976

...

Indica que a baixa de marcações foi interrompida devido à alguma marcação estar com dados incorretos (ex: PIS, data, hora não informado).

...

Indica a quantidade de marcações não processadas.

...

log 9971

...

Indica que a baixa de marcações foi interrompida devido à alguma marcação estar com dados incorretos (ex: PIS, data, hora não informado).

...

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>

...