Doc produitsMenu

Paramètres de chaîne de requête

L'URL d'une interface de recherche Coveo peut inclure un ou plusieurs paramètres de chaîne de requête. Vous pouvez utiliser ces paramètres afin d'effectuer des requêtes plus spécifiques.

Exemple : L'URL de recherche Coveo suivante recherche les mots clés approval et workflow dans la collection d'index intitulée cms.

http://MyCoveoSearch/[default.aspx]?q=approval%20workflow&c=cms

Spécifier manuellement les paramètres de chaîne de requête peut s'avérer utile pour les administrateurs et les développeurs pendant le réglage des problèmes de la Plateforme Coveo.

Syntaxe de chaîne de requête

La syntaxe de chaîne de requête peut inclure une ou plusieurs paires paramètre-valeur comme celles-ci :

http://CoveoSearch:[port]/?param1=value&param2=value

où :

  • [port]

Est, par défaut, 8080. Peut être omis si c'est 80.
  • [default.aspx]

Nom de fichier ASPX facultatif
  • ?

Marque le début de la chaîne de requête.
  • param[n]

Nom d'un paramètre de chaîne de requête.
  • =

Opérateur qui sépare le paramètre de chaîne de requête et sa valeur.
  • Valeur

Valeur du paramètre.
Si une valeur contient plusieurs termes séparés par des espaces, remplacez ces espaces par %20.
  • &

Opérateur qui sépare deux paires paramètre-valeur.

Paramètres génériques de chaîne de requête

Le tableau suivant présente, en ordre alphabétique, les paramètres de chaîne de requête qui sont disponibles.

Paramètre Description Valeurs possibles
c Collection à laquelle vous souhaitez réduire la recherche. Un ou plusieurs noms de collections, séparés par des virgules.
ci Collection à laquelle vous souhaitez réduire la recherche. Un ou plusieurs identifiants de collections, séparés par des virgules
debug Présente des informations de débogage (voir Obtention des informations de débogage d'une interface de recherche). 1
disableanalyticslogging Désactive la journalisation du module Analytiques 1
ea Adresse de messagerie à utiliser dans l'interface de recherche de courriels. Adresse de messagerie
exds Exporte les résultats de la requête vers une source de données XML pour Microsoft Excel. 1
f Identifie le cadre HTML cible. Nom de cadre HTML
lcid Définit la langue de l'interface de recherche. 7 (Allemand), 9 (Anglais), 10 (Espagnol), 12 (Français) , 19 (Néerlandais), 22 (Portugais)
mode Ouvre un panneau de recherche spécifique. Normal, AdvancedSearch, Preferences, DesktopSearch
Valeur par défaut : Normal
opensearch Récupère le document de description d'OpenSearch. 1
opensearchsuggest Récupère des suggestions de requêtes avec OpenSearch Chaîne d'un ou de plusieurs termes
q Termes spécifiés par la requête. Chaîne d'un ou de plusieurs termes
rdb Lisibilité améliorée true|false
sc Définit la portée de recherche (pour l'interface de recherche SharePoint seulement). AllSharePoint, CurrentSharePointTopLevelSite, CurrentSharePointSite, CurrentSharePointList, AllResults
sg Valeur GUID (Identifiant global unique) de l'action entreprise dans Analytiques Chaîne GUID
sh Définit le hub de recherche. Nom du hub
sk Interface de recherche utilisée afin d'afficher les résultats. Nom de l'interface
sortd Définit l'ordre de tri : descendant Booléen true, false]
Par défaut : false
sortf Définit le champ de tri. Nom de champ avec @ comme préfixe (le champ doit être Trier par (voir Ajout d'un champ de tri))
tz

Définit l'identifiant du fuseau horaire.

Note : À partir de CES 7.0.7022 (septembre 2014), l’index gère l’heure avancée.

voir TZID dans Zone TZID
wakeup Relance l'interface de recherche 1
wld Active la recherche par caractères de remplacement. true|false

Une valeur de paramètre de 1 signifie que le paramètre agit tel un levier, sa fonction étant activée indépendamment de sa valeur.

Paramètres de chaîne de requête pour la recherche avancée

Le tableau suivant présente les paramètres de chaîne de requête qui sont utilisés afin de réduire les résultats de recherche en tenant compte de la page Recherche avancée (voir Utilisation de la page de recherche avancée).

Paramètre Description Valeurs possibles
addl Résultats modifiés dans les n derniers jours ou mois (spécifié par addu). Le nombre de jours ou de mois
addu Unité de temps pour addl La valeur par défaut, si elle n'est pas spécifiée, est jours.
m (mois)
addmin Résultats modifiés à partir de la date de début. aaaa/mm/jj
addmax Résultats modifiés jusqu'à la date de fin. aaaa/mm/jj
adf Résultats pour les formats de fichier donnés doc, txt, pdf, xls, ppt, html, zip..
(voir Formats de fichiers pris en charge)
ads Résultats de la taille de fichier avec un opérateur spécifié par adsr Taille en octets
adsr Opérateur pour le paramètre ads AtLeast, AtMost
Par défaut : AtLeast
adl Langue des résultats English (Anglais), French (Français), Spanish (Espagnol), German (Allemand), Dutch (Néerlandais), Portuguese (Portugais)
(voir Langues prises en charge)
adadd Adresse du résultat de recherche Chaîne d'adresse
adaddop Opérateur pour le paramètre adadd Contains, DoesNotContain, Matches
adit Titre du résultat de recherche Texte du titre
aditop Opérateur pour le paramètre adit Contains, DoesNotContain, Matches
adaut Auteur du résultat de recherche Nom de l'auteur
adautop Opérateur pour le paramètre adaut Contains, DoesNotContain, Matches

Exemple : L'URL suivante contient plusieurs paramètres de chaîne de requête pour la recherche avancée :

http://MyCoveoSearch/q=test&ads=1000&adadd=coveo
&adaddop=Contains&adl=English&addmin=2013/01/01
&addmax=2013/03/30&sortf=@sysdate&@sortd=true

Paramètres de chaîne de requête pour les développeurs

Les paramètres suivants de chaîne de requête ne sont utiles, en général, que pour les développeurs.

Paramètre Description Valeurs possibles
CoveoForceOutlookAddin Affiche l'interface de recherche comme la barre latérale Outlook. 1
CoveoForceMobile Force le navigateur à être détecté comme appareil mobile. 1
CoveoForceWindowsMobile Force le navigateur à être détecté en tant que mobile de Windows. 1
CoveoForceBlackBerry Force le navigateur à être détecté en tant que BlackBerry. 1
CoveoForceIPhone Force le navigateur à être détecté en tant qu'iPhone. 1
CoveoForceIPad Force le navigateur à être détecté en tant qu'iPad. 1
CoveoForceAdvancedMobile Force le navigateur à être détecté en tant que mobile avancé. 1

Une valeur de paramètre de 1 signifie que le paramètre agit tel un levier, sa fonction étant activée indépendamment de sa valeur.