Árvore de páginas

Versões comparadas

Chave

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

ÍNDICE

Índice
excludeÍNDICE

01. VISÃO GERAL

O Dashboard do ponto reúne alguns indicadores para sinalizar de que será necessário realizar alguma manutenção no ponto de um funcionário ou verificar a integração das marcações do Clock In. No total temos 8 indicadores, que são:

1. Total de funcionários
2. Funcionários com o ponto completo
3. Funcionários com o ponto incompleto
4. Funcionários sem marcações
5. Total de marcações no período
6. Marcações processadas
7. Marcações existentes para integração
8. Marcações sem NSR

02. INDICADORES

No Dashboard o indicadores estarão agrupados de acordo com seu grupo. Atualmente temos 2 grupos, que são os Indicadores de Funcionários e Indicadores de Marcações do Clock In.

Totvs custom tabs box
tabsIndicadores de Funcionários,Indicadores de Marcações do Clock In
idsfuncionarios,clockin
Totvs custom tabs box items
defaultyes
referenciafuncionarios

O grupo Indicadores de Funcionários irá exibir informações dos funcionários cadastrados no Protheus e trazer as informações do Ponto. Com isso será possível identificar a quantidade de funcionários que utilizam o ponto eletrônico, funcionários com o ponto completo, incompleto e sem qualquer marcação realizada no período. As informações que serão exibidas são com base nas tabelas de marcações (SP8 e SPG) .

Neste grupo teremos no total 4 indicadores que são:

Total de funcionários: Informa a quantidade total de funcionários que utilizam o ponto eletrônico. Para que um funcionário seja contabilizado, ele deverá ter preenchido em seu cadastro o Turno, Regra de Apontamento e Sequencia inicial.

Funcionários com o ponto completo: Informa a quantidade de funcionários com o ponto completo no período selecionado. Por exemplo um funcionário precisa realizar a marcação do ponto 4 vezes ao dia (entrada jornada, saída para o almoço, volta do almoço e saída da jornada). Na semana o funcionário trabalha de segunda à sexta, então teremos 5 dias trabalhados, onde cada dia o funcionário precisa bater o ponto 4 vezes totalizando 20 marcações na semana. Se o funcionário possuir 20 ou mais marcações o sistema irá contabilizar como ponto completo

Funcionários com o ponto incompleto: Informa a quantidade de funcionários com o ponto incompleto no período selecionado. Por exemplo um funcionário precisa realizar a marcação do ponto 4 vezes ao dia (entrada jornada, saída para o almoço, volta do almoço e saída da jornada). Na semana o funcionário trabalha de segunda à sexta, então teremos 5 dias trabalhados, onde cada dia o funcionário precisa bater o ponto 4 vezes totalizando 20 marcações na semana. Se o funcionário possuir menos de 20 marcações o sistema irá contabilizar como ponto incompleto

Funcionários sem marcações: Informa a quantidade de funcionários que não possuem uma única marcação no período.

Totvs custom tabs box items
defaultno
referenciaclockin

O grupo Indicadores de Marcações do Clock In irá exibir informações referente a integração das marcações. O Dashboard fará uma consulta na Carol para verificar o total de marcações que existem e informar quais delas já foram integradas, quantas estão pendentes de integração e marcações sem NSR. Com isso será possível identificar se será necessário realizar a integração das marcações ou gerar a NSR no Clock In. As informações que serão exibidas são com base nas marcações existentes no Clock In e nas tabelas de integração (RR1 ou MSA_CONTROL_MARCAC).

Neste grupo teremos no total 4 indicadores que são:

Total de marcações no período: Informa a quantidade total marcações existentes no Clock In no período selecionado.

Marcações processadas: Informa a quantidade total de marcações que foram integradas, ou seja, as marcações que estão presentes na tabela RR1 ou MSA_CONTROL_MARCAC

Marcações existentes para integração: Informa a quantidade total de marcações que não foram integradas e já estão prontas para a integração, ou seja, as marcações que já foram geradas a NSR no Clock In e não estão presentes na tabela RR1 ou MSA_CONTROL_MARCAC

