Configurer un groupe d’index de texte pour effectuer des recherches dans plusieurs tables

Mettez à jour les tables au format d’indexation V4 et incluez-les dans un groupe d’index de texte pour faciliter la recherche dans plusieurs tables.

Avant de commencer

Rôle requis : ts_admin ou admin

Pourquoi et quand exécuter cette tâche

Les groupes d’index de texte vous permettent d’indexer et de rechercher dans plusieurs tables.

Effectuer des recherches dans plusieurs tables nécessite d’abord de normaliser les tables afin que les scores de pertinence aient la même signification pour toutes les tables. L’indexation V4 fournit cette normalisation. Zing utilise la fonction de classement Okapi BM25 pour calculer le score de pertinence des résultats de recherche.

Le format d’indexation de table V4 est optimisé pour la documentation, comme les articles de la base de connaissances. Vous n’avez pas besoin de réindexer les tables qui utilisent ce format lorsque vous modifiez la valeur d’un attribut d’indexation, telle que le poids d’un champ. Si vous souhaitez utiliser la fonction de classement BM25 sur une seule table, vous pouvez la convertir au format V4.

Pour activer la recherche dans plusieurs tables, vous devez :

1. Configurez toutes vos tables choisies pour utiliser le format d’index V4 si elles ne l’utilisent pas déjà.
   Remarque :

   Dans les nouvelles instances, les tables Élément de catalogue [sc_cat_item], Connaissances [kb_knowledge], Questions sur les Questions-réponses de réseaux sociaux [kb_social_qa_question] et Utilisateur [sys_user] utilisent le format d’index V4. Si vous mettez à niveau votre instance à partir d’une version précédente, le format d’indexation de ces tables reste le même que dans l’ancienne version.
2. Ajoutez les tables à un groupe d’index de texte afin qu’elles puissent être indexées et recherchées ensemble.
   Remarque :

   Vous ne pouvez pas ajouter la table Tâche [task] ni aucune table qui l’étend à un groupe d’index de texte.

Procédure

1. Configurez les tables que vous souhaitez inclure dans plusieurs recherches de table pour utiliser le format d’index V4.
   Remarque :

   La mise à niveau de V3 vers V4 est facile. Le passage à une version antérieure de V4 à V3 est plus difficile et déconseillé.
   1. Accédez à la Tous > Définition du système > Configurations des index de texte.
   2. Ouvrez l’enregistrement de la table que vous souhaitez mettre à niveau au format d’index V4.
   3. Si Format n’est pas désactivé, sélectionnez V4, sélectionnez Soumettre, puis passez à l’étape 2.
      Vous pouvez choisir le formatage de l’index à cette étape, car aucun index n’existe pour la table.
   4. Si le format est désactivé, sélectionnez le lien connexe Afficher l’enregistrement du nom d’index .
      Le champ désactivé signifie qu’un index existe déjà pour la table et que vous devez explicitement mettre à jour le format d’index.
      La page d’index de texte s’affiche.
   5. Sélectionnez le lien connexe Mettre à niveau vers V4 , puis sélectionnez OK.
      Le système planifie une tâche pour mettre à niveau l’index de texte de V3 vers V4, ce qui permet à cette table de participer à l’indexation de plusieurs tables.
2. Créez un groupe d’index de texte qui spécifie les tables que vous souhaitez indexer ensemble afin de pouvoir les rechercher ensemble.
   1. Accédez à la Tous > Définition du système > Groupes d'index de texte.
   2. Sélectionnez Nouveau.
   3. Entrez les valeurs de champ suivantes :

      Champ	Valeur
      Étiquette	Nom du groupe de tables que vous souhaitez indexer et rechercher ensemble.
      Tables	Liste des tables que vous souhaitez inclure dans le groupe d’index de texte.

      Vous pouvez ajouter des tables formatées avec V3 et V4 aux groupes d’index de texte. Si vous ajoutez des tables V3, le groupe d’index de texte reste inactif.

   4. Sélectionnez Soumettre.
