Árvore de páginas

Versões comparadas

Chave

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

...

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.


Aviso
titleImportante!

Este documento, assim como esta funcionalidade, somente terá utilidade para cliente clientes que utilizam o ponto eletrônico.

...

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:

...

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

Serão considerados os estabelecimento 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.

...

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

    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


    ...

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

    ...

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

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

    ...

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

    ...

    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

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

    No caso de haver integração com Suricato ou Clockin é 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).

    ...

    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.

    ...

    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

    ...

    Apresenta o total de marcações existentes no Clock In de acordo com o filtro informado no Dashboard (período e estabelecimento).

    ...

    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.

    ...

    Abaixo demonstramos um exemplo da tela do Dashboard de Marcações de Ponto.

    Image Removed

    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, para um grupo de pessoas, o conteúdo que estamos visualizando em tela .

    Após realizar a parametrização do filtro e clicar em Atualizar, é necessário apenas clicar em "Enviar E-mail" .

    Image Removed

    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 horas apresentam o dia e horário do envio do e-mail.
      • Anexo: arquivo com o print da tela do Dashboard que permite a conferência dos indicadores de funcionários e das marcações do Clock In.

    Image Removed 

    Abertura do anexo.

    Image Removed

    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 estabelecimento e período de consulta informados, o programa realiza a consulta das informações dos indicadores de funcionários e marcações do clockin (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.

    Image Removed

    Período Consulta Informações 

    Data Inicial                                             

    Data Final

    MensalConsidera o primeiro dia do mês atual
    .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.

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



    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>
    
    

    ...