Marcações sem NSR: Informa a quantidade total de marcações que não possuem NSR gerada.

Aviso
titleAtenção

Os indicadores do Clock In irão apresentar algum número apenas se todos os parâmetros de integração estiverem preenchidos. Caso o Clock In não seja utilizado ou os parâmetros de integração não estiverem preenchidos os indicadores serão zerados.

Para informações de como preencher os parâmetro acesse a documentação abaixo:
Integração Protheus x Carol - Importação de Batidas

03. CONFIGURAÇÃO

3.1. PORTA MULTIPROTOCOLO

Para que seja possível utilizar o Dashboard será necessário habilitar a Porta Multiprotocolo. Ao acessar a rotina do Dashboard caso a porta não esteja habilitada será exibida uma mensagem informando que será necessário habilitar a Porta Multiprotocolo.

Para habilitar a porta será necessário alterar o arquivo appserver.ini, na sessão General deverá ser incluída a chave App_Environment e seu conteúdo deverá ser o nome do ambiente configurado.

Exemplo de configuração da Porta Multiprocolo:

Para verificar se a Porta Multiprotocolo está habilitada, ao acessar o Protheus, a tela de login deverá ser a mesma da imagem abaixo:

Informações
titleObservação

Para habilitar a Porta Multiprotocolo, o Application Server precisa ser a partir da versão 19.3.0.1.

Para mais informações de como realizar a configuração da Porta Multiprotocolo acesse o link abaixo:
Application Server - Porta Multiprotocolo

3.2. ENVIO DO E-MAIL
Âncora
3.2
3.2

No Dashboard temos a opção de tirar uma fotografia dos indicadores e enviar por e-mail, mas para que o e-mail seja enviado corretamente teremos que realizar algumas configurações como por exemplo a configuração do servidor de e-mail como endereço do servidor, usuário, senha e etc.

Para realizar as alterações necessárias siga os passos abaixo:

Acesso o módulo Configurador (SIGACFG) e acesse a rotina Configurar do e-mail.

Após isso preencha os campos conforme o servidor de e-mail que será utilizado.

Após a configuração do e-mail, teremos que preencher o conteúdo do parâmetro MV_GPEMAIL, este parâmetro será responsável por armazenar o destinatário do e-mail contendo as informações do Dashboard. 

MV_GPEMAIL
Preencher com o destinatário do e-mail, caso ele não seja preenchido o sistema irá utilizar o MV_RELAUSR. Caso o MV_GPEMAIL e o MV_RELAUSR não estiverem preenchidos o sistema não irá enviar o e-mail.

3.3. ENVIO DO E-MAIL SCHEDULER

Para a utilização do Scheduler para o envio do e-mail com as informações do Dashboard, teremos que utilizar 2 parâmetros e realizar a configuração mencionada no item 3.2, como o preenchimento do servidor de e-mail, usuário, senha e etc.

Após realizar todo os preenchimento utilizando o configurador, teremos que preencher o conteúdo do parâmetro MV_GPEMAIL e MV_PONREST.

MV_GPEMAIL
Preencher com o destinatário do e-mail, caso ele não seja preenchido o sistema irá utilizar o MV_RELAUSR. Caso o MV_GPEMAIL e o MV_RELAUSR não estiverem preenchidos o sistema não irá enviar o e-mail.

Exemplo:

MV_PONREST 

Preencher com o endereço do servidor Rest configurado no Protheus.

Informações
titleConfiguração E-mail

Para mais informações sobre a configuração do envio do e-mail, acesse os links abaixo:

MP - FRAME - Configurar o SMTP para envio de relatórios por e-mail
Application Server - Uso de e-mail com GMail

04. EXEMPLOS DE UTILIZAÇÃO

Totvs custom tabs box
tabsProtheus,Scheduler
idsprotheus,scheduler

Podemos utilizar o Dashboard de duas maneiras, a primeira dela será via interface, ou seja, é possível acessar o Dashboard pelo Protheus e segunda maneira é através do Scheduler. Ao configurar a rotina PONA480A no Scheduler, será enviado um e-mail contendo as informações do Dashboard, desta maneira não há a necessidade de ficar acessando o Protheus para verificar os indicadores.

