マップイベントの定義

UI ビルダー のイベントマッピングとは、イベントのペイロードまたはコンテキスト値を、そのイベントを操作するオブジェクトまたはハンドラーにマッピングするプロセスのことです。4 つのイベントタイプは、コンポーネント、ページ、データリソース、および宣言アクションです。

イベントマッピングは UI ビルダー の重要なプロセスです。コンポーネントを使用してページを構築する場合は、ユーザー向けのアクションを実行するためのコンポーネントが必要です。たとえば、ボタンコンポーネントをページに追加する場合は、ボタンクリックイベントをイベントハンドラーにマッピングする必要があります。このイベントハンドラーは、ユーザーが選択したときにボタンクリックアクションを実行します。たとえば、フォームなどのデータリソースを追加した際に、フォームが正常にロードされたときにイベントハンドラーでユーザーに通知するなどです。

イベントタイプ

利用可能なイベントタイプは、コンポーネントに基づいています。たとえば、宣言アクションイベントは、アクションバーやリストコンポーネントなどの特定のコンポーネントで使用できます。

ページで実行するアクションに基づいて、イベントのタイプを選択します。たとえば、Web ページをロードするボタンなど、アクションをコンポーネントにバインドする場合は、コンポーネントイベントを使用します。ページにアラート通知を追加するなど、ページ全体にイベントを適用する場合は、ページイベントを使用します。次の表では、UI ビルダー で利用可能な各イベントタイプについて説明し、イベントの使用方法の例を示します。

表 : 1. イベントタイプと説明

イベントタイプ	説明
コンポーネントイベント	コンポーネントをセットアップするアクション。そのコンポーネントアクションを構成するイベントハンドラーを設定します。たとえば、Web ページへの移動など、ボタンのアクションを適用するイベントハンドラーを追加します。コンポーネントへのイベントのバインドの詳細については、「コンポーネントへのイベントのバインド」を参照してください。
ページイベント	ページ全体に対してアクションを実行するページイベント。次のページイベントを構成できます。 ページイベントマッピング。 これらのイベントマッピングは、[sys_ux_macroponent] テーブルにあるページ定義レコードに保存されます。 これらのイベントマッピングのソースイベントは、ページ準備完了とページプロパティです。これらはページに対して定義されます。 これらのイベントマッピングに使用できるハンドラーは次のとおりです。 ユーザーセッションイベント ページレベルイベント UXR アプリシェルデータソース ページで定義されているクライアントスクリプト ローカルおよび継承されたデータリソースからの操作 バリアントイベントマッピング。 これらのイベントマッピングは、[sys_ux_screen] テーブルにあるバリアントレコードに保存されます。 これらのイベントマッピングのソースイベントは、ページに対して定義されたディスパッチイベントです。 これらのイベントマッピングに使用できるハンドラーは、キャンバスレベルのイベント、UXR アプリシェルデータソース、および継承されたデータリソースからの操作です。 バリアントイベントマッピングは、ページ上のコンポーネントからディスパッチされるイベントをユーザーセッションイベントハンドラーにリレーできるように、リレーとして使用されます。 コンポーネントのディスパッチされたイベントをユーザーセッションハンドラーにマッピングすると、ページの保存時にマッピングが自動的に作成されます。たとえば、[クリックしたボタン] イベントをキャンバスレベルの [宛先にリンク] イベントにマッピングすると、そのイベントによって、ページの保存時に、ディスパッチされたリレーイベントとバリアントイベントのマッピングが作成されます。 ディスパッチされるイベント。 これらのイベントは [sys_ux_event] テーブルに保存されます。ページ定義レコードには、[sys_ux_event] レコードへの参照が含まれています。 これらのイベントは、バリアントイベントマッピングのソースイベントとして機能します。 [+ 追加] を選択して、ページの新しいディスパッチイベントを作成できます。新しい sys_ux_event のイベント名とペイロードフィールドを自動入力するようにイベントラベルを構成します。 これらのイベントは、リレーイベントマッピングを作成するために使用されます。[ターゲットの親イベントハンドラー] を選択して、選択したイベント後のペイロードフィールドをモデル化します。ディスパッチされたイベントのペイロードフィールドを手動で作成することもできます。 処理済みイベント。 これらのイベントは [sys_ux_event] テーブルに保存されます。ページ定義レコードには、[sys_ux_event] レコードへの参照が含まれています。 これらのイベントは、ページイベントマッピングのソースイベントとして機能します。 [+ 追加] を選択して、ページの新しいディスパッチイベントを作成できます。処理されるイベントが、親イベントハンドラーを基にモデル化されることはありません。処理済みイベントのペイロードフィールドは手動で作成されます。既存のハンドラーのペイロードフィールドをテンプレートとして使用するには、テンプレートを選択し、必要に応じてフィールドを編集します。 ページへのイベントのバインディングの詳細については、「ページへのイベントのバインド」を参照してください。
データリソースイベント	データがフェッチされたときに通知を出すデータリソースにマッピングされるイベント。 データフェッチが開始されました。データリソースイベントがトリガーされると、イベントハンドラーがデータフェッチプロセスを実行します。 データのフェッチに成功しました。データリソースイベントがトリガーされると、イベントハンドラーはデータフェッチが正常に完了した場合のユーザーへの通知プロセスを実行します。 データのフェッチに失敗しました。データリソースイベントがトリガーされると、イベントハンドラーはデータフェッチが失敗した場合のユーザーへの通知プロセスを実行します。 データリソースへのイベントのバインディングの詳細については、「データリソースへのイベントのバインド」を参照してください。
宣言アクションイベント	データ要素を UI ビルダー 内でバインドして、イベントアクションを宣言アクションに追加します。 Now Platform® 宣言アクションアサインテーブルで、宣言アクションイベントマッピングを構成します。例については、次に移動します。 フィルターナビゲーター > sys_declarative_action_assignment.リスト 次に、既存の宣言アクションを検索して開きます。 UI ビルダー で、イベントを宣言アクションにバインドします。宣言アクションイベントの使用方法の詳細については、「宣言アクションへのイベントのバインド」を参照してください。