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

使用以下方法更新 Excel 中的行 n8n 行动

PDF4me 在 Excel 中更新行 直接从现有工作表行修改 n8n喂食一个或多个 JSON 对象（始终包装在数组中） PDF4me 将属性与列标题匹配，自动进行类型转换，并从您选择的行开始按顺序遍历工作表。非常适合同步。 SQL 结果令人耳目一新 CRM 快照，或者在不插入新行的情况下修补审批状态列。

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

设置​

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

先决条件

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

配置

  1. 添加 PDF4me 工作流的节点
  2. 选择“更新行”操作
  3. 请提供Excel源文件。 JSON 数组，并更新偏移量
在 Excel 中更新行

参数​

重要的： 标有星号（***）的参数为必填项。 Json Data 必须始终是一个 JSON 数组（将单行包装在 []）。

范围类型描述例子
输入数据类型***StringExcel数据源选择器。选项： Binary Data， Base64 String， URL。Binary Data
输入二进制字段***二进制需要 Input Data Type = Binary Data参考上游二进制文件。{{ $binary.data }}
Base64 文档内容***String需要 Input Data Type = Base64 String提供 base64 工作簿。UEsDBBQAAAA...
文档网址***String需要 Input Data Type = URL工作簿的公开链接。https://files.example.com/report.xlsx
文件名***String工作簿的处理/显示名称（带扩展名）。inventory.xlsx
JSON 数据***StringJSON 对象数组。每个对象依次更新数组中的一行。[{"SKU":"A-100","Stock":45}]
工作表名称String目标工作表。空白工作表使用第一张工作表。Inventory
起始行数字从第 1 行开始更新工作表行（通常是第 1 行的标题行）。2
起始列数字使用从 1 开始的列偏移量进行标题对齐。1
转换数值和日期Boolean自动将数字/日期字符串转换为 Excel 值。默认值 true。true
日期格式String启用转换后，将应用Excel日期格式。yyyy-MM-dd
数字格式String启用转换后，Excel 数字格式。#,##0.00
忽略空值Boolean什么时候 true空值不会影响现有单元格的值。true
忽略属性标题Boolean不区分大小写的标头匹配。默认值 false。true
文化名称String用于解析数字/日期的文化。空值表示不变。en-US
二进制数据输出名称***String存储已修补工作簿的输出二进制插槽的名称。document

输出​

输出参数​

范围类型描述例子
文件名String更新后的 Excel 文档文件名 - 行更新后输出的 Excel 文档文件名excel_updated.xlsx
文件大小数字文件大小（字节） - 行更新后 Excel 文档的大小（以字节为单位）212810
成功BooleanPDF4me 运行状态 - Boolean 指示行更新过程成功或失败的标志。 PDF4me 返回 true 为了成功运营和 false 任何错误true
原始文件名String原始 Excel 文档文件名 - 输入的 Excel 文档文件名myExcelFile.xlsx
工作表名称String工作表名称 - 更新行的工作表名称Sheet1
起始行数字起始行号 - 从 1 开始更新的行号1
起始列数字起始列号 - 从 1 开始更新的列编号1
行已更新数字更新的行数 - 成功更新的行总数1
convertNumericAndDateBoolean数字和日期转换状态 - 指示是否启用了自动数字和日期转换。 true 如果启用， false 如果禁用true
日期格式String应用日期格式 - 转换过程中应用的日期格式字符串yyyy-MM-dd
数字格式String应用数字格式 - 转换过程中应用的数字格式字符串N2
忽略空值Boolean空值处理 - 指示是否忽略空值。 true 如果忽略空值（保留现有值）， false 如果写入了空值false
忽略属性标题Boolean不区分大小写的标头匹配 - 指示是否使用了不区分大小写的标头匹配。 true 如果启用， false 如果区分大小写false
文化名称String文化/地方规范 - 用于解析数字和日期的文化代码（例如，“en-US”、“de-DE”、“fr-FR”）en-US
信息String操作消息 - 描述行更新操作结果的消息，包括已更新的行数和工作表名称。Successfully updated 1 row(s) in worksheet 'Sheet1'

N8N 行动反应​

这 PDF4me 更新行 API 返回的结果可以以多种格式查看。请选择最符合您需求的视图：

JSON 回复格式

原始 JSON 来自……的回应 API：

[
  {
    "fileName": "excel_updated.xlsx",
    "fileSize": 212810,
    "success": true,
    "originalFileName": "myExcelFile.xlsx",
    "worksheetName": "Sheet1",
    "startRow": 1,
    "startColumn": 1,
    "rowsUpdated": 1,
    "convertNumericAndDate": true,
    "dateFormat": "yyyy-MM-dd",
    "numericFormat": "N2",
    "ignoreNullValues": false,
    "ignoreAttributeTitles": false,
    "cultureName": "en-US",
    "message": "Successfully updated 1 row(s) in worksheet 'Sheet1'"
  }
]

用例​

  • 库存同步刷新从……提取的库存数量 ERP 在保持价格和元数据不变的情况下进行查询。
  • 订单或项目状态补丁状态、所有者或 SLA 当上游系统发出更新时，列也会随之更新。
  • 财务调整每晚重写预测或实际数据行，而不破坏现有公式/结构。

获取帮助​

n8n Integration Guiden8n SampleGetting Started