使用 Power Automate 从 SharePoint 列表生成 PDF：Handlebars 模板以及 HTML 转 PDF 发票工作流程

PDF4me 生成单个文档 这是一个 Power Automate 操作，它将 Handlebars HTML 模板和 JSON 有效负载渲染成一个完整的 HTML 文档，然后由配套的“将 HTML 转换为 PDF”操作将其分页到 A4 纸张上。SharePoint 列表中的新行会触发此流程，“撰写”操作会组装 JSON，Dropbox 会将发票 PDF 存储到以发票编号命名的文件夹中。无需高级连接器，也无需编写任何代码。

每个财务团队在使用 Power Automate 时都会遇到同样的难题。 转换文件 此操作需要高级许可证，并且拒绝修改 HTML 模板。Adobe PDF 服务和 Encodian 都需要付费。matthewdevaney 的热门变通方案完全绕过了 HTML，并将您锁定在 Power Apps 中。以下模式是搜索结果前十名中没有任何一家能够完整展示的：SharePoint 列表列集被转换为 JSON 有效负载，一个真正的 车把模板 文件位于 /Shared Documents/而且，PDF4me 的两个操作可以实现渲染和分页，而免费层连接器的成本仅为两个操作。

Handlebars模板渲染：PDF4me与其他替代方案的比较​

每个 Power Automate 架构师在选择发票 PDF 连接器之前都会进行比较：

基于原因的问答​

您将获得​

输入： 一个名为 SharePoint 的列表 Invoices （列：标题、发票日期、到期日、客户姓名、客户地址、客户邮箱、货币、小计、税率、税额、总计、备注）以及一个 Handlebars 模板 /Shared Documents/invoice_template.html。 输出： Dropbox 中每行一个 A4 PDF 文件，名为 {Title}.pdf （INV-1005 变为 INV-1005.pdf）。

你需要什么​

流程概览​

1. 创建物品时 （SharePoint 触发器） Invoices 列表）。
2. 撰写 嵌套的 JSON 有效负载（发票/客户/项目/总计/备注）。
3. 使用路径获取文件内容 为了 /Shared Documents/invoice_template.html。
4. PDF - 生成文档（单个） 模板主体加上 JSON，输出类型为 Html。
5. 将 HTML 转换为 PDF A4 纵向，缩放比例 0.8，40px 边距，打印背景：是。
6. 创建文件 在 Dropbox 中 /， 文件名 {Title}.pdf。

完整流程概述​

端到端运行。将 HTML 转换为 PDF 耗时 11 秒，这是分页器部分，其他所有操作均在半秒以内。

步骤 1：如何在新的 SharePoint 发票上触发 Power Automate 流？​

目前为止的流程： 流程从这里开始。

将 SharePoint 触发器指向包含发票行的站点和列表。之后，每一列都会变成动态内容。

1. 添加 SharePoint > 创建物品时 作为触发因素。
2. 配置：
   • 网站地址选择 SharePoint 站点（例如： PDF4me Sharepoints - https://ynoox1.sharepoint.com/sites/PDF4meSharepoints）。
   • 列表名称： Invoices。
3. 保存并让触发器检测列表架构。以下屏幕截图中的行（INV-1002、INV-1003、INV-1005）显示了 Handlebars 模板将使用的 12 列。

发票清单​

SharePoint 列表是真实数据源。这里的每一列都对应 Handlebars 有效负载中的一个字段。

触发器配置​

触发器只有两个字段，其他所有信息都来自该行。

步骤 2：如何从 SharePoint 行构建 Handlebars JSON 有效负载？​

目前为止的流程： SharePoint触发器。

Compose 功能将 SharePoint 中的 12 个扁平列转换为 Handlebars 模板迭代的嵌套 JSON。该模板需要…… invoice， customer， 一个 items 大批， totals，以及一个 notes 细绳。

1. 添加 撰写。
2. 在 输入粘贴下面的 JSON，然后将匹配的 SharePoint 动态内容字段放入每个值的引号之间，以便数字和日期作为字符串出现。

