数据设置

模板设计器中映射、计算和数据源管理的参考指南。

模板设计器中的 数据 选项卡用于定义文档背后的逻辑。它将可视化设计与实际数据源（Excel/CSV）连接，并处理计算和分组等业务逻辑。

部分概览

数据选项卡包含以下部分：

  1. 映射：将数据文件列连接到模板变量。
  2. 计算：使用公式创建新变量。
  3. 分组（必需）：定义如何将行拆分为单独的 PDF 文档。
  4. 数据关联：将源数据与收件人数据关联（类似 VLOOKUP）。
  5. 输出配置：设置生成 PDF 的文件命名规则。
  6. 数据源：加载用于预览和映射的示例数据。

1. 映射

映射允许模板从数据源文件的列中"读取"值。

  • 源数据（收据图标）：表示主要数据（例如发票、销售行）。这些数据通常每行不同。
  • 收件人数据（人物图标）：表示参考数据（例如客户列表、产品目录）。这些数据通常是静态的，或通过 ID 关联。

加载数据源（参见下方 数据源 部分）时，映射通常会自动创建。您也可以手动添加。

2. 计算

计算允许您从现有数据派生创建新变量。用于金额计算、税额计算或文本字段的组合。

示例： 从 UnitPrice（单价）和 Quantity（数量）计算总金额：

  • 名称：TotalAmount
  • 公式：{{UnitPrice}} * {{Quantity}}

创建后，{{TotalAmount}} 即可作为变量在设计中使用。

聚合（求和）

对于组级合计，可以使用 sum 类型代替公式。这会自动对组内所有行的指定字段求和：

  • 类型：sum
  • 字段：要求和的变量（例如 TotalAmount）

适用于计算小计、总计或其他从明细行聚合的值。

取整

计算支持 取整 选项，用于控制数值结果的取整方式：

  • floor：向下取整（例如 10.9 → 10）
  • ceil：向上取整（例如 10.1 → 11）
  • round：标准四舍五入（例如 10.5 → 11）

对于税额计算和货币格式化特别有用。

3. 分组

此设置为必填项。 分组键 决定如何处理多行数据。

  • 单行模式：如果数据中的每一行代表一个唯一文档，请选择唯一 ID 列（例如 InvoiceID）。
  • 多行模式：如果数据中包含同一文档的多行（例如包含 5 个明细行的发票），请选择标识文档的列（例如 InvoiceID）。引擎会将这 5 行分组到一个 PDF 中。

4. 数据关联

使用此部分将 收件人数据 关联到 源数据，类似于 Excel 中的 VLOOKUP。

  • 匹配值（导入数据）：源数据中充当"外键"的列（例如 CustomerID）。
  • 查找键（收件人数据）：收件人数据中的唯一 ID 列（例如 CustomerID）。

为什么使用此功能？ 如果您的源数据只有 CustomerID "C001"，但需要在发票上打印客户的完整地址，请关联收件人数据。系统将自动获取与 "C001" 关联的地址。

5. 输出配置

  • PDF 命名规则：定义生成 PDF 的文件名。
  • 默认值：{{InvoiceNo}}.pdf

您可以使用变量创建动态文件名，例如 Invoice_{{InvoiceNo}}_{{Date}}.pdf。

6. 数据源

此部分帮助您验证映射并预览连接的正确性。虽然可以手动映射，但加载实际数据文件能显著减少错误。

支持的格式

  • CSV 文件（.csv）
  • Excel 文件（.xlsx、.xls）

使用方法

  1. 点击 加载源数据 或 加载收件人数据。
  2. 从文件选择器中选择文件。
  3. 数据预览 对话框将会出现。
  4. 查看数据后点击 加载。系统将自动为文件中找到的所有列提供映射建议。