グローバルテキスト検索プロパティの設定

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:10分
  • アドミニストレーターは、グローバルテキスト検索の動作をシステムプロパティで制御できます。

    始める前に

    必要なロール:admin

    手順

    1. 次のように移動する。 All (すべて) > システムプロパティ > グローバルテキスト検索.
    2. 次のグローバルテキスト検索プロパティの値を確認し、必要に応じて変更します。
      表 : 1. グローバルテキスト検索の UI プロパティ
      プロパティ 説明
      グローバルテキスト検索を有効にします (glide.ui.text_search.enable)
      コア UI および UI15 でグローバル検索を有効にするオプション。
      • タイプ:ブーリアン
      • デフォルト値:true
      • サポートされている値は次のとおりです。
        • trueコア UI でのグローバル検索が有効です。
        • falseコア UI でのグローバル検索が無効です。
      注:
      ネクストエクスペリエンス が有効になっている場合、このシステムプロパティは無効です。ネクストエクスペリエンス統一ナビゲーション検索フィールドを有効または無効にするには、「glide.ui.polaris.global_search」で説明されているシステムプロパティを設定します ネクストエクスペリエンス システムプロパティ.
      グローバルテキスト検索機能を利用できるロールのリスト (カンマ区切り形式) (glide.ui.can_search)
      グローバル検索へのアクセスを許可するユーザーロールのカンマ区切りリスト。ロールを持つユーザーのグローバル検索を有効にするには、このリストにロールを追加します。
      • タイプ:文字列
      • デフォルト値:itil, text_search_admin, admin
      グローバルテキスト検索テーブルの設定時に、オプションとして表示しないテーブルのリスト (カンマ区切り形式) (glide.ui.no_text_search)
      コア UI のテキスト検索グループを定義するときにオプションとして表示されないテーブルのカンマ区切りリスト。例として、システムテーブルやメンテナンステーブルがあります。
      • タイプ:文字列
      • デフォルト値:sys_audit, sys_event, ecc_queue, ecc_event, syslog, syslog_transaction, sys_journal_field, sys_audit_relation, ecc_agent_log, ecc_mi_result, sysrule_escalate_history, sys_user_token, sys_time_dimension, sys_attachment_doc, sys_audit_delete
      テーブル当たりに返すグローバルテキスト検索一致項目数 (glide.ui.text_search.rowcount)
      グローバルテキスト検索結果ページの各テーブルに対してプレビューされる一致レコードの最大数。ユーザーはテーブルを選択して、そのテーブルのすべての一致する結果を表示できます。
      • タイプ:整数
      • デフォルト値:10
      注:
      このシステムプロパティは、コア UI のグローバルテキスト検索プレビュー制限のみを制御します。ネクストエクスペリエンス UI で、ワークスペースグローバル検索構成 [sys_aw_global_search_config] テーブルの Now Experience 検索構成レコードを編集することで、グローバル検索プレビューの制限を設定できます。
      グローバルテキスト検索のナレッジベース結果の背景色 (css.textsearch.kb.background.color)
      ナレッジ記事のグローバルテキスト検索結果の背景色。このプロパティは、従来のグローバル検索結果ページでの結果の表示にのみ影響します。
      • タイプ:文字列
      • デフォルト値:#f0f7f9
      グローバルテキスト検索のカタログ結果の背景色 (css.textsearch.catalog.background.color)
      カタロググローバルテキスト検索結果の背景色。このプロパティは、従来のグローバル検索結果ページでの結果の表示にのみ影響します。
      • タイプ:文字列
      • デフォルト値:#ffffdd
      グローバルテキスト検索の完全一致に使用するフォームビュー - 空の場合デフォルトのビューを使用します (glide.ui.text_search.match_view)

      グローバルテキスト検索で完全一致の結果を表示するために使用するフォームビューの名前。値が指定されていない場合、グローバルテキスト検索ではデフォルトのフォームビューを使用します。

      ビューの作成および管理については、「ビューの管理」を参照してください。
      • タイプ:文字列
      • デフォルト値:(空)
      グローバルテキスト検索の結果に対して使用するリスト/フォームビュー。空の場合、デフォルトのビューが使用されます (glide.ui.text_search.view)

      グローバルテキスト検索が、検索した各テーブルの結果を書式設定するために使用するリストビューの名前。値が指定されていない場合、グローバルテキスト検索ではデフォルトのリストビューを使用します。

      ビューの作成および管理については、「ビューの管理」を参照してください。
      • タイプ:文字列
      • デフォルト値:text_search
      グローバルテキスト検索のクエリメソッド。テーブルに関係なく単一のインデックスに対して、各テーブル、各基底クラス (親テーブル) に対してクエリを実行するか (テキストインデックスの再生成が必要)、または GlideRecord にクエリを処理させます (simple)。Zing テキスト検索エンジンの場合、優先する値は「simple」です (glide.ir.query_method)
      グローバルテキスト検索で使用するクエリメソッド。
      注:
      basesingle、および table の値はサポートされていません。このシステムプロパティをデフォルトの simple 値に設定したままにします。
      • タイプ:選択リスト
      • デフォルト値:simple
      • 使用可能な値:
        • base:基底クラスごとに検索クエリを実行します。この値のサポートは停止しています。
        • simple:GlideRecord に検索クエリを処理させます。
        • single:単一のテキスト検索インデックスに対して検索クエリを実行します。この方法を使用するには、テキスト検索インデックスを再生成する必要があります。この値のサポートは停止しています。
        • table:検索可能なテーブルごとに検索クエリを実行します。この値のサポートは停止しています。
      テキストインデックス検索中に返される結果の最大数。これにより、テキストインデックスから抽出されて表示されるレコードの数が制限されます (glide.lucene.base_result_max)
      テキスト検索インデックスを検索するときにグローバルテキスト検索で返される結果の最大数。
      注:
      クエリメソッドが simple に設定されている場合、このプロパティは無視されます。
      • タイプ:整数
      • デフォルト値: 100
      テキストインデックスから取得されるエントリの最大数。最大結果に指定された値とこの値の間にあるすべてのエントリのテキストインデックスからは、関連するテーブルのみが返されます。これは、表示される任意のテーブルに対してより多くの結果が存在することを示せるようにするために行われます (glide.lucene.base_hits_max)
      グローバルテキスト検索がテキスト検索インデックスから取得するエントリの最大数。
      注:
      クエリメソッドが simple に設定されている場合、このプロパティは無視されます。
      • タイプ:整数
      • デフォルト値: 500
      グローバル検索で複数グループを検索する場合に使用する同時プロセス数 (1 ~ 16) (glide.ts.global_search.parallelism) 複数の検索グループを検索するときにグローバルテキスト検索で使用する同時実行スレッドの数。検索グループごとに 1 つのスレッドが必要です。
      この値は、検索グループ構成に最適な結果が得られるように設定します。たとえば、5 つの検索グループと 4 つのスレッドがある場合、最初の 4 つのグループは並行して実行され、最初の 4 つのグループのいずれかが終了すると、5 番目のグループが開始されます。このセットアップは、グループの 1 つが他のグループよりもはるかに大きい場合に良好に機能する可能性があります。同様に、検索グループが 5 つある場合、この値を 5 より大きく設定してもメリットはありません。
      • タイプ:整数
      • デフォルト値: 4
    3. [保存] を選択します。
      ビジネスルールの [テキスト検索プロパティの合理的な変更] は、新しい値を検証し、許容範囲外である場合は更新を中止します。
    4. ワイルドカード検索用語に表示される一致の最大数を設定するには、次の手順を実行します。
      1. [システムプロパティ] テーブルを開き、プロパティ glide.ts.max_wildcard_expansion を検索します。
        フィールド 説明
        名前 glide.ts.max_wildcard_expansion
        説明 明確であるとみなせる、ワイルドカード検索用語の最大一致項目数。
        タイプ 整数
        デフォルト値 500
      2. [値] を編集します。
        ワイルドカード検索がこの値よりも多くの単語に一致する場合、ユーザーに検索を絞り込むように求めるメッセージが表示されます。
      3. [更新] を選択します。
    5. Zing テキスト検索の語幹言語を設定するには、次の手順に従います。
      1. テキスト検索用語を語幹化する言語の、インターナショナリゼーション (i18n) プラグインをインストールします。
      2. 次の新しいシステムプロパティを追加します:glide.ts.stemming_language
        フィールド 説明
        名前 glide.ts.stemming_language
        説明 テキスト検索の語幹化に使用する言語。語幹化の詳細については、「Zing による派生語と語幹解釈の一致」を参照してください。
        タイプ 文字列
        サポートされている値
        • 英語
        • フランス語
        • ドイツ語
        デフォルト値 英語
      3. テーブルでテキスト検索に新しい語幹言語を使用するようにするには、テキスト検索インデックスを手動で再生成します。
        この手順の詳細については、「テーブルのテキストインデックスの再生成」を参照してください。
    6. オプション: 完全一致の代替番号検索を有効にして設定するには、次の手順を実行します。
      注:
      代替番号検索はデフォルトで無効になっています。有効にすると、グローバルテキスト検索でレコード番号の完全一致が見つからない場合、指定されたテーブルのリストで一致が検索されます。この追加の検索により、グローバルテキスト検索に時間がかかる可能性があるため、代替番号検索は必要な場合にのみ有効にしてください。
      1. 代替番号検索を有効にするには、次の新しいシステムプロパティを追加します:glide.ui.text_search.enable_fallback_number_search
        フィールド 説明
        名前 glide.ui.text_search.enable_fallback_number_search
        説明 グローバルテキスト検索でレコード番号の完全一致が見つからない場合に使用する、代替番号検索を有効にするオプション。
        注:
        代替番号検索を有効にすると、グローバルテキスト検索に時間がかかる場合があります。このオプションは必要な場合にのみ有効にしてください。
        タイプ ブーリアン
        デフォルト値 false
      2. 代替番号検索によって検索されるテーブルのリストを構成するには、次の新しいシステムプロパティを追加します:glide.ui.text_search.fallback_table_list
        フィールド 説明
        名前 glide.ui.text_search.fallback_table_list
        説明

        代替番号検索を実行するときに検索するテーブルの名前のカンマ区切りリスト。

        番号 [sys_number] テーブルでプリフィックスが定義されているすべてのテーブルを検索するには、特別な値 all を使用します。
        注:
        検索するテーブルの数を増やすと、代替番号検索に必要とされる時間が長くなる可能性があります。本番環境に配置する前に、このシステムプロパティへの変更をテストしてください。
        タイプ 文字列
        デフォルト値 task,kb_knowledge