Histórico da Página
Ferramenta de Importação Genérica de Tabelas Protheus
Deck of Cards | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Card | | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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. |
---|