Ferramenta de Importação Genérica de Tabelas Protheus

Deck of Cards

id	Principal
effectType	slide

Card

default	true
label	Objetivo

Visando ofertar uma solução adequada para auxílio na implantação dos módulos de RH, bem como na importação de tabelas posterior ao período de implantação, foi desenvolvida a ferramenta genérica de importação de tabelas RHIMPGEN.

Através da ferramenta RHIMPGEN é possível a definição de leiautes para importação de arquivos texto para as tabelas do Protheus.

Para execução da ferramenta é preciso executar o Smartclient com o programa inicial como RHIMPGEN.

Pré-Requisitos: lista dos itens necessários para realização das importações.

Manutenção de Layouts: rotina responsável pela definição dos leiautes dos arquivos de importação. Pode ser configurado a partir de uma Tabela do Protheus OU a partir de um Modelo Pré-Definido.

Manutenção de Layouts - Tabelas Genéricas: ramificação da rotina de Manutenção de Layouts. Essa opção permite configurar um leiaute para as Tabelas

Genéricas do SIGAGPE (e.g. S008 - Assistência Médica Faixa Salarial)

Manut. De-Para: rotina responsável pela configuração do relacionamento entre os códigos externos (valor contido no arquivo - De) e os códigos internos (valor a ser gravado no Protheus - Para). É possível realizar a exportação e importação da lista para um arquivo CSV a fim de facilitar a manutenção dos dados.

Gerar XML: rotina responsável por gerar uma planilha com a estrutura do leiaute selecionado. Este arquivo procura facilitar a geração do arquivo de importação dentro da estrutura configurada.

Geração de Verbas (SRV): rotina responsável pela geração de verbas no Protheus. É feita a carga das verbas padrão do sistema, possibilitando a alteração da configuração de cada verba, acrescentar novas verbas e indicar De-Para para cada verba listada.

Processamento: Passo a passo de como realizar a importação dos dados.

Rotinas alteradas/incluídas:

Características do Requisito

Linha de Produto:

Protheus

Segmento:

Serviços

Módulo:

SIGAGPE - Gestão de Pessoal

Rotina:

Rotina	Nome Técnico
RHIMPGEN	Ferramenta de Importação Genérica

Rotina(s) envolvida(s)

Nome Técnico

Informe a(s) rotina(s) envolvidas.

Informe o nome técnico da(s) rotina(s) envolvidas.


RHIMPLAY	Manutenção de Layouts
RHIMPDP	Manutenção de De/Para
RHIMPSRV	Geração de Verbas
RHIMP02	Importação Modelo de Funções
RHIMP03	Importação Modelo de Centro de Custos
RHIMP04	Importação Modelo de Departamentos
RHIMP05	Importação Modelo de Sindicatos
RHIMP06	Importação Modelo de Verbas
RHIMP07	Importação Modelo de Turnos
RHIMP08	Importação Modelo de Funcionários
RHIMP09	Importação Modelo de Dependentes
RHIMP10	Importação Modelo de Ausências
RHIMP11	Importação Modelo de Histórico Salarial
RHIMP12	Importação Modelo de Movimento da Folha de Pagamento
RHIMP13	Importação Modelo de Transferências
RHIMP14	Importação Modelo de Movimento de Rescisão
RHIMP15	Importação Modelo de Movimento de Férias
RHIMP16	Importação Modelo de Movimento de 13º Salário
RHIMP19	Importação Modelo do Cadastro de Crachás Provisórios
RHIMP20	Importação Modelo de Movimento de Banco de Horas
RHIMP21	Importação Modelo de Eventos
RHIMP25	Importação Modelo de Beneficiários
RHIMP26	Importação Modelo de Vale Refeição
RHIMP28	Importação Modelo de Plano de Saúde
GPEA010	Cadastro de Funcionários
GPEM040	Rescisão
GPEA040	Cadastro de Verbas

Cadastros Iniciais:

Tipos de Ausências

/ Processos / Roteiros de Cálculo

Parâmetro(s):

Informe os parâmetros utilizados.

Ponto de Entrada:

Informe o ponto de entrada relacionado (link).

Chamados Relacionados

Informe o(s) chamado(s) relacionado(s).

Requisito (ISSUE): Informe o requisito relacionado (Issue).

Descrição

