Configurez un groupe d’index de texte pour effectuer une recherche dans plusieurs tables

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture

    • 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 d’effectuer des recherches dans plusieurs tables.

    Pour effectuer des recherches dans plusieurs tables, vous devez d’abord normaliser les tables afin que les scores de pertinence aient le même sens pour toutes les tables. L’indexation V4 assure 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 les tables que vous avez 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], Base de connaissances [kb_knowledge], Questions et réponses sociales [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] ou des tables qui l’étendent à un groupe d’index de texte.

    Procédure

    1. Configurez les tables que vous souhaitez inclure dans plusieurs recherches de tables pour utiliser le format d’index V4.
      Remarque :
      La mise à niveau de la V3 vers la 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 vers le format d’index V4.
      3. Si l’option Format n’est pas désactivée, sélectionnez V4, sélectionnez Soumettre, puis passez à l’étape 2.
        Vous pouvez choisir la mise en forme de l’index dans cette étape, car aucun index n’existe pour la table.
      4. Si Format est désactivé, sélectionnez le lien connexe Afficher le nom de l’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, permettant ainsi à 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 à des groupes d’index de texte. Si vous ajoutez des tables V3, le groupe d’index de texte reste inactif.

      4. Sélectionnez Envoyer.
    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 de configuration d’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 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 Text Index Table Attribute Maps (Cartes attributaires de table d’index de texte ), sélectionnez New (Nouveau).
        Le formulaire Carte attributaire 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 d’autres paramètres de moteur de recherche pour d’autres tables du 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 des 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 Text Index Column Attribute Maps (Cartes attributaires de colonnes d’index de texte ), sélectionnez New (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 de 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 Envoyer.
      9. 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 de texte.
      10. Sous Liens connexes, sélectionnez Générer un index de texte.
    5. Facultatif : Ajoutez un dictionnaire de synonymes.
      La spécification d’un dictionnaire permet d’effectuer des recherches sur le terme de recherche et les synonymes du terme de recherche, 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 décrite dans Créer des dictionnaires de synonymes.
      6. Sélectionnez Envoyer.
      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înes à 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înes, consultez Interrogation de tables dans le script.