Paramétrage du champ

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 12 minutes de lecture
  • Un paramètre de champ contrôle le comportement d’indexation d’un champ spécifié (colonne) sur tous les enregistrements d’une source indexée.

    Voici des exemples de la façon dont vous pouvez utiliser les paramètres de champ.
    • Désactiver l’indexation de texte ou la possibilité de recherche pour un champ trouvé sur les enregistrements de table source
    • Modifier les mappages par défaut entre les champs de table source et les champs de l’index Recherche IA
    • Ajouter un champ de table référencé à l’index par remontée pas à pas à partir d’un champ de référence sur les enregistrements de table source

    Les paramètres de champ d’une source indexée s’affichent dans sa liste connexe Paramètres de champ et mappage.

    Créer un paramètre de champ pour une source indexée

    Définissez un paramètre de champ source indexé pour configurer Recherche IA le comportement d’indexation de contenu d’un champ spécifique sur les enregistrements de table source.

    Avant de commencer

    Rôle requis : ais_admin

    Pourquoi et quand exécuter cette tâche

    Pour en savoir plus sur les paramètres et valeurs de champ disponibles, reportez-vous à la section Liste des paramètres de Recherche IA champs de source indexés.

    Procédure

    1. Accédez à la Tout > Recherche IA > Recherche IA Index > Sources indexées.
    2. Ouvrez la source indexée pour laquelle vous souhaitez définir un paramètre de champ.
    3. Dans la liste connexe Paramètres de champ et mappage, sélectionnez Nouveau.
    4. Renseignez les champs du formulaire Paramétrer les champs.
    5. Sélectionnez Soumettre.

    Résultats

    Le nouveau paramètre de champ apparaît dans la liste connexe Paramètres de champ et mappage.

    Que faire ensuite

    Pour appliquer le nouveau paramètre de champ, effectuez une réindexation complète de la table pour la source indexée. Pour plus d’informations sur cette procédure, reportez-vous à la section Effectuer un indexation complète de la table ou une réindexation pour une seule source indexée.

    Activer l’indexation des champs de table référencés pour une source indexée

    Configurez une source indexée pour indexer les valeurs de champ à partir des tables référencées par les champs dans la table source. Vous pouvez indexer ces valeurs de champ pour les utiliser dans des filtres et EVAM des configurations de résultats de recherche, les indexer pour la recherche, ou les deux.

    Avant de commencer

    Rôle requis : ais_admin

    Pourquoi et quand exécuter cette tâche

    Lorsqu’une table source indexée inclut un champ de référence, Recherche IA les valeurs d’indexation du champ de référence sont utilisées par défaut pour ce champ mais pas pour les autres champs de la table qu’elle référence. Pour indexer les valeurs de ces champs de table référencée, vous pouvez créer dot_walk_fields des paramètres de champ sur searchable_dot_walk_fields votre table source indexée.
    • Pour utiliser des valeurs de champ issues de tables référencées dans des filtres de source de recherche, des filtres de facette et EVAM des configurations de résultats de recherche, créez un dot_walk_fields paramètre de champ.
    • Pour permettre la recherche des valeurs de champ des tables référencées, créez un searchable_dot_walk_fields paramètre de champ.

    En tant que valeur de l’un de ces paramètres de champ, répertoriez les noms des champs de table référencés que vous souhaitez indexer, séparés par des virgules. Par exemple, pour indexer les champs nom et client à partir de la table référencée par le champ société sur la table source indexée, sélectionnez le champ société et saisissez la valeur nom,client.

    Pour remonter pas à pas dans plusieurs tables, vous pouvez entrer des valeurs de nom de champ avec des préfixes de champ de référence séparés par des points. Par exemple, saisissez une valeur company.contact.name pour indexer le champ de nom dans la table référencée par le champ de contact sur la table référencée par le champ de référence société de la table source indexée.
    Remarque :
    Chaque niveau de référence de remontée pas à pas impose un impact sur les performances de l’indexation. Évitez d’utiliser des références multiniveaux, sauf si cela est nécessaire.

    Vous pouvez créer des dot_walk_fields paramètres de champ et searchable_dot_walk_fields pour le même champ de référence.

    Procédure

    1. Accédez à la Tout > Recherche IA > Recherche IA Index > Sources indexées.
    2. Dans la liste connexe Paramètres de champ et mappage, sélectionnez Nouveau.
    3. Dans le formulaire Paramètre de champ, entrez les valeurs de champ affichées pour votre cas d’utilisation.
      • Pour indexer les valeurs de champ des tables référencées en vue de leur utilisation dans les filtres de source de recherche, les filtres de facette et EVAM les configurations des résultats de recherche, entrez les valeurs de champ suivantes.
        Champ Valeur
        Attribut dot_walk_fields
        Champ <nom du champ de référence de table source indexée que vous souhaitez utiliser pour remonter pas à pas vers une autre table>
        Valeur

        <liste de noms séparés par des virgules pour les champs que vous souhaitez indexer à partir de la table référencée>

      • Pour indexer les valeurs de champ des tables référencées en tant que texte interrogeable, entrez les valeurs de champ suivantes.
        Champ Valeur
        Attribut searchable_dot_walk_fields
        Champ <nom du champ de référence de table source indexée que vous souhaitez utiliser pour remonter pas à pas vers une autre table>
        Valeur

        <liste de noms séparés par des virgules pour les champs que vous souhaitez indexer à partir de la table référencée>

      Remarque :
      Si les dot_walk_fields attributs et searchable_dot_walk_fields n’apparaissent pas dans la liste de sélection d’attribut , assurez-vous que votre sélection de champ est un champ de référence.
    4. Sélectionnez Soumettre.
      L’attribut et la valeur apparaissent dans la liste connexe Paramètres de champ et mappage.

    Liste des paramètres de Recherche IA champs de source indexés

    Vous pouvez ajuster le comportement d’indexation des champs d’enregistrement source dans une Recherche IA source indexée en configurant des attributs et des valeurs de champ.

    Pour plus d’informations sur la création de paramètres de champ, reportez-vous à la section Créer un paramètre de champ pour une source indexée.

    Attribut Description
    dot_walk_fields

    Indexez la référence et affichez les valeurs des champs de la table source du champ de référence sélectionné à utiliser dans les filtres de source de recherche, les filtres de facette et EVAM les configurations des résultats de recherche.

    Recherche IA Met automatiquement à jour les valeurs de champ indexé pour refléter les modifications apportées aux valeurs de champ de la table référencée.

    Pour en savoir plus sur les filtres de sources de recherche, reportez-vous à la section Rechercher des sources. Pour en savoir plus sur les filtres de facette, reportez-vous à la section Créer une facette dans la configuration d’une Recherche IA application.
    • Champ : nom d’un champ de référence à partir de la table source indexée.
    • Type : chaîne
    • Valeur : liste séparée par des virgules des champs de table référencés à indexer pour une utilisation dans les sources de recherche
    Remarque :
    Vous ne pouvez pas rechercher des valeurs de champ indexées avec ce paramètre de champ. Pour indexer les valeurs de champ à partir de tables référencées à des fins de recherche, créez un searchable_dot_walk_fields paramètre de champ. Vous pouvez créer des dot_walk_fields paramètres de champ et searchable_dot_walk_fields pour le même champ de référence.

    Si vous modifiez la valeur de ce paramètre pour le champ d’une source indexée, la modification ne prend effet qu’une fois que vous avez réindexé le contenu de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un indexation complète de la table ou une réindexation pour une seule source indexée.

    index_calculated_field

    Option permettant d’activer l’indexation de contenu interrogeable à partir des valeurs de champ calculées.

    Si votre source indexée contient un champ calculé, vous devez définir ce paramètre de champ sur vrai pour ce champ afin d’indexer correctement ses valeurs. Avec une valeur de paramètre de champ faux ou aucune valeur, Recherche IA les valeurs du champ calculé sont ignorées lors de l’indexation du contenu.
    • Champ : nom d’un champ calculé à partir de la table source indexée. (Si vous spécifiez un champ non calculé, le système rejette la soumission du paramètre de champ et affiche un message d’avertissement.)
    • Type : booléen
    • Valeurs :
      • true: appliquer une gestion spéciale pour indexer correctement les valeurs de champ calculées à partir du champ sélectionné.
      • false: n’applique pas de gestion spéciale lors de l’indexation des valeurs de champ à partir du champ sélectionné. Les valeurs de champ calculées ne sont pas indexées.

    Si vous modifiez la valeur de ce paramètre pour le champ d’une source indexée, la modification ne prend effet qu’une fois que vous avez réindexé le contenu de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un indexation complète de la table ou une réindexation pour une seule source indexée.

    map_to

    Mappez le champ sélectionné à partir de la table source indexée à un Recherche IA champ d’index. Lors de l’indexation des enregistrements à partir de la table source, Recherche IA remplit le champ d’index spécifié avec la valeur du champ source sélectionné.

    Par exemple, la source indexée de la table de connaissances du système de base mappe le champ source kb_knowledge.short_description au champ d’index de titre . Lorsque Recherche IA l’enregistrement est indexé à partir de la table Connaissances [kb_knowledge], il renseigne le titre interrogeable de l’enregistrement indexé avec la valeur du champ short_description de l’enregistrement source.
    • Champ : nom d’un champ à partir de la table source indexée.
    • Type : chaîne
    • Valeur : nom du Recherche IA champ auquel vous voulez mapper les valeurs d’affichage du champ sélectionné. Pour en savoir plus sur les champs d’index, reportez-vous Recherche IA à Recherche IA Champs d’index.
    Remarque :
    Vous ne pouvez définir qu’un seul paramètre de champ map_to pour un champ source indexé. Si vous essayez de définir plusieurs paramètres map_to pour le même champ, le système affiche un message d’erreur.

    Si vous modifiez la valeur de ce paramètre pour le champ d’une source indexée, la modification ne prend effet qu’une fois que vous avez réindexé le contenu de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un indexation complète de la table ou une réindexation pour une seule source indexée.

    no_text_index
    Option permettant de désactiver l’indexation du contenu pouvant faire l’objet d’une recherche à partir du champ sélectionné sur les enregistrements provenant de la source indexée.
    • Champ : nom d’un champ à partir de la table source indexée.
    • Type : booléen
    • Valeurs :
      • true: désactiver l’indexation du contenu consultable pour le champ sélectionné. La recherche et les filtres ne peuvent pas correspondre à la valeur du champ.
      • false: permet d’activer l’indexation du contenu interrogeable pour le champ sélectionné. La recherche et les filtres peuvent correspondre à la valeur du champ.
    • Valeur par défaut: false

    Si vous modifiez la valeur de ce paramètre pour le champ d’une source indexée, la modification ne prend effet qu’une fois que vous avez réindexé le contenu de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un indexation complète de la table ou une réindexation pour une seule source indexée.

    Pour Service et assistance client obtenir des instructions sur la définition de l’option no_text_index pour différents types de champs, consultez KB0859922 sur le Now Support site.

    not_searchable
    Option permettant de désactiver la correspondance de recherche pour le contenu indexé à partir du champ sélectionné.
    • Champ : nom d’un champ à partir de la table source indexée.
    • Type : booléen
    • Valeurs :
      • true: désactiver la correspondance de recherche pour le contenu indexé à partir du champ sélectionné. La recherche ne peut pas correspondre à la valeur du champ. Les filtres (tels que la sécurité du contenu, les onglets de navigation et les facettes) peuvent toujours correspondre à la valeur du champ.
      • false: permet d’activer la correspondance de recherche pour le contenu indexé à partir du champ sélectionné. La recherche et les filtres peuvent correspondre à la valeur du champ.
    • Valeur par défaut: false
    Valeurs prises en charge :

    Si vous modifiez la valeur de ce paramètre pour le champ d’une source indexée, la modification ne prend effet qu’une fois que vous avez réindexé le contenu de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un indexation complète de la table ou une réindexation pour une seule source indexée.

    searchable_dot_walk_fields

    Indexez la référence et affichez les valeurs des champs de la table source du champ de référence sélectionné en tant que texte interrogeable.

    Recherche IA ne met pas automatiquement à jour les valeurs de champ indexé pour refléter les modifications apportées aux valeurs de champ de la table référencée. Pour mettre à jour les valeurs des champs indexés, vous devez réindexer la source indexée. Pour plus d’informations sur cette procédure, reportez-vous à la section Effectuer un indexation complète de la table ou une réindexation pour une seule source indexée.
    • Champ : nom d’un champ de référence à partir de la table source indexée.
    • Type : chaîne
    • Valeur : liste séparée par des virgules des champs de table référencés à indexer en tant que contenu pouvant faire l’objet d’une recherche
    Remarque :
    Vous ne pouvez pas utiliser les valeurs de champ indexées avec ce paramètre de champ dans les filtres de source de recherche. Pour indexer les valeurs de champ à partir de tables référencées afin de les utiliser dans les filtres de source de recherche, créez un dot_walk_fields paramètre de champ. Vous pouvez créer des dot_walk_fields paramètres de champ et searchable_dot_walk_fields pour le même champ de référence.

    Si vous modifiez la valeur de ce paramètre pour le champ d’une source indexée, la modification ne prend effet qu’une fois que vous avez réindexé le contenu de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un indexation complète de la table ou une réindexation pour une seule source indexée.

    Remarque :
    Les paramètres de champ sont des enregistrements de la table Attribut de configuration Recherche IA [ais_configuration_attribute] dont la valeur de champ S’applique à correspond à Colonne. Les enregistrements de cette table dont la valeur de champ S’applique à est Table sont Attributs de la source indexée.

    Cet exemple montre comment la source indexée de la table d’éléments de catalogue du système de base mappe short_description valeurs de champ de la table Élément de catalogue [sc_cat_item] au champ de texte de l’index pour les Recherche IA enregistrements indexés.


    Recherche IA Formulaire de paramètre de champ affichant l’élément de catalogue source [sc_cat_item],le map_to d’attribut,le short_description de champ etle texte de valeur.

    Sécurité pour les valeurs de champ de table référencée interrogeables

    Lorsqu’un utilisateur recherche des valeurs de champ de table référencées que vous avez indexées pour une recherche avec le paramètre de searchable_dot_walk_fields champ, seules les valeurs de champ que l’utilisateur peut afficher apparaissent dans les résultats de la recherche. Le système utilise les règles de liste de contrôle d’accès (ACL) basées sur les rôles d’une valeur de champ pour déterminer si l’utilisateur de la recherche peut afficher cette valeur de champ.

    Les valeurs de champ de table référencée interrogeables qui ont des ACL ou des critères d’utilisateur basés sur une condition ou un script n’apparaissent pas dans les résultats de recherche.

    Pour les valeurs de champ pouvant faire l’objet d’une recherche et indexées via plusieurs niveaux de référence de remontée pas à pas, le système ne prend en compte que les ACL basées sur le rôle sur la valeur de champ finale. Par exemple, si vous indexez company.contact.name valeurs de champ de table référencées pour la recherche, l’accès de l’utilisateur aux valeurs de champ de nom n’est pas affecté par les ACL basées sur le rôle sur les valeurs de champ contact .

    Pour contourner tous les ACL et permettre aux utilisateurs de rechercher toutes les valeurs de champ de table référencées pouvant faire l’objet de recherches, vous pouvez définir la glide.ais.query.allow_indexlookup_for_dotwalk propriété système sur vrai. Cela permet de contourner l’évaluation de l’ACL pour les valeurs de champ indexées via les paramètres du dot_walk_fields champ et searchable_dot_walk_fields .

    Pour plus de détails sur les types et la configuration des ACL, consultez Règles de liste de contrôle d’accès.