設定檔管理

如何設定設定檔以定義資料處理、PDF 生成和郵件規則。

設定檔是 PDF Mail Engine 的核心。設定檔 建立一組可重複使用的規則，用於讀取資料、生成 PDF 和發送郵件。 您可以為不同用途建立多個設定檔，例如「每月發票」、「活動門票」或「付款提醒」。

核心設定

建立或編輯設定檔時，核心設定 區段處理開始生成檔案所需的基本設定。

設定項目說明
設定檔名稱為您的設定檔指定一個唯一名稱（例如「Invoices_2024」）。此名稱用於組織您的檔案和日誌。
說明新增關於此設定檔用途的私人備註。這是選填項目，僅供您參考。
範本檔案選擇定義 PDF 和郵件內容生成方式的規則檔案（.yaml）。
預設值：templates/template.yaml
主資料檔案選擇您的客戶清單或通訊錄（CSV 或 Excel）。
預設值：data/master_data.csv
PDF 輸出資料夾選擇生成的 PDF 要儲存的位置。
預設值：outputs

選填設定

如果您使用特定的 Excel 檔案，或需要確保與日文 Excel 環境的相容性，請使用這些設定。

Excel 工作表選擇

如果您的資料位於 Excel 檔案（.xlsx）中，您可以指定要讀取的確切工作表。

  • 匯入工作表名稱：包含交易資料（要處理的項目清單）的 Excel 工作表名稱。
  • 主資料工作表名稱：包含主客戶資料的 Excel 工作表名稱。

相容性設定

  • 新增 BOM 輸出：如果您計劃在 Windows 上的 Microsoft Excel 中開啟匯出的 CSV 檔案，請勾選此選項。這會在檔案中新增特殊標記（BOM），以防止日文字元顯示為亂碼。

技術詳細資訊

本節適用於系統管理員或透過直接編輯檔案來設定設定檔的使用者。

檔案與路徑邏輯

設定中的所有檔案路徑都相對於您的 設定檔工作區 資料夾。這允許您將整個設定檔資料夾複製或移動到另一台電腦而不會中斷連結。

欄位名稱內部鍵值預設值備註
設定檔名稱profile_name（必填）最多 50 個字元。
說明descriptionnull選填內部備註。
範本檔案pdf_template_pathtemplates/template.yaml需要 YAML 格式。
主資料master_csv_pathdata/master_data.csv支援 CSV、XLSX、XLS。
PDF 輸出pdf_output_base_diroutputs自動建立子資料夾。
匯入工作表import_sheet_namenull（第一個工作表）用於交易資料。
主資料工作表master_sheet_namenull（第一個工作表）用於主資料。
根路徑profile_root_path（自動生成）選填。覆寫此設定檔的預設資料目錄。
BOM 輸出csv_export_with_bomfalse設為 true 以相容 Excel/Shift-JIS。