Academy
Fontes de Dados

Etapa Arquivo Excel

A etapa Arquivo Excel importa planilhas nos formatos XLSX, XLS e XLSB para iniciar um fluxo de Preparação de Dados a partir dos dados desse arquivo.

O Arquivo Excel está na categoria Fonte de Dados da barra de ferramentas. Depois de configurar a preparação com ele, você envia os arquivos pela tela de Upload de Arquivos da plataforma Dattos.

Importar a planilha

Há duas formas de carregar o arquivo:

  • Importar Arquivo: abre o explorador de arquivos para você selecionar o arquivo.

  • Arrastar e soltar: arraste o arquivo direto para a tela.

Validação na importação: são aceitos apenas arquivos com extensão XLSX, XLS e XLSB e tamanho máximo de 50 MB.

Configurar a etapa e escolher as abas

Na tela de configuração você encontra:

  • Informações do arquivo: identifica o nome do arquivo importado.

  • Trocar Arquivo: substitui o arquivo importado. Ao importar um novo arquivo, a plataforma oferece manter as configurações já feitas e atualizar apenas a amostra, ou atualizar todas as configurações com base no novo arquivo.

  • Nome: identifica o nome da etapa. Por padrão, vem com o nome do arquivo de amostra importado, mas o campo é editável.

Em seguida, escolha como a plataforma localiza as abas a configurar para leitura:

  • Realizar a leitura considerando o nome da aba: a plataforma busca a aba pelo nome.

  • Realizar a leitura considerando a ordem da aba: a plataforma busca a aba pela ordem. Útil quando o nome da aba pode mudar, mas os dados são os mesmos.

Quando o arquivo tem mais de uma aba, a opção de selecionar abas aparece e permite escolher quais abas configurar. Para cada aba, a tela mostra a Ordem da aba no arquivo, o Nome da aba no arquivo e a Saída (porta de saída de dados usada para conectar as etapas).

Dica: escolha um nome que represente as informações do arquivo e seja fácil de entender para você e seus colegas.

Uma saída por aba: para cada aba importada, conforme a seleção feita, a plataforma gera uma porta de saída.

Abas unificadas: se a opção "Unificar abas em uma única porta de saída" estiver ativa nas configurações avançadas, só é permitido selecionar uma aba como modelo.

Configurar as abas e colunas

Para cada aba selecionada, ajuste a leitura e as colunas:

  • Selecione a aba do Arquivo: escolhe a aba a configurar.

  • Contém Cabeçalho?: determina se o arquivo tem cabeçalho.

  • Iniciar importação de dados na linha / Informe a linha do cabeçalho: define a linha inicial para a leitura dos dados.

  • Ordem da Coluna: mostra a ordem em que as colunas foram importadas; o campo é editável.

  • Nome da Coluna: mostra todas as colunas do arquivo; os nomes podem ser renomeados.

  • Tipo de Dado: Alfanumérico, Numérico ou Data. Para Data, informe o padrão da máscara que a coluna usa. O campo é editável.

  • Amostra: exibe o conteúdo das colunas da primeira linha importada.

  • Adicionar Coluna: inclui colunas manualmente na configuração. Informe a quantidade e clique no botão; a nova linha abre para preencher Ordem (editável), Nome na Origem (editável), Amostra (vem nula e não é editável) e Tipo de Dados (Alfanumérico, Numérico ou Data).

  • Ícone Excluir Coluna: remove uma coluna da configuração da aba.

Use Fechar para sair sem salvar e voltar ao Designer, ou Salvar para guardar as configurações.

Configurações avançadas

  • Separador decimal para converter texto em número: Vírgula ( , ) ou Ponto ( . ), conforme o separador usado no arquivo. Por exemplo, um conteúdo "100,99" lido como número precisa do separador Vírgula; "100.99" precisa do separador Ponto. Em ambos os casos o resultado exibido é "100,99".

  • Adicionar como coluna o nome da fonte de dados: acrescenta à amostra uma coluna com o nome da etapa.

  • Adicionar como coluna o nome do arquivo: acrescenta à amostra uma coluna com o nome do arquivo importado.

  • Adicionar como coluna o nome da aba: acrescenta à amostra uma coluna com o nome da aba da saída de dados.

  • Unificar abas em uma única porta de saída: use quando a estrutura das colunas é idêntica em todas as abas ou quando quiser tratar todas as abas como uma única tabela na saída da etapa.

Ao unificar abas: com "Unificar abas em uma única porta de saída" ativo, ao escolher as abas para leitura só é permitido selecionar uma aba como modelo.

Artigos relacionados

  • Configurar Preparação de Dados

  • Etapa Arquivo OFX

  • Etapa Arquivo Texto

Isso foi útil?