Delimitadores Arquivo.txt

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 layouts criados a partir de modelo geram um registro e os layout criados a partir de Tabela outro.

Modelo

De-Para Automático

De-Para automático está disponível apenas para algumas tabelas/modelos. Ao habilitá-lo, ele será usado apenas para o campo chave principal, ou seja, caso habilite o DE-PARA do Cadastro de Funcionários (SRA), por exemplo, será feito DE-PARA automático apenas do campo (RA_MAT).

Exemplo

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

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

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:

Txt de exemplo

No canto superior direito existe um botão que possibilita a geração de um exemplo de arquivo de texto baseado no layout carregado. Ele poderá ser utilizado apenas quando existir um layout carregado. 

Fórmulas 

Durante a montagem de layouts genéricos será possível definir fórmulas, que poderão ser desde strings fixas, até funções executadas via RDMAKE. Um exemplo de uso para as fórmulas seria, por exemplo, nos campos FILIAL. Supondo que o a FILIAL do Protheus seja "D MG 01" (utilizando gestão de empresas), e a FILIAL do sistema legado, e que foi gravada no arquivo, seja "01". A conversão poderia ser feita tanto pelo DE-PARA de Filial, quando através do campo Fórmula, escrevendo algo como "D MG 01", no caso de existir mais de uma filial, bastaria escrever uma fórmula/função para tratar as diferentes possibilidades. Foram disponibilizadas duas funções para facilitar o desenvolvimento dos layouts: U_Periodo() que retorna o período do registro e U_Processo() que retorna o processo do funcionário do registro atual. Além disso, quando a tabela importada tiver um campo matrícula o sistema automaticamente se posicionará na tabela de funcionário(SRA).

Fórmulas de strings fixas devem estar entre aspas. Exemplo: "D MG 01 ".

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 layout, 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 layout padrão serão criados automaticamente. Esses leiautes disponíveis no campo "Modelo" são referentes aos modelos de importação utilizados na migração de bases de dados Logix, por isso suas posições são 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 layout. Ao selecionar uma tabela, se já existir um layout previamente cadastrado, ele é carregado para alteração. Do contrário um novo layout genérico baseado na ordem dos campos no dicionário de dados (SX3) é gerado. Na getdados é 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 do getdados 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, na tabela será exibido o layout especifico e apenas poderá ser alterado no cabeçalho a Descrição, o Nome do Arquivo, a Sequência e o De-Para automático; no getdados a Fórmula. Image Added
Card
id manut_leiaute label Manutenção de Layouts
Na montagem de layouts genéricos é possível definir quais campos serão importados, sendo que os campos obrigatórios sempre deverão constar no layout, seja como uma posição no arquivo ou como uma fórmula pré-definida. Ao abrir a tela principal, existirá um browser com todos os layouts definidos. Em ações relacionadas existirá uma opção para manutenção (inclusão/alteração) dos layouts. Image Removed   Ao clicar na opção para manutenção de layouts, uma nova tela é aberta onde existirá duas opções principais:  Seleção de uma tabela para definição do layout. Ao selecionar uma tabela, se já existir um layout previamente cadastrado, ele é carregado para alteração, do contrário um novo layout genérico baseado na ordem dos campos no dicionário de dados (SX3) é gerado. Na getdados é 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 TXT, que é baseado na ordem do SX3) e Fórmula (detalhes mais abaixo). Dos campos da tabela será possível alterar a posição e a fórmula. No cabeçalho deve ser informado o Tabela, a Descrição (carregado o nome da tabela no SX2 por padrão), o Nome do Arquivo (arquivo com informações do sistema externo que será importado para o Protheus), a Sequência e o De-Para automaticamente (detalhes mais abaixo). Image Removed 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 TXT, a posição pode ser 0 (ZERO), e na fórmula deve ser informado a empresa: "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 usados 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, na tabela será exibido o layout especifico e apenas poderá ser alterado no cabeçalho a Descrição, o Nome do Arquivo, a Sequência e o De-Para automático; no getdados a Fórmula. Image Removed
Informações
title Importante

A rotina foi preparada para importar dados para as tabelas genéricas que são atualizadas pela Manutenção de Tabelas.

Para realizar a importação de dados para as tabelas genéricas é preciso criar um layout para o tabela RCB(Estrutura das Tabelas Genéricas), quando a RCB for selecionada o campo Tabela Auxiliar ficará ativo possibilitando a escolha de alguma das tabelas genéricas.

Após a escolha da tabela genérica que se deseja importa e a definição do nome do arquivo que será importado o layout será preenchido com os campos da tabela genérica

Os dados das tabelas genéricas ficam gravados na tabela padrão RCC. Assim, a tabela RCB é utilizada para configuração dos leiautes, porém os dados a serem lidos provenientes dos arquivos de importação serão gravados na tabela RCC.

Com isso, foi necessário a inclusão fixa de alguns campos da tabela RCC (tabela alvo) para correta gravação dos dados.

• 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.
• 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 em sua definição de leiaute. Seu preenchimento é opcional.

Ao confirmar, será retornado à tela inicial da rotina e o leiaute estará disponível ao fim da lista, obedecendo o número do campo Sequência

