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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 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, il faut d’abord 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, telle que 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 de votre choix pour utiliser le format d’index V4, si ce n’est pas déjà fait.
      Remarque :
      Dans les nouveaux cas, les tables Élément de catalogue [sc_cat_item], 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 toute table qui l’étend à 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 à la V4 est facile. Le passage à une version antérieure de la V4 à la V3 est plus difficile et déconseillé.
      1. Accédez à la Tout > 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 Format n’est pas désactivé, 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 l’enregistrement de 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 Index de texte s’affiche.
      5. Sélectionnez le lien connexe Mettre à niveau vers la version 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 Tout > 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 voulez 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 Tout > 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 disposez déjà d’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 d’index de texte s’affiche.
      5. Ouvrez l’enregistrement de votre groupe d’index de texte.
      6. Dans l’onglet Cartes d’attributs de la 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 vous souhaitez 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, reportez-vous à la rubrique 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 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 les colonnes de table individuelles du groupe d’index de texte.
      1. Accédez à la Tout > 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 colonnes 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 vous souhaitez 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, reportez-vous à la rubrique 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 dans le 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 car et son synonyme auto. Zing fournit un dictionnaire de synonymes par défaut.
      1. Accédez à la Tout > 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înes, consultez Interrogation de tables dans un script.