Árvore de páginas

Versões comparadas

Chave

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

...

  1. Objetivo
  2. Visão Geral
  3. Exemplo de Utilização
    1. Parametrização
    2. Schedule\Menu
  4. Tela de Cadastro de Schedule
  5. Tela de Cadastro de Menu
  6. Mensagens de Integração
  7. Tabelas utilizadas
  8. 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.

...

  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 05.
  4. 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.
  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 05, 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 inicio 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: 

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

lWorkInforma se a rotina está sendo executada via processo em segundo plano.NãoLógico.F.
dInicioData de inicio para buscar as marcações de pontoNãoDataSTOD("20000101")
dFinalData Final para buscar as marcações de pontoNãoDatadDatabase
cCoDispCódigo específico do dispositivo para buscar as marcações.NãoString

38b0dc89a20aaf49

nCodNSRCódigo do NSR a ser utilizado para buscar as marcações.NãoInteiro00

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
InformacaoDevido ao tamanho da string trafegada entre os sistemas, pode haver estouro de string caso os parâmetros citados a seguir não estejam configurados no appserver.ini, pare o Server e coloque a propriedade <b>TOPMemoMega=1</b> (<a href=https://tdn.totvs.com/display/tec/TOPMemoMega>"Veja Mais sobre TopMemoMega</a>) e a propriedade <b>MaxStringSize</b> ( <a href=https://tdn.totvs.com/pages/viewpage.action?pageId=161349793>Veja Mais Sobre MaxStringSize e o valor que deve colocar no parâmetro</a>)
TituloIMPORTANTE!

...

Tela de configuração do menu escolhido.

imagem 3

Imagem 4

...

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>