#基本的な使い方

テンプレート印刷プラグインは、テンプレートに動的なデータやロジック構造を柔軟に挿入するためのさまざまな構文を提供しています。ここでは、構文の詳細な説明と使用例をご紹介します。

#基本的なデータ置換

{d.xxx} の形式のプレースホルダーを使ってデータを置換します。例えば：

• {d.title}: データセットから title フィールドを読み込みます。
• {d.date}: データセットから date フィールドを読み込みます。

使用例：

テンプレートの内容：

お客様各位、

この度は、弊社製品「{d.productName}」をご購入いただき、誠にありがとうございます。
ご注文番号：{d.orderId}
ご注文日：{d.orderDate}

ご活用いただければ幸いです。

データセット：

{
  "productName": "スマートウォッチ",
  "orderId": "A123456789",
  "orderDate": "2025-01-01"
}

レンダリング結果：

お客様各位、

この度は、弊社製品「スマートウォッチ」をご購入いただき、誠にありがとうございます。
ご注文番号：A123456789
ご注文日：2025-01-01

ご活用いただければ幸いです。

#サブオブジェクトへのアクセス

データセットにサブオブジェクトが含まれている場合、ドット記法を使ってサブオブジェクトのプロパティにアクセスできます。

構文：{d.parent.child}

使用例：

データセット：

{
  "customer": {
    "name": "李雷",
    "contact": {
      "email": "lilei@example.com",
      "phone": "13800138000"
    }
  }
}

テンプレートの内容：

お客様名：{d.customer.name}
メールアドレス：{d.customer.contact.email}
電話番号：{d.customer.contact.phone}

レンダリング結果：

お客様名：李雷
メールアドレス：lilei@example.com
電話番号：13800138000

#配列へのアクセス

データセットに配列が含まれている場合、予約語 i を使って配列内の要素にアクセスできます。

構文：{d.arrayName[i].field}

使用例：

データセット：

{
  "staffs": [
    { "firstname": "James", "lastname": "Anderson" },
    { "firstname": "Emily", "lastname": "Roberts" },
    { "firstname": "Michael", "lastname": "Johnson" }
  ]
}

テンプレートの内容：

最初の従業員の姓は {d.staffs[i=0].lastname}、名は {d.staffs[i=0].firstname} です。

レンダリング結果：

最初の従業員の姓は Anderson、名は James です。