Visando auxiliar no processo de implantação dos módulos de Recursos Humanos, bem como na importação de dados provenientes de outros sistemas, foi desenvolvido esta rotina de importação genérica, que pode ser configurada de acordo com as necessidades de cada implantação.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Aplique o patch do chamado e execute uma vez a rotina RHIMPGEN

Será aberta uma tela com todos os layouts de importação criados, caso nenhum tenha sido definido, a tela estará vazia. Em ações relacionadas existirá três opções:
Manutenção de Layouts:
Nesta opção será possível incluir ou alterar um layout previamente definido. Ao acessar esta opção será exibida uma tela onde o layout poderá ser definido de duas maneiras:
1 - Informando uma tabela: Todos os campos são carregados no grid e é possível definir a posição deles dentro do arquivo de importação. No grid é exibido o nome do campo, se é obrigatório, a posição (o padrão é carregar a ordem do SX3), se deve efetuar DE-PARA automático e a Fórmula. Apenas os últimos três podem ser editados. Todos os campos obrigatórios devem possuir uma posição diferente de zero ou uma fórmula definida. Todos os campos que não existam no arquivo devem ter a posição alterada para ZERO. Pode ser criado apenas uma layout por tabela. No campo fórmulas pode ser utilizado strings, funções protheus e funções de usuário.
O Campo "De Para Automático" pode ser preenchido para todos os campos, porém só irá gerar registros de DE-PARA automaticamente para campos chaves pré-definidos, são eles: PJ_DI, Q3_CARGO, QB_DEPTO, R6_TURNO, RA_MAT, RB6_FAIXA, RB6_NIVEL, RB6_TABELA, RBR_TABELA, RCE_CODIGO, RJ_FUNCAO, RV_COD, CTT_CUSTO.
Sempre que for feita a importação do Layout da tabela SRA, o valor do txt referente ao campo RA_MAT será validado na tabela de DE-PARA, se existir correspondente, ele será utilizado, se não existir e o campo DE-PARA automático do RA_MAT estiver definido como "Sim", um novo registro baseado na numeração automática será gerado e gravado, tanto na tabela de DE-PARA quando na tabela SRA. Se o De-Para automático estiver definido como "Não", é gravado o valor recebido no arquivo de importação. Quando qualquer outra tabela que possua campo relacionado com o RA_MAT for importada é feita a mesma busca na tabela de DE-PARA, porém, ao contrário do primeiro caso, se o registro não for encontrado, ele não é criado automaticamente, independente do conteúdo do campo "DE Para Automático".
2 - Informando um Modelo: Ao informar um modelo padrão RHIMP, apenas os campos chaves são carregados no grid, e será possível apenas definir uma fórmula ou se deve ser feito o DE-PARA automático (que já vem preenchido com "sim" no padrão e deve ser alterado caso os registros já estejam corretos no arquivo de importação). A documentação sobre os modelos RHIMP estão amplamente divulgadas e podem ser localizadas no TDN.

Processos

Períodos

Definição e Manutenção de Tabelas.

Requisito (ISSUE):

RHRH002-4

Outros

ER Ferramenta Importação Protheus

Card

label	Pré-Requisitos

Realizar carga padrão dos cadastros:
- Processo (SIGAGPE > Atualizações > Definições de Cálculo > Processos)
- Roteiros de Cálculo (SIGAGPE > Atualizações > Definições de Cálculo > Roteiros de Cálculo)
- Definição de Tabelas (SIGAGPE > Atualizações > Definições de Cálculo > Definição de Tabelas)
- Manutenção de Tabelas (SIGAGPE > Atualizações > Definições de Cálculo > Manutenção de Tabelas)
- Tipos de Ausências (SIGAGPE > Atualizações > Definições de Cálculo > Tipos de Ausência)

Verbas: realizar carga padrão através da opção RHIMPGEN > Outras Ações > Geração de Verbas (SRV) OU realizar importação dos dados. As verbas são essenciais para realização da importação de qualquer movimentação de cálculo.

Cadastro de De-Para: realizar o cadastro de De-Para para os campos-chave a serem importados e que não possuem opção de De-Para automático. O De-Para das Filiais é essencial para importação de qualquer registro (realizar cadastro em caso de necessidade).

Cadastro de De-Para Específico:
- Tipos de Rescisão: influenciará diretamente na importação de Rescisões
- Tipos de Alteração Salarial: influenciará diretamente na importação de Histórico Salarial
- Tipos de Afastamentos: influenciará diretamente na importação de Ausências, Rescisão, Férias.

Card

