Histórico da Página
...
- Objetivo
- Visão Geral
- Exemplo de Utilização
- Parametrização
- Schedule\Menu
- Tela de Cadastro de Schedule
- Tela de Cadastro de Menu
- Mensagens de Integração
- Tabelas utilizadas
- Rotinas envolvidas
01. OBJETIVO
Apresentar ao usuário final que faça uso da plataforma da Carol para marcações de ponto de seus colaboradores, como configurar o Protheus para habilitar a integração automática de marcações.
...
- Acessar o módulo SIGACFG - Configurador.
- Acessar o caminho do menu AMBIENTE/CADASTROS/MENU.
- Selecione o módulo\Menu que deseja realizar a inclusão da rotina, conforme imagem 1 do Tópico 05.
- Quando clicar em "OK" será aberta uma tela semelhante a imagem 2 do Tópico 05 e você deverá pressionar o primeiro botão central "Adicionar>>" e o menu inteiro será transferido para o lado direito da tela.
- Clique na pasta azul que desejar incluir o item da rotina e pressione o botão Novo Item conforme imagem 3 do Tópico 05, desta forma será exibida uma nova tela para inclusão da rotina conforme imagem 4.
- Preencha o nome que deseja que apareça no menu e digite o nome da rotina citada no inicio deste documento PONAPI01, conforme imagem 4.
- Confirme o cadastro e clique no botão central de Gerar.
- O Sistema exibirá uma mensagem solicitando o nome do xnu que será gerado, sugerimos manter o mesmo nome do xnu padrão ex:
b. Detalhes do PONAPI01
Desenvolvido o processo conforme estudo realizado. Este processo buscará todas as marcações de todos os períodos de todos os dispositivos conforme os parâmetros existentes, sendo eles:
Parâmetro | Observação | Obrigatório | Tipo | Exemplo |
---|---|---|---|---|
lWork | Informa se a rotina está sendo executada via processo em segundo plano. | Não | Lógico | .F. |
dInicio | Data de inicio para buscar as marcações de ponto | Não | Data | STOD("20000101") |
dFinal | Data Final para buscar as marcações de ponto | Não | Data | dDatabase |
cCoDisp | Código específico do dispositivo para buscar as marcações. | Não | String | 38b0dc89a20aaf49 |
nCodNSR | Código do NSR a ser utilizado para buscar as marcações. | Não | Inteiro | 00 |
Obs.: O parâmetro nCodNSR somente deverá ser utilizado quando for necessário realizar buscar uma marcação especifica, pois o Protheus já busca todas as marcações atuais.
Card documentos | ||||
---|---|---|---|---|
|
...
Tela de configuração do menu escolhido.
...
06. 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 Clockin da Carol.
- Será apresentado 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 parametro MV_APICLO1 pois ele é responsável pelo cadastro da URL de EndPoint para a integração de Clockin da Carol.
- Verifique o parametro MV_APICLO2 pois ele é responsável pelo cadastro do path da api Token para a integração de Clockin da Carol.
- Verifique o parametro MV_APICLO3 pois ele é responsável pelo cadastro do Id Conector para a integração de Clockin da Carol.
- Verifique o parametro MV_APICLO4 pois ele é responsável pelo cadastro do User Name para a integração de Clockin da Carol.
- Verifique o parametro MV_APICLO5 pois ele é responsável pelo cadastro do Password para a integração de Clockin da Carol.
- Verifique o parametro MV_APICLO6 pois ele é responsável pelo cadastro do Domain Name para a integração de Clockin da Carol.
- Verifique o parametro MV_APICLO7 pois ele é responsável pelo cadastro do path da api DeviceList para a integração de Clockin 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.
- Não foi possível acessar a API Clockin 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 Clockin 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.
07. TABELAS UTILIZADAS
- SP0 - Pré-Leitura\Relógio de Ponto
- RFE - Relógio de Ponto
- SP8 - Movimento de Marcações
08. Rotinas Envolvidas
- GPEA010 : Cadastro de Funcionários
- PONA030 : Cadastro de Relógios
- PONM010: Leitura e Apontamento
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> |