Totvs custom tabs box items
defaultyes
referenciaprotheus

Para acessar o Dashboard certifique que o pacote da expedição contínua a partir da data 12/09/2022 está aplicado em seu ambiente, tanto o pacote de fontes como o pacote de dicionário de dados. Após isso basta acessar o módulo do ponto (SIGAPON) e acessar a rotina Dashboard (PONA480) em Relatórios → Mensal → Dashboard.

Inicialmente o sistema sempre irá carregar o filtros com conteúdos padrões, por exemplo da Data de Inicio será 2 dias anteriores a date de hoje, a Data de Término 1 dia anterior a data de hoje e as filias serão preenchida com o filtro Todos, ao invés de uma filial em específico. Para realizar a alteração do filtro basta alterar os campos do filtro (Data de Início, Data de Término e Selecione o Local) e posteriormente clicar em atualizar.

Cada vez que o filtro for atualizado clicando em Atualizar, a data e hora informados no campo superior direto em "Última atualização às" será atualizado, com isso poderemos ver em qual dia e hora o Dashboard foi atualizado.

Será possível realizar a alteração dos filtros informando a data inicial e final 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. Por exemplo ao preencher a Data de Inicio com 01/01/2022 automaticamente o calendário do campo Data de Término será bloqueado para dias superiores à 02/03/2022.

Caso a Data de Término seja digitada manualmente para o dia 03/03/2022, o campo ficará destacado em vermelho, sinalizando que o conteúdo é inválido e se mesmo assim foi clicado em atualizar o sistema irá exibir a seguinte mensagem:

Caso todos os filtros estejam corretos será possível realizar a atualização do Dashboard.



Informações
titleNovo Filtro Filial

A partir da atualização do pacote de fontes e pacote de dicionário da Expedição Contínua liberado em 22/05/2023 o campo Local foi alterado para que seja possível selecionar mais de uma filial no filtro e será possível ver o detalhamento de cada indicador, ou seja, será possível ver quais funcionários ou marcações foram contabilizadas em indicador.

Ao clicar no campo "Selecione o Local", será aberta um checklist possibilitando escolher mais de uma filial. Para facilitar na seleção de uma filial em específico é possível realizar a busca de filiais digitando pela filial.

Aviso
titleSeleção de Filiais

Regras de utlização do filtro de filiais:

1º - Se for selecionada apenas 1 filial, o Dashboard irá exibir apenas os grupos Funcionários e Marcações Clock In da filial selecionada.
2º - Se for selecionada todas as filiais, o Dashboard irá exibir apenas os grupos Funcionários e Marcações Clock In totalizando os números de todas as filiais.
3º - Se for selecionada 1 ou mais filiais, desde que não seja todas as filiais, o Dashboard irá exibir os grupos Funcionários e Marcações Clock In seprados por filial e um totalizador com o resultado de todas as filiais selecionadas.

Ao clicar em algum indicador, será aberta uma nova janela onde serão exibidos os funcionários ou marcações do indicador selecionado.

Indicadores de funcionários:

Para o indicador de funcionários com Pontos Incompletos, será possível verificar as inconsistências do ponto por funcionário, ou seja, teremos um detalhamento de quais dias, quais as marcações previstas e realizadas pelo funcionário que gerou a inconsistência. Para isso, basta acessar o indicador de Pontos Incompletos e posteriormente clicar em visulizar.


Indicadores de Marcações Clock In:

Após a atualização dos indicadores, é possível enviar um e-mail clicando no botão "Enviar E-mail". Se as configurações mencionadas no item 3.2 estiverem corretas, será enviado um e-mail para o destinatário definido no parâmetro MV_GPEMAIL.

Abaixo está um exemplo do e-mail enviado:


Para o envio do e-mail todos os indicadores deverão ter sido carregados, caso exista qualquer indicador sendo carregado o e-mail não será enviado.

Totvs custom tabs box items
defaultno
referenciascheduler

