資料設定參考

在範本設計工具中管理對應、計算和資料來源的參考指南。

範本設計工具中的 資料設定 標籤頁是您定義文件邏輯的地方。它將您的視覺設計連接到實際的資料來源（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. 檢視資料並點擊 載入。系統會自動為檔案中找到的所有欄位建議對應。