快速开始

了解如何安装 PDF Mail Engine、设计模板并发送您的第一批发票。

PDF Mail Engine 是一款安全的本地优先工具，用于批量生成 PDF 并通过邮件发送。 本指南将帮助您在几分钟内完成从安装到发送第一张发票的全过程。

步骤 1：安装

最安全的安装方式是通过 Microsoft Store。

从 Microsoft Store 获取

  1. 点击上方按钮。
  2. 点击 获取（或 安装）。
  3. 安装完成后，点击 打开。

步骤 2：创建第一个配置文件

首次启动应用时，主页会显示两个引导选项：

  • Create New Profile（创建新配置文件） — 使用您自己的数据从头开始设置。
  • Try Demo Data（尝试演示数据） — 使用预加载的示例数据体验应用功能（推荐初次使用者选择，参见下文）。

点击 Create New Profile，输入一个描述性名称（如 月度发票），然后点击 Create（创建）。 您将进入 Profile（配置文件） 设置页面。

配置邮件设置（SMTP）

在配置文件设置页面中，找到 SMTP & Email Configuration 部分，配置用于发送邮件的服务器。您需要邮件服务商提供的连接信息：

  • Host（主机）：服务器地址（例如 smtp.example.com）
  • Port（端口）：通常为 587（TLS）或 465（SSL）
  • Username（用户名）：您的登录 ID（通常是邮箱地址，请确认您的服务商要求）
  • Password（密码）：您的登录密码
  • SSL/TLS：如果服务商要求则启用（通常为"是"）

步骤 3：设计模板

接下来，创建 PDF 的布局。您将使用可视化的 模板设计器。

1. 下载示例数据

首先，下载以下示例发票数据用于设计： 📥 sample_invoices.csv

2. 打开设计器

在配置文件设置页面的右下角，点击 Template Designer（模板设计器） 按钮。

3. 初始化模板

开始设计前，会出现一个配置窗口来设置数据结构：

  1. 加载数据：点击 Load Transaction Data（加载交易数据），选择刚下载的 sample_invoices.csv 文件。
  2. 分组键：选择用于唯一标识文档的列（例如 id）。
  3. 电子邮件地址：选择包含电子邮件地址的列（例如 email）。
  4. PDF 文件名：定义文件命名规则。可以使用变量，如 {{ id }}_{{ name }}.pdf。
  5. 点击 Finish（完成）。

4. 创建布局

现在您已进入可视化设计器画布。

  1. 添加文本：将 Text 元素拖放到画布上。
  2. 映射变量：在文本内容区域输入：您好，{{ name }}。
    • 您将看到使用示例数据的实时预览更新。
  3. 保存：点击 Save（保存），将其命名为 invoice_template.yaml。

步骤 4：生成与发送

配置文件已准备就绪（邮件已配置、模板已选择），现在运行任务。

1. 导入数据

在侧边栏中导航到 数据导入，选择相同的 sample_invoices.csv。 （实际业务中，这将是您的月度数据导出文件）

2. 生成 PDF

在侧边栏中导航到 PDF生成，点击 Run Process（执行）。引擎将处理 CSV 中的每一行，将 {{ name }} 替换为实际姓名（例如"张三"、"李四"），并在输出文件夹中创建 PDF。

3. 发送邮件

在侧边栏中导航到 邮件发送。查看队列内容，然后点击 Run Process（执行），将生成的 PDF 作为邮件附件发送。

尝试演示数据

如果您想在设置自己的数据之前先体验应用，请在主页选择 Try Demo Data（尝试演示数据）：

  1. 点击 Setup Demo（设置演示）。
  2. 可选择输入 SMTP 服务器信息（可跳过此步骤，稍后再配置）。
  3. 系统将自动创建包含示例模板和数据的演示配置文件。

这是在创建自己的配置文件之前了解整个工作流程的最佳方式。

总结

您已成功完成以下操作：

  1. 配置了配置文件。
  2. 初始化并设计了动态模板。
  3. 生成并发送了个性化的 PDF。

下一步：