{
  "invoice": {
    "number": "Title",
    "date":   "InvoiceDate",
    "dueDate": "DueDate"
  },
  "customer": {
    "name":    "CustomerName",
    "address": "CustomerAddress",
    "email":   "CustomerEmail"
  },
  "items": [
    { "description": "Item1Description", "quantity": "Item1Qty", "unitPrice": "Item1UnitPrice", "lineTotal": "Item1Amount", "currency": "Currency" },
    { "description": "Item2Description", "quantity": "Item2Qty", "unitPrice": "Item2UnitPrice", "lineTotal": "Item2Amount", "currency": "Currency" },
    { "description": "Item3Description", "quantity": "Item3Qty", "unitPrice": "Item3UnitPrice", "lineTotal": "Item3Amount", "currency": "Currency" },
    { "description": "Item4Description", "quantity": "Item4Qty", "unitPrice": "Item4UnitPrice", "lineTotal": "Item4Amount", "currency": "Currency" },
    { "description": "Item5Description", "quantity": "Item5Qty", "unitPrice": "Item5UnitPrice", "lineTotal": "Item5Amount", "currency": "Currency" }
  ],
  "totals": {
    "currency":   "Currency",
    "subTotal":   "Subtotal",
    "taxRate":    "TaxRate",
    "taxAmount":  "TaxAmount",
    "grandTotal": "GrandTotal"
  },
  "notes": "Notes"
}

组合配置​

在代码视图中编写。每个 JSON 值都是两个引号之间的 SharePoint 数据块，因此数字和日期会以字符串的形式传入，供 Handlebars 模板渲染。

参考：SharePoint 列到 Handlebars 路径​

SharePoint 列与其在模板中位置的精确映射关系。扩展架构时，请将此表添加至书签。

步骤 3：如何从 SharePoint 加载 Handlebars 模板文件？​

目前为止的流程： SharePoint 触发器 + 撰写。

将模板存储为纯文本格式 .html 该文件位于网站的“文档”库中。“使用路径获取文件内容”操作会读取其原始字节，以便“生成文档（单个）”操作可以将其用作模板正文。

模板本身​

