検索ソースを定義する

  • リリースバージョン: Xanadu
  • 更新日 2026年06月16日
  • 所要時間：4分

    • インスタンス テーブルからデータを照会するための基本検索ソースを構成するか、複数のテーブルやデータ ソース間でデータを照会するための高度なデータ フェッチ スクリプトを構成するか、または Web 上の任意の場所からデータを取得します。

    始める前に

    必要なロール：admin

    手順

    1. プラットフォーム UI で、 サービスポータル > ポータル をクリックし、検索ソースを追加するポータルを選択します。
    2. [検索ソース] 関連リストから、[新規] をクリックして検索ソースを追加します。
    3. [検索ソース] フォームでフィールドを定義します。
      表 : 1. [検索ソース] フォーム
      フィールド 説明
      名前 検索カテゴリの表示値です。
      ID レコード ID です。値は一意でなければならず、スペースや特殊文字は含めることはできません。
      アプリケーション 検索ソースの範囲です。
      ロール サービス ポータル ユーザー基準サポートのプラグインが有効になっていない場合は、この検索ソースにアクセスするためのユーザー ロールを定義します。
      検索ページ テンプレート

      検索結果を表示する HTML テンプレートです。基本検索ソースを定義する場合は、デフォルトのテンプレートを変更する必要はありません。

      変更されたテンプレートの例については、「チュートリアル：外部ナレッジベースの検索ソースを設定する」を参照してください。
    4. [データ ソース] タブのフィールドに入力します。
      フィールド 説明
      スクリプト化済みソース 高度なデータ フェッチ スクリプトを追加します。インスタンス テーブルをデータ ソースとして構成する場合は、このオプションを選択しないでください。
      データ フェッチ スクリプト

      データを取得するためのエンドポイントと API コールを定義するスクリプトです。このフィールドは、[スクリプト化済みソース] が選択された場合にのみ表示されます。

      データ フェッチ スクリプトの例については、「チュートリアル：外部ナレッジベースの検索ソースを設定する」を参照してください。

      注:
      ファセット生成スクリプトを定義する場合は、ファセットオブジェクトをデータフェッチスクリプトに挿入し、スクリプトを更新して各ファセットアイテムのデータを生成します。例については、ナレッジベースとサービスカタログの検索ソースを参照してください。 ServiceNow 以外のサイトからデータをクエリする詳細検索ソースに統合されている検索ファセットは、期待どおりに動作しないことがあります。
      ファセット生成スクリプト

      スクリプト化された検索ソースの検索ファセットを定義するスクリプトです。エンドユーザーが検索結果をフィルタリングして、より意味のある結果セットを得ることができます。 このフィールドは、[スクリプト化済みソース] が選択された場合にのみ表示されます。

      注:
      ファセット生成スクリプトを定義する場合は、ファセットオブジェクトをデータフェッチスクリプトに挿入し、スクリプトを更新して各ファセットアイテムのデータを生成します。例については、ナレッジベースとサービスカタログの検索ソースを参照してください。 ServiceNow 以外のサイトからデータをクエリする詳細検索ソースに統合されている検索ファセットは、期待どおりに動作しないことがあります。
      テーブル リストから結果を描画するテーブルを選択します。プラットフォーム内の任意のテーブルを選択できます。例、ユーザー [sys_user] またはナレッジ [kb_knowledge] 。
      注:
      インデックス付きテーブルのみが検索結果を返します。詳細：Configure a table for indexing and searching
      条件 定義された条件に基づいて結果をフィルタリングします。例、Active is True。
      プライマリ表示フィールド 検索結果ページに表示するフィールドを選択します。例、名前。
      表示フィールド 検索結果ページに表示する追加フィールドを選択します。例、ユーザー ID、メール、および市区町村。
      結果をページネーション

      検索結果をページネーションします。デフォルトでは true です。

      [スクリプト化済みソース] が選択されている場合、値は false に更新されます。スクリプト化された検索ソースのページネーションを有効にするには、「検索ソース結果をページネーション」を参照してください。

      検索ページ ウィジェットまたはファセット検索ウィジェット インスタンス オプションで、検索ソースのクエリごとの結果の最大数を定義します。
    5. ユーザー入力に基づいて検索フィールドに検索結果を入力できるようにする先行入力設定を構成します。
      フィールド 説明
      先行入力の有効化 先行入力機能を許可します。先行入力を検索ソースに統合しない場合は、チェックボックスをオフにします。
      先行入力詳細設定 必要に応じて、高度な先行入力スクリプトを追加して、検索結果の表示方法を構成します。詳細については、「高度な先行入力テンプレートを作成する」を参照してください。
      先行入力グリフ 各先行入力結果の横にアイコンを追加します。
      ページ 選択した結果を表示するサービス ポータル ページを定義します。たとえば、フォームが選択された場合、選択された先行入力結果がフォームで開きます。

      [先行入力] タブの設定例。ページ フィールドがフォームに設定されています。

    6. [送信] をクリックします。

    次のタスク

    エンド ユーザーが検索結果を絞り込めるようにするには、シンプルな検索ソースにファセットを追加する 。