Paramètres du champ

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 13 minutes de lecture

    • Un paramètre de champ contrôle le comportement d’indexation d’un champ spécifié (colonne) sur tous les enregistrements à partir d’une source indexée.

    Voici des exemples d’utilisation des paramètres de champ.
    • Désactiver l’indexation de texte ou la 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 dans l’index Recherche IA
    • Ajouter un champ de table référencé à l’index en remontée pas à pas à partir d’un champ de référence sur des enregistrements de table source

    Les paramètres de champ d’une source indexée apparaissent 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 plus d’informations sur les paramètres et valeurs de champ disponibles, reportez-vous à la section Liste des paramètres de champ de Recherche IA source indexée.

    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.
    3. Dans la liste connexe à Mappage et paramètres de champ, sélectionnez Nouveau.
    4. Renseignez les champs du formulaire Paramétrage des champs.
    5. Sélectionnez Soumettre.

    Résultats

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

    Que faire ensuite

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

    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 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, 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és, vous pouvez créer dot_walk_fields des 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 source de recherche, les filtres de facette et EVAM les configurations des résultats de recherche, créez un paramètre de dot_walk_fields champ.
    • Pour rendre les valeurs de champ des tables référencées consultables, créez un paramètre de searchable_dot_walk_fields champ.

    Comme valeur pour l’un ou l’autre 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 ville à 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 entrez la valeur nom,ville.

    Pour parcourir 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 la valeurcompany.contact.name pour indexer le champ nom dans la table référencée par le champ contact dans la table référencée par le champ de référence d’entreprise 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 à plusieurs niveaux, sauf si cela est nécessaire.

    Vous pouvez créer les deux 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 à Mappage et paramètres de champ, sélectionnez Nouveau.
    3. Dans le formulaire Paramétrage du 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 à utiliser 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 la 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 pouvant faire l’objet d’une recherche, saisissez les valeurs de champ suivantes.
        Champ Valeur
        Attribut searchable_dot_walk_fields
        Champ <nom du champ de référence de la 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’attributs , 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 Mappage et paramètres de champ.

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

    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 les valeurs de référence et d’affichage des champs sur 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ées pour refléter les changements apportés aux valeurs de champ de la table référencée.

    Pour plus d’informations sur les filtres sources de recherche, reportez-vous à la section Rechercher des sources. Pour plus d’informations sur les filtres de facette, reportez-vous à la section Créer une facette dans une configuration d’application Recherche IA.
    • Champ : nom du champ de référence dans votre table de source indexée. Par exemple, si votre table de source indexée contient un champ de référence d’entreprise qui fait référence à la table Société [core_company], et que vous souhaitez indexer les valeurs de champ à partir des champs de nom et de ville de cette table, vous devez définir Société comme champ.
    • Type : chaîne
    • Valeur : liste séparée par des virgules des champs de table référencés à partir desquels indexer les valeurs. Par exemple, si votre table de source indexée contient un champ de référence d’entreprise qui fait référence à la table Société [core_company] et que vous souhaitez indexer les valeurs de champ à partir des champs de nom et de ville de cette table, vous devez définir nom,ville comme valeur.
    Remarque :
    Vous ne pouvez pas rechercher des valeurs de champ indexées avec ce paramètre de champ. Pour indexer les valeurs de champ des tables référencées pour la recherche, créez un paramètre de searchable_dot_walk_fields champ. Vous pouvez créer les deux 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 à partir de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un index de table complet ou réindexer pour une source indexée unique.
    index_calculated_field

    Option permettant d’activer l’indexation du contenu pouvant faire l’objet d’une recherche à partir des valeurs de champ calculées.

    Si votre source indexée contient un champ calculé, définissez ce paramètre de champ sur true ce champ afin d’indexer correctement ses valeurs. Avec une valeur de champ définie sur false ou sans valeur, Recherche IA ignore les valeurs du champ calculé 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 prises en charge :
      • true: appliquer une gestion spéciale 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.

    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 à partir de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un index de table complet ou réindexer pour une source indexée unique.
    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 le champ d’index spécifié est renseigné 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 . Lorsqu’un Recherche IA enregistrement de la table de connaissances [kb_knowledge] est indexé, le titre pouvant faire l’objet de recherches dans l’enregistrement indexé est renseigné 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 sur lequel vous souhaitez mapper les valeurs d’affichage du champ sélectionné. Pour plus de détails sur Recherche IA les champs d’index, reportez-vous à la section 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 à partir de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un index de table complet ou réindexer pour une source indexée unique.
    no_text_index
    Option permettant de désactiver l’indexation du contenu pouvant être recherché à 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 prises en charge :
      • 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: activez l’indexation du contenu consultable 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 à partir de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un index de table complet ou réindexer pour une source indexée unique.

    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 prises en charge :
      • true: désactivez la correspondance des recherches pour le contenu indexé à partir du champ sélectionné. La recherche ne peut pas correspondre à la valeur du champ. Les filtres (par exemple, pour la sécurité du contenu, les onglets de navigation et les facettes) peuvent toujours correspondre à la valeur du champ.
      • false: activez 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

    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 à partir de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un index de table complet ou réindexer pour une source indexée unique.
    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é sous forme de texte pouvant faire l’objet d’une recherche.

    Recherche IA ne met pas automatiquement à jour les valeurs de champ indexées pour refléter les changements apportés 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 de détails sur cette procédure, reportez-vous à la section Effectuer un index de table complet ou réindexer pour une source indexée unique.
    • Champ : nom du champ de référence dans votre table de source indexée. Par exemple, si votre table de source indexée contient un champ de référence d’entreprise qui fait référence à la table Société [core_company], et que vous souhaitez indexer le texte interrogeable à partir des champs de nom et de ville de cette table, vous devez définir Société comme champ.
    • Type : chaîne
    • Valeur : liste séparée par des virgules des champs de table référencés à indexer comme contenu pouvant faire l’objet de recherches. Par exemple, si votre table de source indexée contient un champ de référence d’entreprise qui fait référence à la table Société [core_company] et que vous souhaitez indexer le texte consultable à partir des champs de nom et de ville de cette table, vous devez définir nom,ville comme valeur.
    Remarque :
    Vous ne pouvez pas utiliser de valeurs de champ indexées avec ce paramètre de champ dans les filtres de source de recherche. Pour indexer les valeurs de champ des tables référencées en vue de les utiliser dans les filtres de source de recherche, créez un paramètre de dot_walk_fields champ. Vous pouvez créer les deux 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 à partir de la source indexée. Pour connaître les étapes de réindexation, reportez-vous à la section Effectuer un index de table complet ou réindexer pour une source indexée unique.
    Remarque :
    Les paramètres de champ sont des enregistrements de la table Attribut de configuration Recherche IA [ais_configuration_attribute] dont la valeur du champ S’applique à sont Colonne . Les enregistrements de cette table dont la valeur du champ S’applique à sont les suivants :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 configuration 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 interrogeables

    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 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 effectuant la recherche peut voir cette valeur de champ.

    Les valeurs de champ de table référencées pouvant faire l’objet d’une recherche qui ont des ACL basées sur des conditions ou des scripts ou des critères d’utilisateur n’apparaissent pas dans les résultats de recherche.

    Pour les valeurs de champ interrogeables 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 les rôles pour 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 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 de recherches, vous pouvez définir la glide.ais.query.allow_indexlookup_for_dotwalk propriété système sur true. Cela contourne l’évaluation ACL pour les valeurs de champ indexées via les paramètres de dot_walk_fields champ and searchable_dot_walk_fields .

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