Histórico da Página
Ferramenta de Importação Genérica de Tabelas Protheus
| Deck of Cards | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Card |
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 layoutleiaute, seja como uma posição no arquivo ou como uma fórmula pré-definida. Ao abrir a tela principal, existirá é exibido um browser com todos os layouts leiautes definidos. Em ações relacionadas existirá uma opção para manutenção (inclusão/alteração) dos layouts.
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). 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. Informações |
Delimitadores Arquivo.txtO sistema realiza a importação das tabelas a partir da leitura de um arquivo de texto delimitado por pipes ("|"). SequênciaO 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 No primeiro acesso, alguns modelos de layout padrão serão criados automaticamente. Esses layouts 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.
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). ExemploNo 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 | | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Outras Ações, há opção Manutenção de Layouts.
A rotina de Manutenção de Layouts possui 2 opções de utilização:
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).
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.
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). ExemploNo leiaute 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:
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.
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.
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.
|
| Card | ||||
|---|---|---|---|---|
| ||||
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.
Após escolher a tabela genérica, o grid será atualizado com a estrutura de campos desta tabela.
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.
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.
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 | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||
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).
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.
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 ("|").
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 ("|").
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.
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.
Leiaute do Arquivo DEPARA - edição em planilha.
Leiaute do Arquivo DEPARA - edição em texto.
|
| Card | |||||
|---|---|---|---|---|---|
| |||||
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.
|
| Card | |||||
|---|---|---|---|---|---|
| |||||
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).
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.
|
| Card | ||
|---|---|---|
| ||
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.
Então, a tela de processamento será aberta. Na aba Perguntas, configure os parâmetros:
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. |
| Card | |||||
|---|---|---|---|---|---|
| |||||
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.
|
| Card | |||||
|---|---|---|---|---|---|
| |||||
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. |
| Card | ||
|---|---|---|
| ||
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:
|
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
|---|
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas