ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

通知テンプレートの作成

Liferay DXP 2023.Q4+/ポータル GA102+

通知テンプレートにより、Liferayサービスの自動化された電子メールやユーザー通知を設計できます。各テンプレートは、送信者、受信者、メッセージの内容を特定します。テンプレートをデザインする際に、サポートされているエンティティを検索し、そのデータをメールに動的に挿入するフィールド参照を追加できます。

現在、通知テンプレートはオブジェクトアクションのみをサポートしています。しかし、コマースチャネルには、チャネルイベントに対する通知テンプレート機能が組み込まれています。詳細については、「メールの保存」を参照してください。

重要

電子メール通知を使用するには、インスタンスにメールサーバーが設定されている必要があります。設定が完了すると、インスタンスレベルで追加の電子メール通知設定にアクセスできるようになります。

すぐに使用できる通知タイプがニーズを満たさない場合は、クライアント拡張機能を使用してカスタム通知タイプを作成できます。詳細については、マイクロサービスクライアント拡張を参照してください。

メール通知テンプレートの追加

グローバルメニュー () を開き、 コントロールパネル タブに移動して、通知の下の テンプレート をクリックします。
追加 () をクリックし、 電子メールを選択します。

フィールド参照を使用すると、エントリとユーザーデータをメッセージに動的に入力できます。用語の定義セクションでは、サポートされているフィールドを参照するオブジェクト定義を選択できます。一般条件セクションでは、通知アクションをトリガーするユーザーのフィールドを参照するための条件を見つけることができます。必要に応じて、テンプレートフィールドでこれらの参照用語を使用します。詳細については、用語の定義リファレンスを参照してください。
［Basic Info］で、テンプレートの名前と説明を入力します。
［Settings］で、メール送信者と受信者の連絡先を入力します。 Liferay DXP 2024.Q3/Portal GA125 以降では、受信者としてアカウント、組織、または通常の役割を選択できます。 Liferay DXP 2025.Q4/Portal 2026.Q1 以降では、ユーザーグループを受信者として設定できます。

複数の受信者を追加するには、メールアドレスをコンマまたはスペースで区切ります (例: test@liferay.com,learn@liferay.com、 [%TICKET_AUTHOR_EMAIL_ADDRESS%] [%CURRENT_USER_EMAIL_ADDRESS%])。
メールを個別に送信するか、一緒に送信するかを決定します。

まとめて送信する場合、電子メールには [宛先] フィールドの受信者の完全なリストが含まれます。メールを個別に送信すると、受信者のリストが非表示になります。

ヒント

メールをまとめて送信すると、透明性とコラボレーションが促進されます。メールを別々に送信するとプライバシーの保護に役立ちます。
［Content］で、件名を入力し、エディタータイプを選択し、メールの本文を作成します。

