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

更新行 Excel 在 Zapier

PDF4me 更新行 Excel 是一个 Zapier 该操作会根据现有电子表格行进行修改。 JSON 数组，将属性名称与列标题匹配。用于同步 CRM 记录、刷新库存数量或使报告与数据库保持一致，所有这些都不会破坏电子表格的公式或布局。

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

验证您的身份 API 要求​

要访问 PDF4me 网站 API 通过 Zapier每个请求都必须包含正确的身份验证凭据。身份验证可确保通信安全，并验证您作为授权用户的身份，从而实现与您的系统之间的无缝集成。 Zapier 工作流程和 PDF4me强大的 Excel 数据更新服务。

Get your API Key
PDF4me Excel 更新工作表中的行 Zapier 配置 - 文件、文件名、工作表名称、JSON 输入、从行插入、从列插入、转换数值和日期、日期格式、数值格式、忽略属性标题、忽略空值、区域性名称
配置“更新行”操作，文件输入， JSON 数据、工作表和格式选项。

您不容错过的重要事实​

JSON 输入必须是 JSON 即使只有一行，数组也是如此
将单个对象用方括号括起来， [{"Name":"John","Age":31}]数组中的每个对象都会更新一行；属性名称会与您的需求进行匹配。 Excel 列标题。
此操作仅更新现有行
更新行操作永远不会插入全新的行。 从行插入 到你要覆盖的第一行（通常是 2 （跳过标题行）。要改为追加行，请使用 添加行。
映射完整的文件内容，而不是文件引用
如果 文件 如果显示“存在但未显示”且步骤出错，请从上一步中选择包含实际二进制内容的字段。参见 Zapier & Power Automate 尖端。

:::提示：映射文件和 JSON 输入来自之前的步骤

使用 + 旁边的按钮 文件 和 文件名 根据之前的 Zap 步骤进行映射。映射 JSON 输入 从一个输出步骤 JSON 数组（例如， API 响应（从解析 CSV 文件中提取文本）。 Excel 文件必须提供完整内容，不能仅提供“存在但未显示”的引用。

:::

Update Rows 如何将我的 JSON 数据与我的数据匹配？ Excel 列？​

更新行会读取工作表的标题行，并将每个属性名称与工作表中的每个属性名称进行匹配。 JSON 输入 将数组设置为同名列标题。 忽略属性标题 到 True 用于不区分大小写的匹配，当源系统的字段名称不完全匹配时非常有用。 Excel的外壳（例如，一个 CRM 使用导出 customerName 反对 Excel 标题 Customer Name）。

更新行和添加行有什么区别？​

更新行 覆盖已存在行中的数据，从指定位置开始。 从行插入 和 从列插入它从不创建新行。如果你的 JSON 数组中起始位置以下的记录数多于现有行数，请使用 添加行 改为追加，或者将这两个操作合并到一个 Zap 中：更新现有 ID 的行，添加新 ID 的行。

主要特点​

  • 就地更新修改现有单元格；Json 输入必须是 JSON 大批
  • 标头匹配属性名称匹配 Excel 列标题
  • 从行插入/从列插入：从 1 开始的起始位置（例如，第 2 行跳过标题行）
  • 转换数值和日期：True = 将字符串转换为 Excel 数字/日期
  • 日期格式/数字格式启用转换时应用格式
  • 忽略空值：True = 跳过空值；False = 更新为空
  • 忽略属性标题：当为真时，不区分大小写的标头匹配

参数​

更新行操作的完整参数列表。参数名称与……匹配 Zapier 配置 UI。

快速设置清单
  1. 地图 文件 （Excel） 和 文件名 上一步
  2. 地图 JSON 输入 （JSON 来自数组 API（解析 CSV 或其他步骤）
  3. 放 工作表名称 （默认 Sheet1）
  4. 放 从行插入 和 从列插入 （从 1 开始计数；通常为 2，数据行用 1 表示）
  5. 配置 转换数值和日期， 日期格式， 数字格式， 忽略空值

必需的： 文件和 JSON 输入。Json 输入必须是…… JSON 将单个对象包装在数组中 [...]。

范围必需的它的作用例子
FileRequiredExcel file content, mapped from a previous step. Must provide full binary content, not a reference labeled Exists but not shown.2. File from Step 2
File NameConditionalExcel filename with .xlsx or .xls extension.add_header_sample_file.xlsx
Worksheet NameConditionalTarget worksheet name. Defaults to Sheet1 when left blank.Sheet1
Json InputRequiredJSON array where each object updates one row. Property names are matched against Excel column headers.[{"Name":"John","Age":31}]
Insert From RowConditional1-based first row to update. Use 2 to skip the header row.2
Insert From ColumnConditional1-based column offset used for header matching.1
Convert Numeric And DateConditionalWhen True, converts JSON string values into native Excel numbers and dates.True
Date FormatConditionalExcel date format applied when Convert Numeric And Date is True.yyyy-MM-dd
Numeric FormatConditionalExcel numeric format applied when Convert Numeric And Date is True.N2
Ignore Attribute TitlesConditionalWhen True, matches JSON property names to column headers case-insensitively.False
Ignore Null ValuesConditionalWhen True, null values in Json Input are skipped instead of clearing the cell.True
Culture NameConditionalLocale used to interpret dates and numbers during conversion.en-US

更新行操作返回什么结果？​

这 PDF4me 更新行 Excel 操作返回修改后的值 Excel 文件将用于后续的 Zap 步骤。输出格式为： 所有共同点 PDF4me Excel 返回文件操作 在 Zapier。