id	manut_leiaute
label	Manutenção de Layouts

Na montagem de leiautes genéricos é possível definir quais campos serão importados, sendo que os campos obrigatórios sempre deverão constar no leiaute, seja como uma posição no arquivo ou como uma fórmula pré-definida.

Ao abrir a tela principal, é exibido um browser com todos os leiautes definidos. Em Outras Ações, há opção Manutenção de Layouts.

Image Added

Informações

title	Importante

Delimitadores no Arquivo texto:

O sistema realiza a importação das tabelas a partir da leitura de um arquivo de texto delimitado por pipes ("|").

Sequência:

O campo Sequência será utilizado para ordenar as importações durante o processamento. Ele é gerado automaticamente e poderá ser alterado a qualquer momento.

Tabela ≠ Modelo

Os leiautes com origem em um Modelo e os leiautes com origem em uma Tabela de sistema são cadastros distintos na tabela GPETABGEN. Assim, é possível configurar o modelo de Funções e também configurar a tabela SRJ (Funções) de forma diferente. Ao final estará disponível para utilização 2 leiautes distintos.

Modelo

No primeiro acesso à rotina RHIMPGEN, os modelos de leiaute padrão serão criados automaticamente. Esses leiautes disponíveis no campo "Modelo" são referentes aos modelos de importação com posições pré-definidas e não podem ser alteradas.

A rotina de Manutenção de Layouts possui 2 opções de utilização:

Seleção de uma Tabela para definição do leiaute.

Ao selecionar uma tabela, se já existir um leiaute previamente cadastrado, ele é carregado para alteração. Do contrário um novo leiaute genérico baseado na ordem dos campos no dicionário de dados (SX3) é gerado.

Na grid é exibido Campo, Título (nome do campo), Tipo (C- caracter, N- numérico, D- Data, L- lógico, M- memo), Obrigatório (se é obrigatório informar campo no Protheus), Posição (a posição no arquivo texto, que é inicialmente baseado na ordem do SX3) e Fórmula (detalhes mais abaixo).

Dos campos da grid será possível apenas alterar a posição e a fórmula. Não é permitido inclusão de novas campos ao leiaute.

No cabeçalho, é possível alterar a Descrição (carregado o nome da tabela no SX2 por padrão), o Nome do Arquivo de importação, a Sequência de execução, e o De-Para automático (detalhes mais abaixo).

Image Added

Todo campo obrigatório deve possuir uma posição válida (diferente de ZERO) ou uma fórmula definida. Por exemplo, se a Empresa é a mesma e não existe informação nela no arquivo, a posição pode ser 0 (ZERO), e na Fórmula deve ser informado um valor para o campo: "T1". Em resumo, deve ser informado a posição apenas de campos que efetivamente existem no arquivo texto, os demais devem ficar com a posição "0" (ZERO). No campo fórmula podem ser utilizadas Strings, Funções Protheus e Funções de Usuário.

2. Seleção de um Modelo de importação padrão.

Ao selecionar o modelo desejado os campos Descrição, Nome do Arquivo e Sequência presentes no cabeçalho serão carregados. Qualquer alteração realizada previamente e salva será carregada.

No grid, serão carregados os campos do leiaute.

Quando utilizada a opção Modelo, será possível alterar apenas o campo Fórmula no grid. Não é permitido inclusão de novas campos ao leiaute.

No cabeçalho os campos Descrição, Nome do Arquivo, Sequência e De-Para Automático são abertos para alteração.

Caso tenha sido realizada alguma alteração anterior no cadastro do modelo, estas serão carregadas.

Image Added

De-Para Automático

De-Para automático está disponível apenas para algumas tabelas/modelos. Ao habilitá-lo, ele será utilizado apenas para o campo chave principal da tabela, realizando a busca do código identificador (De) a ser importado na tabela de De-Para, caso não encontre o registro na tabela, será gerado um novo código (Para) a partir da numeração automática da tabela importada e também gravado a relação entre os códigos na tabela de De-Para.

Quando esta opção estiver desativada, será realizada a busca do relacionamento na tabela de De-Para, porém caso não encontre registro será realizada a tentativa de gravação com o próprio valor proveniente do arquivo texto, passando pela validação do sistema (tamanho do campo, conteúdo, relacionamento com outras tabelas).

Exemplo

No leiaute de importação dos Sindicatos foi definido que seria feito o De/Para automático:

Image Added

