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

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.* 値を入力します。
    コンポーネントの開発者がイベントにデフォルトのペイロード値を含めた場合、その値はオートコンプリート機能を介して選択できます。次の例に示すように、ペイロード値がパラメーター名と一致しない場合があります。

    

    注:

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

    デフォルト値が提供されていない場合、または一部のフィールドで指定すべき正しい値がわからない場合は、ServiceNow® 開発者サイト のコンポーネントの構成と 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 からページテンプレートを使用できます。

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

例に示すように、UI ビルダー で、Base Agent Workspace の [アナリティクスセンター] ページテンプレートに基づいて、「アナリティクスセンター」という名前のページを作成しました。次に、ページテンプレートのコンテンツのみをコピーするオプションを選択します。

[分析 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 を追加すると、イベントハンドラーが完了します。これで、このイベントの [[宛先にリンク] のリレー] イベントハンドラーを削除できます。

次の例は、「アナリティクスセンター」ページを示しています。このページでは、[優先度別のインシデント] のクエリを入力し、結果のレポートを取得できます。また、列をクリックすると、[[レポート可視化] がクリックされました] イベントがトリガーされます。イベントハンドラーを使用すると、レポート内のインシデントの簡単なリストを表示できます。

図 : 1. 構成された [レポートの視覚化がクリックされました (Report Visualization Clicked)] イベントのトリガー