Histórico da Página

...

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 Marcações do Clock In.

2.1. INDICADORES DE FUNCIONÁRIOS

Neste grupo de indicadores, teremos os 4 primeiros indicadores mencionados anteriormente.

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.

...

...

...

2.2. INDICADORES DE MARCAÇÕES DO CLOCK IN

Neste grupo de indicadores, teremos os 4 últimos indicadores mencionados anteriormente.

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 sem NSR: Informa a quantidade total de marcações que não possuem NSR gerada.

04. EXEMPLO DE UTILIZAÇÃO

O cliente utiliza a Carol para as marcações de ponto dentro da empresa, esta empresa possui diversos dispositivos espalhados pela organização.

O Protheus será o responsável por acionar a plataforma Carol, buscar as informações contidas em cada dispositivo e armazenar os registros dentro do módulo SIGAPON. Nos próximos tópicos, os passos serão detalhados:

4.1. PARAMETRIZAÇÃO

Para que haja a devida integração entre os dois sistemas, se faz necessário preencher os parâmetros abaixo:

...

https://domínioCliente.carol.ai

...

4.2. CADASTRO DO RELÓGIO CAROL

Para cadastro do relógio, basta acessar no SIGAPON/CADASTRO DO PONTO/RELÓGIOS e preencher os dados da aba geral com atenção especial para os campos:

1. Controle (P0_CONTROL) = "P"  //Relógio de Ponto
2. Tipo Arquivo (P0_TIPOARQ) = "R" //Integração com Carol ou TSA
3. Rep (P0_REP) = "" //Se o relógio for da Carol este campo não deve ser preenchido

Image Removed

4.3. SCHEDULE\MENU

A rotina desenvolvida para a realização de todo o fluxo de requisição para a Carol foi nomeada de PONAPI01, esta rotina não estará disponibilizada em Menu ou pré-carregada no Schedule.

O Processo de Cadastramento será o mesmo utilizado por outras rotinas:

4.3.1. PREENCHIMENTO DO SCHEDULE

1. Acessar o módulo SIGACFG - Configurador;
2. Acessar o caminho do menu AMBIENTE/SCHEDULE/SCHEDULE;
3. Clicar na opção Cadastro no calendário de agendamentos, conforme imagem1 da tela no Tópico 06;
4. O preenchimento é simples e intuitivo para o preenchimento correto do schedule (leia o item 5 abaixo, antes de confirmar o cadastro);
5. Clique o ícone cinza ao lado do botão de confirmar, pois lá se encontra as informações de periodicidade de acionamento da rotina cadastrada (Imagem 2 do Tópico 06);
6. Após a confirmação do cadastramento, será necessário habilitar os agents (Imagem 3 do Tópico 06 ), onde você pode cadastrar manualmente ou pressionar o ícone de radar verde no canto superior direito e os agents serão incluídos automaticamente;
7. Com os agents devidamente cadastrados, o usuário deve pressionar o ícone de pasta do lado esquerdo e ligar Task Manager e Queue Manager (São os gerenciadores da fila de acionamento dos agents) (Imagem 4 do Tópico 06 ).

Image Removed

4.3.2. PREENCHIMENTO DO CADASTRO DA ROTINA NO MENU

1. Acessar o módulo SIGACFG - Configurador;
2. Acessar o caminho do menu AMBIENTE/CADASTROS/MENU;
3. Selecione o módulo\Menu que deseja realizar a inclusão da rotina, conforme imagem 1 do Tópico 06;
4. Quando clicar em "OK" será aberta uma tela semelhante a imagem 2 do Tópico 06 e você deverá pressionar o primeiro botão central "Adicionar>>" e o menu inteiro será transferido para o lado direito da tela;
5. Clique na pasta azul que desejar incluir o item da rotina e pressione o botão Novo Item conforme imagem 3 do Tópico 06, desta forma será exibida uma nova tela para inclusão da rotina conforme imagem 4;
6. Preencha o nome que deseja que apareça no menu e digite o nome da rotina citada no início deste documento PONAPI01, conforme imagem 4;
7. Confirme o cadastro e clique no botão central de Gerar;
8. O Sistema exibirá uma mensagem solicitando o nome do xnu que será gerado, sugerimos manter o mesmo nome do xnu padrão ex.

05. CONFIGURAÇÃO SSL

Para realizar requisições para a Carol, será necessária a configuração do SSL no Appserver. Atualmente a Carol utiliza a versão SSL 1.3 e por este motivo é necessária a configuração do SSL por parte do Protheus. Segue abaixo um exemplo da configuração:

Image Removed