Após a importação do arquivo de Sindicatos, o De/Para foi gerado de maneira automática:

Image Added

Durante a importação do arquivo de funcionários, que continha o valor original do Sindicato, o sistema busca o valor da chave externa e preenche o campo RA_SINDICA com valor cadastrado na chave interna:

Image Added

Gerar Arquivo Texto de exemplo:

No cabeçalho, há disponível um botão que possibilita a geração de um exemplo de arquivo texto baseado no leiaute carregado em tela. Assim como a opção de Gerar XML, esta opção visa facilitar a configuração/geração do arquivo de importação.

Image Added

Fórmulas

Para cada campo presente no leiaute, é possível configurar uma fórmula para tratar o conteúdo a ser gravado no sistema.

As fórmulas podem ser uma string com valor fixo (sempre entre aspas), referência para um campo existente no Protheus, chamada de funções internas do Protheus ou chamada de funções de usuário executadas via RdMake. Foram disponibilizadas 2 funções de usuário para o auxílio da gravação dos campos Período ( U_Periodo() - retorna o período do registro ) e Processo ( U_Processo() - retorna o código do processo do funcionário do registro/linha atual).

Exemplo 01:

O campo Empresa não está presente no arquivo (posição = zero) e possui uma Fórmula de usuário para retornar o valor a ser gravado no campo.

O campo Filial também não está presente no arquivo (posição = zero) e possui uma string com valor fixo para gravação do conteúdo. Assim, todos os registros serão gravados com o conteúdo "D MG 01" no campo QB_FILIAL.

Image Added

Exemplo 02:

O campo Cod. Processo não está presente no arquivo (posição = zero) e possui chamada para a função U_Processo(). Desta forma, a cada linha processada, será verificado e retornado o código do Processo referente ao funcionário do registro (PC_MAT - posição 3)

O campo Periodo não está presente no arquivo (posição = zero) e possui chamada para a função U_Periodo(). Desta forma, a cada linha processada será verificado e retornado o código do Período referente ao registro importado baseando no campo data do lançamento (neste caso PC_DATA - posição 4).

O campo Número Pagto não está presente no arquivo (posição = zero) e possui um conteúdo fixo informado. Assim, em todos os registros o campo PC_NUMPAG será gravado com conteúdo "01".

Os campos Centro de Custo, Departamento, Posto, Função e Turno não estão presentes no arquivo (posição = zero) e estão referenciados aos campos do cadastro de Funcionários que armazenam as mesmas informações. Assim, para cada campo, será consultado o valor presente no cadastro do funcionário do registro e gravará o conteúdo lido no referente campo da tabela alvo.

O campo Sequencia não está presente no arquivo (posição = zero) e possui chamada para a função Protheus Posicione(tabela, ordem, chave de busca, campo de retorno). Esta função irá retornar o conteúdo presente no campo PJ_SEMANA.

Manutenção de Layouts - exemplo do uso do campo Fórmulas 2 Image Added

Dica

title	Variáveis de Manipulação do Arquivo

A fim de flexibilizar e facilitar a manipulação dos dados do arquivo no momento da importação, está disponível para uso 3 variáveis que fazem referência aos dados do arquivo. Essas variáveis podem ser utilizadas como parâmetros nas chamadas das funções presentes no campo Fórmula.

aCampos: matriz que guarda todos os campos utilizados no leiaute. Cada índice da matriz guarda um campo e é composto por sete posições, sendo elas:
1. Nome do campo
2. Posição na linha
3. Fórmula do campo
4. De/Para
5. Posição reservada
6. Tipo do campo
7. Ordem.
aLinha: vetor que armazena todos os valores da linha atual.
nPos: armazena o índice do campo atual dentro de aCampos. Dessa forma para se acessar o campo que está sendo processado atualmente basta utilizar aCampos[nPos].

Exemplo 01:

No cadastro de Bancos do Protheus, as informações de Número da Conta e Dígito são armazenadas em campos separados. Isso não é comum em todos os sistemas. Caso o arquivo a ser importado possua essas informações unificadas em apenas um campo, é possível fazer o tratamento da informação via fórmula no leiaute sem haver necessidade de alteração do arquivo. No caso deste cenário, os campos A6_NUMCON e A6_DVCTA serão referenciados à mesma coluna do arquivo (5) no campo Posição, e no campo Fórmula realiza-se o tratamento da informação lida.

