Comando IMPORT MULTIEXCEL

Informações do conceito

Importar dados do Microsoft Excel

Cria várias tabelas do Analytics definindo e importando várias planilhas ou intervalos nomeados do Microsoft Excel.

Sintaxe

IMPORT MULTIEXCEL <TO pasta_importação> FROM {nome_arquivo_origem|pasta_origem} TABLE planilhas_intervalos_nomeados_entrada <PREFIX> <KEEPTITLE> <CHARMAX tamanho_máximo_do_campo>

Nota

Você deve especificar os parâmetros de IMPORT MULTIEXCEL exatamente na mesma ordem mostrada acima e na tabela abaixo.

O Analytics não conseguirá importar uma pasta de trabalho do Excel se o Modo de Exibição Protegido do Excel estiver ativo nessa pasta. Você precisa habilitar a edição na pasta de trabalho, salvá-la e fechá-la antes de fazer a importação.

Parâmetros

Nome Descrição
TO pasta_importação

opcional

A pasta onde os dados serão importados.

Para especificar a pasta, use um caminho de arquivo absoluto ou relativo à pasta que contém o projeto do Analytics. Especifique pasta_importação como uma cadeia entre aspas.

Exemplo

TO "C:\Auditoria de pontos de venda\Dados\Dados de trabalho das transações"
TO "Dados\Dados de trabalho das transações"

Se você omitir TO, os dados serão importados na pasta que contém o projeto do Analytics.

FROM nome_arquivo_origem | pasta_origem

O nome do arquivo ou dos arquivos de dados de origem, ou a pasta que contém esses arquivos.

Especifique nome_arquivo_origem ou pasta_origem como uma cadeia entre aspas.

Arquivo ou arquivos de dados de origem na pasta raiz do projeto do Analytics

  • único arquivo Excel

    Especifique o nome e a extensão do arquivo completos.

    Exemplo

    FROM "Transações_AF18.xlsx"
  • vários arquivos Excel

    Para especificar vários arquivos, use um curinga (*) no lugar de caracteres únicos em nomes de arquivos. O caractere curinga representa zero (0) ou mais ocorrências de qualquer letra, número ou caractere especial.

    Exemplo

    FROM "Transações_AF*.xlsx"

    seleciona:

    Transações_FY18.xlsx

    Transações_FY17.xlsx

    Você pode usar um curinga em mais de um local em um nome de arquivo e em uma extensão de arquivo.

    Exemplo

    FROM "Transações_AF*.*"

    seleciona:

    Transações_FY18.xlsx

    Transações_FY17.xls

Arquivo ou arquivos de dados de origem fora da pasta raiz do projeto do Analytics

Se o arquivo ou os arquivos de dados de origem não estão localizados na mesma pasta do projeto do Analytics, você deve usar um caminho de arquivo absoluto ou relativo à pasta que contém o projeto para especificar a localização dos arquivos.

Exemplo

FROM "C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações\Transações_AF18.xlsx"
FROM "Dados\Arquivos mestre de transações\Transações_AF*.xlsx"

Pasta que contém o arquivo ou os arquivos de dados de origem

Em vez de especificar um nome de arquivo, basta especificar o nome da pasta que contém o arquivo ou os arquivos de dados de origem.

Para especificar uma pasta de dados de origem, use um caminho de arquivo absoluto ou relativo à pasta que contém o projeto do Analytics.

Exemplo

FROM "C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações"
FROM "Dados\Arquivos mestre de transações"

Nota

Quando você especifica uma pasta, todas as planilhas de todos os arquivos do Excel da pasta com um nome de planilha correspondente ao valor de TABLE serão importados.
TABLE planilhas_intervalos_nomeados_entrada

O nome das planilhas ou intervalos nomeados a importar. Uma tabela do Analytics separada é criada para cada planilha ou intervalo nomeado importado.

Especifique planilhas_intervalos_nomeados_entrada como uma cadeia entre aspas.

Use um curinga (*) no lugar de caracteres únicos em nomes de planilhas ou intervalos.

Por exemplo, "Trans_*$" seleciona as seguintes planilhas:

  • Trans_Jan
  • Trans_Fev
  • Trans_Mar
  • e assim por diante

