UI ビルダーのイベントペイロード

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • イベントペイロードを使用して、データをアクションにリンクします。

    イベントペイロードは、選択したイベントがトリガーされたときにコンポーネントによって送信されるデータです。イベントによって送信されるデータには、イベントのタイプ、タイムスタンプ、ユーザーアクション、または SysID などのリソースデータが含まれます。UI ビルダーでイベントペイロードを使用して、ページ上のコンポーネント間で情報を共有できます。

    イベントハンドラーを構成するときにこのペイロードデータを使用して、結果のインタラクションを出力データにリンクできます。例えば、SysID をページ上の他のコンポーネントに渡して、指定したレコードに関連する情報を表示できます。

    選択したコンポーネントで利用可能なイベントペイロードを含む赤色のボックス。

    各コンポーネントとイベントには、一意のペイロードオプションのセットがあります。各コンポーネントのイベントペイロードが適切に定義されていない場合があります。その場合は、コンソールが console.log(event.payload) などのペイロードをログに記録するようにクライアントスクリプトを定義します。

    ペイロードを使用してイベントを作成し、コンポーネント間で情報を共有する

    UI ビルダーでイベントペイロードを使用して、ページ上のコンポーネント間で情報を共有します。

    始める前に

    必要なロール:ui_builder_admin

    手順

    1. 移動先 すべて > Now Experience フレームワーク > UI ビルダー.
    2. 作業するエクスペリエンスを開くか、または選択してエクスペリエンスを作成します 作成/挿入 > エクスペリエンス.
    3. ページを作成するか、開きます。
      UI ビルダーでページを作成する方法の詳細については、「UI ビルダーでのページの作成」を参照してください。
    4. データ可視化コンポーネントなど、イベントを含むコンポーネントを追加します。
      コンポーネントをページに追加する方法の詳細については、「コンポーネントの追加と構成」を参照してください。
    5. コンポーネントにイベントハンドラーを追加するには、[イベント] タブを選択します。
      コンポーネントにイベントハンドラーを追加する方法の詳細については、「「Manage actions in UI Builder pages (UI ビルダーページでのアクションの管理)」」を参照してください。
      1. イベントハンドラーをコンポーネントに設定するプロセスを開始するには、[イベントマッピングを追加] をクリックします。
        [イベントマッピングを追加] オプションを指す矢印。
      2. リストから構成するイベントマッピングを選択します。
        データ可視化コンポーネントで利用可能なイベントマッピングのリスト。
      3. [続行] を選択します。
      4. イベントハンドラーのプレビューセクションで、コンポーネントにバインドするイベントハンドラーを選択します。
        リスト内の行がクリックされたときにアラート通知をクリアします。リストから選択されたクライアントステータスパラメーターハンドラーを更新します。
      5. [続行] を選択します。
      6. [クライアントステータスパラメーター名] ドロップダウンから [新しいクライアントステータスパラメーターの作成] を選択します。
      7. [名前] フィールドに名前を入力します。
      8. [タイプ] ドロップダウンからクライアントステータスパラメーターのタイプを選択します。
      9. [初期値] フィールドに値を入力します。
      10. [イベントをトリガーした後に使用する値 (Value to use after triggering event)] フィールドで、「データのバインド」アイコンを選択します。
        [イベントをトリガーした後に使用する値 (Value to use after triggering event)] フィールドの [データをバインド] アイコンを指す矢印。
      11. トリガーされたイベントにバインドする値を選択します。
        「データをバインド」モーダル
      12. [適用] を選択します。
      13. [追加] を選択します。
        データハンドラーは、[イベント] タブのイベントマッピングの下に表示されます。

        データ可視化コンポーネントの構成済みイベントハンドラーを指す矢印。

    6. クライアントステータスパラメーターをバインドするコンポーネントを選択します。この例では、見出しコンポーネントを使用します。
    7. クライアントステータスパラメーターをバインドするフィールドの「データのバインド」アイコンを選択します。
      見出しコンポーネントの [ラベル] フィールドにある [データをバインド] アイコンを指す矢印。
    8. [クライアントステータス] を選択します。
    9. バインドするクライアントステータスパラメーターの横にある矢印を選択します。
      クライアントステータスパラメーターを [ラベル] フィールドにバインドする矢印を指す矢印。
    10. [適用] を選択します。
    11. [保存] を選択します。
    12. [プレビュー] を選択して、構成したイベントをテストします。