Histórico da Página

...

Aviso

title	Observação

A melhoria depende da aplicação da atualização liberada no pacote de expedição do módulo RH a partir de XXXX/XXXX/2022 e da execução do UPDDISTR com o dicionário diferencial para os releases iguais ou superiores a versão 12.1.27.

Foi efetuado a criação da tabela REF, conforme estrutura abaixo:

X2_CHAVE	X2_NOME	X2_MODO	X2_MODOUN	X2_MODOEMP
REF	Lote de integração P&M	C	C	C

Nota

title	Observação

O modo de acesso da tabela REF deve ser obrigatoriamente compartilhado.

Foi efetuado a criação dos índices na tabela REF, conforme estrutura abaixo:

INDICE	ORDEM	CHAVE	SHOWPES
REF	1	REF_FILIAL+REF_TIPO+REF_STATUS+DTOS(REF_DATINT)+REF_HORINT	S
REF	2	REF_FILIAL+REF_PRCID	S

Foi efetuado a criação de campos na tabela REF, conforme estrutura abaixo:

X3_ARQUIVO	X3_ORDEM	X3_CAMPO	X3_TIPO	X3_TAMANHO	X3_TITULO	X3_DESCRIC	HELP
REF	01	REF_FILIAL	C	2	Filial	Filial	Filial do lote
REF	02	REF_PRCID	C	100	Process ID	Process ID	Process ID do lote retornado pelo P&M
REF	03	REF_TIPO	C	1	Tipo API	Tipo API	Tipo da API
REF	04	REF_DATINT	D	8	Data Integr.	Data Integr.	Data da integração
REF	05	REF_HORINT	C	8	Hora Integr.	Hora Integr.	Hora da integração
REF	06	REF_STATUS	C	1	Status	Status Integração	Status da integração
REF	07	REF_LOTE	M	10	Lote	Lote Integração	JSON do lote integrado
REF	08	REF_RETORN	M	10	Retorno	Retorno P&M	Retorno do lote pelo P&M
REF	09	REF_USER	C	6	Usuário	Usuário	Usuário responsável pela geração do lote

Foi efetuado a criação de parâmetros, conforme estrutura abaixo:

X6_VAR	X6_TIPO	X6_DESCRIC	X6_DESC1	Exemplo de preenchimento
MV_APIPEM0	C	URL para geração do token de acesso do ambiente	de integração com o Performance & Metas	https://{TENANT}.rac.{ENVIRONMENT}.totvs.app/totvs.rac/connect/token Exemplo: https://admin.rac.totvs.app/totvs.rac/connect/token
MV_APIPEM1	C	URL base do ambiente de integração com o	Performance & Metas	https://{NOME_EMPRESA}.performance.totvs.app/integration-general/ Exemplo: https://empresateste.performance.dev.totvs.app/integration-general/
MV_APIPEM2	C	ClientId do ambiente de integração com o	Performance & Metas
MV_APIPEM3	C	SecretId do ambiente de integração com o	Performance & Metas
MV_APIPEM4	N	Tipo de verificação de registro ativo na	integração com o Performance & Metas
MV_APIPEM5	D	Data de corte da integração com o	Performance & Metas
MV_APIPEM6	N	Define se espera ou não o retorno da integração	com o Performance & Metas

Nota

title	Observação

Os parâmetros MV_APIPEM4, MV_APIPEM5 e MV_APIPEM5 APIPEM6 não precisam ser configurados através do módulo SIGACFG porque serão exibidos na rotina GPEM939 para que o usuário possa alterá-los conforme necessidade.

Os parâmetros MV_APIPEM0 e MV_APIPEM1 precisam seguir o formato de exemplo.

...

Deck of Cards

startHidden	false
id	WIZARD

Card

default	true
id	wizard1
label	1-Observações
title	Observações

Essa tela exibe um breve descritivo da rotina e contém um botão que direciona para esta documentação do TDN.

Card

id	wizard2
label	2-Configuração
title	Configuração

Essa tela exibe duas três perguntas para configuração da integração:

"Verificação registro ativo": essa opção tem o intuito de definir como o sistema efetuará a validação se determinado registro está ativo, uma vez que apenas registros ativos serão enviados ao P&M (Performance & Metas). Ao selecionar a opção "Somente pelo campo campo MSBLQL (se houver), caso o campo MSLBL exista na tabela, será considerado apenas os registros ativos (MSBLQL diferente de 1); se for selecionado a opção "Campo MSBLQL (se houver) + vínculo com registro ativo da SRA", além da verificação do campo MSBLQL diferente de 1, para um registro ser considerado como ativo terá que ter vínculo com registros ativos da tabela SRA, ou seja, funcionários ativos ou que foram demitidos a partir de determinada data de corte (a data é configurada na pergunta abaixo);
"Data de corte demissão": define a data de corte de demissão para que um funcionário seja considerado ativo ou não, ou seja, funcionário demitidos a partir da data configurada serão considerados ativos, enquanto que funcionários demitidos antes da data não serão considerados como ativos.

