Doc produitsMenu

Plateforme Coveo 7.0 >
Aide à l'administrateur > Outils Coveo > Éditeur d'interface > Onglet Interface de recherche > Menu Fonctionnalités > Configuration de suggestions de requête pour des résultats limités

Configuration de suggestions de requête pour des résultats limités

Coveo .NET Front-End 12.0.404+ (octobre 2013)

Les interfaces de recherche régulières de Coveo .NET Front-End contiennent des suggestions de requêtes lorsqu'une requête ne retourne aucun résultat ou quelques résultats. Les suggestions de requête peuvent être de différents types (voir À propos des suggestions de requête pour des résultats limités). Une suggestion de requête indique le type, le nombre de résultats, et, facultativement, des extraits de résultats.

La proposition de suggestion de requête
Le nombre de résultats retournés
Extraits facultatifs de résultats

Note : La fonction est disponible et activée par défaut dans la plupart des interfaces de recherche régulières, mais pas dans les interfaces de recherche mobiles.

Modèles de skin pour les suggestions de requête

La suggestion de requête est définie dans des fichiers ASCX, dans les dossiers de skin respectifs. L'emplacement et le contenu du modèle de skin pour la suggestion de requête varient selon le type de skin.

Skin normal

Le modèle de suggestion de requête pour tous les skins d'interface de recherche du bureau se trouve dans le fichier ResultsPanel.ascx, après la section <ces:NoResultsAdvices>.

<%-- Query suggestions are displayed when there are few or no results --%>
<ces:QuerySuggestions id="sug" CssClass="CesQuerySuggestions" DisplaySampleResults="True" runat="server">
  <SuggestionTemplate>
    <div class="CesQuerySuggestion">
      <ces:QuerySuggestionLink runat="server" />
      <ces:QuerySuggestionSampleResults runat="server">
        <SampleResultTemplate>
          <ces:DefaultResultTemplate TemplatePath="SuggestionSampleResult.ascx" runat="server"/>
        </SampleResultTemplate>
      </ces:QuerySuggestionSampleResults>
    </div>
  </SuggestionTemplate>
</ces:QuerySuggestions>

Skin Outlook

Le modèle de suggestion de requête pour le skin Outlook se trouve dans le fichier CoveoSearch.ascx, dans la section <ces:IfNoResults>. Dans ce skin, les suggestions de requête ne sont affichées que si aucun résultat n'est retourné. Les extraits de résultats sont désactivés par défaut dans les skins Outlook.

<%-- Query summary (only if no results) --%>
<ces:IfNoResults runat="server">
  <ces:QuerySummary id="$Prefix$qsm" CssClass="CesQuerySummary" runat="server" />
  <ces:NoResultsAdvices CssClass="CesNoResultsAdvices" style="margin-top: 10px;" runat="server" />
  <ces:QuerySuggestions DisplaySampleResults="False" SortAscending="True" runat="server">
    <SuggestionTemplate>
      <div>
        <ces:QuerySuggestionLink runat="server" />
      </div>
    </SuggestionTemplate>
  </ces:QuerySuggestions>
</ces:IfNoResults>

Skin de console

Le modèle de suggestion de requête pour le skin de console, utilisée dans les interfaces de recherche de la Console des comptes clients et de la Console de cas, se trouve dans le fichier MasterSection.ascx, après la section <ces:NoResultsAdvices>.

<%-- Query summary (only if no results) --%>
<ces:IfNoResults runat="server">
  <ces:QuerySummary id="$Prefix$qsm" CssClass="CesQuerySummary" runat="server" />
  <ces:NoResultsAdvices CssClass="CesNoResultsAdvices" style="margin-top: 10px;" runat="server" />
  <ces:QuerySuggestions DisplaySampleResults="False" SortAscending="True" runat="server">
    <SuggestionTemplate>
      <div>
        <ces:QuerySuggestionLink runat="server" />
      </div>
    </SuggestionTemplate>
  </ces:QuerySuggestions>
</ces:IfNoResults>

Skin mobile

Les suggestions de requête ne sont pas disponibles dans les modèles de skin mobile.

Personnalisation des suggestions de requête

En tant qu'administrateur, vous pouvez personnaliser certains aspects de la fonction de suggestion de requête en modifiant les modèles de skin.

Pour personnaliser les suggestions de requête

  1. À l'aide d'un compte d'administrateur, connectez-vous à votre serveur d'interface Coveo.

  2. Naviguez vers le dossier de skin de l'interface de recherche que vous souhaitez modifier ([[.Net_Front-End_Path]\Web\Coveo\Skins\[search_interface]).

  3. À l'aide d'un éditeur de texte :

    1. Ouvrez le fichier ASCX contenant le modèle de suggestion de requête (voir Modèles de skin pour les suggestions de requête).

    2. Modifiez le fichier pour effectuer une ou plusieurs des personnalisations possibles suivantes.

      • Changer le nombre maximal de résultats retournés qui déclenchent les suggestions de requête :

        Dans la balise <ces:QuerySuggestion>, ajoutez l'attribut FewResults="n" afin de définir le nombre de résultats retournés sous ou égal à n, pour lequel la fonctionnalité de suggestion de requête recherche des requêtes alternatives. La valeur par défaut est 5 lorsque non spécifiée.

      • Afficher les extraits de résultats ou non

        Dans la balise <ces:QuerySuggestion>, ajoutez l'attribut DisplaySampleResults="true" afin que les extraits de résultats apparaissent. La valeur par défaut est false lorsque non spécifiée. Le nombre maximal d'extraits de résultats est également personnalisable.

        Exemple :

        Partie principale de la suggestion, présentant la requête alternative et indiquant le nombre de résultats retournés (toujours présent)
        Deux extraits de résultats pour cette suggestion de requête (facultatif)
      • Changer le nombre d'extraits de résultats à afficher par suggestion de requête

        Dans la balise <ces:QuerySuggestion>, ajoutez l'attribut NumberOfSampleResults="n" afin de définir le nombre de résultats à afficher. La valeur par défaut est 2 lorsque non spécifiée.

      • Changer le nombre maximal de suggestions de requête à essayer

        Dans la balise <ces:QuerySuggestion>, ajoutez l'attribut QueryLimit="n" afin de définir le nombre maximal de requêtes alternatives essayées par la fonctionnalité de suggestion de requête. La valeur par défaut est 5 lorsque non spécifiée. Évitez un grand nombre afin d'empêcher une inondation de l'index.

      • Changer le mode de tri des requêtes suggérées

        Lorsque plus d'une requête est suggérée, les suggestions sont triées selon le nombre de résultats qu'elles retournent. Dans la balise <ces:QuerySuggestion>, ajoutez l'attribut SortAscending="True" pour trier à partir des suggestions qui retournent le plus petit nombre de résultats. La valeur par défaut est False lorsque non spécifiée.

    3. Enregistrez le fichier.

  4. Vous pouvez également personnaliser ce qui est affiché pour chaque résultat. À l'aide d'un éditeur de texte :

    1. Ouvrez le fichier de modèle SuggestionSampleResult.ascx.

    2. Modifiez le fichier afin de modifier, ajouter ou retirer des éléments.

      Exemple : Pour modifier l'élément <ces:ResultExcerpt.. />, veuillez vous référer au document de référence API pour rechercher et voir les attributs disponibles (voir ResultExcerpt Class Properties).

    3. Enregistrez le fichier.

  5. À l'aide d'un navigateur, accédez à l'interface de recherche modifiée et effectuez des requêtes pour valider que les modifications ont lieu tel que prévu.