Configurer une table pour l’indexation et la recherche

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 le comportement d’indexation et 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 (Tous > Définition du système > Index de texte). Par exemple :

• Tables liées à la base de connaissances
• Tables liées aux données de base
• 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 pour 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 et en temps. Il se peut que vous remarquiez une dégradation des performances ou des résultats de recherche incomplets lors de la génération de l’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 Tous > Définition du système > Configurations des index de texte et sélectionnez Nouveau.
2. Dans 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 multi-tables 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 Tous > Définition du système > Configurations des index de texte et sélectionnez la table que vous avez envoyée.
   4. Sous Liens connexes, sélectionnez Afficher l’enregistrement du nom d’index.
   5. Sous Liens connexes, sélectionnez Mettre à niveau vers V4 , puis 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 multi-tables et BM25 est utilisé pour noter le score de pertinence de la table. Vous pouvez également 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 dans la table sélectionnée.
   1. Accédez à la Tous > 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 attributaires 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 table d’index de texte.

      Champ	Description
      Table	Table pour définir des 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 Tous > Définition du système > Configurations des index de texte et sélectionnez une table.
   2. Dans la liste connexe Cartes attributaires 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 contenant 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 Envoyer.
   5. Répétez cette procédure pour définir des paramètres de moteur de recherche supplémentaires pour les colonnes de table dans le 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 voulez pas indexer, tels que le, a ou an. Il existe une liste globale de mots vides courants, de sorte que vous n’avez qu’à ajouter des mots vides spécifiques à votre situation. Pour afficher la liste globale des mots vides, accédez à https://<nom de l’instance>.service-now.com/ts_stop_list.do dans votre navigateur.
   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 seul mot que vous ne souhaitez pas indexer et sélectionnez Soumettre.
8. Facultatif : Ajoutez un dictionnaire de synonymes.
   Spécifier un dictionnaire de synonymes effectue une recherche sur le terme de recherche ainsi que sur les synonymes du terme de recherche, tels 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 dans la table spécifiée.
      Pour ajouter un dictionnaire, sélectionnez Nouveau et suivez la procédure décrite dans Créer des dictionnaires de synonymes.

Résultats

L’option de recherche de liste de texte apparaît dans les vues de liste 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 dans la vue de formulaire. Pour en savoir plus sur l’utilisation de la recherche de liste, reportez-vous à La recherche de liste trouve des enregistrements de la table actuelle.

Vous pouvez également interroger la table indexée pour les correspondances de chaînes à 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 le script.

Concepts associés

• Zing indexe la ponctuation dans le cadre de certains mots
• Zing indexe certains éléments HTML

Tâches associées

• Configurez un groupe d’index de texte pour effectuer une recherche dans plusieurs tables
• Régénérer un index de texte pour une table
• Supprimer un index
• Supprimer un index pour un champ spécifique
• Supprimer l’index de texte pour une table enfant
• Modifier le mode de requête d’une table indexée
• Activer l’indexation du texte dans les jeux de variables de plusieurs lignes
• Configurer les tables pour utiliser le générateur de jetons japonais

Référence associée

• Attributs d’index Zing et de dictionnaire de recherche
• Statistiques et état de l’indexation de texte

Champs exclus de l’indexation de texte

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

L’indexation de texte exclut un champ s’il répond à 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 des types suivants : Date Date/Heure Durée Vrai/Faux Workflow Pour en savoir plus sur ces types, reportez-vous à Types de champ.
Attributs de champ	L’indexation de texte exclut les champs dont l’attribut no_text_index est défini sur true. Pour plus d’informations sur cet attribut, reportez-vous à 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, voir Chiffrer des champs à l’aide de configurations de chiffrement.