Como demonstra a figura abaixo, a referência aLinha[aCampos[nPos,2]] carrega o dado presente na posição atual (nPos = 5) da linha que está sendo lida.

No campo A6_NUMCON a função Right() indica que será carregado neste campo somente os 4 primeiros caracteres da coluna lida. Já no campo A6_DVCTA a função Left() indica que será carregado neste campo somente os últimos 2 caracteres da coluna lida.

Image Added

Exemplo 02:

Caso algum campo possua tamanho menor ao tamanho do campo no Protheus, é possível realizar um tratamento para completar o tamanho do campo com certo caractere a fim do preenchimento completo do campo.

No exemplo abaixo, imagine que o campo Matrícula possua 4 caracteres no sistema anterior e, no Protheus temos o campo Matrícula com 6 caracteres. Caso não deseje gerar as matrícula por De-Para automático, pode-se realizar uma tratamento no próprio campo para completar com zeros (0) à esquerda a fim de ter o conteúdo totalmente preenchido.

Com uso da função Protheus StrZero() completa-se a cadeia de caracteres lida na coluna do campo Matrícula (aLinha[aCampos[nPos,2]]).

Image Added

Card

id	manut_leiaute_tab_generica
label	Manutenção de Layouts - Tabelas Genéricas

A rotina de Manutenção de Layouts também atende à necessidade de configurar leiautes para tabelas genéricas (Manutenção de Tabelas).

Para realizar a configuração de leiaute para uma tabela genérica, é necessário selecionar a tabela RCB - Configuração de Parâmetros no campo Tabela, o que fará com que o campo Tab.Aux. seja habilitado para edição.

No campo Tab.Aux. selecionar a tabela genérica desejada através da busca padrão ou digitando seu código. É possível escolher qualquer tabela definida na rotina Definição de Tabelas, inclusive tabelas de usuário.

Manutenção de Layouts - configuração leiaute tabela genérica Image Added

Consulta Padrão Tabelas Genéricas Image Added

Após escolher a tabela genérica, o grid será atualizado com a estrutura de campos desta tabela.

Manutenção de Layouts - exemplo configuração leiaute tabela genérica Image Added

A estrutura das tabelas genéricas é armazenada fisicamente no banco de dados na tabela RCB (por isso o leiaute é configurado a partir desta tabela) porém, os dados dessas tabelas ficam fisicamente armazenados na tabela RCC - Parâmetros. Com isso, foi necessário a inclusão fixa de alguns campos da tabela RCC na estrutura dos leiautes das tabelas genéricas (por mais que não estejam presentes no arquivo) a fim de assegurar a correta gravação dos dados.

Manutenção de Layouts - tabelas genéricas - campos fixos no leiaute. Image Added

O campo EMPRESA é utilizado em todos os leiautes para identificar a empresa alvo da importação.
O campo RCC_FILIAL é utilizado em todos os leiautes para Tab.Aux. a fim de identificar a Filial para qual a informação será gravada. Caso o campo não seja informado, será gravada a primeira Filial presente no SM0 obedecendo a regra de compartilhamento da tabela alvo (RCC).
O campo RCC_FIL é utilizado nas tabelas genéricas para especificar a Filial do registro. É um campo disponibilizado na própria rotina de Manutenção de Tabelas. Seu preenchimento é opcional.
O campo RCC_CHAVE é utilizado nas tabelas genéricas para especificar a competência de vigência do registro. É um campo disponibilizado na própria rotina de Manutenção de Tabelas para as tabelas que não possuem o campo Ano/Mes em sua definição de leiaute. Seu preenchimento é opcional.

Ao confirmar a configuração do leiaute, a janela de edição é fechada retornando-se à tela inicial da rotina. O leiaute estará disponível na lista, obedecendo o número do campo Sequência.

Exemplo de leiaute de tabela genérica cadastrado. Image Added

Realizada a importação, os dados estarão disponíveis para visualização e manutenção na rotina SIGAGPE > Atualizações > Definições de Cálculo > Manutenção de Tabelas.

Card

label	Manut. De-Para

A rotina de Manutenção de De-Para possibilita incluir, alterar e visualizar os relacionamentos entre os códigos externos (valor presente no arquivo texto) e internos (valor a ser gravado no Protheus).

Acesse em Importação de Tabelas (RHIMPGEN) > Outras Ações > Manut. De-Para.

