跳到主要内容

在 Zapier 中填充 Excel 文件

Excel - 填充 这是一个 Zapier 操作,它使用 JSON 数据填充 .xlsx 模板,并返回填充后的工作簿,同时保留所有单元格样式、公式和合并区域。如果您已有品牌化的 Excel 布局,并希望自动将新数据填充到其中,请使用此操作。该操作接受一个模板文件和一个 JSON 有效负载,并返回一个填充后的工作簿。 .xlsx这样,您就可以通过电子邮件发送、上传或存档,而无需手动粘贴。

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

验证您的 API 请求

Zapier 中的每个 PDF4me 模块都需要有效的连接。请创建或选择一个包含您的 PDF4me API 密钥的连接。

您不容错过的重要事实

模板布局完全保留。
“填充”操作基于单元格值,而非样式。模板中定义的字体、颜色、边框、合并单元格、行高、列宽、图像和公式都会保留。只有您标记为要填充的单元格才会受到影响。
模板需要智能标记或表格
PDF4me 将 JSON 写入单元格,这些单元格要么包含 Aspose 智能标记,例如 &=Items.ItemName 或者将其放置在 Excel 表格中,表格的列标题与 JSON 字段名称匹配。空白表格将生成空输出。
模板字段需要的是文件,而不是 URL。
地图 2. 文件 从 Dropbox/Google Drive/OneDrive 的“获取文件”步骤中获取模板 URL。模板 URL 仅适用于通过 HTTPS 公开提供的模板,如果您传递的是映射文件,则该 URL 为空。
Zapier Excel - 填充操作配置选项卡显示模板映射到 2. 文件,模板 URL 为空,模板名称由 2. 文件名加上 2. 文件扩展名 .xlsx 组成,JSON 数据包含一个 Items 数组,其中包含具有 ItemName、Qty 和 UnitPrice 字段的对象。

配置顶部。从上一步的文件输出映射模板,然后通过连接文件名和文件扩展名来构建模板名称。JSON 数据是 PDF4me 写入模板的有效负载。

什么是 Zapier 中的 Excel - Populate?

“Excel - Populate”是Zapier的PDF4me操作,用于将JSON有效负载中的数据填充到预先设计的.xlsx模板中。它接受一个模板文件和一个JSON对象,并返回一个填充后的工作簿文件。与将所有内容扁平化为原始网格的在线JSON转Excel转换器不同,“Populate”会保留模板的布局,因此每次触发时都可以重新生成带有品牌标识的报告、发票和仪表板,而不会出现格式偏移。

参数

范围必需的它的作用例子
TemplateConditionalThe .xlsx template file. Map from a Dropbox / Drive / OneDrive Get File step. Required unless Template URL is set.2. File
Template URLConditionalPublic HTTPS URL to fetch the template. Used only when Template is blank.https://example.com/tpl.xlsx
Template NameRequiredFilename with extension. Used for output naming and downstream mapping. Typically built by concatenating File Name and File Ext from the prior step.Items.xlsx
JSON DataRequiredData payload to write into the template. Object keys must match Smart Markers or table column headers.{"Items":[{"ItemName":"A123","Qty":"55","UnitPrice":"3.05"}]}
Strict JSON StringsOptionalWhen True, quoted numbers stay as strings in the output cells. When False, they auto-convert to numeric cells.True
Culture & Language SettingsOptionalLocale used to parse date and numeric cells. Does not modify stored values.en-US
Calculate FormulasOptionalWhen True, formulas in the template are evaluated after population so totals open pre-computed.True
Worksheet IndexesOptional1-based index of the worksheet(s) to populate. Comma-separated for multiple sheets in one call.1 (or 1,3)
Quote Prefix To StyleOptionalWhen True, cells beginning with a single quote are styled as text rather than treated as a prefix character.False
Zapier Excel - 填充配置选项卡向下滚动显示“严格 JSON 字符串 True”、“区域和语言设置 en-US”、“计算公式 True”、“工作表索引 1”和“引用前缀到样式 False”。

高级选项。“严格 JSON”和“计算公式”是两个默认设置,几乎永远不需要更改。仅当模板的数据区域位于除第一个工作表之外的其他工作表时,才需要调整工作表索引。

输出

场地类型它包含什么
FileBinaryThe populated .xlsx workbook. Map into a Dropbox / Drive / OneDrive Upload File step, or attach it in Gmail / Outlook Send Email.
File NameStringThe Template Name you provided in the Configure tab. Useful when the upload step needs both file bytes and a filename separately.

Zapier 中的 Excel - Populate 功能是如何工作的?

Zapier 将模板文件字节和 JSON 有效负载传递给 PDF4me。 /api/v2/PopulateExcelTemplate 端点。PDF4me 使用 Aspose Cells 打开模板,解析每个智能标记或表格绑定到 JSON,计算所有依赖公式,并将填充后的 .xlsx 文件作为 Base64 编码的字节流返回,Zapier 会将其显示为端点。 File 输出。根据 Zapier 文件字段文档这样,该文件输出就可以直接放入任何接受文件输入的后续操作中,而无需手动进行编码或解码步骤。

常见问题

Excel - Populate 功能支持哪些文件类型?+
模板必须为 .xlsx 格式(Excel 2007 或更高版本)。数据以 JSON 格式提供,可以直接粘贴到 JSON 数据字段中,也可以从之前生成 JSON 数据的步骤中映射而来。旧版 .xls 模板在使用前应另存为 .xlsx 格式。
如何在 Zapier 中将 JSON 转换为 Excel?+
使用 Aspose Smart Markers 设计 .xlsx 模板(例如 &=Items.ItemName或者创建一个列标题与 JSON 字段名称匹配的表格,然后使用 Excel 的“填充”功能将 JSON 行写入该模板。输出将保留模板中的所有样式、公式和合并区域。请参阅 Aspose 智能标记参考 精确的标记语法。
Excel - Populate 需要多少积分?+
Excel - Populate 每次运行消耗一个 PDF4me 积分,无论 JSON 有效负载包含多少行。免费套餐包含每日积分限额;付费套餐可提高限额。请参阅 定价页面 针对当前各层级的分配。
我可以一次性填充多个工作表吗?+
是的。将工作表索引设置为以逗号分隔的列表,例如: 1,3 并将 JSON 有效负载构建成一个数组的数组,每个目标工作表对应一个数组。一次调用即可在单个 PDF4me 请求中填充所有列出的工作表,从而节省积分和 Zapier 任务使用量。
为什么我的 Excel -Populate 函数返回的是一个空工作簿?+
该模板没有 Aspose Smart Markers,也没有列标题匹配的 Excel 表格。PDF4me 通过将 JSON 字段名称与模板标记进行匹配来填充内容。打开模板并添加如下标记: &=Items.ItemName 在数据区域的第一行,或者将数据范围转换为列标题与 JSON 键匹配的表格。