配置文件设置
了解如何配置配置文件以定义数据处理、PDF 生成和邮件发送规则。
配置文件是 PDF Mail Engine 的核心。配置文件 创建了一套可重复使用的规则，用于读取数据、生成 PDF 和发送邮件。 您可以为不同用途创建多个配置文件，例如"月度发票"、"活动门票"或"付款提醒"。
基本设置
创建或编辑配置文件时，基本设置 部分包含开始生成文件所需的核心设置。
| 设置项 | 说明 |
|---|---|
| 配置文件名称 | 为配置文件设置一个唯一名称（例如"Invoices_2024"）。此名称用于组织文件和日志。 |
| 说明 | 添加关于此配置文件用途的备注。此项为可选，仅供您自己参考。 |
| 模板文件 | 选择定义 PDF 和邮件内容生成规则的文件（.yaml）。默认值： templates/template.yaml |
| 收件人数据文件 | 选择客户列表或通讯录（CSV 或 Excel）。 默认值： data/master_data.csv |
| PDF 输出文件夹 | 选择生成的 PDF 的保存位置。 默认值： outputs |
自动整理功能
运行任务时，PDF Mail Engine 会在 PDF 输出文件夹 中自动创建格式为 ProfileName_Date_Time 的子文件夹。无需每次运行时手动创建新文件夹。
可选配置
使用特定 Excel 文件或需要确保与中文/日文 Excel 环境兼容时，请使用这些设置。
Excel 工作表选择
如果数据位于 Excel 文件（.xlsx）中，可以精确指定要读取的工作表。
- 导入工作表名称：包含交易数据（待处理项目列表）的 Excel 工作表名称。
- 收件人工作表名称：包含收件人数据的 Excel 工作表名称。
默认行为
如果这些字段留空，PDF Mail Engine 将自动读取 Excel 文件的 第一个工作表。
兼容性设置
- 添加 BOM 输出：如果您打算在 Windows 的 Microsoft Excel 中打开导出的 CSV 文件，请勾选此选项。这会在文件中添加特殊标记（BOM），防止中文字符显示为乱码。
技术详情
本部分面向系统管理员或通过直接编辑文件来配置配置文件的用户。
文件与路径逻辑
配置中的所有文件路径都是相对于 配置文件工作区 文件夹的相对路径。这使您可以将整个配置文件文件夹复制或移动到另一台计算机，而不会破坏链接关系。
| 字段键 | 内部键 | 默认值 | 备注 |
|---|---|---|---|
| Profile Name | profile_name | （必填） | 最多 50 个字符。 |
| Description | description | null | 可选的内部备注。 |
| Template File | pdf_template_path | templates/template.yaml | 需要 YAML 格式。 |
| Master Data | master_csv_path | data/master_data.csv | 支持 CSV、XLSX、XLS。 |
| PDF Output | pdf_output_base_dir | outputs | 自动创建子文件夹。 |
| Import Sheet | import_sheet_name | null（第一个工作表） | 用于交易数据。 |
| Master Sheet | master_sheet_name | null（第一个工作表） | 用于收件人数据。 |
| Root Path | profile_root_path | （自动生成） | 可选。覆盖此配置文件的默认数据目录。 |
| BOM Output | csv_export_with_bom | false | 设为 true 以兼容 Excel/Shift-JIS。 |