Image Removed

"": define se irá aguardar o retorno do processamento da integração pelo P&M (Performance & Metas).

Nota

title	Observação técnica

A verificação do registro ativo da opção "Campo MSBLQL (se houver) + vínculo com registro ativo da SRA" é diferente para cada opção de integração:

Filiais:
Grupos de cargo: um grupo será considerado como ativo se houver cargos com vínculo ao grupo (verificação do campo Q3_GRUPO) e cujo cargo esteja vinculado a pelo menus um funcionário ativo conforme regra explicada acima (verificação dos campos RA_CARGO, RA_SITFOLH e RA_DEMISSA);
Cargos:
Departamentos:
Funcionários:

Ao definir que irá aguardar o retorno do processamento da integração pelo P&M (Performance & Metas), a rotina irá consumir uma API do P&M (Performance & Metas) para verificar o status do processamento do lote, e assim que processado, irá exibir o status de integração no log.

Observe que na possibilidade do P&M (Performance & Metas) demorar para processar a integração, a rotina irá ficar "presa" até que toda a integração enviada seja processada pelo P&M.

Card

id	wizard3
label	3-Opções
title	Opções

Essa tela exibe a lista de opções existentes para integração com o Performance & Metas do tipo checkbox e deve ser selecionado as opções que serão integradas.

Atualmente, há as seguintes opções para integração:

Filiais;
Grupos de cargo;
Cargos;
Departamentos;
Funcionários.

Card

id	wizard4
label	4-Filtro
title	Filtro

Essa tela exibe botões para a definição de filtros para a integração, separados pelos registros que podem ser integrados, ou seja, há um botão de filtro para filiais, outro botão para grupos de cargo, etc..

O botão de filtro de filiais sempre será exibido, independente se a opção de integração de filiais esteja ou não selecionada, pois o filtro de filial será utilizado para a integração de todas as opções. Já os outros botões serão desativados para clique caso a respectiva opção de integração não esteja selecionada.

No filtro de filial, será exibido uma MarkBrowse para seleção de filiais, enquanto que nos demais filtros será possível definir um filtro sobre qualquer campo da respectiva tabela, conforme necessidade.

Card

id	wizard5
label	5-Processamento
title	Processamento

Essa tela exibe um descritivo e um botão, que ao ser clicado iniciará a integração com o Performance & Metas.

...

Nota

title	Observação técnica

A integração com o P&M (Performance & Metas) é do tipo assíncrona, ou seja, será efetuado integração dos registros em lotes, mas o processamento da validação e gravação pelo P&M será realizado em momento posterior. Dessa forma, a rotina GPEM939 será finalizado antes do processamento das informações pelo P&M.

Após a geração e envio de um lote de registros para o P&M, será retorno um ID do processamento pelo P&M, e esse ID será salvo na tabela REF conforme exemplo abaixo:

Campo	Conteúdo
REF_FILIAL	Sempre em branco
REF_PRCID	Process ID do lote retornado pelo P&M
REF_TIPO	Tipo da API: 1=Filiais 2=Grupos de cargo 3=Cargos 4=Departamentos 5=Funcionários
REF_DATINT	Data da integração
REF_HORINT	Hora da integração
REF_STATUS	Status da integração: 0=Não iniciado 1=Executando 2=Concluído 3=Houve erro de validação
REF_LOTE	JSON do lote
REF_RETORN	Retorno do processamento realizado pelo P&M
REF_USER	Código do usuário responsável pela integração

A informação do ID será utilizada posteriormente para consultar o status de processamento do lote pelo P&M.

Atente-se que o sistema Protheus não fará controle se determinado registro foi ou não integrado com sucesso ao P&M. Havendo necessidade de reenvio de informações para o P&M, será efetuado envio dos registros de acordo com os filtros criados pelo usuário na rotina de integração, podendo ser reenviado sendo possível reenviar todos os registros novamente ou apenas um ou alguns registros em específico.

04. DEMAIS INFORMAÇÕES

...

Árvore de páginas

Versões comparadas

Versão antiga 9

Nova versão 10

Chave

04. DEMAIS INFORMAÇÕES