Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Produto:

Solucoes_totvs_cross
SolucaoCrossTOTVS RH

Linha de Produto:

Linhas_totvs
SegmentoDistribuição
RegionConstrução Projetos
LinhaLinha Protheus

Segmento:

Segmentos_totvs
SegmentoRH

Módulo:SIGAGPE
Função:

GPEM939

Ticket:


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

DRHCALCPRT-3734

DRHCALCPRT-4009


02. SITUAÇÃO/REQUISITO

Necessário criar Criar uma rotina que fará a integração com o P&M (Performance & Metas) dos itens abaixo:

...

Aviso
titleObservaçã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_CHAVEX2_NOMEX2_MODOX2_MODOUNX2_MODOEMP
REFLote de integração P&MCCC
Nota
titleObservaçã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:

INDICEORDEMCHAVESHOWPES
REF1REF_FILIAL+REF_TIPO+REF_STATUS+DTOS(REF_DATINT)+REF_HORINT       S
REF2REF_FILIAL+REF_PRCIDS


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

X3_ARQUIVOX3_ORDEMX3_CAMPOX3_TIPOX3_TAMANHOX3_DECIMALX3_TITULOX3_DESCRICHELP
REF01REF_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


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

X6_VARX6_TIPOX6_DESCRICX6_DESC1Exemplo de preenchimento
MV_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://{TENANTNOME_EMPRESA}.performance.totvs.app/integration-general/

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

MV_APIPEM2CClientId do ambiente de integração com oPerformance & Metas
MV_APIPEM3CSecretId do ambiente de integração com oPerformance & Metas
MV_APIPEM4NTipo de verificação de registro ativo naintegração com o Performance & Metas
MV_APIPEM5DData de corte da integração com oPerformance & Metas
MV_APIPEM6NDefine se espera ou não o retorno da integraçãocom o Performance & Metas
MV_APIPEM7NDefine o tempo máximo em minutos de espera paraobter o retorno do Performance & Metas
Nota
titleObservação

Os Somente deve ser efetuado configuração dos parâmetros MV_APIPEM0, MV_APIPEM1, MV_APIPEM2 e MV_APIPEM3; já os parâmetros MV_APIPEM4, MV_APIPEM5, MV_APIPEM6 e MV_APIPEM7 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 ser configurados conforme o formato de exemplo da tabela acima.

Nota
titleObservação

Será necessário incluir manualmente um item no menu do módulo SIGAGPE , em Miscelânea, no grupo para a rotina GPEM939. Sugere-se criar um grupo chamado Performance & Metas , para o item GPEM939em Miscelânea.

Além disso, para ser possível realizar a integração é necessário cadastrar grupos de cargo através da rotina TRMA030, uma vez que essa informação é obrigatória para o P&M (Performance & Metas), além de vincular os grupos aos cargos cadastrados no sistema.


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

Deck of Cards
startHiddenfalse
idWIZARD
Card
defaulttrue
idwizard1
label1-Observações
titleObservações

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


Card
idwizard2
label2-Configuração
titleConfiguração

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

  1. "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);
  2. "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.
  3. "Verificação retorno P&M:": define se a rotina irá aguardar o retorno do processamento da integração pelo P&M (Performance & Metas).
  4. "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 (Performance & Metas).


Image Added


Nota
titleObservaçã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 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 (Performance & Metas), 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. Todas as validações e mensagens são geradas pelo P&M, sendo de responsabilidade do usuário analisar a mensagem da validação e, se necessário, tomar ação para reenviar o registro novamente.

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 ou até o tempo limite ser atingido.

Card
idwizard3
label3-Opções
titleOpçõ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
idwizard4
label4-Filtro
titleFiltro

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
idwizard5
label5-Processamento
titleProcessamento

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


...