No cabeçalho, o campo Tabela é carregado com os nomes das tabelas que possuem De-Para cadastrado, possibilitando assim o filtro desses dados a fim de facilitar a manutenção dos registros. Quando selecionado a opção em branco, serão carregados todos os registros cadastrados na tabela de De-Para (GPETABDP).

O campo Buscar possibilita encontrar um registro carregado no grid da tela.

No cadastro de De-Para é possível criar um relacionamento de valores para quaisquer campos existentes no Protheus. Para incluir um novo De-Para inclua uma nova linha de registro informando Campo (nome do campo na tabela do Protheus, e.g.: RA_MAT), Chave Externa (valor presente no arquivo texto) e Chave Interna (valor a ser gravado no Protheus).

Image Added

Exemplo 01:

Campo Tipo de Aviso de Prévio (RG_TPAVISO) da tabela de Rescisão (SRG) possui tamanho diferente entre o sistema anterior (tamanho 5) e o Protheus (tamanho 2), fazendo necessário o cadastro de De-Para a fim de gerar um novo código para gravação da informação no Protheus. Desta forma, ao executar a importação do arquivo de Rescisão, antes de gravar o conteúdo no campo RG_TPAVISO, o sistema efetuará busca no De-Para e gravará no campo o conteúdo presente em Chave Interna. Caso a chave não seja encontrada no De-Para, o valor original (do arquivo) será truncado e gravado.

Campo	Chave Externa	Chave Interna
RG_TPAVISO	00001	01
RG_TPAVISO	00002	02
RG_TPAVIO	00010	03

Exemplo 02:

Outro cenário que pode ocorrer, é a configuração de De-Para para os códigos das Filiais que podem sofrer alteração na mudança de sistemas. Para configurar De-Para de Empresa+Filial é necessário preencher com FILIAL o campo Campo. Ao incluir duas informações na chave (e.g.: Empresa+Filial) é necessário separá-las utilizando pipes ("|").

Campo	Chave Externa	Chave Interna
FILIAL	01\|01	T1\|D MG 01
FILIAL	01\|02	T1\|D MG 02
FILIAL	02\|01	T2\|L MG 01

Exemplo 03:

Ao realizar De-Para de campos que possuem identificação por Filial, é necessário incluir o valor da Filial na chave, separando o código da Filial e o código do campo por pipes ("|").

Campo	Chave Externa	Chave Interna
RA_MAT	01\|A00001	D MG 01\|000001
RA_MAT	02\|A00002	D MG 02\|000002
RA_MAT	01\|B00003	L MG 01\|000001

Caso o valor da Filial informado na Chave Interna seja inexistente no Protheus, não será realizada a importação.

Outras Ações > De-Para Específicos

Dentro da rotina de Manutenção de De-Para há a opção De-Para Específicos para configuração de alguns itens que possuem valor padrão dentro do Protheus e, por diferença de tamanho ou outras características se torna necessário a configuração do De-Para.

Image Added

Tipos de Rescisão: No Protheus, os tipos de rescisão (e.g.: Pedido de Demissão Trabalhado) são configurados a partir da tabela genérica S043 (presente na rotina Manutenção de Tabelas). Por padrão o sistema carrega 14 tipos de rescisão. Ao acionar a opção de De-Para Específico Tipos de Rescisão, uma nova tela é exibida com a listagem dos tipos padrão do Protheus e uma coluna para informar o valor externo (De). Ao confirmar a configuração, será gravado na tabela de De-Para (GPETABDP) a relação informada para o campo RG_TIPORES (tabela SRG - Rescisão. Na importação dos cálculos de rescisão, o sistema verifica se o Tipo de Rescisão está gravado no sistema. Caso não esteja, a importação dos dados não ocorrerá. Por isso é necessário a configuração da tabela ou do De-Para antes da importação desse item.).
Tipos de Alteração Salarial: No Protheus, os tipos de alteração salarial (e.g.: Salário Inicial) ficam gravados na tabela SX5 (Tabelas) com chave de identificação 41. Essa tabela somente é alterada via Configurador (SIGACFG). Por padrão o sistema carrega 3 tipos de alteração salarial. Ao acionar a opção de De-Para Específico Tipos de Alteração Salarial, uma nova tela é exibida com a listagem dos tipos padrão do Protheus e uma coluna para informar o valor externo (De). Ao confirmar a configuração, será gravado na tabela de De-Para (GPETABDP) a relação informada para o campo R3_TIPO (tabela SR3 - Histórico Valores Salariais. Na importação do Histórico de Alteração Salarial, o sistema verifica se o Tipo de Alteração Salarial está gravado no sistema. Caso não esteja, a importação dos dados não ocorrerá. Por isso é necessário a configuração da tabela ou do De-Para antes da importação desse item.).
Tipos de Afastamento (Ausências): No Protheus, os tipos de ausências (e.g.: Afastamento Temporário por Doença) ficam gravados na tabela RCM. Por padrão o sistema carrega 18 tipos de ausências. Ao acionar a opção de De-Para Específico Tipos de Afastamentos, uma nova tela é exibida com a listagem dos tipos padrão do Protheus e uma coluna para informar o valor externo (De). Ao confirmar a configuração, será gravado na tabela de De-Para (GPETABDP) a relação informada para o campo R8_TIPOAFA (SR8 - Lançamentos de Ausências. No momento da importação de Ausências, o sistema verifica a existência dos Tipos de Ausências. Caso o valor a ser importado não exista no sistema, a importação dos dados não ocorrerá. Por isso é necessário a configuração da tabela ou do De-Para antes da importação.).