3. Configurez les attributs d’indexation et de recherche sur les tables d’un groupe d’index de texte.
   1. Accédez à la Tous > Définition du système > Configurations des index de texte.
   2. Sélectionnez Nouveau.
      Le formulaire Configuration des index de texte s’affiche. Si vous avez déjà un groupe d’index de texte dans la liste, passez à l’étape 3.d.
   3. Dans S’applique à, sélectionnez Groupe d’index.
   4. Dans le groupe d’index, sélectionnez la loupe et sélectionnez le groupe d’index de texte que vous avez créé, puis sélectionnez Soumettre.
      Les seuls groupes d’index de texte qui s’affichent sont ceux que vous avez déjà créés.
      La table Configuration des index de texte s’affiche.
   5. Ouvrez l’enregistrement de votre groupe d’index de texte.
   6. Dans l’onglet Cartes d’attributs de table d’index de texte , sélectionnez Nouveau.
      Le formulaire Carte d’attribut de table d’index de texte s’affiche. Les attributs se rapportent à la façon dont Zing indexe ou recherche des tables individuelles dans le groupe d’index de texte.
   7. Dans Table, sélectionnez une table pour laquelle définir des attributs.
      Seules les tables du groupe d’index de texte spécifié et leurs tables enfants s’affichent.
   8. Dans Nom d’attribut, sélectionnez la loupe et sélectionnez un attribut.
      Pour afficher la liste des attributs, saisissez ts_configuration_attribute.list dans le navigateur d’application. Pour les définitions d’attributs, consultez Index Zing et attributs de recherche.
   9. Dans Valeur , saisissez une valeur et sélectionnez Soumettre.
      Les valeurs valides dépendent de l’attribut. Pour plus d’informations sur les valeurs valides, consultez Index Zing et attributs de recherche.
   10. Répétez cette procédure pour définir des paramètres de moteur de recherche supplémentaires pour d’autres tables dans le groupe d’index de texte.
   11. Sous Liens connexes, sélectionnez Générer un index de texte.
4. Configurez les paramètres de recherche sur les colonnes de table individuelles dans le groupe d’index de texte.
   1. Accédez à la Tous > Définition du système > Configurations des index de texte.
   2. Ouvrez l’enregistrement de votre groupe d’index de texte.
   3. Dans l’onglet Cartes d’attributs de colonne d’index de texte , sélectionnez Nouveau.
      Le formulaire Carte d’attribut de colonne d’index de texte s’affiche. Les attributs se rapportent à la façon dont Zing indexe ou recherche des colonnes de table individuelles dans le groupe d’index de texte.
   4. Dans Table, sélectionnez une table pour laquelle définir des attributs.
      Seules les tables du groupe d’index de texte et leurs tables enfants s’affichent.
   5. Dans Nom d’attribut, sélectionnez un paramètre du moteur de recherche, entrez une valeur pour ce paramètre dans Valeur, puis sélectionnez Soumettre.
      Pour afficher la liste des attributs, saisissez ts_configuration_attribute.list dans le navigateur d’application. Pour les définitions d’attributs, consultez Index Zing et attributs de recherche.
   6. Dans Colonne, spécifiez le nom de la colonne de la table sélectionnée à laquelle vous souhaitez appliquer l’attribut de recherche.
   7. Dans Valeur, spécifiez la valeur de l’attribut qui régit la recherche.
   8. Sélectionnez Soumettre.
   9. 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 de texte.
   10. Sous Liens connexes, sélectionnez Générer un index de texte.
5. Facultatif : Ajouter un dictionnaire de synonymes.
   La spécification d’un dictionnaire permet d’effectuer des recherches sur le terme recherché et les synonymes du terme recherché, tels que voiture et son synonyme auto. Zing fournit un dictionnaire de synonymes par défaut.
   1. Accédez à la Tous > Définition du système > Configurations des index de texte.
   2. Ouvrez l’enregistrement de votre groupe d’index de texte.
   3. Dans l’onglet Indexer les dictionnaires de synonymes , sélectionnez Nouveau.
   4. Dans Index, sélectionnez l’index de table auquel ajouter les mots vides.
   5. Dans Dictionnaire de synonymes, sélectionnez le dictionnaire à utiliser.
      Pour ajouter un dictionnaire, sélectionnez Nouveau et suivez la procédure de la section Créer des dictionnaires de synonymes.
   6. Sélectionnez Soumettre.
   7. Sous Liens connexes, sélectionnez Générer un index de texte.
6. Sélectionnez Mettre à jour.

Que faire ensuite

Vous pouvez interroger les tables du groupe d’index de texte 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é 123TEXTINDEXGROUP321 . Pour plus d’informations sur l’interrogation des groupes d’index de texte pour les 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 une table pour l’indexation et la recherche
• 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