Extrair linhas de uma planilha do Excel usando n8n Ação

PDF4me Extrair linhas Converte qualquer fatia de planilha em um arquivo pronto para uso. JSON dentro de n8nEspecifique intervalos de linhas/colunas com base zero, decida se a primeira linha deve se tornar cabeçalho, ignore linhas ocultas ou vazias e escolha se os valores devem permanecer tipados (números, booleanos, etc.). ISO datas) ou forçado a texto. Ideal para inserir dados do Excel em APIs, bancos de dados ou adicionais PDF4me ações.

Artigos relacionados no blogue

Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.

Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.

Visite o blogue →

Configurar

Adicione o PDF4me Adicione o nó “Extrair linhas” ao 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

Get Your API Key

Configuração

1. Adicione o PDF4me nó para o fluxo de trabalho
2. Selecione a ação "Extrair linhas da planilha do Excel".
3. Forneça a fonte Excel e a janela de extração.

Parâmetros

Importante: Os parâmetros marcados com um asterisco (***) são obrigatórios. Os índices de linha/coluna são Baseado em 0 (Linha 0 = Linha 1 do Excel).

Parâmetro	Tipo	Descrição	Exemplo
Tipo de dados de entrada***	String	Seletor de origem do Excel (Binary Data, Base64 String, URL).	Binary Data
Campo binário de entrada***	Binário	Necessário quando Binary Data está selecionado.	{{ $binary.data }}
Conteúdo do documento Base64***	String	Necessário quando Base64 String está selecionado.	UEsDBBQAAAA...
URL do documento***	String	Necessário quando URL está selecionado. Link para o arquivo público.	https://files.example.com/report.xlsx
Nome do arquivo***	String	Nome lógico da pasta de trabalho com extensão.	analytics.xlsx
Nome da folha de exercícios	String	Folha de exercícios para leitura. Em branco = primeira folha.	Summary
Primeira fila***	Número	Linha inicial baseada em zero para extração.	0
Última fila	Número	Linha final baseada em 0. Use -1 para ler até a última linha de dados.	-1
Primeira coluna	Número	Coluna inicial baseada em 0 (0 = coluna A).	0
Última coluna	Número	Coluna final baseada em 0. Use -1 para a última coluna de dados.	-1
Possui linha de cabeçalho	Boolean	true usa First Row como cabeçalhos de coluna e os exclui dos dados.	true
Excluir linhas ocultas	Boolean	Ignore as linhas que estão ocultas no Excel.	false
Excluir colunas ocultas	Boolean	Ignorar colunas ocultas.	false
Excluir linhas vazias	Boolean	Remova as linhas onde todas as células estão vazias.	true
Exportar células vazias	Boolean	Inclua células vazias com valores de string vazios em vez de omiti-las.	false
Exportar valores como texto	Boolean	Forçar todos os valores a serem strings. false Preserva os tipos nativos.	false
Nome da saída de dados binários***	String	Slot binário que armazena dados serializados. JSON (PDF4me retornos JSON bytes).	document

Saída

Parâmetros de saída

Parâmetro	Tipo	Descrição	Exemplo
sucesso	Boolean	PDF4me status da operação - Boolean Sinalizador indicando o sucesso ou a falha do processo de extração de linhas. 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
Nome da planilha	String	Nome da folha de exercícios - O nome da planilha da qual as linhas foram extraídas.	First Worksheet
temHeaderRow	Boolean	Status da linha de cabeçalho - Indica se a primeira linha foi tratada como cabeçalho. true se cabeçalhos fossem usados, false de outra forma	true
primeiraLinha	Número	Índice da primeira linha (baseado em 0) - O índice baseado em 0 da primeira linha extraída	0
últimaLinha	Número	Último índice de linha (baseado em 0) - O índice baseado em zero da última linha extraída. -1 indica extração até a última linha de dados	2
primeira coluna	Número	Índice da primeira coluna (baseado em 0) - O índice baseado em 0 da primeira coluna extraída (0 = coluna A)	0
últimaColuna	Número	Índice da última coluna (baseado em 0) - O índice baseado em zero da última coluna extraída. -1 indica extração até a última coluna de dados	-1
excluirLinhasVazias	Boolean	Exclusão de linhas vazias - Indica se as linhas vazias foram excluídas. true se excluído, false se incluído	true
excluirLinhasOcultas	Boolean	Exclusão de linha oculta - Indica se as linhas ocultas foram excluídas. true se excluído, false se incluído	true
excluir colunas ocultas	Boolean	Exclusão de coluna oculta - Indica se colunas ocultas foram excluídas. true se excluído, false se incluído	true
exportarValoresComoTexto	Boolean	Modo de exportação de texto - Indica se os valores foram exportados como texto. true se forçado a usar cordas, false se os tipos nativos forem preservados	false
exportarCélulasVazias	Boolean	Exportação de célula vazia - Indica se células vazias foram exportadas. true se incluídas com strings vazias, false se omitido	false
exportAsObject	Boolean	Modo de exportação de objetos - Indica se os dados foram exportados em formato de objeto.	false
formato de hiperlink	String	Formato de hiperlink - Formato utilizado para hiperlinks nos dados extraídos. Valores: "Texto", "URL", etc.	Text
cultura	String	Código de cultura/localidade - Código cultural utilizado para extração de dados (ex.: "en-US", "de-DE", "fr-FR")	en-US
linhasExtraídas	Número	Número de linhas extraídas - O número total de linhas que foram extraídas com sucesso.	1
dados extraídos	Object	Objeto de dados extraído - Objeto aninhado contendo os dados da linha extraídos com o array rowData	{"rowData": [{"Column1": 1, "First Name": "Dulce"}]}
mensagem	String	Mensagem da operação - Mensagem descritiva indicando o resultado da operação de extração de linhas, incluindo o número de linhas extraídas e o nome da planilha.	Successfully extracted 1 row(s) from worksheet 'First Worksheet'

