跳到主要内容
PDF4me API集成知识库扩展API 测试员博客

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

PDF4me 从 Excel 中提取工作表 将 Excel 工作簿中的整个工作表转换为结构化格式 JSON 通过 n8n 自动化工作流程。通过以下方式处理 Excel 文件 n8n 触发器、二进制数据、base64 字符串或公共 URLs 提取完整的工作表数据，具备自动检测表头、按名称或索引灵活选择工作表、支持多工作表以及保留数据类型等功能。此解决方案是完整数据导出和多工作表处理的理想选择。 API 集成、数据库迁移和全面的 Excel 到JSON 需要完整提取工作表、结构化输出和无缝集成的转换工作流程。

相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间，您可以浏览 PDF4me 博客，查看适用于各平台的教程和工作流程。
访问博客 →

设置​

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

先决条件：

  • PDF4me API 证书
  • n8n 工作流访问
Get Your API Key

配置：

  1. 添加 PDF4me 节点到工作流
  2. 选择“从 Excel 文件中提取工作表”操作
  3. 配置输入参数（见下文）
从 Excel 中提取工作表

参数​

以下是“提取工作表”操作的完整参数列表。配置这些参数可控制工作表的提取。

重要的： 标有星号 (***) 的参数是必需的，必须提供这些参数才能使操作正常运行。

范围类型描述例子
输入数据类型***StringExcel 输入格式选择
• 选择 Excel 数据输入格式
• PDF4me 支持多种输入类型
• 选项：二进制数据， Base64 字符串，或 URL		Binary Data
输入二进制字段***二进制二进制Excel文件输入 （二进制数据必填）
• 参考之前的 Excel 文件（.xlsx、.xls）。 n8n 节点或文件上传
• PDF4me 处理具有自动格式检测功能的二进制 Excel 文件
• 当输入数据类型为“二进制数据”时为必填项		{{ $binary.data }}
Base64 Excel 内容***StringBase64 编码后的 Excel 输入 （如果是 Base64 字符串则为必填项）
• 提供以 base64 编码字符串形式保存的 Excel 内容（.xlsx、.xls）。
• PDF4me 自动解码和处理 Excel 内容
• 当输入数据类型为“Base64 细绳”		UEsDBBQABgAI...
Excel URL***String公共 Excel URL 输入 （如果是 URL，则为必填项）
• 提供公开/开放权限 URL 导出到 Excel 文件（.xlsx、.xls）
• PDF4me 从提供的目录中下载并处理 Excel 文件。 URL
• 当输入数据类型为“URL“		https://abc.com/data.xlsx
Excel 名称***StringExcel 输入文件名
• 请指定输入Excel文件的名称，并带有正确的扩展名（.xlsx、.xls）。
• PDF4me 此功能用于格式检测和处理优化		data.xlsx
工作表名称String以逗号分隔的工作表名称
• 要提取的工作表名称列表
• 格式：“Sheet1，摘要，报告”
• 选择逻辑如果提供了 WorksheetNames 和 WorksheetIndexes，则提取指定名称的工作表。如果同时提供了 WorksheetNames 和 WorksheetIndexes，则提取匹配其中任一项的工作表（并集）。如果两者都未提供，则提取所有工作表。
• 区分大小写的工作表名称		Employees,Sales
工作表索引String逗号分隔索引（从 0 开始）
• 要提取的工作表索引列表
• 格式：“0,1,2”（索引 0 = 第一页，索引 1 = 第二页，依此类推）
• 选择逻辑如果提供了参数 → 提取已建立索引的工作表。如果同时提供了两个参数 → 提取匹配以下任一条件的工作表（并集）。
• 基于 0 的索引索引 0 = 第一个工作表		0,2,4

输出​

输出参数​

范围类型描述例子
jsonFileNameStringJSON 输出文件名 - 生成的名称 JSON 包含提取的工作表数据的文件excel_extracted.json
txtFileNameStringTXT 输出文件名 - 生成的包含提取的工作表数据的 TXT 文件的名称excel_extracted.txt
json文件大小数字JSON 文件大小（字节） - 尺寸 JSON 输出文件大小（字节）206933
txt文件大小数字TXT 文件大小（字节） - TXT 输出文件的大小（以字节为单位）206933
成功BooleanPDF4me 运行状态 - Boolean 指示工作表提取过程成功或失败的标志。 PDF4me 返回 true 为了成功运营和 false 任何错误true
原始文件名String原始 Excel 文档文件名 - 输入的 Excel 文档文件名myExcelFile.xlsx
提取String提取方法 用于识别要提取的工作表的方法。值：“name”（如果按工作表名称提取），“index”（如果按工作表索引提取）。name
工作表名称String提取的工作表名称 - 以逗号分隔的已提取工作表名称列表Sheet2
解析数据Object已解析的工作表数据 - Object 包含提取的工作表数据，其中工作表名称作为键，行对象数组作为值。每个行对象包含列标题作为键，单元格值作为值。{"Sheet2": [{"First Name": "Dulce", "Age": 32}]}
信息String操作消息 - 描述性消息，指示工作表提取操作的结果，包括工作表名称和提取方法Successfully extracted worksheet(s) 'Sheet2' by name and created JSON and TXT outputs

N8N 行动反应​

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

JSON 回复格式

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

用例​

完整数据导出和迁移​

  • 将整个 Excel 工作簿提取为 JSON 用于系统迁移、数据归档和备份操作
  • 将多工作表 Excel 文件转换为 JSON 云存储和数据库导入格式
  • 导出完整的工作表数据 API 集成和跨系统同步

多页处理与分析​

  • 同时提取多个工作表以进行并行处理 n8n 工作流程
  • 使用不同的业务逻辑和转换处理不同的工作表标签页
  • 将完整的工作簿数据与外部数据集成 APIs 以及数据分析平台

商业智能和数据集成​

  • 将 Excel 数据导出到 JSON 用于商业智能工具和分析平台
  • 将 Excel 报表转换为结构化报表。 JSON 用于自动报告和仪表板更新
  • 将 Excel 数据与 CRM 系统、数据库和云服务

获取帮助​

n8n Integration Guiden8n SampleGetting Started