ライフサイクル・イベントからのアクション・チェーンの開始

ライフサイクル・イベントは、ページ・ライフサイクル中に発生する事前定義済のイベントです。これらのイベントが発生したときにアクション・チェーンを開始するには、イベント・リスナーを作成します。たとえば、ページのオープン時に一部のコンポーネント変数を初期化する場合は、vbEnterイベントをリスニングするアーティファクトにイベント・リスナーを作成できます。次に、イベント・リスナーを設定して、コンポーネント変数に値を割り当てるアクション・チェーンをトリガーできます。

アクション・チェーンをトリガーするイベント・リスナーを作成する前に、ページ・ライフサイクルを理解することが重要です。これにより、ページ・ライフサイクルを強化するためにカスタム・コードをどこに接続するかがわかります。 applicationの各ページには、一連の処理ステップであるライフサイクルが定義されています。これには、ページの初期化、変数とタイプの初期化、コンポーネントのレンダリングなどが含まれます。

ライフサイクルの各ステージには、関連付けられたイベントがあります。これらのイベントに対して"listen"を行い、要件に基づいて何かを実行するたびにアクション・チェーンを開始できます。たとえば、ページのロード前にデータをロードするには、vbEnterイベントを使用し、GET RESTエンドポイントを呼び出すアクション・チェーンを起動できます。

1つ以上のページでフローを作成し、各フローに独自のライフサイクルがあることに注意してください。

この表では、アクション・チェーンの開始に使用できるライフサイクル・イベントについて説明します:

ライフサイクル・イベント	説明
`vbBeforeEnter`	ページに移動する前にトリガーされます。ユーザーがページにアクセスしたり、ユーザーを別のページ(ログイン画面など)にリダイレクトする権限を持っていない場合によく使用されます。このイベントはページに移動する前にページにディスパッチされるため、プロパティ`cancelled`を`true` (`{ cancelled: true }`)に設定したオブジェクトを返すことで、ナビゲーションを取り消すことができます。このイベントでは、次の変数スコープを使用してデータを取得できます: `$application`: イベント・アクション・チェーンでは、すべてのapplication変数を使用できます `$flow`: イベント・アクション・チェーンでは、すべての親フロー変数を使用できます `$parameters`: URLのすべてのページ入力パラメータは、イベント・アクション・チェーンで使用できます
`vbEnter`	コンテナ・スコープ変数がデフォルト値、URLパラメータの値または永続値で追加および初期化され、現在のコンテナ階層およびapplication内のすべてのフローおよびページにディスパッチされた後にトリガーされます。一般的にデータのフェッチに使用されます。このイベントでは、次の変数スコープを使用してデータを取得できます: `$application`: イベント・アクション・チェーンでは、すべてのapplication変数を使用できます `$flow`: イベント・アクション・チェーンでは、すべての親フロー変数を使用できます `$page`: すべてのページ変数をイベントのアクション・チェーンで使用できます
`vbBeforeExit`	ページから移動する前に、階層内のすべてのページでトリガーされます。ユーザーがページを離れる前にページを保存する必要がある場合に警告したり、プロパティ`{ cancelled: true }`でオブジェクトを返すことでページへのナビゲーションを取り消したり(そのページを表示する権限がユーザーにないため)、一般に使用されます。
`vbExit`	ページから移動するときにトリガーされ、現在のコンテナ階層内のすべてのフローおよびページにディスパッチされます。ログアウト後にユーザー・セッションの詳細を削除する場合など、ページを離れる前にクリーン・アップを実行するために一般的に使用されます。
`vbAfterNavigate`	ページへのナビゲーションが完了した後にトリガーされ、階層およびapplicationのすべてのページおよびフローにディスパッチされます。イベント・ペイロード(`$event`)は、次のプロパティを持つオブジェクトです: `currentPage <String>`: 現在のページのパス `previousPage <String>`: 前のページのパス `currentPageParams <Object>`: 現在のページ・パラメータ `previousPageParams <Object>`: 前のページ・パラメータ
`vbNotification`	起動通知アクションがアプリケーションによって起動されたときにトリガーされます。
`vbResourceChanged`	アプリケーションが更新されたときにトリガーされます。通常、更新されたアプリケーションを表示するためにリフレッシュする必要があることをユーザーに通知するために使用されます。
`vbDataProviderNotification`	データ・プロバイダの暗黙的なフェッチがエラーで失敗した場合にトリガーされます。

ライフサイクル・イベントからアクションを開始するには:

アクション・チェーンをトリガーするイベントを含むページの「イベント・リスナー」タブを開きます。
「+イベント・リスナー」をクリックします。
イベント・リスナーの作成ウィザードで、ライフサイクル・イベント・カテゴリを展開し、アクション・チェーンをトリガーするイベントを選択します。「次へ」をクリックします。

「図page-designer-events-select.pngの説明」
トリガーするアクション・チェーンを選択します。アーティファクトのスコープとなるアクション・チェーンを選択できます。たとえば、フロー・アーティファクトのイベントを作成する場合、フローまたはapplicationで定義されているアクション・チェーンのみをコールできます。

新しいアクション・チェーンを今すぐ作成する場合は、andをクリックして新しいアクション・チェーンのIDを入力します。これは後でエディタで編集できます。「終了」をクリックします。

「図page-designer-settings-selectaction.pngの説明」

イベント・リスナーを作成した後、追加のアクション・チェーンを起動する場合は、ライフサイクル・イベントの「アクション・チェーンの追加」をクリックします。