Show Menu
SUJETS×

Paramètres CGI

Paramètres CGI

Rechercher des paramètres CGI

Le code du formulaire de recherche est fourni que vous pouvez copier et coller dans le code HTML de votre site ( Design > Auto-Complete > Form Source ).
Vous pouvez également définir les paramètres répertoriés dans le formulaire de recherche lui-même ou à partir d’un script. Outre les paramètres répertoriés ci-dessous, vous pouvez également utiliser les paramètres de recherche principale pour contrôler la recherche.
Voir Paramètres CGI de recherche principal.
Les requêtes de recherche se composent d’une URL de base. L’URL de base indique le compte que le client recherche et un ensemble de paramètres CGI (paires clé-valeur) qui indiquent comment renvoyer les résultats de recherche souhaités pour le compte associé.
L’URL de base est associée à un compte spécifique et à un environnement intermédiaire ou dynamique. Vous pouvez demander plusieurs alias pour l’URL de base à votre gestionnaire de compte. Par exemple, une société appelée Megacorp peut avoir deux URL de base associées à son compte : https://search.megacorp.com et https://stage.megacorp.com . La première URL effectue une recherche dans son index dynamique et la seconde dans son index intermédiaire.
Trois formats de paramètres CGI sont pris en charge. Par défaut, votre compte est configuré pour séparer les paramètres CGI par un point-virgule, comme dans l’exemple suivant :
https://search.megacorp.com?q=shoes;page=2
Si vous le préférez, votre gestionnaire de compte peut configurer votre compte pour qu’il utilise des esperluettes afin de séparer les paramètres CGI, comme dans l’exemple suivant :
https://search.megacorp.com?q=shoes&page=2
Un troisième format, appelé format SEO, est également pris en charge lorsqu’une barre oblique / est utilisée à la place du séparateur et du signe égal, comme dans l’exemple suivant :
https://search.megacorp.com/q/shoes/page/2
Chaque fois que le format d’optimisation du référencement est utilisé pour envoyer une requête, tous les liens de sortie sont renvoyés au même format.
Paramètre de recherche guidée
Exemple
Description
q
q=string
Spécifie la chaîne de requête pour la recherche. Ce paramètre correspond au paramètre de recherche principal sp_q . Voir Paramètres CGI de recherche principal.
q#
q#=string
La facette (recherche dans un champ donné) est effectuée au moyen des paramètres q et x numérotés. Le paramètre q définit le terme que vous recherchez dans la facette, comme indiqué par le paramètre x numéroté correspondant.
Si, par exemple, vous disposez de deux facettes nommées taille et couleur, vous pouvez avoir un élément du type q1=petite;x1=taille;q2=rouge;x2=couleur. Ce paramètre correspond aux paramètres de recherche sp_q_exact_# principal.
Voir Paramètres CGI de recherche principal.
x#
q#=string
La facette (recherche dans un champ donné) est effectuée au moyen des paramètres q et x numérotés. Le paramètre q définit le terme que vous recherchez dans la facette, comme indiqué par le paramètre x numéroté correspondant.
Par exemple, si vous avez deux facettes appelées taille et couleur, vous pouvez avoir un élément du type q1=petit;x1=taille;q2=rouge;x2=couleur. Ce paramètre correspond aux paramètres de recherche sp_x_# principal.
Voir Paramètres CGI de recherche principal.
collecte
collection=string
Indique la collection à utiliser pour la recherche. Ce paramètre correspond au paramètre de recherche principal sp_k . Voir Paramètres CGI de recherche principal.
count
count=number
Indique le nombre total de résultats affichés. La valeur par défaut est définie dans Settings > Searching > Searches. . Ce paramètre correspond au paramètre de recherche principal sp_c . Voir Paramètres CGI de recherche principal.
page
page=number
Indique la page des résultats qui sont renvoyés.
grade
rank=field
Indique le champ de classement à utiliser pour le classement statique. Le champ doit être un champ de type Classement avec une pertinence supérieure à 0. Ce paramètre correspond au paramètre sp_sr principal. Voir Paramètres CGI de recherche principal.
sort
sort=number
Indique l’ordre de tri.
"0" est la valeur par défaut et trie par score de pertinence ; "1" est classé par date ; "-1" n’est pas trié. Les utilisateurs peuvent spécifier un nom de champ pour la valeur du sp_s paramètre. Par exemple, sp_s=title trie les résultats selon les valeurs contenues dans le champ de titre. Lorsqu’un nom de champ est utilisé pour la valeur d’un sp_s paramètre, les résultats sont triés par ce champ, puis subtriés par pertinence. To enable this feature, click Settings > Metadata > Definitions. Dans la page Définitions, cliquez sur Add New Field ou sur Edit un nom de champ particulier. Dans la liste Sorting déroulante, sélectionnez Ascending ou Descending. Ce paramètre correspond au paramètre de recherche principal sp_s .
Voir Paramètres #principal.(../c-appendices/c-cgiparameters.md#reference_582E85C3886740C98FE88CA9DF7918E8).

Paramètres CGI de recherche principale

