Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Índice
indent20px
excludeCONTEÚDO

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.


Aviso
titleImportante!

Este documento, assim como esta funcionalidade, somente terá utilidade para

cliente

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çã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.   

...

titleInformação Importante!
  • 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.

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:

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ções
titleInformaçã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 . 


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.


Informações
titleImportante

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.

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


Informações
titleSeleçã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

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. 


GrupoIndicadorRegraRegra

Indicadores de Funcionários

Total de Funcionários

Apresenta o total de funcionários que :

    • estão parametrizados para serem considerados no cálculo do ponto (PE1700);
    • possuem origem de contratação Empresa (FP1500);
    • batem entrada e saída (campo no PE1700);
    • estejam ativos no período informado e
    • não estejam em afastamento (férias, atestado, entre outros) durante todo o período informado. 


Informações
titleImportante

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:

  • para cada dia trabalhado do período selecionado, no qual não exista atestado ou férias, a quantidade de marcações realizadas (exceto pré-assinaladas) seja igual ou superior à quantidade de marcações esperadas, conforme a jornada de trabalho do dia (respeitando a ordem: calendário do funcionário, alteração de jornada, empréstimo de turno, turno de lotação), considerando também se o funcionário bate ou não intervalo.


Informações
titleImportante

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:

  • para cada dia trabalhado do período selecionado, no qual não exista atestado ou férias, a quantidade de marcações realizadas (exceto pré-assinaladas) seja inferior (mas não nula) à quantidade de marcações esperadas, conforme a jornada de trabalho do dia (respeitando a ordem: calendário do funcionário, alteração de jornada, empréstimo de turno, turno de lotação), considerando também se o funcionário bate ou não intervalo.

Funcionários sem Marcações

Apresenta o total de funcionários que:

  • não possuem marcações em nenhum dia trabalhado do período selecionado, desconsiderando os dias para os quais exista atestado ou férias.


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


Informações
titleImportante

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çãoApresenta 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 NSRExibe o total de marcações existentes no Clock In no período selecionado e que não possuem o NSR gerado.



Informações
titleImportante

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


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


Campo/QuadroDescriçã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:

  • Todos: quando selecionada esta opção indica que todos os estabelecimentos serão considerados.
  • Selecionar: quando selecionada esta opção indica que serão considerados os estabelecimentos escolhidos na pasta Seleção.
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:


OpçãoData Início PeríodoData Término Período
MensalConsidera o primeiro dia do mês atual.Considera o dia da execução do programa.
Quinzenal

Verifica em qual quinzena do mês atual se enquadra a data da execução do programa. Caso seja na:

  • Primeira Quinzena: considera o primeiro dia do mês atual.
  • Segunda Quinzena: considera o dia 16 do mês atual.

Verifica em qual quinzena do mês atual se enquadra a data da execução do programa. Caso seja na:

  • Primeira Quinzena: considera o dia 15 do mês atual.
  • Segunda Quinzena: considera o dia da execução do programa.
SemanalConsidera a segunda-feira da semana em que se enquadra a data da execução do programa.Considera o dia da execução do programa.
Quantidade de DiasÉ calculada subtraindo-se da data de execução do programa a quantidade de dias informada no campo Qtde Dias.Considera o dia da execução do programa.


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

Informações
titleImportante

Para mais informações sobre os campos Nome Organização e Nome Ambiente verifique o documento https://docs.carol.ai/docs

Para mais informações sobre os campos Connector Id e Connector Token verifique o documento https://centraldeatendimento.totvs.com/hc/pt-br/articles/4408796105495-RH-Clock-In-by-Carol-Connector-Token

(informação) 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

(informação) 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

...

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

...

titleInformação

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

Informações

Dependendo do editor de texto utilizado para visualizar o arquivo de log técnico, as informações do arquivo JSON são visualizadas sem formatação. Para correta visualização sugere-se utilizar os editores "Notepad++", "Word" ou "Excel".

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.

...

Possível Origem

...

Uma ou mais informações não estão preenchidas no FP0540.

...

Código de retorno da requisição dos dispositivos, caso diferente de 200, está com algum erro de comunicação.

...

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

...

iconfalse

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

...



HTML
<!-- 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>

...