イベント起動アクションの追加

火災イベント・アクションを追加して、事前定義済イベントまたはアプリケーションで定義したカスタム・イベントを起動します。

イベント・タブを使用して作成されたカスタム・イベントは、application、フロー、ページまたはフラグメントに対して定義されます。これを使用すると、ページへのナビゲートなどの一部のアクションを実行でき、イベントの作成時に定義したペイロードを実行できます。

カスタム・イベントをトリガーするには、アクション・チェーンでFire Eventアクションを使用します。このアクションは、いくつかの方法で開始できます( 「アクション・チェーンの開始」を参照)。また、モジュール関数(JavaScript関数)でイベント・ヘルパーのfireCustomEvent()メソッド(「モジュール機能イベント・ヘルパー」を参照)を使用して、カスタム・イベントをトリガーすることもできます。この方法でカスタム・イベントをトリガーする方法の詳細は、「カスタム・イベントを起動してアクション・チェーンを開始」を参照してください。

このアクションのAPIの詳細は、「Oracle Visual Builderページ・モデル参照」の「起動イベント」を参照してください。

アクション・チェーンで「イベントの起動」アクションを使用して、イベントを処理するために別のアクション・チェーンを開始するカスタム・イベントをトリガーする方法の概要を次に示します:

カスタム・イベントを作成し、必要に応じてパラメータを定義します。
複数のアクション・チェーンを起動できるイベント・リスナーを作成します:
1. イベント・リスナーの作成ウィザードで、イベント・リスナーにカスタム・イベントを割り当てます:
  
  図jsac-assign-listener-custom-event.pngの説明
2. カスタム・イベントのアクション・チェーンを作成します。これは、イベントが起動イベント・アクションによってトリガーされたときに開始されます。リスナーのカスタム・イベントに入力パラメータがある場合、アクション・チェーンが作成され、入力パラメータを含むeventオブジェクトが渡されるため、「イベント・リスナー」タブを使用してアクション・チェーンを作成します(例: event.param1, event.param2...).
カスタム・イベントをトリガーしてそのアクション・チェーンを開始するには、アクション・チェーンを作成し、イベントに定義されたパラメータを指定してカスタム・イベントをトリガーする「イベントの起動」アクションを追加します。

起動イベント・アクションを使用するには:

組込みアクションの最後に説明されているように、3つの方法のいずれかでアクションを追加します。
「プロパティ」ペインで、使用可能なイベントの「イベント名」リストから既存のイベントを選択するか、「作成」をクリックして適切なスコープ・レベル(ページ、フローまたはapplication)で新しいカスタム・イベントを作成します。リストには、現在のスコープ内で使用可能なイベントが含まれます。
イベントに入力パラメータがある場合は、「パラメータ」プロパティが表示されます。パラメータを渡すには、パラメータの右端にマウス・ポインタを重ね、をクリックして変数を選択します。変数を作成する必要がある場合は、「変数」ダイアログの「作成」リンクを使用して、適切なスコープ・レベルで変数を作成します。

図jsac-fire-event-action-example.jpgの説明
イベントが値を返す場合は、「結果の保存先」プロパティによって表示される自動生成された変数に割り当てられます。