Configurer une table pour l’indexation et la recherche

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 6 minutes de lecture

    • Activez l’indexation de texte Zing pour une table afin de permettre aux utilisateurs de rechercher des valeurs de chaîne dans ses enregistrements. Configurez les attributs d’indexation de texte, les mots vides et les dictionnaires de synonymes de la table pour contrôler le comportement de recherche.

    Avant de commencer

    Rôle requis : ts_admin ou admin

    Pourquoi et quand exécuter cette tâche

    L’activation de l’indexation de texte pour une table permet aux utilisateurs de rechercher des valeurs de chaîne dans les enregistrements de cette table. Vous pouvez configurer des dictionnaires d’attributs, de mots vides et de synonymes pour contrôler l’indexation et le comportement de recherche d’une table indexée.

    Par défaut, le système crée des index de texte pour les tables avec un enregistrement d’index de texte (Tout > Définition du système > Index de texte). Par exemple :
    • Tables liées à la base de connaissances
    • Tables liées aux données principales
    • Tables liées à Connect
    • Table de tâches
    • Table des utilisateurs
    L’activation de l’indexation de texte pour une table l’active également pour toutes les tables enfants. Si vous souhaitez désactiver l’indexation de texte pour une table enfant, reportez-vous à la section Supprimer l’index de texte d’une table enfant.
    Remarque :
    Chaque fois que vous créez une table d’index, le système crée également des rôles de contrôle d’accès (ACL) pour les nouvelles tables.
    L’indexation de texte peut être une tâche gourmande en ressources dont l’exécution peut prendre un certain temps. Vous pouvez remarquer une dégradation des performances ou des résultats de recherche incomplets lors de la génération d’index. Pour estimer la durée d’indexation du texte, vous pouvez afficher les statistiques historiques d’indexation du texte.
    Remarque :

    L’indexation de texte des nouvelles tables créées par des transferts d’ensembles de mises à jour est désactivée, même si elle est activée pour les tables incluses dans l’ensemble de mises à jour.

    Pour permettre aux utilisateurs de rechercher des tables créées par des transferts d’ensembles de mises à jour, vous devez activer manuellement l’indexation de texte pour ces tables.

    Procédure

    1. Accédez à la Tout > Définition du système > Configurations des index de texte et sélectionnez Nouveau.
    2. Dans la zone S’applique à, sélectionnez Table.
    3. Dans Table, sélectionnez la table pour laquelle vous souhaitez configurer l’indexation de texte.
    4. Facultatif : Si vous avez l’intention d’utiliser la table dans des recherches multitables ou si vous souhaitez utiliser l’algorithme de notation BM25 sur la table, mettez à niveau son format d’indexation vers V4.
      1. Si la valeur de Format n’est pas grisée, sélectionnez v4, puis sélectionnez Soumettre et passez à l’étape 5.
      2. Si la valeur de Format est grisée, sélectionnez Soumettre.
        La valeur grisée signifie que la table a déjà été indexée et que son indexation doit être mise à niveau vers V4.
      3. Accédez à la Tout > Définition du système > Configurations des index de texte et sélectionnez la table que vous avez soumise.
      4. Sous Liens connexes, sélectionnez Afficher l’enregistrement de nom d’index.
      5. Sous Liens connexes, sélectionnez Mettre à niveau vers V4 et sélectionnez Soumettre.
        L’indexation de la table spécifiée est mise à niveau de V3 vers V4. Désormais, cette table peut faire partie de l’indexation à plusieurs tables et BM25 est utilisé pour noter le score de pertinence de la table. Vous pouvez éventuellement sélectionner Afficher la configuration sous Liens connexespour afficher le format d’indexation de table sur la page Configuration de l’index de texte .
    5. Configurez les attributs d’indexation et de recherche sur la table sélectionnée.
      1. Accédez à la Tout > Définition du système > Configurations des index de texte et sélectionnez la table que vous avez configurée.
      2. Dans la liste connexe Cartes d’attributs de table d’index de texte, sélectionnez Nouveau.
        Les attributs se rapportent à la façon dont Zing indexe les documents et classe les documents renvoyés dans les résultats de recherche.
      3. Renseignez les champs du formulaire Cartes d’attributs de la table d’index de texte.
        Champ Description
        Table Table pour laquelle définir les attributs.
        Nom d'attribut Attribut de moteur de recherche. Pour obtenir la liste des attributs et des valeurs valides, consultez Index Zing et attributs de recherche.
        Valeur Valeur pour l’attribut.
      4. Répétez cette procédure pour définir des attributs supplémentaires pour la table.
      5. Dans la section Liens connexes, sélectionnez Générer un index de texte.
    6. Configurez les attributs au niveau des colonnes.
      1. Accédez à la Tout > Définition du système > Configurations des index de texte et sélectionnez une table.
      2. Dans la liste connexe Cartes d’attributs de colonnes d’index de texte, sélectionnez Nouveau.
      3. Renseignez les champs du formulaire Carte d’attribut de colonne d’index de texte.
        Champ Description
        Table Table qui contient la colonne pour laquelle vous souhaitez définir des attributs. Seules les tables du groupe d’index et leurs tables enfants s’affichent.
        Nom d'attribut Attribut. Pour obtenir la liste des attributs et des valeurs valides, consultez Index Zing et attributs de recherche.
        Colonne Nom de la colonne de la table sélectionnée à laquelle vous souhaitez appliquer l’attribut de recherche.
        Valeur Valeur pour l’attribut.
      4. Sélectionnez Soumettre.
      5. Répétez cette procédure pour définir des paramètres de moteur de recherche supplémentaires pour les colonnes de table du groupe d’index.
      6. Dans la section Liens connexes, sélectionnez Générer un index de texte.
    7. Facultatif : Ajoutez des mots vides.
      Les mots vides sont des mots que vous ne souhaitez pas indexer, tels que le, a ou an. Il existe une liste globale de mots vides courants, vous n’avez donc qu’à ajouter des mots vides spécifiques à votre situation. Pour afficher la liste globale des mots vides, naviguez dans votre navigateur jusqu’à https://<nom d’instance>.service-now.com/ts_stop_list.do.
      1. Dans l’onglet Mots vides d’index , sélectionnez Nouveau.
      2. Dans Index, sélectionnez l’index auquel ajouter le mot vide.
      3. Dans Word, saisissez un mot que vous ne souhaitez pas indexer et sélectionnez Soumettre.
    8. Facultatif : Ajouter un dictionnaire de synonymes.
      La spécification d’un dictionnaire de synonymes effectue une recherche sur le terme recherché, ainsi que sur les synonymes du terme recherché, tel que voiture, et son synonyme, auto. Zing fournit un dictionnaire de synonymes par défaut.
      1. Dans l’onglet Indexer les dictionnaires de synonymes , sélectionnez Nouveau.
      2. Dans Index, sélectionnez l’index auquel ajouter les mots vides.
      3. Dans Dictionnaire de synonymes, sélectionnez le dictionnaire de synonymes à utiliser sur la table spécifiée.
        Pour ajouter un dictionnaire, sélectionnez Nouveau et suivez la procédure de la section Créer des dictionnaires de synonymes.

    Résultats

    L’option de recherche de liste par texte apparaît dans les vues de listes pour la table et ses tables enfants.

    Que faire ensuite

    Vous pouvez rechercher des enregistrements dans la table indexée à l’aide de la recherche de liste en mode formulaire. Pour en savoir plus sur l’utilisation de la recherche par liste, reportez-vous à la section La recherche de liste trouve des enregistrements de la table actuelle.

    Vous pouvez également interroger la table indexée pour les correspondances de chaîne à l’aide des méthodes GlideRecord.addQuery(name, value) ou GlideRecord.addEncodedQuery(name, value) avec le nom réservé 123TEXTQUERY321 . Pour plus d’informations sur l’interrogation des correspondances de chaînes, consultez Interrogation de tables dans un script.

    Champs exclus de l’indexation de texte

    L’indexation de texte exclut les champs qui remplissent certaines conditions de nom, de type, d’attribut ou de chiffrement. Les recherches des utilisateurs ne correspondent pas ou ne renvoient pas les valeurs des champs exclus.

    L’indexation de texte exclut un champ s’il remplit l’une des conditions de la table suivante.
    Catégorie Description
    Nom de champ L’indexation de texte inclut les champs sys_class_name et sys_tags , mais exclut tous les autres champs dont le nom commence par sys_.
    Type de champ
    L’indexation de texte exclut les champs de ces types :
    • Date
    • Date/Heure
    • Durée
    • Vrai/Faux
    • Workflow

    Pour en savoir plus sur ces types, reportez-vous à la section Types de champ.
    Attributs de champ

    L’indexation de texte exclut les champs dont l’attribut no_text_index est défini sur vrai.

    Pour en savoir plus sur cet attribut, reportez-vous à la section Supprimer un index pour un champ spécifique.
    Chiffrement de champ

    L’indexation de texte exclut les champs configurés pour Chiffrement Edge.

    Pour plus d’informations sur la configuration des champs avec Chiffrement Edge, reportez-vous à la rubrique Chiffrer les champs à l’aide de configurations de chiffrement.