Histórico da Página

01. DADOS GERAIS

Produto:

Solucoes_totvs_cross

SolucaoCross	TOTVS RH

Linha de Produto:

Linhas_totvs

Segmento	Distribuição
Region	Construção Projetos
Linha	Linha Protheus

Segmento:

Segmentos_totvs

Segmento	RH

Módulo:

SIGAGPE

Função:

GPEA430

GPEA944A

GPEA944B

GPEA944C

GPEM939

GPEM939A

GPEM939B

GPEM939C

GPTABBRA

Ticket:

Requisito/Story/Issue (informe o requisito relacionado) :

DRHCALCPRT-3734

DRHCALCPRT-4009

DRHCALCPRT-4164

DRHCALCPRT-3736

DRHCALCPRT-3733

DRHCALCPRT-3735

DRHCALCPRT-3737

DRHCALCPRT-4380

DRHCALCPRT-4375

DRHCALCPRT-4452

DRHCALCPRT-4374

DRHCALCPRT-4504

02. SITUAÇÃO/REQUISITO

Criar uma rotina que fará a integração dos cadastros do Protheus com o P&M (Performance & Metas)

...

.

Criar uma rotina que possibilite consultar as informações dos lotes de integrações com o P&M (Performance & Metas).

03. SOLUÇÃO

Aviso

icon	false
title	Observação

A funcionalidade abaixo está em desenvolvimento.

Foi efetuado a criação da rotina GPEM939 para efetuar a integração com o P&M (Performance & Metas) dos itens abaixo:

- Filiais (tabela SM0);

...

- Filiais (tabela SM0);
- Grupos de cargo (tabela SQ0);
- Cargos (tabela SQ3);
- Departamentos (tabela SQB);
- Funcionários Grupos de contrato (tabela SRAgenérica 1C ).

Criar uma rotina que possibilite consultar as informações dos lotes de integrações com o P&M (Performance & Metas).

...

- ;
- Funcionários (tabela SRA).

Foi efetuado a criação da rotina

...

GPEM939B para

...

permitir a visualização das informações dos lotes de integração com o P&M (Performance & Metas)

...

, bem como consultar manualmente o status de integração. Também foi disponibilizada a rotina GPEM939C para ser possível agendar no Schedule a consulta automática dos lotes de integração.

Aviso

...

- Filiais (tabela SM0);
- Grupos de cargo (tabela SQ0);
- Cargos (tabela SQ3);
- Departamentos (tabela SQB);
- Funcionários (tabela SRA).

Foi efetuado a criação da rotina GPEM939B para permitir a visualização das informações dos lotes de integração com o P&M (Performance & Metas), bem como consultar manualmente o status de integração. Também foi disponibilizada a rotina GPEM939C para ser possível agendar no Schedule a consulta automática dos lotes de integração.

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 30/05/2022 de [EM CONSTRUÇÃO, SEM DATA] 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 REFde índices no dicionário SIX, conforme estrutura abaixo:

INDICE	ORDEM

X2_CHAVE

X2_NOME

X2_MODO

X2_MODOUN

X2_MODOEMP

REF

Lote de integração P&M

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:

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

INDICEORDEMCHAVESHOWPESREF1REF_FILIAL+REF_TIPO+REF_STATUS

+DTOS(REF_DATINT)+REF_HORINT

S

REF

REN

2

1

REF

REN_FILIAL+

REF_PRCID

REN_TIPO+REN_CODIGO	S
RET	1	RET_FILIAL+RET_TIPO+RET_CODIGO	S
RET	2	RET_FILIAL+RET_TIPO+RET_FILCAD+RET_CODCAD

NREF3REF_FILIAL+DTOS(REF_DATINT)+REF_HORINT

S

Foi efetuado a criação de campos na tabela REFtabelas no dicionário SX2, conforme estrutura abaixo:

X3

X2_

ARQUIVO

CHAVE

X3

X2_

ORDEM

NOME

X3

X2_

CAMPO

MODO

X3

X2_

TIPO

MODOUN

X3

X2_

TAMANHO

MODOEMP

X3_DECIMALX3_TITULOX3_DESCRICHELPREF01REF_FILIALC20FilialFilial

Filial do lote

REF02REF_PRCIDC1000Process IDProcess ID

Process ID do lote retornado pelo P&M

REF03REF_TIPOC10Tipo APITipo API

