Définir les propriétés de recherche de texte global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 8 minutes de lecture

    • Les administrateurs peuvent contrôler le comportement de la recherche de texte global avec les propriétés système.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Propriétés système > Recherche de texte global.
    2. Examinez les valeurs des propriétés de recherche de texte global suivantes et modifiez-les si nécessaire.
      Tableau 1. Propriétés de l’interface utilisateur pour la recherche de texte global
      Propriété Description
      Activer la recherche de texte global (glide.ui.text_search.enable)
      Option permettant d’activer la recherche globale dans Interface utilisateur principale UI15.
      • Type : booléen
      • Valeur par défaut: true
      • Valeurs prises en charge :
        • true: la recherche globale est activée dans Interface utilisateur principale.
        • false: la recherche globale est désactivée dans Interface utilisateur principale.
      Remarque :
      Lorsque Next Experience cette option est activée, cette propriété système n’a aucun effet. Pour activer ou désactiver le champ de Navigation unifiée recherche dans , définissez la glide.ui.polaris.global_search propriété système décrite dans Next Experience Next Experience propriétés système.
      Liste de rôles (séparés par des virgules) qui peuvent utiliser l’option de recherche de texte global (glide.ui.can_search)
      Liste séparée par des virgules des rôles d’utilisateur qui autorisent l’accès à la recherche globale. Pour activer la recherche globale pour les utilisateurs disposant d’un rôle, ajoutez le rôle à cette liste.
      • Type : chaîne
      • Valeur par défaut: itil, text_search_admin, admin
      Liste de tables (séparées par des virgules) qui ne s’afficheront pas en tant qu’options lors de la configuration des tables de recherche de texte global (glide.ui.no_text_search)
      Liste séparée par des virgules des tables qui n’apparaissent pas en tant qu’options lors de la définition de groupes de recherche de texte pour Interface utilisateur principale. Les tables système ou de maintenance en sont des exemples.
      • Type : chaîne
      • Valeur par défaut: 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
      Nombre de correspondances de recherche de texte global renvoyées par table (glide.ui.text_search.rowcount)
      Nombre maximal d’enregistrements correspondants prévisualisés pour chaque table sur la page des résultats de recherche de texte global. Les utilisateurs peuvent sélectionner une table pour afficher tous les résultats correspondants pour cette table.
      • Type : entier
      • Valeur par défaut : 10
      Remarque :
      Cette propriété système contrôle uniquement la limite d’aperçu de la recherche de texte global dans Interface utilisateur principale. Dans Next Experience l’interface utilisateur, vous pouvez définir la limite d’aperçu de la recherche globale en modifiant l’enregistrement de configuration de recherche Now Experience dans la table Configurations de recherche globale de l’espace de travail [sys_aw_global_search_config].
      Couleur d’arrière-plan de la recherche de texte global pour les résultats de la base de connaissances (css.textsearch.kb.background.color)
      Couleur d’arrière-plan pour les résultats de recherche de texte global de l’article de la base de connaissances. Cette propriété affecte uniquement l’affichage des résultats sur la page des résultats de recherche globale héritée.
      • Type : chaîne
      • Valeur par défaut: #f0f7f9
      Couleur d’arrière-plan de la recherche de texte global pour les résultats du catalogue (css.textsearch.catalog.background.color)
      Couleur d’arrière-plan pour les résultats de recherche de texte global du catalogue. Cette propriété affecte uniquement l’affichage des résultats sur la page des résultats de recherche globale héritée.
      • Type : chaîne
      • Valeur par défaut: #ffffdd
      La vue du formulaire à utiliser pour la correspondance exacte de la recherche de texte global ; un champ vide signifie Vue par défaut (glide.ui.text_search.match_view)

      Nom de la vue de formulaire que la recherche de texte global utilise pour afficher les résultats de correspondance exacte. Si aucune valeur n’est spécifiée, la recherche de texte global utilise la vue de formulaire par défaut.

      Pour plus d’informations sur la création et la gestion des vues, voir Gestion des vues.
      • Type : chaîne
      • Valeur par défaut : (vide)
      Vue de la liste et du formulaire à utiliser pour les résultats de la recherche de texte global. Un champ vide correspond à la vue par défaut (glide.ui.text_search.view)

      Nom de la vue de liste que la recherche de texte global utilise pour formater les résultats de chaque table recherchée. Si aucune valeur n’est spécifiée, la recherche de texte global utilise la vue de liste par défaut.

      Pour plus d’informations sur la création et la gestion des vues, voir Gestion des vues.
      • Type : chaîne
      • Valeur par défaut: text_search
      Méthode de requête pour la recherche de texte global. Exécutez une requête pour chaque table, pour chaque classe de base (table parente), par rapport à un index unique quelle que soit la table (nécessite la régénération de l’index de texte) ou laissez GlideRecord gérer la requête (simple). Avec le moteur de recherche de texte Zing, la valeur préférée est « simple » (glide.ir.query_method)
      Méthode de requête à utiliser pour la recherche de texte global.
      Remarque :
      Les basevaleurs , single, et table ne sont pas prises en charge. Laissez cette propriété système définie sur sa valeur par défaut simple .
      • Type : liste de choix
      • Valeur par défaut: simple
      • Valeurs disponibles :
        • base: exécuter une requête de recherche pour chaque classe de base. Cette valeur n’est plus prise en charge.
        • simple: laisser GlideRecord gérer la requête de recherche.
        • single: exécuter une requête de recherche sur un index de recherche de texte unique. Pour utiliser cette méthode, vous devez régénérer les index de recherche de texte. Cette valeur n’est plus prise en charge.
        • table: exécuter une requête de recherche pour chaque table pouvant faire l’objet d’une recherche. Cette valeur n’est plus prise en charge.
      Le nombre maximal de résultats trouvés durant une recherche d’index de texte. Cela limite le nombre d’enregistrements extraits de l’index de texte et affichés (glide.lucene.base_result_max)
      Nombre maximal de résultats que la recherche de texte global renvoie lors de la recherche dans un index de recherche de texte.
      Remarque :
      Lorsque la méthode de requête est définie sur simple, cette propriété est ignorée.
      • Type : entier
      • Valeur par défaut : 100
      Le nombre maximal d’entrées à récupérer à partir de l’index de texte. Seule la table impliquée est renvoyée depuis l’index de texte pour toutes les entrées comprises entre la valeur spécifiée pour les résultats maximum et cette valeur. Cela permet d’indiquer qu’il existe d’autres résultats pour une table donnée qui vont être affichés (glide.lucene.base_hits_max)
      Nombre maximum d’entrées que la recherche de texte global récupère à partir d’un index de recherche de texte.
      Remarque :
      Lorsque la méthode de requête est définie sur simple, cette propriété est ignorée.
      • Type : entier
      • Valeur par défaut : 500
      Nombre de processus simultanés (1 à 16) utilisés lors de la recherche dans plusieurs groupes avec une recherche globale (glide.ts.global_search.parallelism) Nombre de threads simultanés que la recherche de texte global utilise lors de la recherche de plusieurs groupes de recherche. Chaque groupe de recherche nécessite un thread.
      Définissez cette valeur pour obtenir des résultats optimaux pour la configuration de votre groupe de recherche. Par exemple, si vous avez cinq groupes de recherche et quatre threads, les quatre premiers groupes s’exécutent en parallèle et le cinquième groupe commence lorsque l’un des quatre premiers groupes se termine. Cette configuration peut bien fonctionner si l’un des groupes est beaucoup plus grand qu’un autre. De même, si vous avez cinq groupes de recherche, une valeur supérieure à cinq n’apporte aucun avantage.
      • Type : entier
      • Valeur par défaut : 4
    3. Sélectionnez Enregistrer.
      La règle métier Changement de propriété de recherche de texte valide rationnellement les nouvelles valeurs et abandonne la mise à jour si elles se trouvent en dehors de ses plages acceptables.
    4. Pour définir le nombre maximal de correspondances à afficher pour un terme de recherche par caractère générique, procédez comme suit.
      1. Ouvrez la table Propriétés système et recherchez la propriété glide.ts.max_wildcard_expansion.
        Champ Description
        Nom glide.ts.max_wildcard_expansion
        Description Nombre maximal de correspondances pour un terme de recherche générique autorisées comme non équivoques.
        Type Entier
        Valeur par défaut 500
      2. Modifiez la valeur.
        Si une recherche par caractère générique correspond à plus de mots que cette valeur, le système affiche un message demandant à l’utilisateur d’affiner la recherche.
      3. Sélectionnez Mettre à jour.
    5. Pour définir le langage de recherche de texte Zing, procédez comme suit.
      1. Installez le module d’extension internationalisation (i18n) pour la langue dans laquelle vous souhaitez obtenir des termes de recherche de texte stem.
      2. Ajoutez une nouvelle propriété système, glide.ts.stemming_language:
        Champ Description
        Nom glide.ts.stemming_language
        Description Langue à utiliser pour la recherche textuelle. Pour plus d’informations sur la radicalisation, reportez-vous à la section Zing associe les mots dérivés à la racine.
        Type Chaîne
        Valeurs prises en charge
        • Anglais
        • Français
        • Allemand
        Valeur par défaut Anglais
      3. Pour que les tables utilisent le nouveau langage de recherche de texte pour la recherche de texte, régénérez manuellement leurs index de recherche de texte.
        Pour plus de détails sur cette procédure, reportez-vous à la section Régénérer un index de texte pour une table.
    6. Facultatif : Pour activer et configurer la recherche de numéro de secours pour les correspondances exactes, procédez comme suit.
      Remarque :
      La recherche par numéro de secours est désactivée par défaut. Lorsqu’il est activé, si une recherche de texte global ne trouve aucune correspondance exacte pour un numéro d’enregistrement, le système recherche des correspondances dans une liste de tables spécifiées. Cette recherche supplémentaire peut allonger les recherches de texte global. Activez donc la recherche par numéro de secours uniquement si vous en avez besoin.
      1. Pour activer la recherche par numéro de secours, ajoutez une nouvelle propriété système, glide.ui.text_search.enable_fallback_number_search:
        Champ Description
        Nom glide.ui.text_search.enable_fallback_number_search
        Description Option permettant d’activer la recherche par numéro de secours à utiliser lorsque la recherche de texte global ne trouve aucune correspondance exacte avec un numéro d’enregistrement.
        Remarque :
        La recherche par numéro de secours peut allonger les recherches textuelles globales. Activez l’option uniquement si vous en avez besoin.
        Type Booléen
        Valeur par défaut Faux
      2. Pour configurer la liste des tables recherchées par recherche par numéro de secours, ajoutez une nouvelle propriété système, glide.ui.text_search.fallback_table_list:
        Champ Description
        Nom glide.ui.text_search.liste_table_secours
        Description

        Liste de noms de tables séparés par des virgules à rechercher lors de la recherche par numéro de secours.

        Utilisez la valeur all spéciale pour rechercher toutes les tables qui ont des préfixes définis dans la table Nombre [sys_number].
        Remarque :
        L’augmentation du nombre de tables à rechercher peut augmenter le temps requis pour la recherche par numéro de secours. Testez tous les changements apportés à cette propriété système avant de les mettre en production.
        Type Chaîne
        Valeur par défaut tâche, kb_knowledge