Outras Ações > Exportar CSV e Importar CSV

Foi implementada também as opções de Exportar e Importar o cadastro de De-Para para um arquivo CSV (delimitado por ponto-e-vírgula) a fim de permitir a edição via editores de planilha facilitando a manipulação/criação de dados.

Para realizar a importação é necessário utilizar o mesmo arquivo exportado (mesmo nome e leiaute).

A opção Exportar CSV gera um arquivo com todos os registros da tabela de De-Para.

A opção Importar CSV funciona de forma incremental, onde é possível importar apenas o diferencial (novos registros) e a rotina irá acrescentar os dados lidos à tabela de De-Para.

Image Added

Leiaute do Arquivo DEPARA - edição em planilha.

Leiaute arquivo DEPARA - editor planilha Image Added

Leiaute do Arquivo DEPARA - edição em texto.

Leiaute arquivo DEPARA - editor texto Image Added

Card

label	Gerar XML

A opção Gerar XML presente na rotina de Importação de Tabelas permite a geração de um arquivo planilha do leiaute configurado em Manutenção de Layouts. O objetivo da rotina é facilitar a geração do arquivo texto de importação através da manipulação de dados via planilha.

Acesse em Importação de Tabelas (RHIMPGEN) > Outras Ações > Gerar XML.

Image Added

Nota

title	Atenção!

Esta planilha poderá ser utilizada para preenchimento e posterior conversão para arquivo texto para efetuar a importação. Opção será válida apenas para os leiautes genéricos. (Não utilizada com modelos RHIMP).

Card

label	Geração de Verbas (SRV)

A opção Geração de Verbas (SRV) tem como objetivo auxiliar a geração e relacionamento das verbas entre os sistemas (origem e destino). Ao acessar a rotina é carregado em tela uma lista de verbas padrão pré-configuradas. A primeira coluna do grid é disponibilizada para inserção do código externo (De) para agilizar o cadastro de De-Para dos itens. É possível realizar a alteração de todos os campos do grid a fim de atender às necessidades de uso do cliente (e.g.: configuração de Incidências.). Também é possível a inserção de novas linhas a grid caso as verbas carregadas não atendam todas as necessidades do cliente.

Em resumo, é possível realizar o cadastro e configuração de todas as verbas a serem utilizadas pelo sistema nesta tela, antes de iniciar o uso do sistema. A gravação das informações na tabela de Verbas (SRV) via esta rotina é feita apenas enquanto a tabela estiver vazia. Após o cadastro de itens na tabela, a manutenção dos dados é feita via rotina padrão do Protheus (SIGAGPE > Atualizações > Definições de Cálculo > Verbas).

Acesse em Importação de Tabelas (RHIMPGEN) > Outras Ações > Geração de Verbas (SRV).

Image Added

Aviso

title	Geração das Verbas

A TOTVS se exime de qualquer responsabilidade no tocante a utilização deste modelo. A configuração disponibilizada é um mero modelo. Toda a validação do cadastro, principalmente das incidências, é de responsabilidade do cliente.

Outras Ações > Exportar CSV e Importar CSV

Foi implementada também as opções de Exportar e Importar a lista de De-Para das verbas padrão (Código Externo, Código Verba, Descrição, Desc.Det.) para um arquivo CSV (delimitado por ponto-e-vírgula) a fim de permitir a edição via editores de planilha facilitando a configuração do relacionamento de De-Para.

