Configurer les options d’instance de widget de facette de filtre

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 6 minutes de lecture
  • Configurez les options d’instance de widget pour les widgets de facette de filtre sur la Gestion des connaissances page des résultats de recherche du Portail de services.

    Avant de commencer

    Rôle requis : sp_admin ou admin

    Pourquoi et quand exécuter cette tâche

    La page d’accueil utilise plusieurs widgets pour filtrer les éléments dans la liste des résultats de recherche. Il existe deux types de widgets de facette :
    • Facettes de champs simples basées sur les champs de la table de connaissances
    • Facettes de requête avancée basées sur les requêtes personnalisées de la table de connaissances
    Utilisez les options de l’instance de widget pour personnaliser ces widgets de facette :
    • Facette des champs des connaissances (pour le filtrage par base de connaissances, catégorie de connaissances et auteur)
    • Facette des balises de connaissances (pour le filtrage par balise)
    • Facette des ressources de connaissances (pour le filtrage par ressource, comme les articles)
    • Facette des requêtes de connaissances (pour le filtrage par évaluation, date de dernière modification et nombre de vues)
      Remarque :
      Les facettes de requête s’affichent lorsqu’au moins une facette de champ de la base de connaissances est ajoutée à la page.

    Utilisez le widget de langue de la base de connaissances par défaut pour inclure des filtres de langue dans la page des résultats de recherche dans la base de connaissances. Pour ajouter un widget de langue personnalisé, vous devez désactiver le widget de langue de la base de connaissances sur la page des résultats de recherche dans la base de connaissances.

    Procédure

    1. Accédez à la page des résultats de recherche du Portail de services Gestion des connaissances.
    2. Ctrl + clic droit sur un widget de facette de filtre.
    3. Cliquez sur Options d’instance.
    4. Configurez les paramètres souhaités pour le type de widget de facette sélectionné.
      Options d'instance Description
      Titre Titre du widget de facette de filtre.
      Glyphe Icône qui apparaît à gauche du titre.
      Ordre Ordre dans lequel les widgets de facette de filtre apparaissent sur le côté gauche de la page des résultats de recherche. S’ils sont vides, les widgets de facette de filtre sont triés par ordre alphabétique.
      Couleur d'amorce Couleur de l’en-tête du widget de facette de filtre.
      CSS Configurations personnalisées qui déterminent l’apparence des éléments dans le widget. Pour plus d’informations, consultez Introduction à Service Portal SCSS.
      Table source Table contenant le champ Source utilisé pour fournir les options de widget de facette de filtre. La table par défaut est Connaissances (kb_knowledge).
      Champ source Champ de la table source qui fournit les options de widget de facette de filtre. Les types de champs pouvant être utilisés comme champ source comprennent la chaîne, la liste Glide, le nombre entier, la référence et le booléen.
      Identificateur de facette Nom unique de la facette de requête personnalisée qui peut être utilisée dans le code de script.
      Modèle de facette Modèle qui détermine le type d’interaction des facettes.
      Modèles de widgets de facette des champs de connaissances :
      • Sélection unique : les utilisateurs ne peuvent sélectionner qu’un seul filtre à partir de ce widget.
      • Sélection multiple : les utilisateurs peuvent sélectionner plus d’un filtre à partir de ce widget.
      • Sélection déroulante : les utilisateurs peuvent sélectionner plus d’un filtre à partir d’un menu déroulant.
      Modèles de widgets de facette de requête de connaissances
      • Requête simple : affiche une étiquette pour chaque valeur de facette.
      • Évaluation : affiche les étoiles d’évaluation.
      Modèle personnalisé Modèle personnalisé qui détermine l’interaction des facettes et la sélection de valeur.
      Options de facette Requête personnalisée au format JSON pour l’étiquette, l’ID, la commande et la requête pour chaque valeur de facette. Inclut la table, la valeur (requête codée) et la valeur d’affichage (requête codée).
      Trier par Ordre des options de filtre dans le widget de facette. L’ordre par défaut est l’étiquette, qui trie les options par ordre alphabétique. Pour les champs de référence, vous pouvez également indiquer un ordre à partir de la table de champs de référence.
      Résultats minimum pour afficher la barre de recherche du filtre Nombre minimum de résultats requis pour afficher une barre de recherche en haut du widget de facette de filtre.
      Résultats minimum pour afficher la barre de défilement Nombre minimum de résultats requis pour afficher une barre de défilement dans le widget de facette de filtre.
      Longueur maximale du champ de chaîne Longueur maximale du champ. Seuls les champs dont la longueur est inférieure à cette valeur peuvent être ajoutés en tant que facette de filtre.
      Autres paramètres d’URL Noms des paramètres d’URL utilisés pour initialiser cette facette de filtre, s’ils sont utilisés dans l’URL en tant que paramètre de recherche.
      Extraire les valeurs maximales

      Option permettant d’extraire les valeurs de filtre de tous les articles de la base de connaissances dans les résultats de recherche.

      La sélection de l’option Extraire les valeurs maximales peut avoir un impact sur le temps de chargement des résultats de recherche. Si cette option est désactivée, le temps de chargement s’améliore en fonction de la valeur de la glide.knowman.search.facet_depth propriété.

      Si la glide.knowman.search.apply_acls propriété est définie sur true, une valeur de filtre peut apparaître dans une facette de filtre même s’il n’y a pas de résultats de recherche pour cette valeur de filtre. Par exemple, une base de connaissances sans articles peut apparaître comme une valeur dans la facette du filtre de base de connaissances.

      Afficher la valeur vide Si cette option est activée, elle affiche une option de facette de filtre vide que les utilisateurs peuvent sélectionner pour filtrer les articles qui n’ont pas cet ensemble de champs.

      Par exemple, si un article n’a pas de catégorie affectée, cliquer sur l’option vide répertorie tous les articles sans catégorie affectée.

      Afficher uniquement les valeurs de la facette Résultats correspondants Crée un widget de facette de filtre dynamique qui affiche uniquement les valeurs de filtre qui correspondent aux résultats de la recherche au lieu d’afficher toutes les valeurs. Si vous désactivez cette option d’instance, le temps nécessaire au chargement des données de la facette de filtre est réduit.
      Afficher la hiérarchie des catégories (valide pour kb_category uniquement) Si cette option est activée, les catégories avec leur liste hiérarchique jusqu’au quatrième niveau. Lorsque vous activez cette option, vous ne pouvez sélectionner qu’une seule catégorie à la fois. Tous les articles qui sont inclus dans les sous-catégories au-delà du quatrième niveau apparaissent également dans le quatrième niveau de la catégorie. Les résultats de recherche filtrés sur une catégorie parente sélectionnée incluent les articles de cette catégorie et toutes les catégories enfants associées.
      Remarque :
      • Si le nombre d’articles de la base de connaissances renvoyés dans les résultats de recherche est supérieur à la profondeur de la facette de recherche, toutes les catégories sont affichées dans cette facette. Par conséquent, certaines catégories affichées dans cette facette peuvent ne pas être associées à des articles de la base de connaissances dans les résultats de recherche. Par défaut, la profondeur de la facette est définie sur 300 et configurée par un administrateur dans la glide.knowman.search.facet_depth propriété.
      • Pour configurer les widgets de la page Résultats de recherche dans la base de connaissances en ajoutant d’autres filtres. Plus précisément, si des filtres sur la langue doivent être appliqués, ils doivent utiliser le widget de langue de la base de connaissances OOB. Le widget de facette de champ peut être configuré à l’aide du champ de langue dans les options d’instance pour un comportement similaire, mais dans ce cas, l’instance de widget de langue de la base de connaissances OOB doit être désactivée sur la page des résultats de recherche dans la base de connaissances.
    5. Cliquez sur Enregistrer.