Extrair planilha de arquivo Excel usando n8n Ação
PDF4me Extrair planilhas do Excel Converte planilhas inteiras de pastas de trabalho do Excel em planilhas estruturadas. JSON através n8n Fluxos de trabalho de automação. Processar arquivos do Excel via n8n gatilhos, dados binários, strings base64 ou públicos URLs Extrair dados completos de planilhas com detecção automática de cabeçalho, seleção flexível de planilhas por nome ou índice, suporte a múltiplas planilhas e preservação do tipo de dados. Esta solução é ideal para exportação completa de dados e processamento de múltiplas planilhas. API integração, migração de banco de dados e conversão completa de Excel paraJSON Fluxos de trabalho de transformação que exigem extração completa da planilha com saída estruturada e integração perfeita.
Configurar
Adicione o PDF4me O nó "Extrair Planilhas" para o seu n8n fluxo de trabalho e configure os parâmetros necessários. Para obter instruções de configuração inicial, consulte nosso n8n Guia de integração.
Pré-requisitos:
- PDF4me API credenciais
- n8n acesso ao fluxo de trabalho
Configuração:
- Adicionar PDF4me nó para fluxo de trabalho
- Selecione a ação "Extrair planilha do arquivo Excel".
- Configure os parâmetros de entrada (veja abaixo)

