Paramétrer les champs

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

    Voici quelques 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 pour 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 les valeurs de champ disponibles, reportez-vous à la section Liste des paramètres de Recherche IA champ de la source indexée.

    Procédure

    1. Accédez à la Tous > 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. Remplissez les champs du formulaire Paramétrage.
    5. Sélectionnez Envoyer.

    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 obtenir des détails sur cette procédure, reportez-vous à la section Effectuer un indexage complet 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 de la table source. Vous pouvez indexer ces valeurs de champ pour les utiliser dans les filtres et EVAM les configurations des 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, elle indexe par défaut les valeurs pour le champ de référence, Recherche IA 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 des dot_walk_fields paramètres de champ sur searchable_dot_walk_fields votre table source indexée.
    • Pour utiliser les valeurs de champ des tables référencées dans les filtres de sources de recherche, les filtres de facette et EVAM les configurations des résultats de recherche, créez un dot_walk_fields paramètre de champ.
    • Pour rendre les valeurs de champ des tables référencées consultables, créez un searchable_dot_walk_fields paramètre de champ.

    Comme valeur pour l’un ou l’autre de ces paramètres de champ, listez 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 entre plusieurs tables, vous pouvez saisir des valeurs de nom de champ en séparant des points par des préfixes de champ de référence. Par exemple, saisissez un company.contact.name de valeur pour indexer le champ nom dans la table référencée par le champ contact sur la table référencée par le champ de référence de 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 sur l’indexation. Évitez d’utiliser des références à plusieurs niveaux, sauf si cela est nécessaire.

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

    Procédure

    1. Accédez à la Tous > 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, saisissez les valeurs de champ affichées pour votre cas d’utilisation.
      • Pour indexer les valeurs de champ à partir de tables référencées afin de les utiliser dans les filtres de sources 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é 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 pouvant faire l’objet d’une recherche, 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é 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 Sélection d’attributs , assurez-vous que votre sélection de champ est un champ de référence.
    4. Sélectionnez Envoyer.
      L’attribut et la valeur apparaissent dans la liste connexe Paramètres de champ et mappage.

    Liste des paramètres de Recherche IA champ de la source indexée

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

    Pour plus d’informations sur la création de paramètres de champ, reportez-vous à 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é pour une utilisation dans les filtres sources 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 source de recherche, reportez-vous à Sources de recherche. Pour en savoir plus sur les filtres de facette, reportez-vous à la section Créer une facette dans une configuration d’application Recherche IA.
    • 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 les valeurs de champ indexées avec ce paramètre de champ. Pour indexer les valeurs de champ des 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 paramètres de champ ET dot_walk_fieldssearchable_dot_walk_fields pour le même champ de référence.
    index_calculated_field

    Option permettant d’activer l’indexation du contenu pouvant faire l’objet de recherches à 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 true pour ce champ afin d’indexer correctement ses valeurs. Si la valeur de paramètre de champ est 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 un traitement spécial pour indexer correctement les valeurs de champ calculées à partir du champ sélectionné.
      • false: n’appliquez 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.
    map_to

    Mappez le champ sélectionné 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 souhaitez 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 tentez de définir plusieurs paramètres de map_to pour le même champ, le système affiche un message d’erreur.
    no_text_index
    Option permettant de désactiver l’indexation du contenu pouvant faire l’objet de recherches à 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ésactivez l’indexation de contenu pouvant faire l’objet d’une recherche pour le champ sélectionné. La recherche et les filtres ne peuvent pas correspondre à la valeur du champ.
      • false: activez l’indexation de contenu pouvant faire l’objet d’une recherche pour le champ sélectionné. La recherche et les filtres peuvent correspondre à la valeur du champ.
    • Valeur par défaut : false

    Pour obtenir Service et assistance client 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ésactivez la recherche de correspondance 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 :
    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 pouvant faire l’objet d’une recherche.

    Recherche IA ne met pas à jour automatiquement 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 de champ indexées, vous devez réindexer la source indexée. Pour obtenir des détails sur cette procédure, reportez-vous à la section Effectuer un indexage complet 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 de recherches
    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 paramètres de champ ET dot_walk_fieldssearchable_dot_walk_fields pour le même champ de référence.
    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 à est 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 Recherche IA pour les 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 la valeur.

    Sécurité pour les valeurs de champ de table référencée pouvant faire l’objet de recherches

    Lorsqu’un utilisateur recherche des valeurs de champ de table référencées que vous avez indexées pour la 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 recherche. Le système utilise les règles de liste de contrôle d’accès (ACL) basées sur le rôle 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ées pouvant faire l’objet de recherches qui ont des ACL ou des critères d’utilisateur basés sur des conditions ou des scripts n’apparaissent pas dans les résultats de recherche.

    Pour les valeurs de champ pouvant faire l’objet d’une recherche indexées via plusieurs niveaux de référence de remontée pas à pas, le système prend uniquement en compte les ACL basées sur les rôles 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 des utilisateurs aux valeurs de champ de nom n’est pas affecté par les ACL basées sur les rôles sur les valeurs de champ de contact .

    Pour contourner toutes les ACL et permettre aux utilisateurs de rechercher toutes les valeurs de champ de table référencées pouvant faire l’objet d’une recherche, 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 de champ dot_walk_fields et searchable_dot_walk_fields .

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