フィルター ファセット ウィジェットインスタンスオプションの設定
ナレッジ管理 サービスポータルの検索結果ページでフィルターファセットウィジェットのウィジェットインスタンスオプションを設定します。
始める前に
このタスクについて
ホームページは、いくつかのウィジェットを使用して検索結果リストのアイテムをフィルタリングします。次の 2 つのタイプのファセット ウィジェットがあります。
- ナレッジ テーブル フィールドに基づく簡単なフィールド ファセット
- ナレッジ テーブルのカスタム クエリーに基づく詳細なクエリー ファセット
ウィジェットインスタンスオプションを使用して、次のファセット ウィジェットをカスタマイズします。
- ナレッジフィールドファセット (ナレッジベース、ナレッジカテゴリ、および作成者別にフィルタリングする場合)
- ナレッジ タグ ファセット (タグ別にフィルタリングする場合)
- ナレッジリソースファセット (記事やソーシャル Q&A などのリソース別にフィルター処理する場合)
- ナレッジ クエリー ファセット (評価、最終変更日、およびビュー数別にフィルタリングする場合)注:クエリファセットは、少なくとも 1 つのナレッジフィールドファセットがページに追加されている場合に表示されます。
デフォルトのナレッジ言語ウィジェットを使用して、ナレッジ検索結果ページに言語フィルターを含めます。カスタム言語ウィジェットを追加するには、ナレッジ検索結果ページでナレッジ言語ウィジェットを無効にする必要があります。
手順
- Knowledge Management Service Portal 検索結果ページに移動します。
- Ctrl キーを押しながらフィルター ファセット ウィジェットを右クリックします。
- [インスタンス オプション] をクリックします。
-
選択したタイプのファセット ウィジェットに対して希望する設定を行います。
インスタンス オプション 説明 タイトル フィルターファセットウィジェットのタイトル。 グリフ タイトルの左側に表示されるアイコン。 順番 フィルターファセットウィジェットが検索結果ページの左側に表示される順序。空の場合、フィルター ファセット ウィジェットはアルファベット順にソートされます。 ブートストラップの色 フィルターファセットウィジェットヘッダーの色。 CSS ウィジェットの要素の外観と操作感を決定するカスタム構成。詳細については、「Service Portal SCSS の基礎」を参照してください。 ソーステーブル フィルターファセットウィジェットオプションを提供するために使用される [ソースフィールド] を含むテーブル。デフォルトのテーブルは、ナレッジ (kb_knowledge) です。 ソース フィールド フィルターファセットウィジェットオプションを提供する [ソーステーブル] にあるフィールド。ソースフィールドとして使用できるフィールドタイプには、string、glide list、integer、reference、および boolean があります。 ファセット識別子 スクリプトコードで使用できるカスタムクエリーファセットの一意の名前。 ファセット テンプレート ファセットインタラクションのタイプを決めるテンプレート。 ナレッジフィールドファセット ウィジェット テンプレート:- Single Select (単一選択):ユーザーはこのウィジェットから 1 つのフィルターのみを選択できます。
- Multi Select (複数選択):ユーザーはこのウィジェットから複数のフィルターを選択できます。
- [ドロップダウン選択 (Dropdown Select)]:ユーザーはドロップダウン メニューから複数のフィルターを選択できます。
ナレッジ クエリー ファセット ウィジェット テンプレート- Simple Query (簡易クエリー):各ファセット値のラベルを示します。
- 評価:星による評価を示します。
カスタム テンプレート ファセットインタラクションと値選択を決定するカスタムテンプレート。 ファセット オプション 各ファセット値のラベル、ID、順番、およびクエリーの JSON 形式のカスタムクエリー。テーブル、値 (エンコードされたクエリー)、および表示値 (エンコードされたクエリー) を含みます。 順番 ファセットウィジェット内のフィルターオプションの順番。デフォルトの順番は [ラベル] で、オプションをアルファベット順にソートします。参照フィールドには、参照フィールド テーブルからの順番を示すこともできます。 フィルター検索バーを表示するための最小結果 フィルターファセットウィジェットの上部に検索バーを表示するために必要な結果の最小数。 スクロール バーを表示するための最小結果 フィルターファセットウィジェットにスクロールバーを表示するために必要な結果の最小数。 文字列フィールドの最大長 フィールドの最大長。長さがこの値より小さいフィールドのみが、フィルターファセットとして追加できます。 代替 URL パラメーター URL で検索パラメーターとして使用されている場合に、このフィルターファセットを初期化するために使用される URL パラメーターの名前。 最大値のフェッチ 検索結果のすべてのナレッジ記事からフィルター値をフェッチするオプション。
[最大値のフェッチ] オプションを選択すると、検索結果のロード時間に影響を与える可能性があります。このオプションを無効にすると、glide.knowman.search.facet_depth プロパティ値に基づいてロード時間が短縮されます。
glide.knowman.search.apply_acls プロパティが true に設定されている場合、そのフィルター値の検索結果がない場合でも、フィルターファセットにフィルター値が表示される可能性があります。たとえば、記事のないナレッジベースが、ナレッジベースフィルターファセットの値として表示される場合があります。
空の値を表示 有効にすると、このフィールドが設定されていない記事をフィルタリングするためにユーザーが選択できる空のフィルター ファセット オプションが表示されます。 たとえば、記事に割り当てられているカテゴリがない場合に、空のオプションをクリックすると、カテゴリが割り当てられていないすべての記事がリストされます。
結果に一致するファセット値のみを表示 すべての値を表示するのではなく、検索結果と一致するフィルター値のみを表示する動的フィルター ファセット ウィジェットを作成します。このインスタンスオプションを無効にすると、フィルターファセットデータのロードに必要な時間を短縮できます。 カテゴリ階層を表示する (kb_category にのみ有効) 有効にすると、第 4 レベルまでの階層リストとともにカテゴリを表示します。このオプションを有効にすると、一度に選択できるカテゴリは 1 つだけになります。第 4 レベル以降のサブカテゴリに含まれる記事は、カテゴリの第 4 レベルにも表示されます。選択した親カテゴリでフィルター処理された検索結果には、そのカテゴリ内の記事と関連するすべての子カテゴリが含まれます。 注:- 検索結果に返されるナレッジ記事の数が検索ファセットの深さよりも多い場合、すべてのカテゴリがこのファセットに表示されます。したがって、このファセットに表示される一部のカテゴリは、検索結果のナレッジ記事に関連付けられていない可能性があります。デフォルトでは、ファセットの深さは 300 に設定され、管理者が glide.knowman.search.facet_depth プロパティで設定します。
- フィルターを追加してナレッジ検索結果ページウィジェットを設定するには、次の操作を行います。特に、言語のフィルターを適用する必要がある場合は、OOB ナレッジ言語ウィジェットを使用する必要があります。フィールドファセットウィジェットは、インスタンスオプションの言語フィールドを使用して同様の動作を構成できますが、その場合は、ナレッジ検索結果ページで、OOB ナレッジ言語ウィジェットインスタンスを非アクティブにする必要があります。
- [保存] をクリックします。