Doc produitsMenu

Ajout ou modification de champs personnalisés

Les champs d'index peuvent contenir des métadonnées extraites du contenu structuré de référentiels analysés. Les paramètres de champ déterminent à quelles métadonnées un champ est associé, et comment elles peuvent être utilisées. Vous pouvez ajouter ou modifier des champs personnalisés afin d'indexer des informations supplémentaires qui ne sont pas couvertes par les champs intégrés de Coveo.

Exemple : Vous pouvez indexer une colonne SharePoint personnalisée intitulée Département en ajoutant un champ personnalisé correspondant (voir Ajout de nouvelles propriétés aux références SharePoint).

Notes :

  • CES 7.0.7022+ (septembre 2014) L'index traite automatiquement les changements apportés à la configuration de champs existants. Ce processus peut prendre de quelques à plusieurs minutes pour un gros index. Vous ne verrez donc pas immédiatement l'effet.

  • CES 7.0.6942– (août 2014) Lorsque vous modifiez la configuration d'un champ existant, vous devez régénérer les sources qui utilisent ce champ.

Pour ajouter des champs personnalisés

  1. Dans le serveur Coveo, accédez à l'Outil d'administration (voir Ouverture de l'Outil d'administration).

  2. Sélectionnez Configuration > Champs.

  3. Dans la page Groupes de champs, cliquez sur le groupe de champs auquel vous souhaitez ajouter ou modifier un champ (voir Que sont les groupes de champs?).

  4. Dans le panneau de navigation situé à gauche, sélectionnez Champs personnalisés (Custom Fields), puis :

    • Cliquez sur Ajouter pour créer un nouveau champ personnalisé.

      OU

    • Cliquez sur un champ personnalisé existant afin de le modifier.

  5. Dans la page Ajouter un champ personnalisé (Add a Custom Field) :

    1. Dans le champ Nom (Name), tapez un nom afin d'identifier le champ personnalisé.

      Le nom du champ doit être composé d'un à 64 caractères seulement des portées a-z, A-Z et 0-9, et ne doit pas commencer par un nombre. Les noms de champs ne sont pas sensibles à la casse.

      Note : Si le Nom des métadonnées (voir ci-dessous) est laissé vide et le Nom correspond exactement à un nom de métadonnées spécifié dans le référentiel analysé, le contenu des métadonnées est automatiquement copié vers le champ d'index pour chaque document analysé qui contient ces métadonnées. C'est un moyen facile d'associer des métadonnées de référentiel à un champ d'index.

      Vous pouvez définir un Nom pour qu'il soit différent du Nom des métadonnées afin de vous aider à comprendre l'origine du champ.

      Exemple : Vous pouvez utiliser un préfixe afin d'identifier tous les champs personnalisés d'un référentiel donné. Vous créez tous les champs personnalisés pour les métadonnées d'un site Jive avec le préfixe jive. Pour les métadonnées creationDate de Jive, vous créez le champ personnalisé jivecreationdate.

      Note : Ce nom est utilisé, pendant les requêtes de champ, sous la forme @fieldname=fieldvalue.

    2. Dans la section Type, sélectionnez un type de valeur accepté par le champ.

      Il existe quatre types :

      Chaîne (String)

      Le champ accepte des séries de caractères sans valeur mathématique. Les noms d'utilisateur et les mots de passe sont des paramètres de chaîne.

      Numérique (Numeric)

      Le champ accepte les nombres entiers. La taille d'un document en octets est une valeur numérique.

      Date/heure (Date/time)

      Le champ accepte des séries de caractères et de nombres qui représentent une date. La date de modification d'un document est une valeur de date et d'heure.

      Valeur à virgule flottante (Floating point)

      Le champ accepte des nombres avec des fractions (ex. : 10.031).

    3. Dans la boîte Nom des métadonnées (Metadata Name), tapez le nom des métadonnées auxquelles vous souhaitez associer ce champ.

      Important : Veillez à taper le nom des métadonnées exactement comme il est épelé dans le référentiel analysé.

      Tel que mentionné ci-haut, vous pouvez laisser cette boîte vide. Dans ce cas, CES utilise plutôt le Nom afin de tenter une association avec un nom de métadonnées.

    4. Dans le champ Valeur par défaut (Default Value), tapez la valeur qui est indexée lorsqu'un champ est vide. Cette valeur doit être identique au type de champ.

      Exemple : Si la valeur du champ Département est vide, la valeur par défaut, Chaîne, est indexée.

    5. Pour le type Date et heure du champ seulement, dans la boîte Format de la date, tapez le format de la date dans les métadonnées (voir Spécification d'un format de date).

    6. Dans la section Option, sélectionnez les bonnes options :

      Incorporer aux requêtes par champ (Include for field queries)

      Le contenu du champ peut être recherché à l'aide du format @fieldname=fieldvalue. Cette option est sélectionnée par défaut.

      Exemple : La requête @sysauthor=John retourne des documents dont l'auteur est John.

      Incorporer aux requêtes textuelles (Include for free text queries)

      Le contenu du champ peut être recherché à l'aide de texte libre. Cette option n'est pas sélectionnée par défaut et n'est disponible que si le type de champ est Chaîne.

      Exemple : Si les requêtes textuelles sont permises dans @sysauthor, les documents retournés par @sysauthor=John sont également retournés par John; toutefois, la requête John retourne également des documents qui contiennent le mot John dans leur contenu, pas seulement dans le champ sysauthor).

      Permettre la recherche par facette sur ce champ (Allow faceted search on this field)

      Le contenu du champ peut être utilisé afin de créer une facette pour former des groupes de raffinement de requête (voir Ajout ou personnalisation d'une facette). Cette option n'est pas sélectionnée par défaut et n'est disponible que si le type de champ est Chaîne.

      Exemple : Si l'option Permettre la recherche par facette sur ce champ est sélectionnée pour le champ @sysauthor, vous pouvez créer une facette Auteur qui permet aux utilisateurs d'affiner les résultats selon les auteurs des documents.

      Créer un champ de date décomposée CES 7.0.5785+ (août 2013)

      Un nouveau champ est créé. Il contient la date du champ original, mais décomposée en valeurs pour le jour, la semaine, le mois, le quartier et l'année relativement au 1er janvier 1900. Le nom du nouveau champ est le nom du champ original, auquel le suffixe SmartFacet est ajouté. Ce champ est utile afin de créer plus de facettes et graphiques de date intuitifs.

      Exemple : Le champ original MyDate contient 2013-02-24 et le nouveau champ MyDateSmartFacet contient D41329;W5904;M1357;Q452;Y113.

      Permettre la recherche par facette sur ce champ à plusieurs valeurs (Allow faceted search on a field containing multiple values)

      Le contenu du champ à plusieurs valeurs peut être utilisé afin de créer une facette pour former des groupes de raffinement de requête (voir Ajout ou personnalisation d'une facette). Les multiples valeurs du champ, séparées par des points-virgules, sont prises en considération individuellement. Cette option n'est pas sélectionnée par défaut et n'est disponible que si le type de champ est Chaîne.

      Exemple : Le champ à plusieurs valeurs @syslanguage contient French;English pour un document. Si l'option Permettre la recherche par facette sur ce champ à plusieurs valeurs est sélectionnée, dans la facette Langue basée sur ce champ, ce document compte deux fois (pour les éléments French et English) plutôt qu'une fois pour l'élément French;English.

      Permettre de trier les résultats des requêtes par ce champ (Allow to sort query results by this field)

      Le contenu du champ peut être utilisé afin de trier les résultats de recherche (voir Ajout d'un critère de tri). Cette option n'est pas sélectionnée par défaut, mais est disponible pour tous les types de champs.

      Important : L'ajout de champs de tri a un impact sur la taille et la performance de l'index. Il est conseillé de sélectionner l'option Permettre de trier les résultats des requêtes par ce champ seulement pour les champs que vous comptez utiliser afin de trier dans les interfaces de recherche.

      Exemple : Si @sysdate est utilisé pour trier les résultats, la fonction Trier par date (qui permet de trier les documents par date de modification) est disponible dans l'interface de recherche.

      Définir comme champ affiché (Set as display field)

      Sélectionné par défaut pour que le champ soit visible dans le Navigateur d'index (voir Évaluation des détails d'un document du Navigateur d'index) et disponible à partir de l'Éditeur d'interface pour inclusion en tant que champ d'affichage dans les résultats de recherche (voir Ajout de champs d'affichage aux résultats de recherche). Pensez à vider les champs non utilisés afin de minimiser le temps de chargement des résultats de recherche en temps de requête. Vous pouvez modifier cette sélection plus tard (voir Gestion des champs affichés).

    7. Cliquez sur Enregistrer (Save).

      Note : CES 7.0.7711+ (juin 2015)Lorsque le champ Nom que vous avez saisi correspond au nom d'un alias de champ personnalisé ou système, vous obtenez le message d'erreur suivant :

      This name is already used.

Prochaines étapes?

CES 7.0.6942– (août 2014) Régénérez les sources à l'aide du groupe de champs qui contient le(s) nouveau(x) champ(s) (voir Application d'une action à une collection ou à une source).