ページへのイベントのバインド
ページイベントマッピングを使用して UI ビルダー 内でデータ要素をバインドし、イベントアクションをページに追加できるようにします。
始める前に
必要なロール:ui_builder_admin
このタスクについて
- ページイベントマッピング。ページのアラート通知を追加、削除、またはクリアします。
- バリアントイベントマッピング。ページバリアントのアラート通知を追加、削除、またはクリアします。
- ディスパッチされるイベント。ページにディスパッチされるイベントを作成し、親イベントハンドラーの後にイベントをモデル化するリレーイベントマッピングを作成します。ターゲットの親イベントハンドラーを選択して、その後のペイロードフィールドをモデル化します。
- 処理済みイベント。処理済みイベントとは、他のユーザーが公開して使用できるイベントのことです。処理済みイベントを作成すると、Page event mappings で他のユーザーも使用できるようになります。手動で作成するペイロードフィールドを設定したり、モーダルダイアログのオープンやクローズなどの、処理済みイベントのテンプレートを選択したりすることもできます。
手順
- 移動先 すべて > Now Experience フレームワーク > UI ビルダー.
-
作業するエクスペリエンスを開くか、または選択してエクスペリエンスを作成します 作成/挿入 > エクスペリエンス.
詳細については、「UI ビルダー でユーザーがアプリケーションをどのように操作するかを構成する」を参照してください。
-
ページを開くかまたは作成します。
UI ビルダー でページを作成する方法の詳細については、「UI ビルダーでのページの作成」を参照してください。
-
コンテンツツリーでページ本文をハイライト表示します。
本文はコンテンツツリーの最上位の行です。ページ全体をハイライト表示すると、ページレベルのイベントを追加できます。
- 構成パネルで [イベント] タブを選択します。
-
次のいずれかの方法でイベントハンドラーを追加します。
追加するイベントハンドラー 操作 ページイベントマッピング Page ready ソースイベント: - [イベントハンドラーを追加] を選択します。
- ページからアラート通知を追加、削除、またはクリアするには、Page-level event handlers からイベントハンドラーを選択します。ページのアラート通知は、追加、削除、またはクリアできます。
- イベントハンドラーをページに追加するには、[追加] を選択します。
- [新しいイベントハンドラーを追加] を選択します。
- Page-level event handlers からイベントハンドラーを選択します。ページのアラート通知は、追加、削除、またはクリアできます。[ロード中ステータスを設定] を選択して、ページがロード中であることをユーザーが確認できるように、ページに「ロード中」と表示することもできます。[クライアントステータスパラメーターを更新] を選択して、クライアントステータス名を変更することもできます。
- イベントハンドラーをページに追加するには、[追加] をクリックします。
バリアントイベントマッピング バリアントイベントマッピング バリアントイベントマッピングを実行するには、バリアントページが必要です。利用可能なバリアントイベントマッピングは、バリアントページによって異なります。バリアントページにリストがある場合は、[行がクリックされました]、[ナビゲーションアイテム] などのイベントハンドラーを追加します。バリアントにビューポートがある場合は、さまざまなイベントハンドラーを設定できます。
- [イベントマッピングを追加] を選択します。たとえば、[行がクリックされました] に新しいイベントハンドラーを追加できます。
- 利用可能な継承されたイベントハンドラーまたはローカルイベントハンドラー (UXR アプリシェルデータソースなど) のリストからイベントハンドラーを選択します。
- イベントハンドラーをバリアントに追加するには、[追加] を選択します。
- これらのイベントマッピングは、
sys_ux_screenテーブルにあるバリアントレコードにあります。 - これらのイベントマッピングのソースイベントは、ページに対して定義されたディスパッチイベントです。
- これらのイベントマッピングに使用できるハンドラーは、キャンバスレベルのイベント、UXR アプリシェルデータソース、および継承されたデータリソースからの操作です。
- これらのイベントマッピングは、ページ上のコンポーネントからディスパッチされるイベントがユーザーセッションハンドラーにリレーされるように、リレーとして使用されます。
- これらのマッピングは、コンポーネントのディスパッチされたイベントを別のイベントにマッピングすると、ページの保存時に自動的に作成されます。たとえば、Button clicked イベントを Link to destination イベントにマッピングすると、そのイベントによって、ページの保存後に、ディスパッチされたリレーイベントとバリアントイベントのマッピングが作成されます。
ディスパッチされるイベント - [ディスパッチされるイベント] を選択します。
を選択します。
- [イベントを追加] 画面で、次のアクションを実行します。
- イベントのラベルを入力します。
- ターゲットの親イベントハンドラーを選択します。
- イベントハンドラーをディスパッチされるイベントに追加するには、[追加] を選択します。
- 作成した新しいイベントハンドラーが [ディスパッチされるイベント] に表示されます。次の例は、Link to destination イベントハンドラーを追加する方法を示しています。
-
これらのイベントは [sys_ux_event] テーブル内にあります。ページ定義レコードには、[sys_ux_event] レコードへの参照が含まれています。
-
これらのイベントは、バリアントイベントマッピングのソースイベントとして機能します。
-
ページのディスパッチされるイベントを新規作成するには、
を選択します。新しい
sys_ux_eventのイベント名とペイロードフィールドを自動入力するようにイベントラベルを構成します。 -
これらのイベントは、リレーイベントマッピングを作成するためによく使用されます。Target parent event handler を選択して、選択したイベント後のペイロードフィールドをモデル化します。ディスパッチされたイベントのペイロードフィールドを手動で作成することもできます。
処理されるイベント -
これらのイベントは [sys_ux_event] テーブルに保存されます。ページ定義レコードには、[sys_ux_event] レコードへの参照が含まれています。
-
これらのイベントは、ページイベントマッピングのソースイベントとして機能します。
-
ページのディスパッチされるイベントを新規作成するには、
を選択します。これらのイベントは、親イベントハンドラーを基にモデル化されることはありません。処理済みイベントのペイロードフィールドは手動で作成されます。既存のハンドラーのペイロードフィールドをテンプレートとして使用するには、テンプレートを選択し、必要に応じてフィールドを編集します。
- [Save (保存)] を選択します。
-
ページをプレビューして、設定したデータリソースイベントをテストするには、
を選択します。