DRHPAG-42711 DT Integração Carol (Clock In) - Criação do parâmetro MV_APICLOB e contorno da limitação de retorno de 5.000 registros da API clockinrecordsList

01. DADOS GERAIS

Produto:	TOTVS RH
Linha de Produto:	Linha Protheus
Segmento:	RH
Módulo:	PONTO ELETRÔNICO (SIGAPON)
Função:	CLOCK IN(CLOCKIN)
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :	DRHPAG-42492 DRHPAG-42711
Pacote:	12.1.17:https://r.totvs.io/p/1003523 ; 12.1.23:https://r.totvs.io/p/1003524 ; 12.1.25:https://r.totvs.io/p/1003525 ; 12.1.27:https://r.totvs.io/p/1003526 ;

02. SITUAÇÃO/REQUISITO

A integração do SIGAPON com a API da Carol (Clock In) não efetua a gravação de alguns NSR na tabela MSA_CONTROL_MARCAC, além da API clockinrecordsList da Carol limitar o retorno a 5.000 registros.

03. SOLUÇÃO

Criado possibilidade na integração do SIGAPON com a API da Carol (Clock In) que retorna as marcações para que, caso o parâmetro MV_APICLOB esteja ativo, o sistema verifique na tabela MSA se há uma lacuna na numeração dos NSR e assim efetuar a leitura a partir desse número; no padrão, ou seja, com o parâmetro MV_APICLOB desativado, o sistema solicita à Carol que seja retornado a partir do último NSR gravado. Além disso, para contornar a limitação da API clockinrecordsList da Carol que limita o retorno a 5.000 registros, caso seja identificado que o dispositivo possui mais do que 5.000 registros, será efetuado a execução da API clockinrecordsList por várias vezes, até que seja retornado todos os registros.

Por exemplo, imaginemos que na tabela MSA_CONTROL_MARCAC há os registros abaixo:

Dispositivo	NSR
1	1
1	2
1	3
1	4
1	5
1	6
1	8
1	9
1	10

Observe que o NSR 7 não foi gravado. O SIGAPON irá solicitar o retorno a partir de determinado NSR, de acordo com a configuração do parâmetro MV_APICLOB:

Conteúdo	Leitura será realizada a partir de qual NSR?
.F.	11
.T.	7

Observação

O parâmetro MV_APICLOB deve ser criado manualmente, através do módulo SIGACFG - Configurador.

Estrutura do parâmetro:

Campo	Conteúdo
X6_VAR	MV_APICLOB
X6_TIPO	L
X6_DESCRI	Define se na integração com Carol Clock In será efetuada pesquisa por lacuna na numeração do NSR (.T.) ou se será efetuado pesquisa a partir do último NSR gravado (.F.)
X6_CONTEUD	.F. (falso, conteúdo padrão)

Observação: o parâmetro ativo deixará a leitura mais lenta, pois efetuará a leitura a partir da primeira lacuna de NSR existente na tabela MSA.

Somente deve ser utilizado dessa forma caso seja identificado que algum NSR não tenha sido importado. Após a importação do mesmo, o parâmetro deve ser desativado, para que a integração funcione no conceito padrão, que é buscar a partir do último NSR gravado (para evitar reprocessamento dos NSR).

04. DEMAIS INFORMAÇÕES

Não se aplica

05. ASSUNTOS RELACIONADOS