イベントの別のページへのリンク

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：7分

    • UI ビルダー 内の宛先イベントハンドラーへのリンクを追加して、イベントアクションで別のページを開くことができるようにします。イベントハンドラーを、目的のページへのアプリルートをたどるように構成することもできます。

    始める前に

    クリックしたときに別のページを開くコンポーネントがあるワークスペースページが必要です。ダッシュボードの概要は、このようなコンポーネントの一例です。[宛先へのリンク] などのコンポーネントは、宛先イベントハンドルへのリンクをサポートしていません。コンポーネントリンクプロパティは、宛先イベントハンドラーへのリンクよりも優先されます。

    必要なロール：ui_builder_admin

    このタスクについて

    別のページを開くイベントアクションを構成するには、開くページ、そのページの必須パラメーターとオプションのパラメーター、および必要なパラメーターを宛先ページに渡すためにイベントハンドラーに設定するペイロード値を把握する必要があります。

    ヒント:
    リンク元のコンポーネントとリンク先の宛先ページの両方の例を、Base Agent Workspace エクスペリエンスで見つけることができます。この ネクストエクスペリエンス はベースシステムで提供されます。ページテンプレートからページを作成する場合は、テンプレートのコンテンツのコピーのみを実行してください。それに対する参照は実行しないでください。ページテンプレートのコピーと参照の違いの詳細については、「テンプレートからのページの作成」を参照してください。

    手順

    1. UI ビルダー でエクスペリエンスを開きます。
    2. オプション: 宛先ページがエクスペリエンスに存在しない場合は、作成します。
      ページの作成については、「UI ビルダー でのページの作成」を参照してください。ページを宛先として使用できるように、必ず必須パラメーターとオプションのパラメーターを設定します。ページ内の特定のコンポーネントが宛先である場合は、そのコンポーネントを含める必要があります。また、@context.props.<parameter-name> 値が指定されたページパラメーターを使用するように、コンポーネントのプロパティを構成する必要があります。

      ページテンプレートからページを作成することも検討できます。Base Agent Workspace エクスペリエンスには、他のコンポーネントの宛先として事前に構成されている複数のページテンプレートがあります。テンプレートから宛先ページを作成する場合、コンポーネントは事前に正しいプロパティで構成されています。必要なステータスパラメーターまたはクライアントスクリプトもコピーされます。ページパラメーターを追加する必要があります。これらのパラメーターは、ページテンプレートを含むエクスペリエンスのエージェントアプリ構成 [sys_ux_app_config] レコードにある、UX アプリルート関連リストからコピーできます。

      作成するページをエクスペリエンス内の宛先として確実に機能させるには、エクスペリエンスにページテンプレートを使用したエクスペリエンスと同じアプリシェル UI が必要です。

    3. 宛先ページにリンクするページに切り替えます。
    4. 関連するコンポーネントに移動して選択します。
    5. [イベント] タブを選択します。
    6. [+ イベントマッピングを追加] を選択します。
    7. 使用するイベントを選択します。
    8. [ + イベント ハンドラーを追加] を選択します。
    9. [継承されたイベントハンドラー] セクションで、[宛先へのリンク] を選択します。
      [継承されたイベントハンドラー] の [宛先へのリンク] を指す矢印
    10. [宛先を選択] をクリックします。
      [宛先を選択] ボタンを指す矢印。
    11. [ページ] を展開し、リンクするエクスペリエンスのページを選択します。
      ルートの先にある宛先ページの各パラメーターのフィールドが表示されます。必須パラメーターにはアスタリスク (*) が付いています。
    12. 必須パラメーターフィールドと該当するパラメーターフィールドのそれぞれに、適切な @payload.* 値を入力します。
      コンポーネントの開発者がイベントにデフォルトのペイロード値を含めた場合、その値はオートコンプリート機能を介して選択できます。次の例に示すように、ペイロード値がパラメーター名と一致しない場合があります。

      オートコンプリートを使用して、[UUID パラメーター (uuid parameter)] フィールドの @payload.indicator_sysId プロパティを選択します。

      注:
      アプリルートを指定する代わりに、外部 URL にリンクするオプションがあります。

      デフォルト値が提供されていない場合、または一部のフィールドで指定すべき正しい値がわからない場合は、ServiceNow® Developer サイト のコンポーネントの構成と API のドキュメントを参照してください。それでも必要な @payload.* 値が見つからない場合は、カスタマーサービス & サポート にお問い合わせください。

      ヒント:
      Base Agent Workspace ページテンプレートからページを作成してリンクコンポーネントを作成する場合、コンポーネントには [宛先にリンク] リレーイベントハンドラーが含まれます。これらのイベントハンドラーは機能しません。ただし、パラメーターに適用可能な @payload.* 値が含まれています。

    分析 Q&A コンポーネントのイベントハンドラーの構成

    新しい ネクストエクスペリエンス を取得し、分析 Q&A コンポーネントがあるページを追加するとします。最初に、Base Agent Workspace エクスペリエンスで提供されるアナリティクスセンターページテンプレートからページを作成します。次に、分析 Q&A の 3 つのイベントの最初のターゲットページを作成し、そのイベントのイベントハンドラーを構成します。

    次の場所に移動する Now Experiences フレームワーク > エクスペリエンスに、テストエクスペリエンス UX application が表示されます。Base Agent Workspace と同じ Agent Workspace アプリシェル UI を使用するため、Base Agent Workspace からページテンプレートを使用できます。

    UX アプリケーションのリスト。

    次に、[テストワークスペース (Test Workspace)] 管理パネルを選択し、UX アプリルートまたはページがない UX アプリ構成レコードを見つけて、[開く] をクリックします。

    [分析 Q&A 1] コンポーネントを選択し、[イベント] タブを開きます。ここから、[[レポート可視化] がクリックされました] イベントの [[宛先にリンク] のリレー] イベントハンドラーを開くことができます。分析 Q&A の質問がレポートを返す場合、レポート内の値をクリックしてこのイベントをトリガーできます。値をクリックすると、この値に寄与するレコードリストも表示されます。[ルート] フィールドに、宛先が [簡易リスト] ページテンプレートに基づくページになることが表示されます。@payload.* 値が対応する、[タイトル] フィールドに @payload.listTitle を入力できるページのパラメーターも表示されます。

    表 : 1. 提案された [簡易リスト] 宛先ページのパラメーターと、対応するペイロード
    パラメーター @payload.* 値
    table (必須) @payload.table
    listTitle @payload.listTitle
    query @payload.query
    disableInlineEditing なし

    宛先リレーイベントハンドラー。

    次に、次の場所に移動します メニュー > ページの作成 をクリックし、簡易リストテンプレートに基づくページを作成します。たとえば、ページの名前を「レコードリスト」とします。次に、「アナリティクスセンター」ページを作成したときと同様のプロセスに従います。今度は、プロセスの最後のステップで、必須パラメーターとして table を追加し、オプションのパラメーターとして listTitle、query、disableInlineEditing を追加します。

    [ページを作成] ウィザードの最終ページ

    このページには既にリストコンポーネントが含まれているため、このコンポーネントの [構成] タブを開くと、パラメーターが @context.props.* 値に既に渡されていることがわかります。

    リストコンポーネントの [構成] タブ。

    ここで「アナリティクスセンター」ページに戻ります。[[レポート可視化] がクリックされました] イベントで、新しいイベントハンドラーを追加します。次に、作成したレコードリストページを選択し、[[宛先にリンク] のリレー] イベントハンドラーから取得した情報に従って、table、listTitle、および query フィールドに @payload.* 値を追加します。これらのフィールドに入力する際に、予測入力が役立ちます。

    宛先イベントハンドラーへのリンクのナビゲーションを構成します。

    [OK] をクリックし、[タイトル] として @payload.listTitle を追加すると、イベントハンドラーが完了します。これで、このイベントの [[宛先にリンク] のリレー] イベントハンドラーを削除できます。