...
Criar uma rotina que fará a integração dos cadastros do Protheus com o P&M (Performance & Metas) .Criar e uma rotina que possibilite consultar as informações dos lotes de integrações com o P&M (Performance & Metas).
...
- Na tabela auxiliar S049 foi criado o campo "Agrupador P&M" para definir o agrupador de contrato que será enviado ao P&M na integração de grupos de contrato e de funcionários:
Image Removed
Image Added
Se o cadastro de grupos de cargo estiver com modo de acesso Exclusivo, será necessário cadastrar um De x Para através da rotina GPEA944A:
...
Em Outras Ações, foi disponibilizado a opção "Vincular departamentos", onde será possível marcar quais departamentos serão vinculados ao cadastro:
![](/download/attachments/680969647/image2022-5-25_10-31-44.png?version=1&modificationDate=1653485504860&api=v2)
Nota |
---|
|
Com o cadastro de De x Para, ao efetuar a integração com o P&M, todos os grupos de cargo, ou cargos ou departamentos serão enviados com o código e descrição cadastrados nesse cadastro. |
Foi efetuado a criação da rotina GPEM939 para efetuar a integração com o P&M (Performance & Metas) dos itens abaixo:
...
Aviso |
---|
|
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.
Clique aqui para exibir ou esconder o conteúdo. Cloak |
---|
| 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 | ObservaçãoO modo de acesso das tabelas REF, REN e RET devem ser obrigatoriamente compartilhado.
Foi efetuado a criação de campos na tabela REF, no dicionário SX3 conforme estrutura abaixo: X3_ARQUIVO | X3_ORDEM | X3_CAMPO | X3_TIPO | X3_TAMANHO | X3_TITULO | X3_DESCRIC | HELP |
---|
RCM | ZZ | RCM_TIPOPM | C | 1 | Tipo P&M | Tipo P&M | Informe o tipo de afastamento para o P&M | REF | 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 tabela genérica no dicionário SX6SX5, conforme estrutura abaixo: X6VARX6TIPOX6DESCRICDESCRI |
---|
1C | 1 | Empregado e Trabalhador Temporário | 1C | 2 | Avulso | 1C | 3 | Agente Público | 1C | 4 | Cessão | 1C | 7 | Contribuinte Individual | 1C | 9 | Bolsista |
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 | 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 | 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 SecretId do ambiente de 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_APIPEM4APIPEM6 | N | Tipo de verificação de registro ativo na | Define se espera ou não o retorno da integração | 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 | 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. | Observaçã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. | 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 |
Foi efetuado a criação de consultas padrão no dicionário SXB, conforme estrutura abaixo: XB_ALIAS | XB_TIPO | XB_SEQ | XB_COLUNA | XB_DESCRI | XB_CONTEM |
---|
RCMTPA | 1 | 01 | RE | Tipo afastamento |
| RCMTPA | 2 | 01 | 01 |
| GP430TpA(.T.) | RCMTPA | 5 | 01 |
|
| VAR_IXB | S04328 | 1 | 01 | RE | Tipo desligamento |
| S04328 | 2 | 01 | 01 |
| GPS04328(.T.) | S04328 | 5 | 01 |
|
| VAR_IXB | ObservaçãoOs 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
|
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.
...