Após a importação utilizando-se do layout cadastrado os registros podem ser visualizados pela Manutenção de Tabelas ou pelo banco de dados na tabela TCC.

Acessar Importação de Tabelas > Outras Ações > Manut. De-Para.

Manutenção de DE-PARA, onde é possível visualizar e alterar todos os registros de DE-PARA existentes, existindo ainda a possibilidade de informar novos registros, para o caso de existir um DE-PARA pré-definido. Para incluir um novo De-Para inclua uma nova linha de registro informando Campo, Chave Externa e Chave Interna.

 No cadastro de DE-PARA é possível criar um relacionamento de valores para quaisquer campos existentes no Protheus.

Supondo que o campo "Tipo de Aviso" (RG_TPAVISO) da tabela de rescisão (SRG) possua características diferentes do sistema gerador do arquivo. Por exemplo, o tamanho do campo no Protheus é 2, enquanto no arquivo enviado será 5. Para possibilitar que a integração realize o DE-PARA deste campo deverá ser seguido os seguintes passos:

• Acessar a opção "Manutenção de DE-PARA" 
• Criar uma nova linha na grid indicando, no nome do campo "RG_TPAVISO", na chave externa deve inserir o valor do campo no arquivo TXT (sistema externo), e a na chave interna o código do Tipo de Aviso 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á o conteúdo correto. Caso a chave não seja encontrada no DE-PARA, o valor original (do arquivo) será truncado e gravado.

O mesmo poderá ser feito para relacionar a empresa e filial, por padrão, os modelos genéricos devem vir preenchidos com a Empresa e Filial do Protheus, entretanto, caso isso não ocorra, pode ser definido um DE-PARA de Filial que será obedecido durante a importação. Para que isso seja possível, os seguintes passos deverão ser seguidos:

• Acessar a rotina "Manutenção de DE-PARA" em "Outras Ações"
• Criar um novo registro, onde o nome do campo deve ser "FILIAL", a "Chave Externa" deverá possuir a empresa e filial definida no TXT separado por pipe ("|"), Ex.: 01|01
• A "Chave Interna" deverá ser preenchida com a empresa e filial correspondente no Protheus, também separada por pipes. Ex.: T1|D MG 01
  
  

Desta forma a importação será feita baseada neste valores. Caso a empresa e filial existente no arquivo seja diferente da empresa e filial do Protheus, e não seja definido um DE-PARA, a importação não ocorrerá.

Também será possível, através do botão "Outras Ações", cadastrar um "DE-PARA Especifico" para os cadastros de "Tipos de Rescisão", "Tipos de Afastamentos" e "Tipos de Aumento Salarial". Através desta rotina será possível definir um DE-PARA de campos cuja origem não são uma tabela fixa padrão do dicionário Protheus.



 

1. • Tipos de Rescisão: Supondo que o Tipo de rescisão do sistema de origem possua características, como tamanho, diferentes do Protheus. Através desta opção será exibido em um grid todos os Tipos de Rescisão cadastrados no Protheus (Tabela S043), com uma coluna para informar o código correspondente no sistema de origem. Ao informar o código do sistema de origem, o DE-PARA será gravado e toda vez que for feita a importação de um arquivo de rescisão, por exemplo, essa tabela será consultada para que o tipo de rescisão seja gravado corretamente.
   • Tipos de Alteração Salarial e Tipos de Afastamento: Como no caso acima, caso os tipo de alteração salarial sejam diferentes dos utilizados no Protheus, poderá utilizar esta opção para que seja exibido todos os tipos existentes no Protheus com possibilidade de fazer o relacionamento do código do sistema de origem com o código Protheus. Desta forma, todas as vezes que for feita a importação de histórico salarial, por exemplo, o código correto será gravado.

Também é possível exportar o cadastro de De/Para para um arquivo delimitado por ponto e vírgula(extensão CSV) para preenchimento por editores de planilha. O layout exportado pode ser importado desde que esteja no mesmo layout do arquivo exportado pela ferramenta.

Acessar > Importação de Tabelas > Outras Ações > Gerar XML.

É possível gerar uma planilha que poderá ser aberta no Excel com todos os campos definidos no layout.

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

É possível gerar uma tabela padrão de verbas com todas as incidências. Na criação, é possível definir para que seja criado um DE-PARA automático, onde poderá associar o código da verba do sistema de origem a cada nova verba que será criada, ou criar o DE-PARA sem valor de origem (o cadastro do código de origem deverá ser feito posteriormente).

É possível exportar o cadastro para um arquivo delimitado por ponto e vírgula(extensão CSV) para que o preenchimento do De/Para seja feito em um editor de planilhas como o Excel. O arquivo exportado pode ser importado após o seu preenchimento.

Após cadastrar os layouts , eles poderão ser selecionados na tela principal. Ao confirmar, será solicitado o diretório onde estão os arquivos para importação e aberta uma tela onde será possível definir os seguintes 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. Parametro não é válido para modelos RHIMP.
• 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. Se marcado com "Não", ao constatar a primeira inconsistência, o processo de leitura do arquivo é abortado.