模板是普通的 HTML，带有内联 CSS，以及用于存储数据的 Handlebars 表达式。实际工作由两个结构完成。 {{#each items}} 每个行项目重复一行表格，并且 {{#if description}} 内部的守卫会跳过未使用的 Item4 和 Item5 列留下的空白。

<tbody>
  {{#each items}}
  {{#if description}}
  <tr>
    <td>{{description}}</td>
    <td class="num">{{quantity}}</td>
    <td class="num">{{currency}}{{unitPrice}}</td>
    <td class="num">{{currency}}{{lineTotal}}</td>
  </tr>
  {{/if}}
  {{/each}}
</tbody>

其他所有项目均可直接替代： {{invoice.number}} 在标题中， {{customer.*}} 阻止账单支付， {{totals.*}} 在总计表中，以及 {{notes}} 在页脚处。

1. 添加 SharePoint > 使用路径获取文件内容。
2. 配置：
   • 网站地址与触发点位于同一位置。
   • 文件路径： /Shared Documents/invoice_template.html。
   • 推断内容类型： Yes （保留默认设置）。

使用路径获取文件内容​

模板存在于 /Shared Documents/ 并通过绝对路径获取。版本历史记录是自动生成的，因为它只是一个 SharePoint 文件。

步骤 4：PDF - 生成文档（单个）如何填充 Handlebars 模板？​

目前为止的流程： SharePoint触发器+撰写+使用路径获取文件内容。

Generate Document (Single) 是模板引擎。它读取 Handlebars 源代码（{{invoice.number}}， {{#each items}}...{{/each}}），替换 JSON 有效负载中的值，并返回渲染后的 HTML。它不进行分页。分页是下一步的工作。

1. 添加 PDF4me PDF > PDF - 生成文档（单个）。
2. 配置：
   • 模板文件类型： Html (Handlebars Syntax)。
   • 模板文件名： invoice_template.html。
   • 模板文件数据动态内容， Body 来自 SharePoint 获取文件内容步骤。
   • 文档数据类型： Json。
   • 文档数据文本动态内容 Body 从“编写”步骤开始。
   • 输出类型： Html。
   • 保持PDF模板可编辑： No。

生成文档（单个）配置​

输出类型为 Html， 不是 Pdf.生成文档（单页）将渲染后的 HTML 传递给下一步，因此分页仍然是一个单独的、可测试的问题。

步骤 5：如何将渲染后的 HTML 分页到 A4 PDF 中？​

目前为止的流程： SharePoint 触发器 + 撰写 + 使用路径获取文件内容 + PDF - 生成文档（单个）。

“将 HTML 转换为 PDF”是分页引擎。它读取“生成文档（单行）”生成的 HTML，应用页面大小和边距，并返回 PDF 字节。

1. 添加 PDF4me PDF > 将 HTML 转换为 PDF。
2. 配置：
   • 文件内容动态内容 Body 从“生成文档（单个）”步骤。
   • HTML文件名： invoice.html。
   • 页面布局： Portrait。
   • 页面大小： A4。
   • 规模： 0.8 （5 项商品的发票可以放在一页上）。
   • 上/下/左/右边距： 40px 每个。
   • 打印背景： Yes （渲染总计块的背景颜色）。

将 HTML 转换为 PDF 配置​

0.8 的字体大小可以将五行发票显示在一张 A4 纸上。如果商品种类较少，需要更大的字体，可以将字体大小调整为 0.9 或 1.0。

步骤 6：如何将发票 PDF 保存到 Dropbox 并设置一个易于理解的名称？​

目前为止的流程： SharePoint 触发器 + 撰写 + 使用路径获取文件内容 + PDF - 生成文档（单个） + 将 HTML 转换为 PDF。

最后一步是将 PDF 文件放入一个 Dropbox 文件夹中，文件夹名称与发票号码关联。

1. 添加 Dropbox > 创建文件。
2. 配置：
   • 文件夹路径： / （或者类似这样的子文件夹） /invoices/）。
   • 文件名动态内容 Title 来自 SharePoint 触发器，后跟字面字符串 .pdf. INV-1005 变为 INV-1005.pdf。
   • 文件内容动态内容 Body 来自“将 HTML 转换为 PDF”步骤。

创建文件配置​

将文件命名为发票号码，Dropbox 文件夹就会自动变成一个可搜索、去重的发票存档。

运行流程并验证​

1. 节省 右上角的流水。
2. 向……添加新行 Invoices SharePoint 列表。将标题设置为易于识别的内容（INV-1005）并填写每一列，使模板包含真实数据。
3. 打开流程 运行历史记录 并选择最新运行结果。所有卡片都应显示为绿色，与流程概览截图类似。“将 HTML 转换为 PDF”卡片速度最慢（约 11 秒），因为分页操作在此处进行。
4. 打开 Dropbox 并确认 INV-1005.pdf （或您的标题）位于根目录。下载并打开它，然后与示例进行比较。

无需重建即可添加的常见变体​

常见问题​

如何使用 Power Automate 从 SharePoint 列表项创建 PDF？​

使用 SharePoint 的 When an item is created 作为触发器， Compose 执行将行的扁平列转换为嵌套 JSON 有效负载的操作 Get file content using path 从以下位置加载您的 HTML 模板： /Shared Documents/PDF4me Generate Document (Single) 将 JSON 合并到模板中，并使用 PDF4me Convert HTML to PDF 对结果进行分页。将输出保存到任意文件连接器（Dropbox、OneDrive、SharePoint）。该链中的每个操作都使用标准连接器层，因此您无需 Power Automate Premium 许可证。

PowerAutomatic能否生成PDF文件？​

是的。Power Automate 本身无法根据 HTML 模板渲染 PDF，但是…… PDF4me 连接器添加了使之成为可能的两个操作： Generate Document (Single) 用于模板渲染和 Convert HTML to PDF 用于分页。两者都属于标准版，可免费安装。它们配合使用，可以将 SharePoint/Dataverse/Excel 中的任何一行数据转换为带有品牌标识的 PDF 文件，所用模板为可编辑的 HTML 格式，存储在数据旁边。

如何在 Power Automate 中从 HTML 创建 PDF？​

添加 PDF4me 将 HTML 转换为 PDF 在流程中任何包含 HTML 的内容处执行操作（例如 Compose 输出、获取文件内容正文、Compose 表达式、Webhook 有效负载）。配置页面大小（A4）， 布局 （Portrait），边距（40px），并设置 Print Background: Yes 因此，CSS背景得以保留。该操作的 Body 输出文件是您提供给存储操作的 PDF 二进制文件。这与上面步骤 5 中使用的操作相同。

PowerAutomatic 能否在不付费的情况下将 HTML 转换为 PDF？​

是的。PDF4me 连接器的“将 HTML 转换为 PDF”操作属于标准连接器层级，这意味着您可以将其安装并用于任何 Power Automate 计划，而无需像原生连接器那样升级到高级许可证。 Convert File Adobe PDF Services 连接器也需要此功能。您仍然需要一个 PDF4me API 密钥（提供免费版本），在首次添加操作时粘贴该密钥即可。

如何在 Power Automate 中根据模板生成 PDF？​

使用 PDF4me 生成文档（单个） 和 Template File Type: Html (Handlebars Syntax) （适用于 HTML 模板） Word （为了 .docx （模板）。将模板字节馈送到 Template File Data 并将 JSON 有效负载导入 Document Data Text。 放 Output Type: Html 如果您之后需要分页（例如在本博客中），或者 Pdf 一步即可获取 PDF 文件。该操作支持完整的 Handlebars 语法，包括 {{#each}} 和 {{#if}} 适用于行项目和条件块。

故障排除​

后续步骤​

同样的六步模式（行+模板+渲染+分页+名称+存储）可以处理任何可以用HTML描述的按行品牌化的PDF。