Para a utilização do Scheduler para o envio do e-mail do Dashboard, certifique que o pacote da expedição contínua a partir da data 12/09/2022 está aplicado em seu ambiente, tanto o pacote de fontes como o pacote de dicionário de dados.

Caso o ambiente esteja atualizado, teremos a rotina PONA480A, ela será responsável por realizar o envio do e-mail com as informações do Dashboard.

Aviso
titleImportante

A rotina PONA480A deverá ser executada apenas pelo Scheduler. Não será possível utiliza-la pelo menu do Protheus.

Preencha no Scheduler o campo rotina com PONA480A

Ao clicar em parâmetros será possível definir o filtro que será utilizado para trazer os indicadores do Dashboard.

Para a configuração existem 3 campos, que são:

1. Filial
2. Período (Mensal, Semanal, Quinzenal e Qtde Dias)
3. Quantidade de Dias


Informações
titleObservação

A partir da atualização do pacote de fontes e pacote de dicionário da Expedição Contínua liberado em 22/05/2023 o campo Filial foi alterado para que seja possível selecionar mais de uma filial.


1 - Filial

Filial que será utilizada para a realização do filtro do Dashboard.

Se o pacote de fontes e o pacote de dicionário estiver atualizado com a data de 22/05/2023 será possível selecionar várias filias e até mesmo definir um range das filais para a utilização do filtro.

Abaixo está um exemplo selecionando a filial D MG 01 e utilizando o range da M SP 01 à M SP 04.

2 - Período: 

1. Mensal
Para a data inicial será considerado o primeiro dia do mês atual e para a data final o dia de hoje. Por exemplo, hoje é dia 11/08/2022, então a data inicial será 01/08/2022 e a data final 11/08/2022.
2. Semanal
Para a data inicial será considerada a segunda-feira da semana atual e para a data final o dia de hoje. Por exemplo, hoje é dia 11/08/2022, a segunda-feira da semana atual é 08/08/2022, então a data inicial será 08/08/2022 e a data final 11/08/2022.
3. Quinzenal
Para a data inicial será considerado a quinzenal atual e para a data final o dia de hoje. Por exemplo, hoje é dia 11/08/2022, a data inicial será 01/08/2022 e a data final 11/08/2022. Caso a data de hoje seja superior ao dia 15, será utilizada a segunda quinzena do mês. Por exemplo, hoje é dia 25/08/2022, então a data inicial será 15/08/2022 e a data final 25/08/2022.
4. Qtde Dias
Para a data inicial será considerado a quantidade de dias preenchida no 3º parâmetro menos o dia de hoje e a data final será o dia de hoje. Por exemplo, no parâmetro Quantidade de Dias está preenchido com 5 e a data de hoje é 11/08/2022, então a data inicial será dia 06/08/2022 e a data final 11/08/2022

3 - Quantidade de dias

Quantidade de dias que será utilizada para subtrair com a data de hoje, para utilização da data inicial do filtro do Dashboard. Este parâmetro só deverá ser preenchido caso a Opção do período seja "Qtde Dias", caso contrário este parâmetro será ignorado.


Informações
titleObservação

Caso a quantidade de dias informado no terceiro campo Quantidade de dias for superior a 60, o sistema automaticamente irá utilizar 60, mesmo que o campo esteja preenchido com 70, por exemplo.

Após a configuração do Scheduler a rotina irá enviar o e-mail de acordo com a periodicidade definida e o parâmetros serão utilizados no filtro do Dashboard. Abaixo está um exemplo do e-mail enviado.


05. ANEXOS

  1. Configuração dos parâmetros de integração com o Clock In
    1. Integração Protheus x Carol - Importação de Batidas
  2. Configuração da Porta Multiprotocolo
    1. Application Server - Porta Multiprotocolo
  3. Configuração do E-mail
    1. MP - FRAME - Configurar o SMTP para envio de relatórios por e-mail
    2. Application Server - Uso de e-mail com GMail
  4. Configuração Security Habilitado

DRHGCH-21414 DT Função para Usuário e Senha para portal


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>