场地类型它包含什么
Job IdStringUnique identifier for the Zapier job execution.
File UrlURLAPI endpoint to download the updated Excel file. Map this to the next step’s file input.
Alternate File UrlURLAlternate download URL with the filename embedded in the path.
File NameStringBase filename without extension.
File ExtensionStringFile extension of the output file.
Full File NameStringComplete filename with extension.
Document IdStringUnique identifier for the processed document.
File SizeNumberSize of the output file in bytes.

例子 JSON 输出 （URL（仅显示格式，链接无效）：

{
"Job Id": "969f2da3-f10a-49bf-b084-6fc4759991ec",
"File Url": "api.pdf4me.com/Zapier/GetDocument?d=...",
"Alternate File Url": "api.pdf4me.com/Zapier/GetAltDocument/.../add_header_sample_file.xlsx",
"File Name": "add_header_sample_file",
"Full File Name": "add_header_sample_file.xlsx",
"File Extension": ".xlsx",
"Document Id": "...",
"File Size": 212764
}

典型配置​

计划数据库同步
计划触发器会按一定时间间隔查询数据库，并将结果格式化为指定格式。 JSON 数组，更新行会覆盖共享报表中匹配的行，使其始终反映最新数据。
API驱动的仪表板刷新
预定的 Zap 调用 REST API解析 JSON 响应，更新行将值写入一个 Excel 仪表板存储在 Dropbox 或 Google Drive 中，保留现有公式和图表。
CRM 机会跟踪
当……时，webhook 会被触发。 CRM 机遇转变阶段。Zap 构建了一个 JSON 包含更新字段的对象，并且“更新行”会刷新匹配的行。 Excel 商机追踪器。

实用技巧​

始终设置 从行插入 到 2 如果工作表的第一行有标题行，则标题行将被覆盖；否则，标题本身将被覆盖。

使用 忽略空值 = 真 当你 JSON 源仅发送已更改的字段，因此不相关的单元格不会被清空。

用少量水进行测试。 JSON 首先使用数组（1-2 个对象）确认标题匹配，然后再针对完整数据集运行。

速查表​

  • 仅使用现有行 添加行 添加新条目。
  • JSON 输入始终是一个数组，请将单个对象包装在内。 [...]。
  • 除非另有说明，否则标头匹配区分大小写。 忽略属性标题 属实。
  • 放 转换数值和日期 设置为 True 可保持数字和日期为原生格式，而不是文本格式。
  • 地图上的完整文件内容 文件绝不会是“存在但未显示”的引用。

场景示例​

这 PDF4me 更新行 Excel 行动 Zapier 提供针对实际数据同步需求而设计的综合场景模板：

自动化数据库到Excel 同步场景

保留你的 Excel 报告与数据库更改自动同步：

完整场景步骤：

  1. 扳机计划触发器每 4 小时运行一次以刷新数据
  2. 查询数据库： 执行 SQL 查询以获取自上次同步以来的更新记录
  3. 格式 JSON： 转变 SQL 结果 JSON 数组格式，并带有正确的属性名称
  4. 得到 Excel 报告从 Google 云端硬盘获取主报告模板
  5. 更新行:映射文件、文件名、Json 输入（来自步骤 3）；设置工作表名称、从第 2 行插入、转换数值和日期 = True、忽略空值 = True、日期格式 = MM/dd/yyyy、数值格式 = $#,##0.00
  6. 上传结果： 地图 文件 URL 输出到 Google 云端硬盘，替换旧版本
  7. 电子邮件团队向团队发送数据刷新完成通知
  8. 日志同步记录同步时间戳和同步日志中的记录数

这样做能达到什么目的：

  • 将数据库记录同步到 Excel 按计划自动
  • 消除数据库和报表之间的手动数据录入。
  • 保持 Excel 与当前数据库状态一致的报告
  • 蜜饯 Excel 更新数据时的公式和格式

行业应用案例及应用​

  • CRM商机更新：在 Excel 中修改商机行，添加最新状态、金额和结束日期。
  • 广告系列效果刷新更新广告系列指标行，包括当前的展示次数、点击次数和转化次数。
  • 潜在客户评分更新：从营销自动化系统中刷新 Excel 跟踪表中的潜在客户评分数据
  • 客户数据库同步更新客户记录行，包含最新的联系信息和购买历史记录
  • 销售预测更新使用更新后的管道数据和中标概率修改预测行

常见问题​

How do I update multiple rows in Excel at once with Zapier?+
Map a JSON array to Json Input where each object represents one row. PDF4me matches each object's property names to your Excel column headers and updates every row in the array in a single action. See Microsoft's guidance on resizing Excel tables for how Excel itself expects table rows to grow.
What happens if Json Input has fields that don't match my column headers?+
By default, matching is case-sensitive, so Name and name are treated as different headers. Set Ignore Attribute Titles to True to match headers case-insensitively. Fields with no matching header are ignored, not added as new columns.
Does Update Rows add new rows if they don't already exist?+
No. Update Rows only modifies existing rows starting at the position set by Insert From Row and Insert From Column. To append brand-new rows, use the Add Rows action instead.
Why do my dates or numbers show up as plain text after updating?+
Set Convert Numeric And Date to True and specify a Date Format (for example yyyy-MM-dd) and Numeric Format (for example N2). Without this, JSON string values are written as text rather than native Excel numbers or dates.
How do I avoid the 'File: (Exists but not shown)' error?+
In the File field, pick the option from the previous step that provides full file content rather than a reference labeled "Exists but not shown." See the Zapier & Power Automate Tips guide for the full explanation.

相关操作​

在其他平台上执行相同任务​

获取帮助​

Zapier IntegrationGet your API KeyZapier Documentation