Nota

O caractere curinga (*) representa zero (0) ou mais ocorrências de qualquer letra, número ou caractere especial.

Você pode usar um curinga em mais de um local. Por exemplo, *Trans*$ seleciona:

  • Trans_Jan
  • Jan_Trans

O significado do símbolo de dólar ($)

Em um arquivo do Excel, as planilhas são identificadas por um símbolo de dólar ($) acrescentado no nome da planilha (Trans_Jan$). O símbolo de dólar não é visível no Excel.

Os intervalos nomeados são identificados pela ausência de um símbolo de dólar (Trans_Jan_comercial).

Não é necessário especificar o símbolo de dólar ao usar IMPORT MULTIEXCEL. No entanto, você deve incluí-lo, ou excluí-lo, nas seguintes situações:

  • Incluir "$" se você quer importar apenas planilhas, e nenhum intervalo nomeado, inclua o símbolo de dólar no final do nome da planilha
  • Excluir "$" se você quer importar intervalos nomeados, ou planilhas e intervalos nomeados, em uma única operação de importação, não inclua o símbolo de dólar

PREFIX

opcional

Adicione o nome do arquivo do Excel ao início do nome das tabelas do Analytics.

Dica

Se planilhas em arquivos diferentes tiverem o mesmo nome, a anexação do nome do arquivo do Excel permitirá evitar conflitos entre os nomes das tabelas.
KEEPTITLE

opcional

Trate a primeira linha de dados como nomes de campos em vez de dados. Se omitida, serão usados nomes de campo genéricos.

Nota

Todas as primeiras linhas das planilhas e intervalos nomeados importados devem usar uma abordagem consistente. As primeiras linhas devem ser nomes de campos, ou dados, em todos os conjuntos de dados. Evite misturar as duas abordagens em uma única operação de importação.

Se os conjuntos de dados tiverem uma abordagem inconsistente nas primeiras linhas, use duas operações de importação separadas.
CHARMAX tamanho_máximo_do_campo

opcional

O tamanho máximo em caracteres de qualquer campo em uma tabela do Analytics originada como dados de caracteres em um arquivo de dados de origem no Excel.

Dados no arquivo do Excel que ultrapassem o comprimento máximo do campo são truncados quando importados para o Analytics.

A habilidade de truncar campos evita que valores ocasionalmente longos expandam o tamanho geral do registro além do que é suportado pelo processo de importação:

  • 32.767 caracteres (Analytics versão não Unicode)

  • 16.383 caracteres (Analytics versão Unicode)

Exemplos

Os exemplos abaixo supõem que você tem dados de transações mensais de três anos armazenados em três arquivos do Excel:

  • Transações_FY18.xlsx
  • Transações_FY17.xlsx
  • Transações_FY16.xlsx

Cada arquivo do Excel tem 12 planilhas, uma para cada mês do ano. As planilhas também incluem alguns intervalos nomeados que identificam vários subconjuntos de transações.

Nota

Uma tabela do Analytics separada será criada para cada planilha ou intervalo nomeado que você importar.

Importar planilhas

Importar todas as planilhas de AF18

Você quer importar todas as 12 planilhas mensais do arquivo do Excel AF18 e ignorar todos os intervalos nomeados.

  • use o símbolo de curinga (*) onde o nome do mês ocorre em cada nome de planilha
  • inclua o símbolo de dólar ($) no fim do nome da planilha para selecionar apenas planilhas e nenhum intervalo nomeado
IMPORT MULTIEXCEL FROM "Transações_AF18.xlsx" TABLE "Trans_*$"

Importar todas as planilhas de AF18, manter os nomes dos campos e especificar o comprimento máximo dos campos de caracteres

Este exemplo é o mesmo exemplo acima, mas você quer manter os nomes dos campos dos arquivos do Excel, além de l imitar o comprimento dos campos de caracteres.

  • inclua KEEPTITLE para usar a primeira linha dos dados do Excel como nomes de campos

  • inclua CHARMAX 50 para que os campos originados como dados de caracteres no arquivo do Excel sejam limitados a 50 caracteres na tabela do Analytics resultante

