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

添加行 Excel 在 Make

本模块的功能

添加行 Excel 是一个 Make 模块 PDF4me 动态插入 JSON 数据以行的形式输入 Excel 电子表格在 Make 场景。当您需要填充数据时使用它。 Excel 来自数据库查询的文件 REST API 回复、表单提交或 CRM 按计划或触发器导出数据。该模块支持基于表格的表头匹配和基于坐标的单元格定位，并具备自动类型转换和特定于培养物的日期和数字解析功能。

始终将单个对象包装在数组中
这 JSON 输入 字段需要 JSON 即使只插入一行，数组也会被使用。 [{"姓名":"约翰","年龄":30}] 不是 姓名：约翰，年龄：30传递不带数组括号的普通对象会导致错误。数组中的每个对象都会从指定位置开始插入一行。
表名触发表格模式，空表名触发坐标模式
当你提供 表名该模块使用 Excel 表头匹配和插入指定位置 Excel 表格中的行号。如果使用坐标模式，请将表名留空并指定。 从行插入 和 从列插入 用于精确的单元格级定位。切勿混用两种模式。
设置文化名称以匹配数据源区域设置
这 文化名称 字段控制日期和数字在您表格中的显示方式 JSON 插入前会进行解析。默认值 美国英语 日期格式为 MM/DD/YYYY，小数分隔符为句点。如果您的数据来自欧洲 API 使用 那就是 或者 法语 根据惯例，相应地设置文化名称，以防止日期和数字解析错误。
相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间，您可以浏览 PDF4me 博客，查看适用于各平台的教程和工作流程。
访问博客 →

验证您的身份 API 要求​

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

Get your API Key
Make 中的“向 Excel 添加行”模块，显示了用于自动插入电子表格数据的“文件名”、“文档”、“Json 输入”、“表名”和“转换数值和日期”字段。

放 表名 使用表头匹配表插入，或者将其留空并设置 从行插入 和 从列插入 用于基于坐标的定位。启用 转换数值和日期 申请 Excel 类型格式化。

如何向……添加行 Excel 自动 Make？​

这 PDF4me 添加行 Excel 模块可连接到任何 Make 触发生成结构化数据。典型的流程会下载目标数据。 Excel 模板来自 Google Drive 或者 Dropbox然后传递 JSON 将先前模块中的数据导入到 JSON 输入字段中。根据 Make 集成文档， PDF4me 模块将文件作为二进制缓冲区进行处理，因此更新后的 Excel 文件返回到文档数据输出，可以直接上传。对于最常见的用例（插入数据库或 API 结果导致 Excel 表），将表名设置为您命名的表名。 Excel 将表格中的“转换数值和日期”设置为“是”，以确保数字和日期在电子表格中正确显示。

参数​

重要的： 标记的参数 必需的 必须提供。 条件 参数具有内置默认值，并且仅在特定模式下适用。

范围必需的它的作用例子
ConnectionRequiredPDF4me connection holding your API key. Create one from the Make Connections panel.My PDF4me connection
File NameRequiredExcel filename with .xlsx or .xls extension. Maps to the output filename. Map from a prior download module or use a dynamic expression.sales_data.xlsx
DocumentRequiredBinary Excel file content as a Make buffer. Map from Google Drive, Dropbox, SharePoint, or HTTP download module.1. Data
Json InputRequiredJSON array of objects to insert as rows. Each object = one row. Always use array brackets. Property names match column headers in table mode or define column order in coordinate mode.[{"Product":"Widget","Qty":50}]
Worksheet NameConditionalName of the target worksheet. Defaults to Sheet1 if omitted. Case-sensitive. Must match the worksheet tab name exactly.Sales
Table NameConditionalExcel table name for table-based insertion. When set, enables header-matching mode. Leave empty for coordinate-based insertion. Never use with Insert From Row/Column.SalesTable
Excel Row NumberConditional1-based row position within the table for insertion (table mode only). Set to 1 to insert at the first data row after headers.1
Insert From RowConditional1-based row number for insertion start (coordinate mode only). Error if used together with Table Name. Row 1 = the first worksheet row.3
Insert From ColumnConditional1-based column number for insertion start (coordinate mode only). Column A = 1, B = 2. Error if used together with Table Name.1
Convert Numeric And DateConditionalWhen Yes, converts JSON strings to Excel number and date types using Date Format and Numeric Format patterns. Default: Yes.Yes
Date FormatConditionalExcel date format pattern applied when Convert Numeric And Date is Yes. Default: yyyy-MM-dd. Common formats: MM/dd/yyyy, dd-MMM-yyyy.MM/dd/yyyy
Numeric FormatConditionalExcel numeric format pattern applied when Convert Numeric And Date is Yes. Default: N2. Common: #,##0.00, 0.00%.#,##0.00
Ignore Null ValuesConditionalWhen Yes, skips JSON null values instead of inserting empty cells. Default: No. Useful for optional form fields that may be absent from the JSON.No
Ignore Attribute TitlesConditionalWhen Yes, enables case-insensitive matching between JSON property names and Excel column headers. Default: No.Yes
Culture NameConditionalCulture code for parsing dates and numbers in the JSON data. Default: en-US. Set to de-DE, fr-FR, etc. for European data sources.en-US

