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 [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.

Toggle Cloak

id	upddistr

Clique aqui para exibir ou esconder o conteúdo.

Cloak

visible	true
id	upddistr

Foi efetuado a criação de índices no dicionário SIX, 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	N
REF	3	REF_FILIAL+DTOS(REF_DATINT)+REF_HORINT	S
REN	1	REN_FILIAL+REN_TIPO+REN_CODIGO	S
RET	1	RET_FILIAL+RET_TIPO+RET_CODIGO	S
RET	2	RET_FILIAL+RET_TIPO+RET_FILCAD+RET_CODCAD	S

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

X2_CHAVE	X2_NOME	X2_MODO	X2_MODOUN	X2_MODOEMP
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

note

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

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

Considerações importantes:

- 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, é 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 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.
- 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 do processamento das informações pelo P&M retornar erros de validação, atente-se que as mensagens apresentadas na integração são as retornadas pelo P&M. Para mais detalhes sobre os motivos de apresentação dos 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.

A rotina GPEM939 é do tipo Wizard e possui cinco passos:

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 quatro perguntas para a 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. 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 que não sejam demitidos ou que foram demitidos com data de demissão superior à data de corte informada 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 serão considerados como inativos.
"Verificação retorno P&M:": define se a rotina irá aguardar o retorno do processamento da integração pelo P&M ou não.
"Tempo limite (em minutos):": define o tempo máximo que a rotina irá aguardar para obter o status de retorno do processamento pelo P&M.

Nota

title	Observação

Ao definir que irá aguardar o retorno do processamento da integração pelo P&M, a rotina irá consumir uma API do P&M para verificar o status do processamento do lote, e assim que processado, irá exibir o status das integrações no log. Atente-se que a rotina irá tentar obter o status da integração até o tempo máximo estipulado; atingindo o tempo limite, a rotina irá ser encerrada exibindo o log dos status obtidos até o momento. Havendo erro no processamento do P&M, no log de ocorrências será exibido o ID do registro enviado ao P&M, contendo o código da validação e sua respectiva mensagem, conforme lista detalhada na documentação: https://tdn.totvs.com/pages/viewpage.action?pageId=676047532.

Observe que na possibilidade do P&M demorar para processar a integração, a rotina irá ficar "presa" até que toda a integração enviada seja processada pelo P&M ou até o tempo limite ser atingido.

Card

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

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

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 efetuar o filtro na 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

As informações enviadas para o P&M são geradas conforme detalhamento abaixo:

Deck of Cards

startHidden	false
id	jsons

Card

default	true
id	filiais
label	Filiais
title	Filiais

"integrationId": M0_CODIGO+M0_CODFIL,

"name": M0_FILIAL

Card

id	grupos
label	Grupos de cargo
title	Grupos de cargo

"integrationId": M0_CODIGO+Q0_FILIAL+Q0_GRUPO,

"name": Q0_DESCRI

Card

id	cargos
label	Cargos
title	Cargos

"integrationId": M0_CODIGO+Q3_FILIAL+Q3_CARGO,

"name": Q3_DESCSUM,

"positionGroupIntegrationId": M0_CODIGO+Q0_FILIAL+Q0_GRUPO;

Card

id	departamentos
label	Departamentos
title	Departamentos

"integrationId": M0_CODIGO+QB_FILIAL+QB_DEPTO,

"name": QB_DESCRIC;

Card

id	contratos
label	Grupos de contrato
title	Grupos de contrato

"integrationId": M0_CODIGO+X5_FILIAL+X5_CHAVE,

"name": X5_DESCRI;

Card

id	funcionarios
label	Funcionários
title	Funcionários

"integrationId": M0_CODIGO+RDZ_CODRD0,

"name": RA_NOMECMP ou RA_NOME,

"socialName": RA_NSOCIAL,

"email": RA_EMAIL,

"admissionDate", RA_ADMISSA,

"lastRaiseDate": R3_DATA,

"birthDate": RA_NASC,

"departmentIntegrationId": M0_CODIGO+QB_FILIAL+QB_DEPTO,

"positionIntegrationId": M0_CODIGO+Q3_FILIAL+Q3_CARGO,

"facilityIntegrationId": M0_CODIGO+RA_FILIAL

Após a geração e envio de um lote de registros para o P&M, será retornado para o Protheus um UUIID de identificação do lote de processamento 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 X=Não encontrado
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

...

05. ASSUNTOS RELACIONADOS

DT Integração com P&M (Performance & Metas) - Fase 2Não há.

Templatedocumentos

HTML

<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;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>

Árvore de páginas

Versões comparadas

Versão antiga 30

Nova versão 31

Chave

05. ASSUNTOS RELACIONADOS