Ajout ou personnalisation d'une facette

CES contient des facettes intégrées que vous pouvez facilement ajouter à votre interface de recherche (voir Gestion des facettes et résultats reliés intégrés qui apparaissent dans une interface de recherche).

Vous pouvez également personnaliser des facettes existantes ou en créer de nouvelles et les ajouter à une interface de recherche.

Pour ajouter ou personnaliser des facettes

Accédez à l'Éditeur d'interface (voir Ouverture de l'Éditeur d'interface).
Sélectionnez l'onglet Interfaces de recherche.
Dans le menu :
1. Dans la liste déroulante Interface sélectionnée, sélectionnez l'interface de recherche à laquelle vous souhaitez apporter des modifications.
2. Cliquez sur le menu Fonctionnalités.
Dans le panneau de navigation à gauche, cliquez sur Facettes et résultats reliés.
Dans le panneau situé à droite :
- Pour ajouter une nouvelle facette, au-dessus de la liste Facettes intégrées, cliquez sur Ajouter une nouvelle facette.
  
  OU
- Pour personnaliser une facette existante, dans la liste Facettes et résultats reliés, cliquez sur la facette que vous souhaitez modifier.
Une page identique à celle ci-dessous apparaît.
Sous Modifier la facette (Edit Facet), configurez les paramètres obligatoires suivants :
1. Dans la boîte Titre (Title), tapez le texte que vous souhaitez voir comme légende au haut de la facette. Cliquez sur le bouton pour taper le sous-titre qui sera traduit dans toutes les langues prises en charge.
2. Dans la liste déroulante Champ à utiliser pour créer un groupe (Field to Group On), sélectionnez le champ dont les valeurs sont utilisées afin de construire les éléments énumérés dans la facette.
  
  Exemple : Sélectionnez sysauthor si vous souhaitez créer une facette qui donne la liste des auteurs de tous les documents retournés.
  
  Note : Si le champ souhaité n’apparaît pas dans la liste déroulante, vous devez rendre le champ disponible avec l'Outil d'administration (voir Ajout d'un champ de facette).

Toujours sous Modifier la facette, vous pouvez changer le comportement par défaut des paramètres suivants :

Dans la liste déroulante Champ à afficher (Field to Display), sélectionnez le champ dont les valeurs sont utilisées pour identifier les éléments dans la facette si il y a différence avec le paramètre Champ à utiliser pour créer un groupe (Field to Group On).

Exemple : Vous pouvez générer une facette selon des identifiants d'auteur avec le champ sysauthorid mais afficher les noms d'auteurs correspondants avec le (champ sysauthor). Le but de cette procédure est d'améliorer la précision des éléments de facettes (car chaque identifiant d'auteur est unique) sans compromettre leur identification par les utilisateurs (les noms sont plus reconnaissables que les identifiants).
Si un développeur a programmé une version personnalisée du code de facette que vous préféreriez utiliser :
1. Dans la boîte Assembly, tapez le nom d'assemblage pleinement qualifié renfermant la classe spécifiée dans la boîte Classe.
2. Dans la boîte Classe, tapez le nom d'une classe (dont son espace de nom) à utiliser afin d'instancier la facette.
À côté d'Icône (Icon), si vous souhaitez utiliser une icône autre que celle par défaut à côté du titre de la facette :
1. Cliquez sur Changer (Change).
2. Cliquez sur le bouton Choisir fichier qui apparaît, puis sélectionnez le fichier d'image de l'icône dans la boîte de dialogue qui s'ouvre.
3. Cliquez sur Envoyer afin de transférer le fichier jusqu'au serveur Coveo à partir de son emplacement d'origine.

Dans Zone, sélectionnez l'endroit où la facette apparaîtra dans l'interface de recherche :

Position par défaut des facettes de l'interface (Interface default facet position) : Comme expliqué dans la section Paramètres par défaut des facettes pour cette interface de recherche.
Droite : Apparaît dans la zone verticale à la droite de l'interface de recherche.

