構成可能なワークスペースで 推奨アクション の全画面表示検索を有効にする

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • 全画面表示検索機能では、AI 検索の結果が展開されたビューの新しいサブタブに表示されます。構成可能なワークスペースでこの機能を有効にするには、次の情報を使用します。

    始める前に

    必要なロール:admin

    このタスクについて

    AI 検索の結果は、アクションを実行できるガイダンスの形でコンテキストサイドパネルの [推奨アクション] タブに表示されます。[全画面表示検索] アイコンを選択すると、AI 検索の結果が展開されたビューを含む新しいサブタブに表示されます。

    ユーザーが全画面表示検索アイコンを選択すると、推奨アクションアプリケーションは、タイプが raExpandedSearchRECOMMENDED_ACTIONS#ACTION_CLICKED と呼ばれるイベントをディスパッチします。このイベントは、全画面表示検索ページを取り込む対応するチームレイヤーで処理する必要があります。次のコードスニペットは、正しいプロパティを持つページに移動する方法の例を示しています。

    if (event.payload.actionProps.type == 'raExpandedSearch') {
              const { contextTable, contextId, contextSysId,
    searchTerm,selectedFilterTab,selectedFacetOptions, 
    selectedSortOption,actionConfigurations } = event.payload.actionProps;
              helpers.navigate.to('ra-expanded-search', { 'contextTable':
    contextTable, 'contextId': contextId }, {'contextSysId': contextSysId,
    'searchTerm': searchTerm, 'selectedFilterTab': selectedFilterTab,
    'selectedFacetOptions': selectedFacetOptions, 'selectedSortOption':
    selectedSortOption, 'actionConfigurations': 
    JSON.stringify(actionConfigurations)}, false, false, 'current');
          }
    構成可能なワークスペースで全画面表示検索ページを定義するには、次の手順に従います。

    手順

    1. UI ビルダーに移動し、ワークスペースエクスペリエンスを選択します。
    2. ra-expanded-search という URL パスを使用して新しいページを作成します。
      これは、上記のスクリプトで全画面表示検索ページを開くために使用するパスです。詳細については、UI ビルダードキュメントの「 空白ページの作成 」を参照してください。
    3. ページの次の必須パラメーターを選択します。
      • contextTable
      • contextId
    4. オプション: ページの次のオプションのパラメーターを選択します。
      • contextSysId
      • searchTerm
      • selectedFilterTab
      • selectedFacetOptions
      • 選択したソートオプション
      • actionConfigurations
    5. sys_ux_screen.list に移動し、[UX 画面] リストからページバリアントを選択して、ステップ 2 で作成したページバリアントを開きます。
    6. 全画面表示検索には、RA によって作成されたページ定義のコピーされたバージョンを使用します。
      たとえば、 推奨アクション拡張検索デフォルト (sysId - b646da9443a8c2108d82c8641ab8f2f3) などです。
      注:
      上記のページ定義を直接使用することはお勧めしません。
    7. ページバリアント内にビューポートを作成してガイダンス詳細エクスペリエンスをロードし、全画面表示検索ページで機能するようにします。
      1. sys_ux_app_route.list に移動し、[新規] を選択して、アプリルートレコードを作成します。
      2. 全画面表示検索ページの構成方法に基づいてフィールドに入力します。
      3. [送信] を選択します。
      注:
      CSM の推奨アクションの全画面表示検索ページとの競合を避けるために、必ず別のルート/親 macroponent 構成要素 ID を使用してください。