件名・本文にデータを差し込む

1. このページで伝える機能

相手の名前や注文番号などを件名・本文へ差し込めます。同じ文面から、対象データに応じた案内を作れます。

2. Wagby11で実現できること

文面の中で、相手の名前を${customerName}、注文番号を${orderId}と表しています。数量など、業務処理から渡す名前と一致させます。

たとえばcustomerNameが「サンプル商事」、orderIdが「OD-1001」、itemNameが「会議用マイク」、quantityが2のとき、次の文面になります。

件名：ご注文 OD-1001 を受け付けました

サンプル商事 様
ご注文 OD-1001 を受け付けました。
商品：会議用マイク
数量：2
お問い合わせ：サポート窓口

HTML本文なら、段落・太字・箇条書きなども指定できます。通常の文字列は自動的にHTMLエスケープされます。テキスト本文とHTML本文はそれぞれのタブで編集します。

3. AIへの指示例

最小限の指示例

注文先の名前と注文番号、商品名、数量をメールへ差し込んでください。

AIは業務データと差し込み名の対応、未入力時の扱い、件名と本文に載せる範囲を類推して補います。必要な値を送信処理から渡すことも含めて指示します。

より詳細な指示例

差し込み名をcustomerName、orderId、itemName、quantityに統一します。件名には注文番号、本文には注文先・注文番号・商品名・数量を表示してください。サンプル商事、OD-1001、会議用マイク、数量2で結果を確認してください。HTMLは通常の文字列のエスケープを維持し、値が渡されない場合も確認してください。
既存の定義・データ・権限を保持し、Wagby11のguide・referenceを確認してください。管理者向けの操作マニュアルを更新し、生成・ビルドと文面の保存・表示を確認してください。差し込みの確認はメールを送信せずに行ってください。

4. 編集されるAppSchemaの例

以下は関連する定義の抜粋です。構文を覚えなくても、どのような案内を送りたいかをAIへ伝えられます。

subject: 'ご注文 ${orderId} を受け付けました'
text_body: |-
  ${customerName} 様
  ご注文 ${orderId} を受け付けました。
  商品：${itemName}
  数量：${quantity}
html_body: |-
  <p>${customerName} 様</p>
  <p>ご注文 <b>${orderId}</b> を受け付けました。</p>

差し込みにはFreeMarker形式を使います。AppSchemaは文面を定義し、実際の値は業務処理から渡します。項目名を書くだけで保存データを自動取得するものではありません。未定義の変数は文面の展開時に検出されます。

5. 参考資料

guide：メール送信

designer/docs/appschema/html/guide/13-mail/index.html

reference：メールテンプレート定義

designer/docs/appschema/html/reference/22-mail-templates.html

Java技術文書：メール送信

designer/docs/appschema/html/java/23_mail_delivery.html