Parâmetros
Lista completa de parâmetros para a ação Extrair Planilhas. Configure esses parâmetros para controlar a extração de planilhas.
Importante: Os parâmetros marcados com um asterisco (***) são obrigatórios e devem ser fornecidos para que a ação funcione corretamente.
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| Tipo de dados de entrada*** | String | Seleção do formato de entrada do Excel • Escolha o formato da sua entrada de dados no Excel. • PDF4me Suporta vários tipos de entrada • Opções: Dados binários, Base64 Corda, ou URL | Binary Data |
| Campo binário de entrada*** | Binário | Entrada de arquivo Excel binário (Obrigatório se os dados forem binários) • Consulte o arquivo Excel de referência (.xlsx, .xls) anterior. n8n upload de nó ou arquivo • PDF4me Processa arquivos binários do Excel com detecção automática de formato. • Obrigatório quando o tipo de dados de entrada for "Dados binários" | {{ $binary.data }} |
| Conteúdo do Excel em Base64*** | String | Base64 Entrada codificada do Excel (Obrigatório se for uma string Base64) • Fornecer conteúdo do Excel (.xlsx, .xls) como uma string codificada em base64 • PDF4me Decodifica e processa automaticamente o conteúdo do Excel. • Obrigatório quando o tipo de dados de entrada for "Base64 Corda" | UEsDBBQABgAI... |
| URL do Excel*** | String | Excel público URL Entrada (Obrigatório se for URL) • Fornecer uma permissão pública/aberta URL para o arquivo Excel (.xlsx, .xls) • PDF4me Baixa e processa o arquivo Excel fornecido. URL • Obrigatório quando o tipo de dados de entrada for "URL" | https://abc.com/data.xlsx |
| Nome do Excel*** | String | Nome do arquivo de entrada do Excel • Especifique o nome do arquivo Excel de entrada com a extensão correta (.xlsx, .xls) • PDF4me Isso é usado para detecção de formato e otimização de processamento. | data.xlsx |
| Nomes das folhas de exercícios | String | Nomes de planilhas separados por vírgulas • Lista de nomes de planilhas a serem extraídas • Formato: "Planilha1,Resumo,Relatório" • Lógica de SeleçãoSe fornecidos → Extrair as planilhas com os nomes especificados. Se WorksheetNames e WorksheetIndexes forem fornecidos → Extrair as planilhas que correspondem a QUALQUER UM DOS DOIS (união). Se NENHUM DOS DOIS for fornecido → Extrair TODAS as planilhas. • Nomes de planilhas que diferenciam maiúsculas de minúsculas | Employees,Sales |
| Índices de planilhas | String | Índices separados por vírgula (baseados em 0) • Lista de índices de planilhas a serem extraídos • Formato: "0,1,2" (Índice 0 = primeira folha, Índice 1 = segunda folha, etc.) • Lógica de SeleçãoSe fornecido → Extrai as planilhas indexadas. Se ambos os parâmetros forem fornecidos → Extrai as planilhas que correspondem a QUALQUER UM (união). • indexação baseada em 0Índice 0 = primeira folha de exercícios | 0,2,4 |
Saída
Parâmetros de saída
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| nomeDoArquivoJson | String | JSON nome do arquivo de saída - O nome do gerado JSON arquivo contendo dados extraídos da planilha | excel_extracted.json |
| NomeDoArquivo txt | String | nome do arquivo de saída TXT - O nome do arquivo TXT gerado contendo os dados extraídos da planilha | excel_extracted.txt |
| tamanho do arquivo JSON | Número | JSON tamanho do arquivo em bytes - O tamanho do JSON arquivo de saída em bytes | 206933 |
| Tamanho do arquivo txt | Número | Tamanho do arquivo TXT em bytes - O tamanho do arquivo de saída TXT em bytes | 206933 |
| sucesso | Boolean | PDF4me status da operação - Boolean Sinalizador indicando o sucesso ou a falha do processo de extração da planilha. PDF4me retornos true para operações bem-sucedidas e false para quaisquer erros | true |
| nome_do_arquivo_original | String | Nome do arquivo original do documento Excel - O nome do arquivo de documento Excel de entrada | myExcelFile.xlsx |
| extrairPor | String | Método de extração - O método utilizado para identificar as planilhas para extração. Valores: "nome" se extraídas pelos nomes das planilhas, "índice" se extraídas pelos índices das planilhas. | name |
| Nomes das planilhas | String | Nomes das planilhas extraídos - Lista de nomes de planilhas extraídos, separados por vírgulas. | Sheet2 |
| dados analisados | Object | Dados da planilha analisados - Object Contém dados extraídos de planilhas com os nomes das planilhas como chaves e matrizes de objetos de linha como valores. Cada objeto de linha contém cabeçalhos de coluna como chaves e valores de célula como valores. | {"Sheet2": [{"First Name": "Dulce", "Age": 32}]} |
| mensagem | String | Mensagem da operação - Mensagem descritiva indicando o resultado da operação de extração da planilha, incluindo os nomes das planilhas e o método de extração. | Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs |
N8N Resposta à ação
O PDF4me Extrair planilha de arquivo Excel API Retorna uma resposta que pode ser visualizada em vários formatos. Escolha a visualização que melhor se adapta às suas necessidades:
- JSON
- Table
- Schema
- Binary
JSON Formato de resposta
O bruto JSON resposta do API:
[
{
"jsonFileName": "excel_extracted.json",
"txtFileName": "excel_extracted.txt",
"jsonFileSize": 206933,
"txtFileSize": 206933,
"success": true,
"originalFileName": "myExcelFile.xlsx",
"extractBy": "name",
"worksheetNames": "Sheet2",
"parsedData": {
"Sheet2": [
{
"": 1,
"First Name": "Dulce",
"Last Name": "Abril",
"Gender": "Female",
"Country": "United States",
"Age": 32,
"Date": "15/10/2017",
"Id": 1562
},
{
"": 2,
"First Name": "Mara",
"Last Name": "Hashimoto",
"Gender": "Female",
"Country": "Great Britain",
"Age": 25,
"Date": "16/08/2016",
"Id": 1582
},
{
"": 3,
"First Name": "Philip",
"Last Name": "Gent",
"Gender": "Male",
"Country": "France",
"Age": 36,
"Date": "21/05/2015",
"Id": 2587
}
]
},
"message": "Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs"
}
]
Visualização em tabela
Dados de resposta em formato de tabela estruturada:
| Parâmetro | Valor |
|---|---|
| nomeDoArquivoJson | excel_extracted.json |
| NomeDoArquivo txt | excel_extracted.txt |
| tamanho do arquivo JSON | 206933 |
| Tamanho do arquivo txt | 206933 |
| sucesso | true |
| nome_do_arquivo_original | myExcelFile.xlsx |
| extrairPor | name |
| Nomes das planilhas | Sheet2 |
| dados analisados | Objeto com nomes de planilhas como chaves e matrizes de linhas como valores. |
| mensagem | Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs |
Estrutura de dados analisada:
| Nome da folha de exercícios | Dados da linha |
|---|---|
| Folha 2 | Array de objetos de linha com cabeçalhos de coluna como chaves |
Nota: A ação retorna duas saídas binárias - data_json (JSON formato) e data_txt (formato TXT), ambos contendo os mesmos dados extraídos da planilha. O parsedData O objeto fornece acesso direto aos dados extraídos no JSON resposta.
Visão do esquema
A estrutura de dados e os tipos de resposta:
1 item
jsonFileName: T excel_extracted.json
txtFileName: T excel_extracted.txt
jsonFileSize: # 206933
txtFileSize: # 206933
success: ☑ true
originalFileName: T myExcelFile.xlsx
extractBy: T name
worksheetNames: T Sheet2
parsedData: {} Object
Sheet2: [] Array
[0]: {} Object
"": # 1
First Name: T Dulce
Last Name: T Abril
Gender: T Female
Country: T United States
Age: # 32
Date: T 15/10/2017
Id: # 1562
[1]: {} Object
"": # 2
First Name: T Mara
Last Name: T Hashimoto
Gender: T Female
Country: T Great Britain
Age: # 25
Date: T 16/08/2016
Id: # 1582
[2]: {} Object
"": # 3
First Name: T Philip
Last Name: T Gent
Gender: T Male
Country: T France
Age: # 36
Date: T 21/05/2015
Id: # 2587
message: T Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs
Indicadores de tipo:
T= String (Texto)#= Número☑= Boolean[]= Array{}= Object
Visualização de Dados Binários
Os dados extraídos da planilha são retornados como dois arquivos binários - um em JSON um em formato e outro em formato TXT:
data_json
─────────────────────────────
File Name: excel_extracted.json
File Extension: json
Mime Type: application/json
File Size: 207 kB
data_txt
─────────────────────────────
File Name: excel_extracted.txt
File Extension: txt
Mime Type: text/plain
File Size: 207 kB
Ambos os arquivos binários contêm os mesmos dados extraídos da planilha em formatos diferentes. parsedData objeto no JSON A resposta fornece acesso direto aos dados estruturados sem a necessidade de analisar os arquivos binários.
Acesso a dados binários:
- JSON Objeto Binário:
$binary.data_json.data - Objeto binário TXT:
$binary.data_txt.data - Base64 ContenteDisponível para uso direto em ambos os formatos.
- Operações com arquivosPronto para download, envio por e-mail ou armazenamento.
Casos de uso
Exportação e migração completa de dados
- Extrair planilhas inteiras do Excel como JSON para migrações de sistemas, arquivamento de dados e operações de backup.
- Converter arquivos Excel com várias planilhas para JSON formato para armazenamento em nuvem e importação de banco de dados
- Exporte os dados completos da planilha para API integração e sincronização entre sistemas
Processamento e análise de múltiplas folhas
- Extraia várias planilhas simultaneamente para processamento paralelo em n8n fluxos de trabalho
- Processar diferentes abas de planilha com diferentes lógicas de negócios e transformações.
- Integre dados completos da planilha com fontes externas. APIs e plataformas de análise de dados
Inteligência de Negócios e Integração de Dados
- Exportar dados do Excel para JSON para ferramentas de inteligência de negócios e plataformas de análise
- Converter relatórios do Excel em formatos estruturados JSON para relatórios automatizados e atualizações de painéis
- Integre dados do Excel com CRM sistemas, bancos de dados e serviços em nuvem