| Produto: | |
|---|
| Linha de Produto: | | Linhas_totvs |
|---|
| Segmento | Distribuição |
|---|
| Region | Construção Projetos |
|---|
| Linha | Linha Protheus |
|---|
|
|
|---|
| Segmento: | |
|---|
| Módulo: | SIGAGPE |
|---|
| Função: | GPEM939 |
|---|
| Ticket: |
|
|---|
| Requisito/Story/Issue (informe o requisito relacionado) : | DRHCALCPRT-3734 DRHCALCPRT-4009 |
|---|
Necessário criar uma rotina que fará a integração com o P&M (Performance & Metas) dos itens abaixo:
- Filiais;
- Grupos de cargo;
- Cargos;
- Departamentos;
- Funcionários.
Foi efetuado a criação da rotina GPEM939 para efetuar a integração com o P&M (Performance & Metas) dos itens abaixo:
- Filiais;
- Grupos de cargo;
- Cargos;
- Departamentos;
- Funcionários.
...
| Aviso |
|---|
|
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 |
|---|
| 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_DECIMAL | X3_TITULO | X3_DESCRIC | HELP |
|---|
| REF | 01 | REF_FILIAL | C | 2 | 0 | Filial | Filial | Filial do lote | | REF | 02 | REF_PRCID | C | 100 | 0 | Process ID | Process ID | Process ID do lote retornado pelo P&M | | REF | 03 | REF_TIPO | C | 1 | 0 | Tipo API | Tipo API | Tipo da API | | REF | 04 | REF_DATINT | D | 8 | 0 | Data Integr. | Data Integr. | Data da integração | | REF | 05 | REF_HORINT | C | 8 | 0 | Hora Integr. | Hora Integr. | Hora da integração | | REF | 06 | REF_STATUS | C | 1 | 0 | Status | Status Integração | Status da integração | | REF | 07 | REF_LOTE | M | 10 | 0 | Lote | Lote Integração | JSON do lote integrado |
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 |
|
| Nota |
|---|
| Os parâmetros MV_APIPEM4 e MV_APIPEM5 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. |
|
| Nota |
|---|
|
Será necessário incluir manualmente um item no menu do módulo SIGAGPE, em Miscelânea, no grupo Performance & Metas, para o item GPEM939. 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. |
A rotina GPEM939 é do tipo wizard Wizard e possui cinco passos:
| Deck of Cards |
|---|
|
| 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 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 para frente, data de corte (a data é configurada na próxima 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 configurada não serão considerados como ativos.
| Nota |
|---|
| 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:
|
|
| 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 |
|---|
|
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 |
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 todos os registros ou apenas um ou alguns em específico. |
04. DEMAIS INFORMAÇÕES
Atualizador de dicionário e base de dados - UPDDISTR.
Incluindo Campos Reservados (CFGX034 - SIGACFG).
Não há.
...