输出​

这 PDF4me 添加行 Excel 该模块会在输出包中返回两个字段：

场地类型它包含什么
NameStringOutput Excel filename derived from the File Name input. Use in the destination upload module File Name field.
Doc DataBufferBinary Excel content with the newly inserted rows as a Make buffer. Map into Google Drive Upload, Dropbox Upload, SharePoint Create File, or Email Send attachment.

场景示例​

这 PDF4me 添加行 Excel 模块 Make 提供满足实际数据自动化需求的全面场景模板：

每日销售数据自动导出方案

利用自动化数据库到Excel数据导入功能，革新您的销售报告：

  1. 扳机定时触发器每天晚上 11 点运行
  2. 查询数据库： 执行 SQL 查询以获取今日销售交易记录
  3. 格式化 JSON： 转变 SQL 结果 JSON 数组格式
  4. 得到 Excel 模板从以下位置获取销售报告模板 Google Drive
  5. 添加行： 插入 JSON 将数据导入 DailySales 表，设置表名，Excel 行号 = 1
  6. 上传结果保存到 Google Drive 每日报告文件夹
  7. 电子邮件报告发送更新 Excel 致销售经理

商业优势： 自动插入 200 多条每日销售记录，节省 2 小时的手动数据输入时间，确保日期和货币格式一致。

行业应用案例及应用​

  • CRM 管道报告将商机数据插入 Excel 销售渠道
  • 销售线索跟踪表：将表单中的新线索添加到 Excel 跟踪日志
  • 营销活动分析：根据分析结果填充营销结果 APIs
  • 客户数据库将客户数据从数据库导出到 Excel 列表

何时应该使用“添加行”功能 Excel 在 Make？​

使用“添加行”功能 Excel 当您需要从任何位置追加结构化数据时 Make将连接源连接到现有 Excel 将电子表格作为自动化工作流程的一部分。此模块非常适合数据库导出。 API 轮询、表单日志记录和 CRM 报告目标文件已存在且您正在添加新记录的情况。如果您需要创建新记录，请执行以下操作。 Excel 从头开始创建文件或将数据转换为其他格式，请查看其他选项。 PDF4me Excel 模块 有售 Make。 根据 微软的 Excel 数据模型文档， 使用 Excel 命名表（与原始坐标相比）可实现自动标题匹配、公式传播和结构化引用支持，因此表格模式是大多数工作流程的推荐方法。

常见问题​

如何向一个数据库中添加行？ Excel 文件在 Make 自动地？​

添加 PDF4me 添加行 Excel 触发后，模块会提供您的数据。下载目标 Excel 文件来自 Google Drive 或者 Dropbox 在前一个模块中，映射 文件名 和 文档， 放 JSON 输入 一个 JSON 对象数组，配置插入模式，然后映射 文件日期 从输出到上传模块。有关详细的设置指南，请参阅 PDF4me Make 文档。

基于表格的插入和基于坐标的插入有什么区别？​

基于表的插入（集） 表名) 使用 Excel 匹配的表头名称： JSON 无论列顺序如何，属性名称都映射到列标题名称。基于坐标的插入（表名留空）使用 从行插入 和 从列插入 用于精确的单元级定位 JSON 对象属性顺序决定列的位置。切勿在同一模块调用中同时使用两种模式。对于具有一致列标题的结构化数据，表格模式更健壮且更易于维护。

为什么对于 JSON 输入，我必须将单行数据用数组包裹起来？​

该模块始终需要一个 JSON 之所以称之为数组，是因为它遍历数组元素，以便在一次调用中插入多行。 JSON 不带方括号的对象不是数组，会导致解析错误。请使用 [{"Field1": "value1"}] 对于单行和 [{"F1":"v1"}, {"F1":"v2"}] 适用于多行。 JSON 规格 将数组和对象视为不同的类型，并且此模块需要数组类型来支持批量行插入。

Make IntegrationGet your API KeyMake Documentation