データタブ (Data Tab)

テンプレートデザイナーにおけるマッピング、計算、およびデータソース管理のリファレンスガイド。

テンプレートデザイナーの Data (データ) タブは、ドキュメントの背後にあるロジックを定義する場所です。ビジュアルデザインと実際のデータソース（Excel/CSV）を接続し、計算やグループ化などのビジネスロジックを処理します。

セクションの概要

データタブは以下のセクションで構成されています：

  1. Mappings (マッピング): データファイルの列をテンプレート変数に接続します。
  2. Calculations (計算フィールド): 数式を使用して新しい変数を作成します。
  3. Grouping (グルーピング) (必須): 複数の行を別々のPDFドキュメントに分割する方法を定義します。
  4. Master Data Link (宛先データの連携): 差し込みデータを宛先データと結合します（VLOOKUPスタイル）。
  5. Output Configuration (出力設定): 生成されるPDFのファイル命名規則を設定します。
  6. Data Sources (差し込みデータ): プレビューとマッピング用にサンプルデータを読み込みます。

1. Mappings (マッピング)

マッピングにより、テンプレートはデータソースファイルの列から値を「読み取る」ことができます。

  • Source Data (差し込みデータ) (レシートアイコン): メインデータ（請求書、売上行など）を表します。このデータは通常、行ごとに異なります。
  • Master Data (宛先データ) (人物アイコン): 参照データ（顧客リスト、商品カタログなど）を表します。このデータは多くの場合静的であるか、IDによって結合されます。

データソースを読み込むと（後述の Data Sources 参照）、マッピングは多くの場合自動的に作成されます。手動で追加することも可能です。

2. Calculations (計算フィールド)

計算を使用すると、既存のデータから派生した新しい変数を作成できます。金額、税金の計算、またはテキストフィールドの結合などに使用します。

例: UnitPrice (単価) と Quantity (数量) から合計金額を計算する場合：

  • Name: TotalAmount
  • Formula: {{UnitPrice}} * {{Quantity}}

作成すると、{{TotalAmount}} が変数としてデザインで使用できるようになります。

3. Grouping (グルーピング)

この設定は必須です。 Group Key (グループキー) は、複数の行をどのように処理するかを決定します。

  • Single-Row Mode (単一行モード): データの各行が1つのユニークなドキュメントを表す場合は、一意のID列（例：InvoiceID）を選択します。
  • Multi-Row Mode (複数行モード): データに1つのドキュメントに対して複数の行が含まれる場合（例：5つの明細行を持つ請求書）、ドキュメントを識別する列（例：InvoiceID）を選択します。エンジンはこれら5行を1つのPDFにグループ化します。

4. Master Data Link (宛先データの連携)

このセクションを使用して、ExcelのVLOOKUPのように、Master Data を Source Data に結合します。

  • Match Value (Import Data): 「外部キー」として機能する差し込みデータの列（例：CustomerID）。
  • Lookup Key (Master Data): 宛先データの一意のID列（例：CustomerID）。

なぜこれを使用するのですか？ 差し込みデータには CustomerID "C001" しかないが、請求書に顧客の完全な住所を印刷したい場合、宛先データをリンクします。システムは "C001" に関連付けられた住所を自動的に取得します。

5. Output Configuration (出力設定)

  • PDF Naming Rule (PDFファイル名規則): 生成されるPDFのファイル名を定義します。
  • Default: {{InvoiceNo}}.pdf

Invoice_{{InvoiceNo}}_{{Date}}.pdf のように変数を使用して動的なファイル名を作成できます。

6. Data Sources (差し込みデータ)

このセクションは、マッピングの検証と接続の正確性をプレビューするのに役立ちます。手動マッピングも可能ですが、実際のデータファイルを読み込むことでエラーを大幅に減らすことができます。

サポートされている形式

  • CSV Files (.csv)
  • Excel Files (.xlsx, .xls)

使用方法

  1. Load Source Data (差し込みデータ読み込み) または Load Master Data (宛先データ読み込み) をクリックします。
  2. ファイルピッカーからファイルを選択します。
  3. Data Preview (データプレビュー) ダイアログが表示されます。
  4. データを確認し、Load (読み込み) をクリックします。システムはファイル内で見つかったすべての列に対して自動的にマッピングを提案します。