検索ソースの定義

  • リリースバージョン: Australia
  • 更新日 2026年06月17日
  • 所要時間：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. [送信] をクリックします。

    次のタスク

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