アクションの種類について
Liferay 7.4 U60+/GA60+
アクションは、オブジェクトのエントリーイベントによって引き起こされるカスタム操作を定義します。 Liferayは以下のアクションの種類を提供します。
| 種類 | Description |
|---|---|
| 通知 | あらかじめ設定されたテンプレートを使って、メールやユーザー通知を送信します。 |
| オブジェクトエントリーを追加 | アクティブなオブジェクトにエントリーを作成します。 |
| オブジェクトエントリーを更新 | 現在のオブジェクトエントリーの項目を更新します。 |
| Webhook | URLにペイロードを配信します。 |
| Groovy スクリプト | Groovy スクリプトを実行します。 |
- Groovyスクリプトアクションは、Liferay PaaSおよびLiferay DXP Self-Hostedでのみ利用可能です。
- DXP 2024.Q2/Portal GA120以降、スクリプト機能はデフォルトで無効になっています。 システム設定 → スクリプト管理（セキュリティカテゴリ内）で有効にできます。
- オブジェクトアクションクライアント拡張機能 を使用してカスタムオブジェクトアクションを作成します。
通知
通知アクションにより、オブジェクトエントリーに関するユーザー通知またはメール通知を送信します。 ユースケースは以下の通りです。
- 新規受注時のメール通知を自動的に送信する
- カスタムチケットシステムで、チケットの更新についてのユーザー通知を自動的に送信する
- ユーザーにタスクやイベントをリマインドするため、手動でメール通知を送信する
各メッセージの送信者、受信者、および内容を決定するには、 通知テンプレート を選択する必要があります。 メール通知には、インスタンスに 構成されたメールサーバー も必要です。
標準搭載の通知タイプがニーズに合わない場合は、クライアント拡張機能を使用してカスタム通知タイプを作成できます。 詳細については、 マイクロサービス クライアント拡張機能 を参照してください。
オブジェクトエントリーを追加
指定されたオブジェクトにエントリーを作成します。 ユースケースは以下の通りです。
- 注文の支払い時に、カスタム出荷オブジェクトのエントリーを自動的に追加する
- 新規アカウントにデフォルトユーザーを自動的に追加する
- カスタムチケットシステム内で、現在のチケットに子チケットを手動で追加する。
有効なオブジェクトを選択する必要があります。 その後、エントリーのフィールドに規定値を設定できます。 これらの値を直接入力するか、 コード ( 
) をクリックして、値を動的に設定する式を使用します。 オブジェクトに必須項目が含まれている場合、規定値を設定する必要があります。
オブジェクトエントリーを更新
現在のオブジェクトエントリーの1つのまたは複数の項目を更新します。 ユースケースは以下の通りです。
- ユーザーが添付ファイルをダウンロードした後、エントリーのブール値フィールドを
trueに自動更新する - ボタンをクリックすると、チケットの担当者を現在のユーザーに手動で更新する
- ユーザーがお気に入り登録した後、エントリーのブール値フィールドを
trueに自動更新する
現在のエントリーで更新するフィールド（複数可）を選択し、新しい値を入力する必要があります。 これらの値を直接入力するか、 コード ( ) をクリックして、値を動的に設定する式を使用できます。
Webhook
Webhookアクションは、オブジェクトイベントが発生した際に、データペイロードをターゲットURLに送信します。 これにより、Liferayはリアルタイムデータを外部システムにプッシュできるようになります。
URL: URL フィールドにターゲットエンドポイントを入力します。 これは、外部システムがLiferayからのPOSTリクエストを受信する宛先です。
シークレット: ペイロードの整合性を検証するために使用されるオプションの共有文字列。 Liferayと受信システムの両方に同じ秘密鍵を設定することで、外部サービスはリクエストが正当であり、信頼できる送信元から送信されたものであることを検証できます。
ターゲットエンドポイントが OAuth 2.0 を必要とする場合は、代わりに オブジェクトアクションクライアント拡張機能 を使用する必要があります。
Webhookアクションを使用すると、Liferayをさまざまなサードパーティの自動化ツールやプラットフォームと統合できます。 詳しい手順については、 Google スプレッドシートでオブジェクトを使用する を参照してください。
Groovy スクリプト
DXP 2024.Q2/Portal GA120以降、スクリプト機能はデフォルトで無効になっています。 システム設定 → スクリプト管理（セキュリティカテゴリ内）で有効にできます。
Groovyスクリプトアクションは、Groovyスクリプトを実行します。 用意されたコードウィンドウにスクリプトを入力します。 Liferay 7.4 U33+/GA33+ では、Liferay は GroovyShell クラス を使用して、保存をクリックしたときに Groovy スクリプトの構文を検証します。 スクリプトが無効な場合、Liferayは一般的なエラーメッセージを表示します。
Groovyスクリプトは一部の環境で利用可能ですが、カスタムロジックを実装するには、オブジェクトアクションクライアント拡張機能を使用することをお勧めします。 クライアント拡張機能は、より拡張性の高いアプローチを提供し、OAuth 2.0などの最新のセキュリティ標準をサポートします。 詳細については、 オブジェクトアクションクライアント拡張機能 を参照してください。