プロファイル設定

データ処理、PDF 生成、メール送信ルールを定義するプロファイルの設定方法。

プロファイルは PDF Mail Engine の中心機能です。プロファイル は、データを読み込み、PDF を生成し、メールを送信するための一連のルールセットを作成します。「月次請求書」「イベントチケット」「支払いのリマインダー」など、用途ごとに複数のプロファイルを作成できます。

基本設定 (Core Configuration)

プロファイルを作成または編集するとき、Core Configuration セクションでファイル生成に必要な主要設定を行います。

設定項目	説明
Profile Name (プロファイル名)	プロファイルに一意の名前を付けます (例: "Invoices_2024")。この名前はファイルやログの整理に使用されます。
Description (説明)	このプロファイルの目的についてのメモを追加します。これはオプションで、あなただけが参照するためのものです。
Template File (テンプレート)	PDF とメールの内容がどのように生成されるかを定義するルールファイル (`.yaml`) を選択します。デフォルト: `templates/template.yaml`
Master Data File (マスターデータ)	顧客リストやアドレス帳 (CSV または Excel) を選択します。デフォルト: `data/master_data.csv`
PDF Output Folder (出力先)	生成された PDF を保存する場所を選択します。デフォルト: `outputs`

ジョブを実行すると、PDF Mail Engine は PDF Output Folder 内に ProfileName_Date_Time という形式のサブフォルダーを自動的に作成します。実行ごとに手動で新しいフォルダーを作成する必要はありません。

特定の Excel ファイルを使用する場合や、日本語の Excel 環境との互換性を確保したい場合は、これらの設定を使用します。

データが Excel ファイル (.xlsx) にある場合、読み込むシートを正確に指定できます。

これらのフィールドを空のままにすると、PDF Mail Engine は Excel ファイルの 最初のシート を自動的に読み込みます。

Add BOM Output: エクスポートされた CSV ファイルを Windows の Microsoft Excel で開く予定がある場合は、このボックスをチェックしてください。ファイルに特別なマーカー (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` (最初のシート)	マスターデータ用。
BOM Output	`csv_export_with_bom`	`false`	Excel/Shift-JIS 互換のために `true` に設定。