タイプは、［Rich Text」または［FreeMarker Template］を選択します。
(オプション）オブジェクトの添付フィールドを選択して、そのアセットをメール通知に含めます。

重要

通知アクションに関連するオブジェクトエントリーからのアセットのみを添付できます。
[保存]をクリックします。

作成後、オブジェクトアクションで通知テンプレートを使用できます。詳細については、オブジェクトアクションの定義を参照してください。

ユーザー通知テンプレートの追加

グローバルメニュー () を開き、 コントロールパネル タブに移動して、通知の下の テンプレート をクリックします。
追加 () をクリックし、 ユーザー通知を選択します。

フィールド参照を使用すると、エントリとユーザーデータをメッセージに動的に入力できます。用語の定義セクションでは、サポートされているフィールドを参照するオブジェクト定義を選択できます。一般条件セクションでは、通知アクションをトリガーするユーザーのフィールドを参照するための条件を見つけることができます。必要に応じて、テンプレートフィールドでこれらの参照用語を使用します。詳細については、用語の定義リファレンスを参照してください。
［Basic Info］で、テンプレートの名前と説明を入力します。
［Settings］で、通知の受信者を決定します。

定義済みの用語、ユーザー名、またはユーザーロールを使用できます。 Liferay DXP 2025.Q4/Portal 2026.Q1 以降では、ユーザーグループを受信者として設定できます。複数の受信者を追加するには、値をコンマまたはスペースで区切ります (例: [%TICKET_AUTHOR_ID%]、 [%TICKET_R_ASSIGNEE_USERID%])。

重要

受信者を動的に設定すると、オブジェクトエントリを追加する権限を持つユーザーだけが通知を受信できます。
［Content］セクションで、通知のメッセージを入力します。

定義された用語を使用して、動的に値を入力することができます。
[保存]をクリックします。

作成後、オブジェクトアクションで通知テンプレートを使用できます。詳細については、オブジェクトアクションの定義を参照してください。

参照用語を使用してユーザーおよびエントリデータにアクセスし、テンプレートのフィールドに動的に入力することができます。通知アクションをトリガーするイベントに関係するエントリとユーザーを参照できます。現在のエントリが 1 対多の関係の子側にある場合は、関連オブジェクトエントリ内のフィールドを参照することもできます。関連する入力フィールドへの参照には、 [%RELATIONSHIPNAME_PARENTOBJECTNAME_OBJECTFIELD%]というパターンを使用します。

User システムオブジェクトとの 1 対多関係の子側にあるカスタム Ticket オブジェクトを使用するシナリオを検討します。この関係によってチケットの担当者が決まります。エントリの更新時に担当者に通知するための通知アクションをチケットオブジェクトに追加すると、このアクションに使用されるテンプレートは、更新されたチケットと担当者の両方のデータにアクセスできるようになります。

用語は、カスタムオブジェクトフィールドとデフォルトオブジェクトフィールドの両方で使用できます。

重要

通知をトリガーするアクションに直接関係するエントリとユーザーのフィールドのみを参照できます。

現在のエントリのデフォルトの条件

現在のオブジェクトエントリに関する情報にアクセスするには、これらの用語を使用します。

ラベル	コマースの条件
作成者のメールアドレス	`[%OBJECTNAME_AUTHOR_EMAIL_ADDRESS%]`
作成者の名	`[%OBJECTNAME_AUTHOR_FIRST_NAME%]`
作成者 ID	`[%OBJECTNAME_AUTHOR_ID%]`
作成者の姓	`[%OBJECTNAME_AUTHOR_LAST_NAME%]`
作成者のミドルネーム	`[%OBJECTNAME_AUTHOR_MIDDLE_NAME%]`
作成者の接頭辞	`[%OBJECTNAME_AUTHOR_PREFIX%]`
作成者の接尾辞	`[%OBJECTNAME_AUTHOR_SUFFIX%]`
作成日時	`[%OBJECTNAME_CREATEDATE%]`
外部参照コード	`[%OBJECTNAME_EXTERNALREFERENCECODE%]`
ID	`[%OBJECTNAME_ID%]`
編集日	`[%OBJECTNAME_MODIFIEDDATE%]`
ステータス	`[%OBJECTNAME_STATUS%]`

現在のユーザーのデフォルトの利用規約

通知アクションをトリガーしている現在のユーザーに関する情報にアクセスするには、これらの用語を使用します。

ラベル	コマースの条件
現在ユーザーのメールアドレス	`[%CURRENT_USER_EMAIL_ADDRESS%]`
現在ユーザーの名	`[%CURRENT_USER_FIRST_NAME%]`
現在ユーザーの接頭辞	`[%CURRENT_USER_PREFIX%]`
現在ユーザーの姓	`[%CURRENT_USER_LAST_NAME%]`
現在ユーザーのミドルネーム	`[%CURRENT_USER_MIDDLE_NAME%]`
現在ユーザーの ID	`[%CURRENT_USER_ID%]`
現在ユーザーの接尾辞	`[%CURRENT_USER_SUFFIX%]`