N8N Resposta à ação

O PDF4me Extrair linhas de uma planilha do 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

JSON Formato de resposta

O bruto JSON resposta do API:

[
{
"success": true,
"originalFileName": "myExcelFile.xlsx",
"worksheetName": "First Worksheet",
"hasHeaderRow": true,
"firstRow": 0,
"lastRow": 2,
"firstColumn": 0,
"lastColumn": -1,
"excludeEmptyRows": true,
"excludeHiddenRows": true,
"excludeHiddenColumns": true,
"exportValuesAsText": false,
"exportEmptyCells": false,
"exportAsObject": false,
"hyperlinkFormat": "Text",
"culture": "en-US",
"rowsExtracted": 1,
"extractedData": {
"document": null,
"fileName": null,
"success": true,
"errorMessage": null,
"rowData": [
{
"Column1": 1,
"First Name": "Dulce",
"Last Name": "Abril",
"Gender": "Female",
"Country": "United States",
"Age": 32,
"Date": "15/10/2017",
"Id": 1562
},
{
"Column1": 2,
"First Name": "Mara",
"Last Name": "Hashimoto",
"Gender": "Female",
"Country": "Great Britain",
"Age": 25,
"Date": "16/08/2016",
"Id": 1582
}
]
},
"message": "Successfully extracted 1 row(s) from worksheet 'First Worksheet'"
}
]

Table

Visualização em tabela

Dados de resposta em formato de tabela estruturada:

Parâmetro	Valor
sucesso	true
nome_do_arquivo_original	myExcelFile.xlsx
Nome da planilha	First Worksheet
temHeaderRow	true
primeiraLinha	0
últimaLinha	2
primeira coluna	0
últimaColuna	-1
excluirLinhasVazias	true
excluirLinhasOcultas	true
excluir colunas ocultas	true
exportValoresComoTexto	false
exportarCélulasVazias	false
exportAsObject	false
formato de hiperlink	Text
cultura	en-US
linhasExtraídas	1
dados extraídos	Objeto contendo o array rowData
mensagem	Successfully extracted 1 row(s) from worksheet 'First Worksheet'

Objeto de dados extraído:

Parâmetro	Valor
documento	null
nome_do_arquivo	null
sucesso	true
mensagem de erro	null
dados_dados	Matriz de objetos de linha extraídos

Nota: rowData contém os objetos de linha extraídos como uma matriz com os cabeçalhos das colunas como chaves.

Schema

Visão do esquema

A estrutura de dados e os tipos de resposta:

1 item
success: ☑ true
originalFileName: T myExcelFile.xlsx
worksheetName: T First Worksheet
hasHeaderRow: ☑ true
firstRow: # 0
lastRow: # 2
firstColumn: # 0
lastColumn: # -1
excludeEmptyRows: ☑ true
excludeHiddenRows: ☑ true
excludeHiddenColumns: ☑ true
exportValuesAsText: ☑ false
exportEmptyCells: ☑ false
exportAsObject: ☑ false
hyperlinkFormat: T Text
culture: T en-US
rowsExtracted: # 1
extractedData: {} Object
document: null
fileName: null
success: ☑ true
errorMessage: null
rowData: [] Array
[0]: {} Object
Column1: # 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
Column1: # 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
message: T Successfully extracted 1 row(s) from worksheet 'First Worksheet'

Indicadores de tipo:

• T = String (Texto)
• # = Número
• ☑ = Boolean
• [] = Array
• {} = Object
• null = Valor nulo

Binary

Visualização de Dados Binários

Os dados extraídos são retornados como JSON na resposta. Acesse os dados da linha diretamente do extractedData.rowData variedade:

extractedData
─────────────────────────────
rowData: Array of row objects
success: true
errorMessage: null

Acesso aos dados:

• Matriz de dados de linha: $json.extractedData.rowData
• Linhas individuais: $json.extractedData.rowData[0]
• Valores da coluna: $json.extractedData.rowData[0]["First Name"]
• JSON RespostaDisponível em formato estruturado. JSON em n8n resposta

Casos de uso

• API alimentaExtrair as linhas filtradas e enviá-las diretamente para REST endpoints ou consumidores de webhook.
• Ingestão de banco de dadosTransforme relatórios do Excel em documentos estruturados. JSON todas as noites antes de inserir dados em bancos de dados SQL/NoSQL.
• Validação e Garantia de QualidadeExtraia intervalos para verificações de regras, envie alertas ou enriqueça outros fluxos de trabalho sem precisar exportar manualmente.

Obtenha ajuda

n8n Integration Guiden8n SampleGetting Started