Ir para o conteúdo

Importar do Excel para o Jitterbit App Builder

O App Builder suporta a capacidade de importar dados do Microsoft Excel. Existem dois métodos diferentes que você pode usar para importar do Excel; dependendo do seu cenário de caso de uso, você pode selecionar qual é o melhor para suas necessidades. Ambas as opções de importação do Excel são descritas neste artigo.

O App Builder requer que as colunas no arquivo Excel que está sendo enviado estejam alinhadas aos valores de Cabeçalho de Coluna definidos na estrutura da Tabela do App Builder que está sendo alvo da importação (ou criada se for uma nova Tabela). O App Builder também exige que os valores do Cabeçalho do Excel apareçam na primeira linha do arquivo Excel.

Ao importar dados do Excel, o App Builder assume que as informações sendo importadas residem na primeira aba do arquivo Excel resultante. Neste momento, você não pode especificar uma aba diferente no arquivo Excel para importar.

Nota

Se você está procurando construir uma solução robusta para acomodar a importação de dados de um arquivo plano, veja o Processo de importação de arquivo repetível.

Usar planilha do Excel para importar uma tabela

  1. Após acessar o assistente de Tabela, selecione a opção Planilha do Excel
  2. Clique em Próximo
  3. Clique no link Procurar e localize o arquivo a ser enviado
  4. Selecione o arquivo e clique em Abrir
  5. Confirme que o upload está completo e clique em Próximo
  6. Revise as configurações de mapeamento de dados que o App Builder usará para importar o arquivo e faça as alterações necessárias:

    1. Nome da Tabela = nome que será atribuído à Tabela
    2. Tipo de Arquivo = representa a extensão do arquivo para upload. Pode ser .csv, .txt, .xls, .xlsm ou .xlsx
    3. Tipo de Delimitador = usado para CSV e é tipicamente uma vírgula; se você estiver importando do Excel, isso será ignorado
    4. Contém Cabeçalho = campo booleano que indica se o arquivo contém uma linha de cabeçalho
    5. Linha do Cabeçalho = campo numérico que indica a linha que representa os valores do Cabeçalho
    6. Linha de Dados Inicial = campo numérico que indica a linha onde os valores de dados começam
    7. Personalizar Colunas = As opções incluem Automático ou Personalizar. O padrão é Automático.

      • Se você selecionar Personalizar e clicar em Avançar, poderá verificar se os nomes das colunas e os tipos de dados estão corretos, além de visualizar as primeiras linhas da importação. Clique em Anterior para corrigir quaisquer problemas com colunas e tipos de dados; caso contrário, clique em Importar.
  7. Clique em Importar

  8. Clique em Criar Página para iniciar o assistente de Criação de Páginas
  9. Primeiro, selecione um Menu para vincular a nova página. Opções:

    1. Início = a nova página será vinculada a partir da página Inicial
    2. Configuração = a nova página será vinculada sob o menu de Configuração
    3. Relatórios = a nova página será vinculada sob o menu de Relatórios
    4. Nenhum = nenhum link de navegação será gerado para a nova página
  10. Clique em Avançar

  11. Revise os Tipos de Painel disponíveis e selecione a opção desejada

    1. Clique em Anterior se forem necessárias modificações
  12. Clique em Avançar para prosseguir

  13. as atualizações que o App Builder fará com base nas informações fornecidas

    1. Clique em Anterior se forem necessárias modificações
  14. Clique em Criar Páginas

Importar via uma opção de evento

Se você tiver um feed de dados regular que precisa ser atualizado, importar do Excel via um Evento é a opção que você deve usar. Aqui, assumiremos que você tem uma Tabela pré-existente definida no App Builder que corresponde à estrutura do arquivo Excel que você deseja importar. As colunas no arquivo Excel devem alinhar-se aos valores de Cabeçalho de Coluna definidos na estrutura da Tabela do App Builder que está sendo alvo da importação. O App Builder também requer que os valores de Cabeçalho do Excel apareçam na primeira linha do arquivo Excel.

Recomenda-se criar um modelo de Excel com os cabeçalhos corretos, colar os dados que você deseja importar sob esses cabeçalhos e, em seguida, trazê-los para o sistema usando o Plugin de Importação do App Builder.

Os seguintes pré-requisitos devem ser configurados para importar um arquivo Excel para o App Builder:

  1. Criar o Servidor de Sistema de Arquivos (local ou de rede) para armazenar o(s) arquivo(s)
  2. Criar o Armazenamento de Dados para armazenar temporariamente os dados
  3. Vincular o Armazenamento de Dados à aplicação para a qual você estará importando

Para ajuda na configuração do Sistema de Arquivos, consulte o artigo sistema de arquivos do App Builder.

Uma vez que os pré-requisitos estejam configurados, você pode configurar um Evento e uma Ação para executar a importação do arquivo Excel.

  1. Crie um Evento (por exemplo, chamado Importar)
  2. Crie uma Ação associada com as seguintes configurações:

    • Tipo: Importar
    • Tipo de Importação: tipo de arquivo que você está importando. Isso é CSV ou Excel para Excel
    • Sistema de Arquivos: a fonte de dados do sistema de arquivos de onde você estará lendo o arquivo
    • Truncar: se marcado, esta configuração irá deletar o conteúdo da tabela de destino
    • Tabela de Destino: a tabela onde os registros serão armazenados
    • Delimitador: usado para CSV e é tipicamente uma vírgula; se você estiver importando Excel, deixe isso em branco
    • Fonte de Dados Completa: local do arquivo onde o arquivo de importação será movido. Normalmente, este é o mesmo valor que o Sistema de Arquivos.

Nota

A Ação de Importação consumirá todos os arquivos no caminho do diretório/pasta quando executada. Selecionar a opção 'Truncar' irá deletar os registros na tabela após cada arquivo ser importado. Se você deseja preservar os registros de todos os arquivos após a execução, certifique-se de que a opção de configuração 'Truncar' não esteja selecionada.