Histórico da Página
ÍNDICE
- Objetivo
- Visão Geral
- Exemplo de Utilização
- Exemplo de utilização
- Tela de SCHEDULE
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- Tabelas utilizadas
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.
02. VISÃO GERAL
A configuração da integração entre a Carol e Protheus se baseia na configuração de um Schedule que será executada em intervalos previamente configuradas, acionando assim as API's da Carol abaixo:
- https://domínioCliente.carol.ai/api/v2/oauth2/token (API de Autenticação e geradora de Token, onde será realizado os demais acessos\requisições)
- https://domínioCliente.carol.ai/api/v2/queries/named/deviceList (API de Requisição de listagem de dispositivos de ponto cadastrados na Carol)
- https://domínioCliente.carol.ai/api/v2/queries/named/clockinrecordsList(Api de requisição de listagem de marcações por dispositivos na Carol)
03. 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 e buscar as informações contidas em cada dispositivo e gerar os registros dentro do módulo SIGAPON, nos próximos tópicos detalharemos melhor os passos a seguir.
03.1 Parametrização
Para que haja a devida integração entre os dois sistemas, se faz necessário preencher os parâmetros abaixo:
Parâmetro | Descrição do Parâmetro | Exemplo de utilização |
---|---|---|
MV_APICLO1 | CLockin da Carol - Endereço de Acesso ao EndPoint | |
MV_APICLO2 | Clockin da Carol - Patch de Acesso ao EndPoint. | /api/token |
MV_APICLO3 | Clockin da Carol - ID de Conexão de Acesso. | 0a0829171432c9bb26460c31b78f1 |
MV_APICLO4 | Clockin da Carol - Username de Acesso ao EndPoint. | username@totvs.com.br |
MV_APICLO5 | Clockin da Carol - Password de Acesso ao EndPoint. | senha1 |
MV_APICLO6 | Clockin da Carol - Domain Name de Acesso EndPoint. | dominio |
MV_APICLO7 | Path do EndPoint DeviceList -ClockIn Carol. | /api/token |
MV_APICLO8 | Path EndPoint clockinrecordsList - Clockin Carol. | /api/token |
Informações | ||
---|---|---|
| ||
A criação destes parâmetros estará disponível apenas na 12.1.27 e caso o cliente possua a plataforma Carol e versão inferior a citada e deseja integrar com o módulo SIGAPON no Protheus, deverá criar manualmente os parâmetros. |
Após preencher a parametrização correta nos parâmetros citados acima, se faz necessário realizar o cadastro de Schedule ou no cadastro de menus do Protheus dentro do módulo SIGACFG.
03.2 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:
Preenchimento do Schedule.
- Acessar o módulo SIGACFG
- Acessar o caminho do menu AMBIENTE/SCHEDULE/SCHEDULE
- Clicar na opção Cadastro no calendário de agendamentos, conforme imagem da tela no item 04.
04. TELA DE SCHEDULE
Outras Ações / Ações relacionadas
Ação | Descrição |
---|---|
04. TELA XXXXX
Principais Campos e Parâmetros
Campo | Descrição |
---|---|
Card documentos | ||||
---|---|---|---|---|
|
05. TABELAS UTILIZADAS
ÂncoraSchedule Schedule
Schedule | |
Schedule |
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> |