メインコンテンツへスキップ

Word テンプレート構文 - マージフィールドガイド

差し込み印刷を用いた文書生成とは、データソースからデータを読み込み、テンプレート文書内の対応する変数を置き換えるプロセスです。この手法により、固定コンテンツと動的データを組み合わせることで、パーソナライズされた文書を大規模に効率的に作成できます。

メールマージテンプレートの理解​

一般的なメールマージ処理には、2つの重要な構成要素が必要です。

  1. テンプレート文書 - 実際のデータに置き換えられるマージフィールド(変数)が含まれています
  2. データソース - 書式設定手順と、生成される各ドキュメントで共通する情報の両方が含まれています。

PDF4me 複数のテンプレート形式をサポートしています。 Word、 HTML、 そして PDF ドキュメントテンプレートの作成方法や構造化方法に柔軟性を持たせることで、ドキュメントをカスタマイズできます。


基本的なマージフィールド構文​

差し込みフィールドを作成するには Word テンプレートを使用する場合は、次の構文を使用します。

<<[FieldName]>>

この構文は、ドキュメント生成プロセス中に実際のデータに置き換えられる、テンプレート内のプレースホルダーを定義します。

手動マージフィールド作成​

マージフィールドを手動で直接挿入できます Word 上記の構文を入力してドキュメントを作成してください。フィールド名は、データソース内の対応するプロパティ名と一致させる必要があります。

手動マージフィールド

使用例​

テンプレート:

Dear <<[CustomerName]>>,

Thank you for your order #<<[OrderNumber]>>.

データソース(JSON):

{
"CustomerName": "John Smith",
"OrderNumber": "12345"
}

生成された出力:

Dear John Smith,

Thank you for your order #12345.

テンプレートデザインのベストプラクティス​

フィールド命名規則​

  • 説明的で意味のあるフィールド名を使用してください
  • 一貫した命名規則に従ってください(例:キャメルケースまたはパスカルケース)。
  • フィールド名に特殊文字を使用しないでください
  • フィールド名は簡潔かつ明確にしてください。

テンプレートの構成​

  • 差し込みフィールドを追加する前に、テンプレートを論理的に構成してください。
  • テンプレート自体のマージフィールドに書式を適用する
  • 本番環境で使用する前に、サンプルデータを使用してテンプレートをテストしてください。
  • 異なるドキュメントタイプごとにテンプレートのバージョンを維持する

サポートされているテンプレート形式​

PDF4me 文書生成に使用できるテンプレート形式は以下のとおりです。

  • Word 文書 (.docx、.doc) - 完全サポート Word テンプレート構文
  • HTML テンプレート (.html) - Webベースのテンプレート構造
  • PDF テンプレート (.pdf) - フォームベース PDF テンプレート

各フォーマットは同じ差し込みフィールド構文をサポートしており、異なるテンプレートタイプ間での一貫性を確保しています。


次のステップ​

基本的な構文を理解したところで、高度なテンプレート機能について見ていきましょう。


関連リソース​

:::ヒント:高度なテンプレートの作成 高度なテンプレートを作成するための詳細な手順については、こちらをご覧ください。 Word高度な機能を備えたテンプレートについては、以下のセクションにある包括的なテンプレートドキュメントを参照してください。 :::