Para mais informações de como realizar a configuração do SSL no AppServer, no final da desta documentação, em anexos, estará disponível o link do passo a passo de como realizar a configuração.

...

06. TELA DE CADASTRO DE SCHEDULE  

Cadastro de Rotina

Image Removed

Preenchimento da periodicidade dos acionamentos:

Image Removed

Interface de Agents.

Image Removed

Gerenciamento da fila e execução dos agents.

Image Removed

07. TELA DE CADASTRO DE MENU

Tela de listagem de menus

Image Removed

Tela de configuração do menu escolhido

Image Removed

Image Removed

Image Removed

08. MENSAGENS DE INTEGRAÇÃO

Para possibilitar o acompanhamento  da integração do Protheus com a Carol, será apresentado algumas mensagens em tela caso o acionamento seja manual pelo menu ou no console.log, quando a rotina for acionada via Schedule.

• Caso o código NSR enviado por parâmetro e o mesmo seja abaixo de zero:
  • Verifique o Código NSR Informado, pois o mesmo somente aceita números positivos!
• Inconsistências nas datas:
  • Verifique as Datas informadas para acesso ao Clock In da Carol.
• Será apresentada a seguinte mensagem e a mensagem retornada da plataforma Carol.
  • Não foi possível acessar a API Clockin da Carol.
• Problemas com o preenchimento dos parâmetros:
  • Verifique o parâmetro MV_APICLO1 pois ele é responsável pelo cadastro da URL de EndPoint para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO2 pois ele é responsável pelo cadastro do path da API Token para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO3 pois ele é responsável pelo cadastro do Id Conector para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO4 pois ele é responsável pelo cadastro do User Name para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO5 pois ele é responsável pelo cadastro do Password para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO6 pois ele é responsável pelo cadastro do Domain Name para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO7 pois ele é responsável pelo cadastro do path da API DeviceList para a integração de Clock In da Carol.
  • Verifique o parâmetro MV_APICLO8 pois ele é responsável pelo cadastro do path da API clockinrecordsList para a integração de Clock In da Carol.
  • Não foi possível acessar a API Clock In da Carol. Verifique os parametros MV_APICLO0, MV_APICLO1, MV_APICLO2, MV_APICLO3, MV_APICLO4, MV_APICLO5, MV_APICLO6,MV_APICLO7, MV_APICLO8 com as informações fornecidas.
  • Não foi possível acessar a API Clock In da Carol. Verifique os parametros MV_APICLO0, MV_APICLO1, MV_APICLO2, MV_APICLO3, MV_APICLO4, MV_APICLO5, MV_APICLO6,MV_APICLO7, MV_APICLO8, MV_APICLO9 com as informações fornecidas.
  • Não foi possível acessar a API Clock In da Carol. Verifique o parametro MV_APICLO8 pois ele é responsável pelo cadastro do path da api clockinrecordsList para a integração de Clockin da Carol.
  • O parâmetro MV_APICLO9 está vazio ou não foi criado e a Carol possui uma organização configurada. Por favor crie e preencha o MV_APICLO9 com o Nome da Organização.

09. TABELAS UTILIZADAS 

• SP0 -  Pré-Leitura\Relógio de Ponto;  
• RFE -  Relógio de Ponto;  
• SP8 - Movimento de Marcações;  
• MSA_CONTROL_MARCAC - Tabela criada na primeira carga de dados com a Carol para armazenar as marcações integradas, caso o dicionário de dados não possua a RR1. Esta tabela também é utilizada no modelo de integração com o TSA e Suricato, a partir deste momento, será processado pelo sistema onde serão gerados os registros na RFE e SP8.
• RR1 - Nova tabela padrão criada para controle total pelo Protheus para o armazenamento das marcações integradas, esta tabela substitui a MSA_CONTROL_MARCAC. Quando identificado que o cliente possui a tabela MSA, é feito uma cópia de dados da MSA para a RR1 e excluída a tabela antiga MSA. A partir deste momento, será processado pelo sistema onde serão gerados os registros na RFE e SP8.

10. ROTINAS ENVOLVIDAS

• GPEA010: Cadastro de Funcionários;
• PONA030: Cadastro de Relógios;
• PONM010: Leitura e Apontamento.

11. ANEXOS

...

1. https://tdn.totvs.com/x/kum2Hg

...

1. https://tdn.totvs.com/x/34W2Hg

...

1. https://tdn.totvs.com/x/frC2Hg

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.

Image Added

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:

Image Added

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

Image Added

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.

Image Added

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

Image Added

Image Added

Image Added

Image Added

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.

Image Added

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:

Image Added

MV_PONREST 

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

Image Added

04. EXEMPLOS DE UTILIZAÇÃO

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

...

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

...