使用以下方式从 Excel 工作表中提取行 n8n 行动

PDF4me 提取行 将任何工作表切片转换为可直接使用的形式 JSON 之内 n8n指定从 0 开始的行/列范围，决定是否将第一行设为标题，跳过隐藏行或空行，并选择值是否保持类型（数字、布尔值等）。 ISO 日期）或强制转换为文本。非常适合将 Excel 数据导入。 APIs数据库或其他 PDF4me 行动。

设置

添加 PDF4me 将“提取行”节点添加到您的 n8n 工作流程并配置所需参数。有关初始设置说明，请参阅我们的 n8n 集成指南。

先决条件

PDF4me API 证书
n8n 工作流访问

Get Your API Key

配置

添加 PDF4me 工作流的节点
选择“从 Excel 工作表中提取行”操作
提供 Excel 源和提取窗口

参数

重要的： 标有星号 (***) 的参数为必填项。行/列索引为 基于 0 的 （第 0 行 = Excel 第 1 行）。

范围	类型	描述	例子
输入数据类型***	String	Excel 源选择器（`Binary Data`， `Base64 String`， `URL`）。	`Binary Data`
输入二进制字段***	二进制	需要 `Binary Data` 已选中。	`{{ $binary.data }}`
Base64 文档内容***	String	需要 `Base64 String` 已选中。	`UEsDBBQAAAA...`
文档网址***	String	需要 `URL` 已选中。公开文件链接。	`https://files.example.com/report.xlsx`
文件名***	String	逻辑工作簿名称（含扩展名）。	`analytics.xlsx`
工作表名称	String	工作表阅读。空白页 = 第一页。	`Summary`
第一排***	数字	从 0 开始提取。	`0`
最后一行	数字	以 0 为起始行的行。使用 `-1` 读取到最后一行数据。	`-1`
第一栏	数字	从 0 开始的起始列（0 = A 列）。	`0`
最后一列	数字	以 0 为起始值的列。使用 `-1` 针对最后一列数据。	`-1`
包含标题行	Boolean	`true` 用途 `First Row` 作为列标题，并将其从数据中排除。	`true`
排除隐藏行	Boolean	跳过Excel中隐藏的行。	`false`
排除隐藏列	Boolean	跳过隐藏列。	`false`
排除空行	Boolean	删除所有单元格都为空的行。	`true`
导出空单元格	Boolean	保留空单元格，并填充空字符串值，而不是省略它们。	`false`
以文本形式导出值	Boolean	强制所有值转换为字符串。 `false` 保留原生类型。	`false`
二进制数据输出名称***	String	二进制槽存储序列化 JSON （PDF4me 返回 JSON 字节）。	`document`

输出

输出参数

范围	类型	描述	例子
成功	Boolean	PDF4me 运行状态 - Boolean 指示行提取过程成功或失败的标志。 PDF4me 返回 `true` 为了成功运营和 `false` 任何错误	`true`
原始文件名	String	原始 Excel 文档文件名 - 输入的 Excel 文档文件名	`myExcelFile.xlsx`
工作表名称	String	工作表名称 - 从中提取行的工作表的名称	`First Worksheet`
hasHeaderRow	Boolean	标题行状态 - 指示第一行是否被视为标题行。 `true` 如果使用了标头， `false` 否则	`true`
第一行	数字	第一行索引（从0开始）提取的第一行的从 0 开始的索引	`0`
最后一行	数字	最后一行索引（从 0 开始） - 提取的最后一行的从 0 开始的索引。 `-1` 表示提取到最后一行数据	`2`
第一列	数字	第一列索引（从0开始） - 提取的第一列的从 0 开始的索引（0 = A 列）	`0`
最后一列	数字	最后一列索引（从 0 开始） - 提取的最后一列的从 0 开始的索引。 `-1` 表示提取到最后一列数据	`-1`
排除空行	Boolean	排除空行 - 指示是否排除空行。 `true` 如果排除在外， `false` 如果包含	`true`
排除隐藏行	Boolean	隐藏行排除 - 指示是否排除了隐藏行。 `true` 如果排除在外， `false` 如果包含	`true`
排除隐藏列	Boolean	隐藏列排除 - 指示是否排除了隐藏列。 `true` 如果排除在外， `false` 如果包含	`true`
exportValuesAsText	Boolean	文本导出模式 - 指示值是否以文本形式导出。 `true` 如果强制转换为字符串， `false` 如果保留原生类型	`false`
导出空单元格	Boolean	空单元格导出 - 指示是否导出空单元格。 `true` 如果包含空字符串， `false` 如果省略	`false`
exportAsObject	Boolean	对象导出模式 - 指示数据是否以对象格式导出	`false`
超链接格式	String	超链接格式 - 提取数据中超链接使用的格式。值：“文本”、“网址”等。	`Text`
文化	String	文化/地方规范 - 用于数据提取的文化代码（例如，“en-US”、“de-DE”、“fr-FR”）	`en-US`
提取的行	数字	提取的行数 - 成功提取的总行数	`1`
提取的数据	Object	提取的数据对象 - 包含提取的行数据的嵌套对象，其 rowData 数组	`{"rowData": [{"Column1": 1, "First Name": "Dulce"}]}`
信息	String	操作消息 - 描述行提取操作结果的消息，包括提取的行数和工作表名称。	`Successfully extracted 1 row(s) from worksheet 'First Worksheet'`

N8N 行动反应

这 PDF4me 从 Excel 工作表中提取行 API 返回的结果可以以多种格式查看。请选择最符合您需求的视图：

JSON
Table
Schema
Binary

JSON 回复格式

原始 JSON 来自 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'"
}
]

表格视图

以结构化表格格式呈现的响应数据：

范围	价值
成功	`true`
原始文件名	`myExcelFile.xlsx`
工作表名称	`First Worksheet`
hasHeaderRow	`true`
第一行	`0`
最后一行	`2`
第一列	`0`
最后一列	`-1`
排除空行	`true`
排除隐藏行	`true`
排除隐藏列	`true`
exportValuesAsText	`false`
导出空单元格	`false`
exportAsObject	`false`
超链接格式	`Text`
文化	`en-US`
提取的行	`1`
提取的数据	包含 rowData 数组的对象
信息	`Successfully extracted 1 row(s) from worksheet 'First Worksheet'`

提取的数据对象：

范围	价值
文档	`null`
文件名	`null`
成功	`true`
错误信息	`null`
行数据	提取的行对象数组

注意：rowData 包含提取的行对象，以数组形式存储，列标题作为键。

架构视图

响应的数据结构和类型：

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'

类型指示器：

T = String （文本）
# = 数字
☑ = Boolean
[] = Array
{} = Object
null = 空值

二进制数据视图

提取的数据将以如下方式返回： JSON 在响应中。直接从响应中访问行数据。 extractedData.rowData 大批：

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

数据访问：

行数据数组： $json.extractedData.rowData
单行： $json.extractedData.rowData[0]
列值： $json.extractedData.rowData[0]["First Name"]
JSON 回复：以结构化形式提供 JSON 在 n8n 回复

用例

API 饲料提取筛选后的行并将其直接推送到 REST 端点或 webhook 消费者。
数据库导入将 Excel 报表转换为结构化报表 JSON 每晚在插入 SQL/NoSQL 存储之前。
验证与质量保证：无需手动导出，即可提取规则检查范围、发送警报或丰富其他工作流程。

获取帮助

n8n Integration Guide n8n Sample Getting Started

设置​

参数​

输出​

输出参数​

N8N 行动反应​

用例​

获取帮助​

设置

参数

输出

输出参数

N8N 行动反应

用例

获取帮助