Tipo da API

REF04REF_DATINTD80Data Integr.Data Integr.

Data da integração

REF05REF_HORINTC80Hora Integr.Hora Integr.

Hora da integração

REF06REF_STATUSC10StatusStatus Integração

Status da integração

REF07REF_LOTEM100LoteLote Integração

JSON do lote integrado

REF08REF_RETORNM100RetornoRetorno P&M

Retorno do lote pelo P&M

REF09REF_USERC60UsuárioUsuário

Usuário responsável pela geração do lote

REF10REF_OKC20Selecionado?Selecionado?

Evento selecionado para consulta?

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

X6_VARX6_TIPOX6_DESCRICX6_DESC1Exemplo de preenchimentoObservaçãoMV_APIPEM0CURL para geração do token de acesso do ambientede 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_APIPEM1CURL base do ambiente de integração com oPerformance & Metas

https://{NOME_EMPRESA}.performance.totvs.app/integration-general/

Exemplo: https://empresateste.performance.dev.totvs.app/integration-general/

MV_APIPEM2CClientId do ambiente de integração com oPerformance & MetasMV_APIPEM3CSecretId do ambiente de integração com oPerformance & MetasMV_APIPEM4NTipo de verificação de registro ativo naintegração com o Performance & MetasNão precisa ser configurada no módulo SIGACFG.
Será exibida para o usuário na rotina de integração.MV_APIPEM5DData de corte da integração com oPerformance & MetasNão precisa ser configurada no módulo SIGACFG.
Será exibida para o usuário na rotina de integração.MV_APIPEM6NDefine se espera ou não o retorno da integraçãocom o Performance & MetasNão precisa ser configurada no módulo SIGACFG.
Será exibida para o usuário na rotina de integração.MV_APIPEM7NDefine o tempo máximo em minutos de espera paraobter o retorno do Performance & MetasNão precisa ser configurada no módulo SIGACFG.
Será exibida para o usuário na rotina de integração.

Nota

title	Observação

Os parâmetros MV_APIPEM0 e MV_APIPEM1 precisam ser configurados conforme o formato de exemplo da tabela acima.

REF	Lote de integração P&M	C	C	C
REN	Cadastros P&M	C	C	C
RET	Vínculos Cadastros P&M	C	C	C

Nota

title	Observação

O modo de acesso das tabelas REF, REN e RET devem ser obrigatoriamente compartilhado.

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
REF	10	REF_OK	C	2	Selecionado?	Selecionado?	Evento selecionado para consulta?
REN	01	REN_FILIAL	C	2	Filial	Filial	Filial do registro
REN	02	REN_TIPO	C	1	Tipo	Tipo	Tipo do cadastro para o P&M
REN	03	REN_CODIGO	C	20	Código	Código	Código do cadastro no P&M
REN	04	REN_DESC	C	100	Descrição	Descrição	Descrição do cadastro no P&M
RET	01	RET_FILIAL	C	2	Filial	Filial	Filial do registro
RET	02	RET_TIPO	C	1	Tipo	Tipo	Tipo do cadastro para o P&M
RET	03	RET_CODIGO	C	20	Código	Código	Código do cadastro no P&M
RET	04	RET_FILCAD	C	2	Fil. Cad	Filial Cadastro	Filial do cadastro
RET	05	RET_CODCAD	C	20	Cód. Cadast.	Código Cadastro	Código do cadastro

Foi efetuado a criação de parâmetros no dicionário SX6, conforme estrutura abaixo:

X6_VAR	X6_TIPO	X6_DESCRIC	X6_DESC1	Exemplo de preenchimento	Observação
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		Não precisa ser configurada no módulo SIGACFG. Será exibida para o usuário na rotina de integração.
MV_APIPEM5	D	Data de corte da integração com o	Performance & Metas		Não precisa ser configurada no módulo SIGACFG. Será exibida para o usuário na rotina de integração.
MV_APIPEM6	N	Define se espera ou não o retorno da integração	com o Performance & Metas		Não precisa ser configurada no módulo SIGACFG. Será exibida para o usuário na rotina de integração.
MV_APIPEM7	N	Define o tempo máximo em minutos de espera para	obter o retorno do Performance & Metas		Não precisa ser configurada no módulo SIGACFG. Será exibida para o usuário na rotina de integração.

Nota

title	Observação