IMPORT MULTIEXCEL FROM "Transações_AF18.xlsx" TABLE "Trans_*$" KEEPTITLE CHARMAX 50

Importar todas as planilhas de todos os três arquivos do Excel

Você quer importar todas as 36 planilhas mensais dos três arquivos do Excel e ignorar todos os intervalos nomeados.

  • use o símbolo de curinga (*) onde o nome do mês ocorre em cada nome de planilha
  • inclua o símbolo de dólar ($) no fim do nome da planilha para selecionar apenas planilhas e nenhum intervalo nomeado
  • use o símbolo de curinga (*) onde o ano ocorre em cada nome de planilha
  • como forma de reduzir a chance de conflitos de nomes, use PREFIX para acrescentar o nome do arquivo do Excel de origem ao início de cada nome de tabela do Analytics
IMPORT MULTIEXCEL FROM "Transações_AF*.xlsx" TABLE "Trans_*$" PREFIX

Importar intervalos nomeados

Importar todos os intervalos nomeados "Transação_comercial" de AF18

Você quer importar todos os intervalos nomeados "Transação_comercial" do arquivo do Excel AF18 e ignorar planilhas e outros intervalos nomeados.

  • use o símbolo de curinga (*) onde um identificador único ocorre em cada nome de planilha
  • exclua o símbolo de dólar ($) para que intervalos nomeados possam ser selecionados
IMPORT MULTIEXCEL FROM "Transações_AF18.xlsx" TABLE "Transação_comercial_*"

Importar planilhas e intervalos nomeados

Importar todas as planilhas e intervalos nomeados de AF18

Você quer importar todas as 12 planilhas mensais e todos os intervalos nomeados do arquivo do Excel AF18.

  • com TABLE, você usa apenas o símbolo de curinga (*) para que todas as planilhas e intervalos nomeados do arquivo sejam selecionados
  • exclua o símbolo de dólar ($) para que intervalos nomeados possam ser selecionados
IMPORT MULTIEXCEL FROM "Transações_AF18.xlsx" TABLE "*"

Gerenciar diretórios

Importar todas as planilhas de todos os arquivos do Excel na pasta especificada

Você quer importar todas as planilhas de todos os arquivos do Excel na pasta C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações.

  • com TABLE, você usa apenas o símbolo de curinga (*) para que todas as planilhas de cada arquivo sejam selecionadas, e o símbolo de dólar ($) para que somente as planilhas sejam selecionadas, sem intervalos nomeados
  • como forma de reduzir a chance de conflitos de nomes, use PREFIX para acrescentar o nome do arquivo do Excel de origem ao início de cada nome de tabela do Analytics
IMPORT MULTIEXCEL FROM "C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações" TABLE "*$" PREFIX

Importar todas as planilhas de todos os arquivos do Excel na pasta especificada e salvar as tabelas do Analytics em outra pasta

Este exemplo é o mesmo exemplo acima, mas em vez de salvar as tabelas do Analytics na pasta raiz do projeto, você quer salvá-las na pasta "C:\Auditoria de pontos de venda\Dados\Dados de trabalho das transações".

IMPORT MULTIEXCEL TO "C:\Auditoria de pontos de venda\Dados\Dados de trabalho das transações" FROM "C:\Auditoria de pontos de venda\Dados\Arquivos mestre de transações" TABLE "*$" PREFIX

Observações

Vários comandos IMPORT EXCEL

O comando IMPORT MULTIEXCEL na verdade executa vários comandos IMPORT EXCEL individuais, um para cada planilha importada. Se você clicar na entrada de IMPORT MULTIEXCEL no log, os comandos IMPORT EXCEL individuais serão exibidos na área de exibição.

A última tabela importada é aberta automaticamente

IMPORT MULTIEXCEL não permite a palavra-chave OPEN. No entanto, após a execução do comando, a última tabela importada é aberta automaticamente.

Combinação de várias planilhas após a importação

Após importar várias planilhas para tabelas do Analytics individuais, você pode combiná-las em uma única tabela do Analytics. Por exemplo, você pode combinar os dados de doze tabelas mensais em uma única tabela anual contendo todos os dados.

Para obter informações sobre como combinar várias tabelas do Analytics, consulte Comando APPEND.