Dessus : Apparaît dans la zone horizontale au-dessus des résultats de recherche. Cette zone est généralement utilisée afin de présenter des facettes ou des panneaux de résultats reliés dont le Style d'affichage (Display Style) est défini à Boîte déroulante.

Exemple :

1	Une facette de style Boîte déroulante
2	La zone Dessus

Gauche : Apparaît dans la zone verticale à la gauche de l'interface de recherche.

Note : Vous pouvez définir hiérarchiquement des positions de facettes pour un hub, pour une interface de recherche, et pour des facettes spécifiques (voir Configuration de la position des facettes et des panneaux de résultats reliés).

Dans Style d'affichage, sélectionnez le mode d'apparence des facettes :

Normal : Format par défaut (voir À propos des facettes).
Boîte déroulante : La facette apparaît en tant que contrôle déroulant qui est réduit par défaut. Ce type de facette se trouve uniquement dans la Zone Dessus.

Exemple : Une facette Source est illustrée ci-dessous dans les deux formats.

Normal	Boîte déroulante réduite	Boîte déroulante développée

Note : Coveo .NET Front-End 12.0.503+ (décembre 2013) Le style de facette Boîte déroulante a été réintroduit.

Dans Critères d'affichage (Display Criteria), sélectionnez les critères déterminant le moment où la facette apparaît :
- Quand il y a plus d'un résultat (When there is more than one result) : Généralement le comportement désiré parce qu'une facette avec une ou aucune valeur est inutile pour le raffinement des résultats.
- Quand il y a au moins un résultat : À sélectionner si vous souhaitez toujours voir la facette même s'il n'y a qu'un élément de facette.
- Toujours afficher : À sélectionner si vous souhaitez toujours voir la facette, même si aucun élément de facette n'est affiché.
Si vous souhaitez restreindre des éléments de facette à des valeurs spécifiques, dans le champ Valeurs permises (Allowed Values), tapez une liste de valeurs séparées par des virgules. Si vous ne voulez imposer aucune restriction, laissez le champ vide.

