Pular para o conteúdo principal

Excel para Maker

Em sistemas legados, ainda utiliza-se arquivos .xlsx para gerir uma determinada parte das informações de um sistema. Sendo assim, o processo de migração dessas informações se torna um desafio. Tendo em vista essa problemática, criou-se o plug-in Excel para Maker.

O plug-in tem como principal característica, realizar a criação de tabelas no banco de dados caso não exista e preenche-lás com as informações contidas nas folhas correntes do arquivo que está sendo importado.

Considerações Importantes!​

Para que a utilização do plug-in tenha efetividade e os dados sejam migrados é necessário seguir as especificações descritas abaixo:

  • Cada folha do arquivo Excel se tornará uma tabela no banco de dados e cada coluna do arquivo um campo da tabela. A tabela a ser criada sempre seguirá a padronização de criação de tabelas da IDE MAKER5.

    Exemplo: Suponhamos que o projeto que estará importando o arquivo tenha a sigla MKR e a folha do arquivo tenha a nomenclatura PESSOAS, então a tabela possuirá o nome MKR_PESSOAS e suas respectivas colunas terão o nome MKR_PES_NOMEDACOLUNA.

  • Como o plug-in criará uma nova tabela no banco de dados é essencial que o arquivo possua as seguintes características:

    • O nome de cada folha do arquivo representará o respectivo nome da tabela criada no banco de dados, caso não exista.
    • A primeira linha do arquivo deve representar as colunas que serão criadas para a tabela.
    • A segunda linha do arquivo representará o tipo de dado para cada coluna, caso identificada na leitura do arquivo.
    • É de fundamental importância que essas duas primeiras linhas estejam preenchidas para o correto funcionamento do plug-in.

image1357.jpg

  • O plug-in utiliza a biblioteca da Apache POI para realizar a leitura do arquivo .xlsx e a mesma na sua especificação informa as limitações de uso que podem ser consultadas aqui. Sendo assim, é importante o desenvolvedor verificar se possuí memória RAM suficiente alocada para o servidor de aplicações, pois quanto maior for o tamanho do arquivo, maior será a necessidade de memória RAM, caso contrário uma exceção OutOfMemoryError pode ser ocasionada.

Tipo de dados​

  • Os tipos de dados que podem ser convertido para a tabela, são:
    • Letras
    • Numérico
    • Data
    • Lógico

Utilização do Plug-In​

Abaixo segue a exemplificação da utilização do plug-in.

  1. Na tela inicial da IDE Maker localize a aba Plug-in -> Excel para Maker

image1357.jpg Imagem 1 - Interface do Maker 5.

  1. Será aberta a interface do Plug-in.
  2. A opção para sobrescrever os dados por padrão é verdadeira, sendo assim, caso a tabela exista os dados serão apagados e inseridos novamente pelas informações contido no arquivo, caso contrário, apenas acrescidos.
  3. Para iniciar o processo de migração basta clicar no botão Upload e carregar o arquivo para que o processo de migração seja iniciado.

image1357.jpg Imagem 2 - Interface do Maker 5 - Plugin Excel para Maker.

  1. Caso a migração seja realizada com sucesso, a IDE Maker criará o(s) formulário(s) correspondente(s) para cada tabela criada no banco de dados.

image1357.jpg Imagem 3 - Interface do Maker 5 - Retorno do Plugin.

Observações:​

1- Caso já tenha realizado a migração e exista a necessidade de importar o arquivo novamente, após a efitividade da migração a IDE Maker criará novamente o(s) formulário(s).

2- Somente arquivo com a extensão .xlsx é permitida.

3- A maioria das exceções são tratadas pelo plug-in, sendo assim, caso ocorra alguma inconsistência após o processo de migração consulte o log da aplicação.

4- Os tipos de dados devem ser correspondentes para as linhas correntes, ou seja, não se deve ter para a mesma coluna um tipo de dado numérico e uma data.