Para realizar a importação é necessário utilizar o mesmo arquivo exportado (mesmo nome e leiaute).

A opção Exportar CSV gera um arquivo com toda a lista das verbas padrão carregadas.

A opção Importar CSV funciona permite importar apenas o diferencial (registros com código externo) e a rotina atualizar os dados lidos à tabela de Configuração de Verbas.

Image Added

Card

label	Processamento

Após configuração dos leiautes e De-Para, é possível realizar a importação dos arquivos para o Protheus.

Na tela principal da rotina de Importação de Tabelas (RHIMPGEN), selecione os leiautes dos arquivos que serão processados (possível seleção de vários leiautes) e clique em Confirmar. Será solicitado para informar o diretório onde estão localizados os arquivos para importação.

Image Added

Então, a tela de processamento será aberta. Na aba Perguntas, configure os parâmetros:

ExecAuto?: Se marcado com SIM, a importação de algumas tabelas será feita via rotina automática. A vantagem deste método é que serão feitas todas as validações necessárias para inclusão do registro, a desvantagem é que o tempo de processamento é maior. Se marcado com NÃO, nenhuma rotina automática é executada, tornando o processamento mais rápido, porém, a maioria das validações não são feitas e por este motivo podem ser incluídos registros sem integridade garantida. Parâmetro não é válido para modelos RHIMP, que possui validações fixas.
Erro no Fim?: Se marcado com SIM, ao encontrar uma inconsistência em determinada linha, o processo de importação continua a leitura do arquivo, importando os registros que possuem os dados sem problemas. Se marcado com NÃO, ao constatar a primeira inconsistência, o processo de leitura do arquivo atual é abortado (caso esteja importando mais de um leiaute, incia-se o processamento do próximo arquivo).

Image Added

Na aba Informações, clique em Executar e aguarde o processamento. Um log será emitido somente se houver algum problema na importação, caso contrário ao fim do processamento será retornado à tela inicial da rotina.

Em casos de importação de cálculos (Rescisão, Férias, 13º, Folha) caso a tabela já possua dados é exibida a pergunta Apaga importação de Movimento Anterior?. Confirme caso deseje sobrepor os dados presentes na tabela.

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

Manutenção De - Para:
Nesta opção é possível incluir novos registros de DE-PARA dos campos chaves disponíveis ou ainda alterar os registros previamente cadastrados manualmente ou automaticamente. No caso de tabelas exclusivas, deve sempre ser informado a filial antes do valor, seguido por pipe ("|"), em tabelas compartilhadas o uso da filial é desnecessário.
De-Para Filial:
Nesta opção é possível definir o relacionamento entre a filial do sistema de origem e o protheus. Este processo é necessário apenas se a filial do sistema de origem (definida no arquivo de importação) for diferente da filial do protheus. Caso o arquivo já esteja com a filial correta, não é necessário a criação do DE-Para.
Importante:

O arquivo de importação deve ser delimitado por pipes ("|") tanto no modelo RHIMP quanto no modelo genérico.

Procedimento para Utilização

Após a definição de todos os layouts necessários, na tela principal da integração, deverá selecionar os itens para importação e clicar em "Confirmar".

Será solicitado o diretório onde os arquivos de importação estão armazenados. Após informar, uma nova tela é aberta onde será possível ver o log de importações anteriores e iniciar a importação em curso.

Todos os layouts selecionados são processados na ordem em que foram definidos, portanto, convém cadastrá-los de forma que as dependências entre cadastros sejam atendidas, por exemplo, deve ser importado o cadastro de centro de custos antes do cadastro de funcionários, do contrário a rotina retornará erros de integridade devido a execução por MsExecAuto.

Ao final do processo, na ocorrência de problemas, estes serão exibidos no log de importação.

Pré-Requisitos

Os seguintes cadastros devem existir previamente para que as importações ocorram corretamente:

Cadastro de Processos

Cadastro de Roteiros

Tipos de Ausências (Pode ser cadastrado após a importação de Verbas, pois é dependente deste)
Em alguns casos é executado rotina automática para efetuar a importação, estas rotinas poderão validar o relacionamento de outros cadastros não definidos aqui e que já deveriam ter sido criados no processo de implantação. Neste caso, proceder com o cadastramento dos dados reclamados pela MsExecAuto.

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Ferramenta de Importação Genérica de Tabelas Protheus

Descrição