Exemple : Si vous souhaitez créer une facette Auteurs marketing en ne recensant que les auteurs de votre département marketing, tapez la liste des noms des employés du département marketing. La facette ne montrera alors que les éléments de facettes de ces auteurs.
Le paramètre de sélection Performance détermine le nombre de résultats retournés qui seront analysés pour chaque requête afin de trouver les éléments de facettes possibles. Déplacer la sélection du bouton radio de la gauche (Plus rapide (Faster) vers la droite (Plus précis (More Precise) augmente le nombre de résultats analysés.

Sélectionner le bouton radio le plus à gauche sous Plus rapide (valeur par défaut) devrait énumérer tous les éléments de facette disponibles dans une majorité de cas puisque tous les résultats retournés jusqu'aux 1000 premiers sont analysés afin d'identifier les éléments de facette possibles.

Tentez de sélectionner un bouton vers Plus précis si vous soupçonnez qu'il y a un grand nombre d'éléments pour cette facette et que vous souhaitez améliorer les chances que la facette les affiche tous.

Sélectionner Plus précis assure que la facette donne la liste de tous les éléments de facette en analysant tous les résultats de requête. Soyez toutefois averti qu'avec cette sélection, l'affichage de la facette peut être très lent pour les requêtes retournant un grand nombre de résultats.

Exemple : Prenons l'exemple où une facette Auteur apparaît dans l'interface de recherche pour un blogue renfermant des milliers d'auteurs possibles. Si une requête rapporte 80 résultats, la facette présente tous les éléments de facette possibles. Disons qu'une deuxième requête rapporte 5 000 résultats. Dans ce cas, étant donné que la facette, par défaut, ne regarde que les 1 000 premiers résultats afin d'identifier de possibles auteurs, il est possible que la facette ne présente pas tous les auteurs des 5 000 articles de blogue.

Note : Le terme Précision pour ce paramètre fait référence à la probabilité que la facette fasse une liste de tous les éléments de facette possibles. Toutefois, le nombre d'occurrences de résultats apparaissant entre parenthèses pour chaque élément de facette est toujours exact.

Dans le champ Nombre de valeurs (Number of Values), tapez le nombre d'éléments de facette que la facette montrera par défaut. Si davantage d'éléments de facette sont disponibles, le contrôle Plus apparaît au-dessous de la facette afin de permettre à l'utilisateur d'étendre la facette et de présenter tous les éléments de facette. La valeur par défaut est de 5.

Exemple : Une requête retourne des documents avec un grand nombre de types de fichiers différents.

	Le nombre de valeurs étant défini à 5, seuls les cinq types de fichier les plus fréquents seront initialement montrés.
	Le nombre de valeurs additionnelles étant défini à 10, lorsque vous cliquez sur Plus, jusqu'à dix nouveaux fichiers sont présentés.
	Le nombre de valeurs à la recherche étant défini à 15, lorsque vous tapez des caractères dans la boîte de recherche, jusqu'à 15 éléments correspondants peuvent apparaître dans la liste de suggestions.

Dans le champ Nombre de valeurs additionnelles (Additional Values Increment), tapez le nombre d'éléments de facette qui seront ajoutés/masqués chaque fois que l'utilisateur clique sur Plus/Moins. La valeur par défaut est 10.
Dans le champ Nombre de valeurs à la recherche (Number of Search Values), tapez le nombre maximal d'éléments de facette qui apparaîtront au-dessous de la boîte de recherche, dans la liste d'éléments de recherche correspondant aux caractères tapés dans la boîte de recherche. La valeur par défaut est de 15.
Coveo .NET Front-End 12.0.61+ (décembre 2012) Cochez Activer la recherche (Enable Facet Search) afin que la boite de recherche soit visible.

Note : La boîte de recherche n'apparaîtra pas dans la facette si vous spécifiez un champ dans Champ à afficher ci-dessus.
Dans la liste déroulante Unité des intervalles dynamiques (Dynamic Range Unit), lorsque c'est approprié, sélectionnez une option pour inclure des unités afin que les valeurs de plage soient plus lisibles :
- Date : Pour une facette avec des valeurs de plage de dates, sélectionnez pour afficher des valeurs dans le format date courte (mm-jj-aaaa) plutôt que le format date longue (mm-jj-aaaa hh:mm:ss) qui apparaît par défaut.
- Devise : Pour une facette avec des valeurs de plage de devises, sélectionnez pour afficher les valeurs avec des multiples décadiques de la devise (K pour 1 000 ou M pour 1 000 000).
  
  Exemple : $500K-$1,499M plutôt que $500 000-$1,499999
- Octets : Pour une facette avec des valeurs de plage de tailles de fichier, sélectionnez pour afficher les valeurs en unités O, Ko, Mo, Go, ou To plutôt que les valeurs entières complètes.
  
  Exemple : La même facette Taille du fichier respectivement lorsque Aucune unité et Octets est sélectionné dans la liste déroulante Unité des intervalles dynamiques.
Dans la liste déroulante Mode de coupure (Clipping Mode), s'il y a des éléments de facette dont la longueur excède la largeur disponible de la facette, sélectionnez l'endroit où tronquer le légende et ajoutez le caractère d'ellipse.

Exemple : Bien que dans la plupart des cas, il soit plus sensé de tronquer la fin des légendes, il est souvent plus utile, pour une facette de dossier, de voir la fin du chemin d'accès plutôt que son début.
Dans la liste déroulante Critère de tri (Sort Criteria), sélectionnez le critère qui contrôlera l'ordre d'apparition des éléments de facette :
- Nombre d’occurrences (Number of Occurrences) : Trie les éléments de facette en ordre décroissant selon le nombre de fois qu'ils apparaissent dans les résultats de recherche.
  
  Exemple : Dans une facette Auteur, si John a écrit 10 documents et Jack 5, alors John apparaîtra avant Jack.
- Indice de pertinence : Trie les éléments de facette en ordre décroissant de cote d'appréciation. La cote d'appréciation donne davantage de points aux éléments de facette contenus dans des documents apparaissant plus haut dans les résultats de recherche. En conséquence, un élément de facette étant présent quelques fois dans des documents à haut classement apparaît avant un élément de facette étant présent plusieurs fois dans des documents à bas classement.
  
  Exemple : Dans une facette Auteur, si John est l'auteur d'un seul document qui est toutefois l'un des mieux classés, et Jack est celui de 200 documents qui sont au bas de la liste, John apparaîtra alors avant Jack dans la liste d'éléments de facette.
- Ordre alphabétique : Trie les éléments de facette en ordre alphabétique (A à Z) ou numérique croissant.
- Ordre alphabétique décroissant : Trie les éléments de facette en ordre alphabétique (A à Z) ou numérique décroissant.
- Corrélation : Trie les éléments de facette en se basant sur la corrélation avec la requête en cours, et ce, à l'aide d'une méthode Chi2. Les éléments ayant une relation particulière avec la requête apparaissent plus haut que les autres éléments de l'index.
  
  Exemple : Vous pouvez utiliser l'option Corrélation afin de trier une facette Expert qui donnera une liste de personnes étant particulièrement liées aux termes recherchés, et non seulement des personnes étant les auteurs de plusieurs documents qui contiennent les termes.
À côté de Dépend de (Depends On), déterminez si l'apparence de cette facette est une condition à l'utilisation par un utilisateur d'une autre facette. Cette fonctionnalité est utile si les critères de raffinement de deux facettes sont liés selon une hiérarchie.

Exemple : Si une interface de recherche contient à la fois une facette Année et une facette Mois, il est souvent plus sensé de ne montrer que la facette Mois après que l'utilisateur ait sélectionné une année dans la facette Année. Pour obtenir ceci, dans la facette Mois, à côté de Dépend de, cochez Année.
Cochez Afficher en mode réduit par défaut (Collapsed by default) si vous souhaitez que seul le titre de la facette soit montrée et non ses éléments.

Cette option est utile pour, par exemple, des facettes moins fréquemment utilisées si votre interface de recherche contient plusieurs facettes et vous souhaitez sauvegarder de l'espace vertical.

Vous avez également le choix de déterminer quelles images d'icône vont apparaître à la gauche de chaque élément de facette :
1. Pour les anciennes facettes seulement, dans le champ Image par défaut (Default Image), tapez le chemin d'accès et le nom de fichier de l'image à présenter comme icône par défaut à la gauche de tous les éléments de facette. Vous pouvez spécifier le chemin d'accès complet sous la forme http://mysite.com/[path]/[image_file] ou le chemin d'accès relatif à partir duquel la page de l'interface de recherche est sauvegardée.
  
  Exemple : Pour une ancienne facette Auteur, tapez le chemin d'accès et le nom du fichier pour l'icône avec le chemin complet (ex. : http://mysite.com/icon-author.png) ou le chemin relatif (ex. : ~/Coveo/Skins/MySearchInterface/icon-author.png).
2. Vous pouvez également assigner des icônes et des légendes personnalisées à des valeurs d'éléments de facette spécifiques :
  1. À côté de Associations de valeur à image (Value to Image Mappings), cliquez sur Nouveau (Add New).
    
    Trois boîtes apparaissent, où vous pouvez spécifier une ou plusieurs règles pour associer des icônes et des captures à des valeurs de facette.
  2. Dans la boîte à gauche, tapez la valeur de l'élément de facette auquel vous souhaitez assigner une icône et/ou légende spécifique.
  3. Dans la boîte au centre, tapez le chemin d'accès et le nom de fichier de l'image à afficher en tant qu'icône. Vous pouvez spécifier le chemin d'accès complet sous la forme http://mysite.com/[path]/[image_file] ou le chemin d'accès relatif à partir du dossier de skin de l'interface de recherche sous la forme ~/[Relative_Path]/[Filename]
  4. Dans la boîte à droite, tapez une légende personnalisée pour la valeur d'élément.
  Note : Comme effectué pour certaines facettes régulières comme la facette Type, vous pouvez utiliser une ressource intégrée (comme coveo_embedded_res(Coveo.CES.Web.Search.Images.author.png)) ou une méthode d'appel (comme callback(Coveo.CES.Web.Search.Interfaces.ValueMappingFormatter.GetFileTypeIconUri)) pour obtenir de façon dynamique l'icône et la légende appropriées pour la facette. Taper * dans le champ situé à gauche indique que ces ressources ou rappels s'appliquent à tous les éléments. Cette fonctionnalité peut être utilisée par les Services professionnels Coveo et les développeurs.
  
  Exemple : Pour une facette Type, vous devriez utiliser des icônes et des légendes spécifiques pour des documents Word et Excel et utiliser les icônes et légendes régulières pour d'autres types de fichiers. Vous pouvez effectuer ceci en entrant les associations comme suit.
Sous Champs calculés (Computed Fields), vous pouvez configurer la facette afin de calculer et d'afficher une ou plusieurs valeurs numériques pour chaque élément de facette (voir Facettes calculées):

Note : Pour utiliser cette fonctionnalité, il vous faut une licence Coveo qui permet les facettes calculées.
1. Pour chaque valeur calculée, cliquez sur Nouveau (Add New) à côté de Champs calculés.
2. Dans la liste déroulante Champ, sélectionnez le champ dont vous souhaitez utiliser les valeurs en tant que source pour le calcul.
3. Dans la liste déroulante Opération (Operation), sélectionnez l'opération mathématique à effectuer sur les valeurs de champ (Somme (Sum), Moyenne, Minimum, ou Maximum).
4. Dans la liste d'affichage Position d'affichage du résultat, sélectionnez l'endroit où la valeur calculée apparaîtra par rapport avec l'élément de facette (À côté du libellé ou Sous le libellé).
5. Dans les champs Préfixe au résultat et Suffixe au résultat, tapez, respectivement et si nécessaire, le préfixe et le suffixe souhaités qui apparaîtront avant et après les valeurs calculées.
  
  Pour une interface de recherche en plusieurs langues, cliquez sur à côté du champ afin d'ouvrir la boîte de dialogue où vous pouvez taper le préfixe ou le suffixe traduit pour chaque langue prise en charge.
6. Dans la liste déroulante Format, sélectionnez le format numérique dans lequel la valeur calculée apparaîtra dans la facette (Monétaire, Entier, Numérique, Pourcentage, ou Personnalisé). Si vous sélectionnez Personnalisé, apparaîtra alors un autre champ dans lequel vous pouvez taper la chaîne de format numérique.NET désirée.
  
  Note : Référez-vous à la documentation MSDN Chaînes de format numérique régulières pour de plus amples détails sur la chaîne de format numérique.NET.
7. Si vous incluez plus d'une valeur calculée, cliquez sur Haut ou Bas sur la ligne correspondante afin de déterminer dans quel ordre les valeurs calculées apparaîtront.
8. Cliquez sur Supprimer sur la ligne correspondante si vous souhaitez éliminer une valeur calculée.
  
  Exemple : Vous pouvez créer une facette Taille moyenne du document dans laquelle vous pouvez voir la taille moyenne de fichier et le nombre moyen de pages pour chaque type de document. S'il est impossible de calculer une valeur, telle que le nombre moyen de pages pour des documents HTML, rien n’apparaît.
Cliquez sur OK pour compléter la création de la facette personnalisée.
De retour dans la page Facettes, la nouvelle facette apparaît à la fin de la liste Facettes et résultats reliés où vous pouvez :
1. Cliquer sur Haut ou Bas pour déterminer la position de la facette par rapport à d'autres facettes, pour chaque zone dans l'interface de recherche.
2. Si vous souhaitez retirer une facette, sélectionnez-la et cliquez sur Supprimer.
Avec un navigateur, ouvrez ou téléchargez à nouveau l'interface de recherche afin de vérifier que la facette se comporte comme vous le souhaitez.

Obtenez des réponses à vos questions sur answers.coveo.com.

Communauté

Doc produitsMenu

Ajout ou personnalisation d'une facette