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 attributs, des mots vides et des dictionnaires 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 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 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 qui peut prendre un certain temps. Vous remarquerez peut-être 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 de texte, vous pouvez afficher les statistiques d’indexation de texte historiques.

Remarque :

L’indexation de texte des nouvelles tables créées par les 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 les 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 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 à jour son format d’indexation vers V4.
   1. Si la valeur dans Format n’est pas grisée, sélectionnez v4, puis sélectionnez Soumettre et passez à l’étape 5.
   2. Si la valeur dans Format est grisée, sélectionnez Soumettre.
      La valeur grisée signifie que la table a déjà été indexée et qu’elle doit être indexée vers la version V4.
   3. Accédez à la Tout > 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 sélectionnez Soumettre.
      L’indexation de la table spécifiée est mise à niveau de V3 à V4. Maintenant, 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 des 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 table d’index de texte.

      Champ	Description
      Table	Table pour laquelle définir les attributs.
      Nom d'attribut	Attribut du moteur de recherche. Pour obtenir la liste des attributs et des valeurs valides, consultez Index Zing et attributs de recherche.
      Valeur	Valeur de 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 Mappages d’attributs de colonne d’index de texte, sélectionnez Nouveau.
   3. Renseignez les champs du formulaire Mappage d’attributs 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 de 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, un ou un. 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, accédez dans votre navigateur à 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 seul 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 de 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 de la section Créer des dictionnaires de synonymes.

Résultats

L’option de recherche de texte dans la liste apparaît dans les vues de listes de la table et de 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 par liste, reportez-vous à la section La recherche dans la 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îne, consultez Interrogation de tables dans un script.

Concepts associés

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

Tâches associées

• Configurer un groupe d’index de texte pour effectuer des recherches 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 d’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 créateur de jetons japonais

Référence associée

• Index Zing et attributs du dictionnaire de recherche
• Statistiques et statut de l’indexation de texte

Champs exclus de l’indexation de texte

L’indexation de texte exclut les champs qui répondent à certains noms, types, attributs ou conditions de chiffrement. Les recherches d’utilisateurs ne correspondent pas aux champs exclus et ne renvoient pas les valeurs de ces champs.

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 Référence des types de champ.
Attributs de champs	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, voir Chiffrement des champs à l’aide de configurations de chiffrement.