En règle générale, les clients interagissent avec une couche de présentation appelée Recherche guidée. Cependant, il est théoriquement possible de sauter le calque de recherche guidée et d’interagir avec la recherche principale principale en utilisant directement les paramètres CGI décrits sur cette page.
Vous pouvez sélectionner les paramètres CGI de recherche principale dans le tableau suivant :
Prise en charge d’une seule requête
Prise en charge de plusieurs requêtes
Exemples
Description
1
sp_a
sp_a= chaîne
Indique la chaîne du numéro de compte. Ce paramètre est obligatoire et doit être une chaîne de numéro de compte valide. Vous pouvez trouver la chaîne de votre numéro de compte sous Paramètres > Options de compte > Paramètres du compte .
2
sp_advanced
sp_advanced= 0 ou 1
Si sp_advanced=1 est envoyé avec une requête, tout le code entre la balise <search-if-advanced> et la balise </search-if-advanced> dans le modèle de recherche est utilisé pour le formulaire de recherche. Tout le code entre la balise <search-if-not-advanced> et la balise </search-if-not-advanced> est ignoré. Si sp_advanced=0 (ou toute autre valeur) est envoyé, le bloc de modèle <search-if-advanced> est ignoré et le bloc de modèle <search-if-not-advanced> est utilisé.
3
sp_c
sp_c= nombre
Indique le nombre total de résultats à afficher. La valeur par défaut est de 10.
4
sp_context_field
sp_context_field= field
Collecte des informations contextuelles pour le champ donné. Les informations collectées sont générées dans les résultats de la recherche par le biais de la balise de modèle <search-context> . La valeur par défaut est body .
5
sp_d
sp_d= type
Indique le type de plage de dates à effectuer. Les valeurs possibles pour le type sont toutes les valeurs, ce qui signifie qu’il n’est pas possible d’effectuer une recherche de plage de dates, personnalisées, ce qui indique que la valeur de sp_date_range doit être utilisée pour déterminer les dates à rechercher et spécifique, ce qui indique que les valeurs dans sp_start_day , sp_start_month , sp_start_year , sp_end_day_month, et sp_end_month_year_year_year_year_year_year_year_year_year_year_year_year_year_year_year_year_year_year_year_year_year_year_est utilisé. pour déterminer la plage de dates à rechercher. sp_d n'est requis que si votre formulaire de recherche contient l'option de recherche soit par une plage personnalisée (par sp_date_range ), soit par une plage de dates de début et de fin spécifique.
6
sp_d_#
sp_d_#= type
Indique le type de plage de dates à effectuer pour la requête sp_q_# correspondante. Le "#" est remplacé par un nombre compris entre 1 et 16 (par exemple, sp_d_8 , s’applique à la requête numérotée sp_q_8 ).
Vous pouvez définir le type sur n’importe quelle valeur, ce qui signifie qu’il ne faut pas effectuer de recherche de plage de dates, personnalisé, ce qui indique que la valeur de sp_date_range_# est utilisée pour déterminer les dates à rechercher et spécifique, ce qui indique que les valeurs dans sp_q_min_day_# , sp_q_min_month_# , sp_q_min_year_#_# les sp_q_max_month_# et sp_q_max_year_# doivent être utilisés pour déterminer la plage de dates. L'utilisation de sp_d_# n'est requise que si votre formulaire de recherche contient l'option de recherche soit par une plage personnalisée (au moyen de sp_date_range_# ), soit par une plage de dates de début et de fin spécifique.
7
sp_date_range
sp_date_range= number
Spécifie une plage de dates prédéfinie à appliquer à la recherche. Les valeurs supérieures ou égales à zéro indiquent le nombre de jours avant la date d'aujourd'hui — par exemple, la valeur "0" indique "aujourd’hui", la valeur "1" indique "aujourd’hui et hier", la valeur "30" indique "au cours des 30 derniers jours", etc.
Les valeurs inférieures à zéro définissent une plage personnalisée comme suit :
-1 = "Aucun", la même chose que de ne spécifier aucune plage de dates.
-2 = "Cette semaine", qui effectue une recherche du dimanche au samedi de la semaine en cours.
-3 = "Semaine dernière", qui effectue une recherche du dimanche au samedi de la semaine précédant la semaine en cours.
-4 = "Ce mois-ci", qui recherche les dates du mois en cours.
-5 = "Mois dernier", qui recherche les dates du mois précédant le mois en cours.
-6 = "Cette année", qui recherche les dates de l’année en cours.
-7 = "L’année dernière", qui recherche les dates dans l’année précédant l’année en cours.
8
sp_date_range_#
sp_date_range_#= number
Spécifie une plage de dates prédéfinie à appliquer à la requête sp_q_# correspondante. Le "#" est remplacé par un nombre compris entre 1 et 16 (par exemple, sp_date_range_8 , s’applique à la requête numérotée sp_q_8 ).
Les valeurs supérieures ou égales à zéro indiquent le nombre de jours avant la date d’aujourd’hui. Par exemple, une valeur de 0 indique aujourd’hui ; une valeur de 1 indique aujourd’hui et hier; une valeur de 30 est définie dans les 30 derniers jours, etc.
Les valeurs inférieures à zéro définissent une plage personnalisée comme suit :
-1 = "Aucun", la même chose que de ne spécifier aucune plage de dates.
-2 = "Cette semaine", qui effectue une recherche du dimanche au samedi de la semaine en cours.
-3 = "Semaine dernière", qui effectue une recherche du dimanche au samedi de la semaine précédant la semaine en cours.
-4 = "Ce mois-ci", qui recherche les dates du mois en cours.
-5 = "Mois dernier", qui recherche les dates du mois précédant le mois en cours.
-6 = "Cette année", qui recherche les dates de l’année en cours.
-7 = "L’année dernière", qui recherche les dates dans l’année précédant l’année en cours.
9
sp_dedupe_field
sp_dedupe_field= fieldname
Spécifie un champ unique sur lequel dédupliquer les résultats de la recherche. Tous les résultats en double de ce champ sont supprimés des résultats de la recherche. Si, par exemple, pour sp_dedupe_field=title , seul le résultat supérieur d’un titre donné s’affiche dans les résultats de la recherche (aucun des deux résultats n’a le même contenu de champ de titre). Pour les champs de type à plusieurs valeurs (liste autorisée), le contenu entier du champ est utilisé pour la comparaison. Un seul champ peut être spécifié. Un "qualificateur de table" n’est pas autorisé dans le nom du champ.
10
sp_e
sp_e= nombre
Indique que l’extension automatique du caractère générique doit avoir lieu pour tout mot de la chaîne de requête contenant plus de caractères numériques. En d’autres termes, sp_e=5 spécifie que les mots comportant 5 caractères ou plus, tels que "query" ou "number", doivent être développés avec le caractère générique "*", ce qui rend la recherche équivalente à une recherche de "query*" ou "number*". Les mots comportant moins de caractères ne sont pas développés, de sorte qu’une recherche de "mot" n’aurait pas d’extension automatique des caractères génériques.
11
sp_e_#
sp_e_#= nombre
Indique que l’extension automatique du caractère générique a lieu pour n’importe quel mot de la chaîne de requête sp_q_# correspondante avec plus de caractères numériques. En d'autres termes, sp_e_2=5 spécifie que les mots comportant cinq caractères ou plus dans la chaîne de requête sp_q_2 , tels que "query" ou "number", doivent être développés avec le caractère générique " * ", ce qui rend la recherche équivalente à une recherche de "query*" ou "number*". Les mots comportant moins de caractères ne sont pas développés, de sorte qu’une recherche de "mot" dans sp_q_2 n’aurait pas d’extension automatique de caractères génériques.
12
sp_end_day, sp_end_month, sp_end_year
sp_end_day= number ,sp_end_month= number , sp_end_year= number
Ce triplet de valeurs spécifie la plage de dates de fin de la recherche et doit être fourni sous forme de jeu.
13
sp_f
sp_f= chaîne
Spécifie le jeu de caractères des chaînes de paramètres de requête (par exemple sp_q ). Cette chaîne doit toujours correspondre au jeu de caractères de la page qui contient le formulaire de recherche.
14
sp_field_table
sp_field_ table=table: field,field...
Définit un tableau de données logique composé des champs donnés. Par exemple, un tableau nommé "articles" composé des champs "couleur", "taille" et "prix" serait défini comme suit :
sp_field_table=éléments:couleur,taille,prix
Les tableaux logiques sont particulièrement utiles en conjonction avec les champs pour lesquels l’option "Autoriser les listes" est cochée (sous Paramètres > Métadonnées > Définitions ). Tous les paramètres CGI et balises de modèle prenant un nom de champ comme valeur peuvent éventuellement spécifier un nom de table suivi d’un "". avant le nom du champ (par exemple, sp_x_1=tablename.fieldname ).
Par exemple, pour rechercher des documents contenant un ou plusieurs éléments "rouges" de taille "grande" (où les éléments sont représentés sous forme de lignes parallèles de métadonnées), vous pouvez utiliser les éléments suivants :
sp_q_exact_1=red&sp_x_1=items.color& sp_q_exact_2=large&sp_x_2=items.size&sp_field_table=items:color,size,price
15
sp_i
sp_i= valeur
Ignore la recherche lorsque vous générez des rapports.
Utilisez cette requête pour masquer certaines recherches en arrière-plan, telles que les recherches générées par le service Voulez-vous dire ou les recherches générées par un administrateur dans le centre des membres. Un utilisateur final ne générant pas ces types de recherches, il n’apparaît pas dans divers rapports Adobe Search&Promote.
Les valeurs valides sont sp_i=1 et sp_i=2 .
16
sp_k
sp_k= chaîne
Indique la collection à utiliser pour la recherche. La valeur par défaut n’est pas une collection, ce qui signifie que la recherche doit inclure l’ensemble du site.
17
sp_l
sp_l= chaîne
Indique la langue des chaînes de paramètres de requête (par exemple sp_q ). La chaîne doit être un ID de paramètre régional standard contenant un code de langue ISO-639 suivi éventuellement d’un code de pays ISO-3166. Par exemple, "en" ou "en_US" pour l’anglais ou "ja" ou "ja_JP" pour le japonais.
18
sp_literal
sp_literal= 0 ou 1
La définition de sp_literal=1 désactive temporairement toutes les fonctionnalités susceptibles d’interpréter les mots de la requête. Avec ce paramètre, seuls les mots littéraux de la requête correspondent aux documents, quels que soient les synonymes, les formulaires de remplacement de mots et les correspondances sonores.
Notez que sp_literal=0 n’a aucune signification et est ignoré s’il est utilisé.
19
sp_m
sp_m= nombre
Indique si les résumés sont affichés. 1 est oui, 0 est non. La valeur par défaut est de 1.
20
sp_n
sp_n= nombre
Indique le nombre de résultats qui commencent les résultats de la recherche. La valeur par défaut est de 1.
21
sp_not_found_page
sp_not_found_page= url
Indique s’il convient de rediriger vers l’URL spécifiée en l’absence de résultats de recherche.
22
sp_p
sp_p= any/all/phrase
Indique le type de recherche par défaut à effectuer. L’utilisation de n’importe quel signifie rechercher des documents qui contiennent n’importe quel mot de la chaîne de requête. L’utilisation de tous signifie rechercher des documents qui contiennent tous les mots de la chaîne de requête. L’utilisation de phrase signifie que la chaîne de requête est traitée comme s’il s’agissait d’une phrase entre guillemets et que tous les guillemets tapés par l’utilisateur sont ignorés.
Pour l’ expression et tous , la spécification de "+" et "-" avant les mots de recherche est désactivée et ces caractères sont ignorés. Si sp_p n'est pas présent, ou s'il est défini sur une chaîne vide ou une autre, les préfixes de mots "+" et "-" standard sont autorisés.
Voir la description des conseils de recherche pour plus d’informations sur l’utilisation de plus ("+") et moins ("-") dans les recherches.
Consultez l’exemple de formulaire de recherche avancée pour obtenir des exemples d’utilisation du paramètre sp_p .
23
sp_p_#
sp_p_#= tout/phrase
Spécifie le type de recherche par défaut à effectuer avec la requête sp_q_# correspondante. Le "#" est remplacé par un nombre compris entre 1 et 16 (par exemple, sp_p_8 s’applique à la requête numérotée sp_q_8 ). L’utilisation de n’importe quel signifie renvoyer des documents qui contiennent n’importe quel mot de la chaîne de requête. L’utilisation de tous signifie renvoyer des documents qui contiennent tous les mots de la chaîne de requête. L’utilisation d’une expression signifie que la chaîne de requête est traitée comme une expression complète (et tous les guillemets tapés par l’utilisateur sont ignorés).
Si vous spécifiez tout ou phrase , tous les signes plus et moins avant les mots de recherche sont ignorés. Si sp_p_# est omis, ou s'il est défini sur une chaîne vide ou une autre , les préfixes "+" et "-" standard sont autorisés.
24
sp_pt
sp_pt= exact/equivalent/compatible
Indique le type de correspondance cible à appliquer. L’utilisation de signifie que la cible ne renvoie des correspondances cibles que dans les documents qui correspondent exactement à la chaîne de requête dans le contenu cible. L'utilisation de l' équivalent est exacte, sauf que l'ordre des mots n'est pas important. L’utilisation de compatible définit automatiquement le type de correspondance cible en fonction de la valeur du paramètre sp_p . L'utilisation d' exacte est utilisée si sp_p est tout ou phrase , sinon équivalent est utilisé. La valeur par défaut de sp_pt est compatible .
25
sp_pt_#
sp_pt_#= exact/equivalent/compatible
Spécifie le type de correspondance cible à appliquer avec la requête sp_q_# correspondante. Le "#" est remplacé par un nombre compris entre 1 et 16 (par exemple, sp_p_8 s’applique à la requête numérotée sp_q_8 ). L’utilisation de signifie que la cible ne renvoie des correspondances cibles que dans les documents qui correspondent exactement à la chaîne de requête dans le contenu cible. L'utilisation de l' équivalent est comme exact , sauf que l'ordre des mots n'est pas important. L’utilisation de compatible définit automatiquement le type de correspondance cible en fonction de la valeur du paramètre sp_p_# correspondant : exact est utilisé si sp_p_# est tout ou phrase, sinon l'équivalent est utilisé. La valeur par défaut de sp_pt_# est compatible .
26
sp_q
sp_q= chaîne
Spécifie la chaîne de requête pour la recherche. Une chaîne vide ne donne aucun résultat.
27
sp_q_#
sp_q_#= texte
Ce paramètre permet de créer plusieurs requêtes sur des formulaires de recherche. Le paramètre sp_q_# contient la chaîne de requête à utiliser dans la requête numérotée donnée. Une requête de recherche peut faire référence à 16 requêtes numérotées différentes ( sp_q_1 à sp_q_16 ).
Par exemple, l’envoi du formulaire suivant renvoie tous les documents qui contiennent les mots "super" et "livres".
Search for: <input type="text" name="sp_q" value="great"> Search for: <input type="text" name="sp_q_1" value="books">
28
sp_q_day, sp_q_month, sp_q_year
sp_q_day_#, sp_q_month_#, sp_q_year_#
sp_q_day= valeur entière
sp_q_month= valeur entière
sp_q_year= valeur entière
sp_q_day_#= valeur entière
sp_q_month_#= valeur entière
sp_q_year_#= valeur entière
Ces paramètres permettent de spécifier la date exacte d’une requête particulière. Les paramètres sp_q_day , sp_q_month et sp_q_year s'appliquent à la requête principale ( sp_q ).
Le # paramètre est remplacé par un nombre compris entre 1 et 16 (par exemple, sp_q_day_6 , qui s’applique à la requête numérotée sp_q_6 ). Par défaut, toutes les dates sont recherchées par rapport à l’heure Greenwich.
La section suivante du code permet à l’utilisateur de rechercher le mot "orange" dans les documents datés du "janvier". 1st, 2000" dans un champ défini par l’utilisateur et nommé Date de publication :
<input type="hidden" name="sp_x_1" value="PublishDate"> Search for: <input type="text" name="sp_q" value="orange">On : <input type="text" name="sp_q_day_1" size="2" value="1"> Day<input type="text" name="sp_q_month_1" size="2" value="1"> Month <input type="text" name="sp_q_year_1" size="4" value="2000"> Year 
29
sp_q_location
sp_q_location_#
sp_q_location= latitude/longitude OR areacode OR zipcode
sp_q_location_#= latitude/longitude OR areacode OR zipcode
Ces paramètres associent un emplacement à la requête principale ou numérotée. L'utilisation de sp_q_location affecte la requête principale, sp_q_location_# (où le # est remplacé par un nombre compris entre 1 et 16), affecte la requête numérotée donnée. Ces paramètres sont utilisés pour effectuer des recherches de proximité à distance minimale et/ou maximale par rapport aux données d’emplacement indexées pour chaque page du site. Le format de la valeur détermine son interprétation.
Une valeur sous la forme DDD (trois chiffres) est interprétée comme un code d’aracode téléphonique américain ; une valeur sous la forme DDJJ ou DJJJJ-DJJ est interprétée comme un code postal américain; et une valeur sous la forme ±DD.DDDD±DDD.DDD est interprétée comme une paire latitude/longitude. Les signes sont obligatoires pour chaque valeur. Par exemple, +38.6317+120.5509 indique la latitude 38.6317, la longitude 120.5509.
30
sp_q_max_relevant_distance
sp_q_max_relevant_distance _#
sp_q_max_relevant_distance= value
sp_q_max_relevant_distance_#= value
Ces paramètres contrôlent le calcul de la pertinence appliqué aux recherches de proximité. L'utilisation de sp_q_max_relevant_distance affecte la requête principale, sp_q_max_relevant_distance_# (où le # est remplacé par un nombre compris entre 1 et 16), affecte la requête numérotée donnée.
La valeur par défaut de sp_q_max_relevant_distance est 100.
Un score de pertinence parfait pour la composante de proximité représenterait une distance de 0. Un score de pertinence minimum pour le composant de proximité représenterait une distance juste au-dessus de la valeur sp_q_max_relevant_distance_# spécifiée.
31
sp_q_min_day, sp_q_min_month, sp_q_min_year
sp_q_max_day, sp_q_max_month, sp_q_max_year
sp_q_min_day_#, sp_q_min_month_#, sp_q_min_year_#
sp_q_max_day_#, sp_q_max_month_#, sp_q_max_year_#
sp_q_min_day= integer value
sp_q_min_month= integer value
sp_q_min_year= integer value
sp_q_max_day= integer value
sp_q_max_month= integer value
sp_q_max_year= integer value
sp_q_min_day_#= integer value
sp_q_min_month_#= integer value
sp_q_min_year_#= integer value
sp_q_max_day_#= integer value
sp_q_max_month_#= integer value
sp_q_max_year_#= integer value
Ces paramètres permettent de définir des plages de dates minimales et maximales pour une requête particulière. Les paramètres sp_q_min_day , sp_q_min_month , sp_q_min_year , sp_q_max_day , sp_q_max_month etsp_q_max_years’appliquent à la requête principale ( sp_q_max).
Le # dans le nom du paramètre est remplacé par un nombre compris entre 1 et 16 (par exemple, sp_q_min_day_6 s’applique à la requête numérotée sp_q_6 ).
Il est légal de spécifier uniquement une date minimale, une date maximale ou à la fois une date minimale et une date maximale. Toutefois, pour un ensemble minimal ou maximal donné, les trois paramètres de date doivent être spécifiés (jour, mois et année). Par défaut, toutes les dates sont recherchées par rapport à l’heure Greenwich.
La section de code suivante permet à l’utilisateur de rechercher le mot "orange" dans les documents dont la date est comprise entre le 1er janvier 2000 et le 31 décembre 2000 dans un champ défini par l’utilisateur et appelé Date de publication :
<input type="hidden" name="sp_x_1" value="PublishDate">Search for: <input type="text" name="sp_q" value="orange">Between: <input type="text" name="sp_q_min_day_1" size="2" value="1"> Start Day<input type="text" name="sp_q_min_month_1" size="2" value="1"> Start Month <input type="text" name="sp_q_min_year_1" size="4" value="2000"> Start Year And: <input type="text" name="sp_q_max_day_1" size="2" value="31"> End Day <input type="text" name="sp_q_max_month_1" size="2" value="12"> End Month <input type="text" name="sp_q_max_year_1" size="4" value="2000"> End Year
32
sp_q_min, sp_q_max
sp_q _min_#, sp_q _max_#, sp_q _exact_#
sp_q_min= valeur
sp_q_max= valeur
sp_q_min_#= valeur
sp_q_max_#= valeur
sp_q_exact_#=value
Ces paramètres spécifient une valeur minimale (et/ou maximale) à appliquer à la requête principale ou numérotée. L'utilisation de sp_q_min , sp_q_max et sp_q_exact affecte la requête principale ( sp_q ).
Remplacez # dans le nom du paramètre par un nombre compris entre 1 et 16 (par exemple, sp_q_min_8 s'applique à la requête numérotée sp_q_8 ).
L’utilisation de sp_q_exact_# est abrégée pour spécifier à la fois sp_q_min_# et sp_q_max_# avec la même valeur. Si sp_q_exact_# est spécifié, les paramètres sp_q_min_# ou sp_q_max_# correspondants sont ignorés.
Les paramètres sp_q_min_# , sp_q_max_# et sp_q_exact_# peuvent éventuellement spécifier plusieurs valeurs séparées par "|". Par exemple, pour rechercher des documents contenant la valeur vert ou rouge dans le champ "color" : ...&sp_q_exact_1=green|red&sp_x_1=color .
33
sp_q_nocp
sp_q _nocp _#
sp_q_nocp= 1 ou 0
sp_q_nocp_#= 1 ou 0
La valeur par défaut du paramètre est 0 , ce qui signifie que les extensions Expression commune sont exécutées.
Lorsqu'il est défini sur 1 pour la requête de recherche correspondante, les extensions des expressions courantes ne sont pas exécutées.
L'utilisation de sp_q_nocp affecte le paramètre de requête de recherche principal sp_q . Pour appliquer ce paramètre à une requête de recherche numérotée, remplacez # dans le nom du paramètre par le numéro correspondant. Par exemple, sp_q_nocp_8 s'applique à la requête de recherche numérotée sp_q_8 .
34
sp_q_required
sp_q _required _#
sp_q_required= 1 ou 0 ou -1
sp_q_required_#= 1 ou 0 ou -1
Ce paramètre détermine si une correspondance doit (1), (0) ou non (-1) se produire dans la requête correspondante afin qu’un document soit renvoyé sur la page de résultats.
L'utilisation de sp_q_required affecte la requête principale ( sp_q ).
Pour appliquer à une requête numérotée, remplacez le # dans le nom du paramètre par le numéro correspondant (par exemple, sp_q_required_8 s’applique à la requête numérotée sp_q_8 ). La valeur par défaut du paramètre est 1 (doit correspondre).
Pour rechercher des documents qui contiennent le mot "calc" mais NE contiennent PAS "mac", "win" ou "all" dans le champ "plateforme" défini par l’utilisateur, votre formulaire de recherche HTML peut contenir les lignes suivantes :
<input type="hidden" name="sp_x_1" value="platform"> Search for: <input type="text" name="sp_q" value="calc"> Exclude: <input type="text" name="sp_q_1" value="mac win all"> <input type="hidden" name="sp_q_required_1" value="-1">
35
sp_redirect_if_one_result
sp_redirect_ if_one_result= 0 or 1
Indique s’il faut rediriger vers l’URL du résultat de la recherche s’il n’y a qu’un seul résultat de recherche.
36
sp_referrer
sp_referrer= url
Indique l’URL du référent pour la recherche. Utile pour les règles de réécriture de recherche dans lesquelles les résultats de la recherche sont liés au même site que le formulaire de recherche.
La valeur par défaut est la valeur standard CGI HTTP_REFERRER fournie par le navigateur.
37
sp_ro
sp_ro= champ : pertinence
Permet le temps de recherche facultatif, par nom de champ, le contrôle de pertinence. Le ou dans le nom du paramètre signifie "remplacement de la pertinence". Le paramètre accepte un ou plusieurs noms de champ, suivis d’un caractère deux-points, suivis d’une valeur de pertinence comprise entre 0 et 10.
Par exemple, pour définir la valeur de pertinence du nom de champ "body" sur 10, au moment où un client effectue une recherche, le paramètre s’affiche comme suit :
sp_ro=body:10
Ou, pour spécifier plusieurs valeurs de remplacement de pertinence de champ dans la chaîne de paramètre, vous pouvez utiliser un délimiteur de barre verticale. Par exemple, pour définir la valeur de pertinence des noms de champ "body" et "title" sur 9, le paramètre s’affiche comme suit au moment où un client effectue une recherche :
sp_ro=body:9|title:9
Remarque : La spécification d’un champ qui n’est pas impliqué dans la recherche associée n’a aucun effet. Par exemple, si vous définissez sp_ro=title:10 , mais que le nom du champ de titre n’est pas recherché, le paramètre sp_ro n’a aucun effet. En d'autres termes, la spécification d'un nom de champ à l'aide du paramètre _ro ne recherche pas automatiquement ce champ ; au lieu de cela, il remplace uniquement le paramètre de pertinence associé à ce champ.
38
sp_s
sp_s= nombre
Indique l’ordre de tri. La valeur zéro (0) est la valeur par défaut et permet de trier par score de pertinence. Un (1) signifie trier par date et -1 signifie ne pas trier.
Vous pouvez spécifier un nom de champ pour la valeur du paramètre _s . Par exemple, sp_s=title trie les résultats en fonction des valeurs contenues dans le champ de titre. Lorsqu’un nom de champ est utilisé pour la valeur d’un paramètre _s , les résultats sont triés par ce champ, puis subtriés par pertinence.
Définissez le tri du champ référencé sur Croissant ou Décroissant dans Paramètres > de métadonnées > Définitions pour activer cette fonction.
Vous pouvez également affecter plusieurs champs de tri à une seule requête en définissant le paramètre _s plusieurs fois dans le formulaire de recherche. Les lignes de modèle suivantes définissent les résultats de la recherche à trier d’abord par nom d’artiste, puis par nom d’album, puis par nom de piste.
<input type="hidden" name="sp_s" value="artist"> <input type="hidden" name="sp_s" value="album"> <input type="hidden" name="sp_s" value="track"> Search for: <input type="text" name="sp_q" value="Music Search">
Il est également possible de trier sur les données de champ de correspondance de table en spécifiant un qualificateur de nom de table avant le nom du champ, par exemple, items.price. Voir le paramètre sp_field_table pour plus d'informations sur la correspondance des tables.
Si vous effectuez une recherche par proximité, vous pouvez trier les résultats en fonction de la proximité en spécifiant un "champ de sortie de proximité".
39
sp_sr
sp_sr= champ
Indique le champ de classement à utiliser pour le classement statique. Le champ doit être un champ de type Classement avec une pertinence supérieure à 0. Si aucun paramètre sp_sr n’est fourni pour la requête, un champ de type Classement est automatiquement sélectionné.
Pour désactiver le classement statique pour une requête particulière, incluez une valeur NULL pour sp_sr (par exemple, <input type="hidden" name="sp_sr" value=""> ).
40
sp_sfvl_field
sp_sfvl_field= chaîne
Indique le nom d’un champ à utiliser conjointement avec la balise <search-field-value-list> dans le modèle de recherche.
Vous pouvez spécifier plusieurs paramètres sp_sfvl_field .
41
sp_sfvl_df_count
sp_sfvl_df_count= <valeur_entière>
Demande jusqu’à <valeur_entière> les champs de facette dynamique search-field-value-list pour cette recherche.
La valeur par défaut est 0. La valeur maximale autorisée est le nombre actuel de champs de facette dynamique, dynamic-facet-field-count défini pour un index donné. Les valeurs entières inférieures à 0 sont traitées comme 0. Les valeurs d’entiers spécifiées ci-dessus sont plafonnées à dynamic-facet-field-count . Les valeurs non entières sont ignorées ; ils sont traités comme la valeur par défaut.
La recherche d’une tranche donnée est plafonnée avec une valeur maximale autorisée pour sp_sfvl_df_count de la valeur dynamique facette-champ-nombre de cette tranche. Lors de la fusion des résultats de la tranche, la valeur maximale effective de sp_sfvl_df_count est le nombre maximal réel sp_sfvl_df_count sur toutes les tranches.
42
sp_sfvl_df_exclude
sp_sfvl_df_exclude= < nom_champ >[|< nom_champ >|...
Spécifie une liste de champs de facettes dynamiques spécifiques à exclure de la prise en compte pour cette recherche.
Par défaut, tous les champs de facette dynamique sont pris en compte.
43
sp_sfvl_df_include
sp_sfvl_df_include= < nom_champ >[|< nom_champ >|...
Spécifie une liste de champs de facettes dynamiques spécifiques à inclure dans les résultats de la recherche.
Remarque : Le paramètre sp_sfvl_df_count détermine le nombre total de champs de facette dynamique à renvoyer, y compris tout champ spécifié au moyen de sp_sfvl_df_include. En d’autres termes, l’utilisation de sp_sfvl_df_include ne permet pas au nombre total de champs de facette dynamique renvoyés de dépasser sp_sfvl_df_count .
44
sp_staged
sp_staged= 0 ou 1
Si sp_staged=1 est envoyé avec une requête, la requête exécutée est une recherche par étapes.
Une recherche par étapes utilise tous les composants actuellement mis en scène, y compris l’index et les modèles.
45
sp_start_day, sp_start_month, sp_start_year
sp_start_day= nombre
sp_start_month= nombre
sp_start_year= nombre
Ce triplet de valeurs spécifie la plage de dates de début de la recherche et vous le fournissez sous forme de jeu.
46
sp_ sugg _q
sp_submit_q= nombre
Le paramètre sp_sugg_q détermine le paramètre sp_q[_#] à utiliser avec le service Suggestion.
La valeur par défaut de sp_sugg_q est 0, ce qui signifie que le moteur de recherche utilise la valeur de sp_q pour déterminer les suggestions.
Définissez sp_sugg_q=1 pour utiliser la valeur de sp_q_1 pour déterminer les suggestions, etc.
47
sp_t
sp_t= chaîne
Indique le modèle de transport à utiliser.
Ce paramètre est utile si vous souhaitez contrôler l’apparence des résultats de recherche de base sur votre site Web en utilisant différents modèles de transport de recherche pour chaque zone de votre compte de recherche.
Le modèle de transport par défaut est "search".
48
sp_trace
sp_trace= 0 ou 1
Lorsqu'il est défini sur sp_stage=1 , active la fonctionnalité de suivi de recherche principale dans le simulateur.
Remarque : Si ce paramètre n’est pas spécifié, la recherche principale ne collecte pas les informations de suivi et les balises de modèle de recherche principale associées n’ont aucune sortie.
49
sp_w, sp_w_control
sp_w= sound-alike-enable
sp_w_control= sound-alike-control
Indique que la correspondance du son doit être activée ou désactivée pour cette requête particulière.
Le sp_w_control pour "Exact" est ignoré. La correspondance du son est désactivée.
Le sp_w_control pour "Alike" est ignoré. La correspondance du son est activée
Le sp_w_control pour Anything else est 1. La correspondance du son est désactivée.
Le sp_w_control pour Anything est autre chose. La correspondance du son est activée.
Le paramètre sp_w_control permet de créer une case à cocher aux termes négatifs ou positifs pour le contrôle utilisateur final de la correspondance son/son.
Si sp_w_control=0 est utilisé, une case à cocher avec un mot négatif est utilisée pour définir le paramètre sp_w comme dans l'exemple suivant :
<input type=hidden name="sp_w_control" value="0"><input type=checkbox name="sp_w" value="exact">No Sound-Alike matching
Si sp_w_control=1 est utilisé, une case à cocher avec une formulation positive est utilisée pour définir le paramètre sp_w comme suit :
<input type=hidden name="sp_w_control" value="1"><input type=checkbox name="sp_w" value="alike">Sound-Alike matching
Voir l'exemple de formulaire de recherche avancée pour plus d'exemples sur l'utilisation des paramètres _w_control et sp_w .
50
sp_x
sp_x= champ
Indique les champs à rechercher dans la chaîne de requête. tout signifie rechercher dans tous les champs. title signifie rechercher uniquement les champs de titre. desc signifie rechercher uniquement les champs de description de document. clés signifie rechercher uniquement des mots-clés de document. body signifie rechercher uniquement le texte du corps. alt signifie rechercher uniquement du texte de remplacement. url signifie rechercher uniquement les valeurs d’URL. target signifie que la recherche ne cible que les mots-clés. Dans tous ces cas, les spécifications utilisateur des champs "text:", "desc:", "keys:", "body:", "alt:", "url:" et "target:" sont ignorées dans le paramètre sp_q correspondant. Si sp_x n’est pas présent ou s’il est défini sur une chaîne vide ou une autre chaîne, les préfixes de champ utilisateur standard sont autorisés. Pour plus d’informations sur les préfixes de champ, voir la description des conseils de recherche.
Consultez l’exemple de description du formulaire de recherche avancée pour obtenir des exemples d’utilisation du paramètre sp_x .
Vous pouvez créer des requêtes qui recherchent tous les champs définis sur Rechercher par défaut sous Options > Métadonnées > Définitions en définissant sp_x=n’importe quel . Les champs prédéfinis et définis par l’utilisateur peuvent être utilisés comme valeur du paramètre sp_x .
Vous pouvez également affecter plusieurs champs à une seule requête en définissant le paramètre sp_x plusieurs fois. Les lignes de modèle suivantes permettent aux utilisateurs d’interroger à la fois les champs "titre" et "auteur" pour les "Grands Livres".
<input type="hidden" name="sp_x" value="title"><input type="hidden" name="sp_x" value="author">Search for: <input type="text" name="sp_q" value="Great Books">
51
sp_x_#
sp_x_#= nom_champ
Ce paramètre spécifie le champ à rechercher dans la requête sp_q_# correspondante. Le est remplacé par un nombre compris entre 1 et 16 (par exemple, sp_x_8 ). Le nom de champ est un champ prédéfini ou défini par l’utilisateur.
Si aucun paramètre sp_x_# n’est fourni pour une requête numérotée particulière, tous les champs définis comme Rechercher par défaut comme définis sous Paramètres > de métadonnées > Définitions sont recherchés par cette requête.
Par exemple, l’envoi du formulaire suivant renvoie tous les documents qui contiennent le mot "super" qui contient également le mot "Fitzgerald" dans le champ "author" :
Search for: <input type="text" name="sp_q" value="great"><input type="hidden" name="sp_x_1" value="author">Search only documents written by: <input type="text" name="sp_q_1" value="Fitzgerald">
Vous pouvez associer plusieurs noms de champ à une requête spécifique ou à une requête numérotée en fournissant plusieurs instances du même paramètre _x ou sp_x_# dans une seule requête de recherche.
Par exemple, pour rechercher le mot "fleur" dans les champs "corps" et "clés", vous pouvez créer un formulaire de recherche avec les informations suivantes :
<input type="hidden" name="sp_x_1" value="body"><input type="hidden" name="sp_x_1" value="keys">Search for: <input type="text" name="sp_q_1" value="flower">

Exemple typique d’utilisation des paramètres CGI de recherche en arrière-plan

Les requêtes de lien suivantes lancent une recherche en utilisant "Musique" comme requête de recherche et utilisent tous les paramètres par défaut. Notez que l’URL est fractionnée sur deux lignes pour faciliter la lecture. Dans votre code HTML, ce lien doit tous se trouver sur une seule ligne.
<a href="https://search.atomz.com/search/?sp_q=Music&sp_a=sp99999999"> 
Testing...</a>

La même fonctionnalité est généralement définie avec un formulaire :
<form action="https://search.atomz.com/search/"> 
<input size=12 name="sp_q" value="Music"><br> 
<input type=hidden name="sp_a" value="sp99999999"> 
<input type=submit value="Search"><br> 
</form>

Vous devez généralement utiliser les paramètres par défaut lors du lancement d’une recherche. Ainsi, la première page est affichée, triée par pertinence, et permet au client de choisir d’autres pages et d’autres options. Si le formulaire de recherche de votre site comporte des options pour les collections, transmettez le nom de la collection en tant que paramètre.

Exemple détaillé d’utilisation des paramètres CGI de recherche en arrière-plan

Les requêtes de formulaire suivantes affichent 25 les résultats en commençant par le résultat 10 . Les résumés ne sont pas affichés, l’ordre de tri est par date et la collection nommée support est utilisée. Seuls les documents datant des 30 derniers jours sont renvoyés.
<form action="https://search.atomz.com/search/"> 
<input size=12 name="sp_q"><br> 
<input type=hidden name="sp_a" value="sp99999999"> 
<input type=submit value="Search"><br> 
<input type=hidden name=sp_n value=10> 
<input type=hidden name=sp_c value=25> 
<input type=hidden name=sp_m value=0> 
<input type=hidden name=sp_s value=1> 
<input type=hidden name=sp_k value="support"> 
<input type=hidden name=sp_date_range value=30> 
</form>