Os parâmetros MV_APIPEM0 e MV_APIPEM1 precisam ser configurados conforme o formato de exemplo da tabela acima.

Foi efetuado a criação de relacionamentos no dicionário SX9, conforme estrutura abaixo:

X9_DOM	X9_IDENT	X9_CDOM	X9_EXPDOM	X9_EXPCDOM	X9_LIGDOM	X9_LIGCDOM	X9_CONDSQL	X9_USEFIL
REN	001	RET	REN_TIPO+REN_CODIGO	RET_TIPO+RET_CODIGO	1	N		S
SQ0	001	RET	Q0_FILIAL+Q0_GRUPO	RET_FILCAD+RET_CODCAD	1	N	#RET_TIPO ='1'	N
SQ3	001	RET	Q3_FILIAL+Q3_CARGO	RET_FILCAD+RET_CODCAD	1	N	#RET_TIPO ='2'	N
SQB	001	RET	QB_FILIAL+QB_DEPTO	RET_FILCAD+RET_CODCAD	1	N	#RET_TIPO ='3'	N

Nota

title	Observação

A integração com o P&M é do tipo assíncrona, isto é, o P&M fará o processamento das informações enviadas conforme a fila de processamento.
A integração somente envia informações da tabela do grupo de empresas em que o usuário está logado.
O P&M exige que algumas informações sejam obrigatoriamente enviadas. Por esse motivo, para ser possível realizar a integração com o P&M, é

Nota

title	Observação

Será necessário incluir manualmente um item no menu do módulo SIGAGPE para a rotina GPEM939 e para a rotina GPEM939B. Sugere-se criá-las em um grupo separado, chamado de Performance & Metas em Miscelânea.
O P&M exige que algumas informações sejam obrigatoriamente enviadas. Por esse motivo, para ser possível realizar a integração com o P&M, é necessário que o cadastro grupos de cargo tenha sido realizado através da rotina TRMA030, uma vez que essa informação é obrigatória para o P&M. Algumas outras informações também serão obrigatórias:
- Um Um cargo somente será enviado se for preenchido o grupo no campo Q3_GRUPO e que esse grupo seja válido na tabela SQ0;
- Um funcionário somente será enviado se for preenchido o CPF no campo RA_CIC, e-mail no campo RA_EMAIL, se houver departamento preenchido no campo RA_DEPTO e que esse departamento seja válido na tabela SQB, se houver cargo preenchido no campo RA_CARGO e que esse cargo seja válido na tabela SQ3 e que o cargo tenha um grupo preenchido no campo Q3_GRUPO e que esse grupo seja válido na tabela SQ0 e que o funcionário tenha um relacionamento com participante na tabela RDZ.
Atente-se que o sistema não fará controle se determinado registro foi ou não integrado com sucesso ao P&M. O P&M não possui uma forma de consultar se determinado ID já foi integrado ou não e o sistema não irá controlar os retornos do 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, sendo possível reenviar todos os registros novamente ou apenas um ou alguns registros em específico.
A integração com o P&M é do tipo assíncrona, isto é, o P&M fará o processamento das informações enviadas conforme a fila de processamento.
A integração somente envia informações da tabela do grupo de empresas em que o usuário está logado.
Não há controle de restrição de acesso por filiais.
O P&M não permite que determinado cadastro tenha a mesma descrição de outro enviado anteriormente, mesmo possuindo códigos diferentes. Dessa forma, se os cadastros de grupos de cargo, cargos ou departamentos serem de modo exclusivo, será necessário realizar um cadastro de De x Para através das rotinas GPEA944A, GPEA944B ou GPEA944C.
Apenas o envio de funcionários irá validar a restrição de acesso por filiais.
Atente-se que o sistema 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 por qualquer motivo, será efetuado envio dos registros de acordo com os filtros criados pelo usuário na rotina de integração, sendo possível reenviar todos os registros novamente ou apenas um ou alguns registros em específico.
Em caso Em caso de retorno do processamento das informações pelo P&M retornar erros de validação, observe atente-se que as mensagens apresentadas na integração são as retornadas pelo P&M e não. Para mais detalhes sobre os motivos de apresentação do errodos erros, deve-se consultar a documentação do P&M no link: https://tdn.totvs.com/pages/viewpage.action?pageId=676047532.
As rotinas mencionadas abaixo devem ser incluídas manualmente no menu.