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

通知テンプレートの作成

Liferay DXP 2023.Q4+/Portal GA102+

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

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

重要

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

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

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

グローバルメニュー（）を開き、［コントロールパネル］タブに移動し、通知の下にある［Templates（テンプレート）］をクリックします。
新規をクリックし、 メール を選択します。

フィールド参照を使用すると、入力データやユーザーデータを使って通知メッセージを動的に生成できます。通知をトリガーしたユーザーの参照キーにアクセスするには、「一般用語」セクションを使用するか、オブジェクト定義のフィールドの参照キーを見つけるには、「用語の定義」セクションを使用してください。動的な値を含めるには、これらの参照用語をメッセージテンプレートにコピーしてください。詳細については、用語の定義リファレンスを参照してください。
［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%] を使用します。

ユーザーシステムオブジェクトとの一対多の関係において、子側に位置するカスタムチケットオブジェクトが存在するシナリオを考えてみましょう。この関係によって、チケットの受取人が決定されます。チケットオブジェクトに、エントリの更新時に担当者に通知する通知アクションを追加すると、このアクションに使用されるテンプレートは、更新されたチケットと担当者の両方のデータにアクセスできます。

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

重要

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

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

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

ラベル	コマースの条件
作成者のメールアドレス	`[%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%]`