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).
Voir Copie du code HTML du formulaire de recherche dans le….
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 d’arrière-plan pour contrôler la recherche.
Voir Paramètres CGI de recherche dorsale.
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 actif. 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 recherche leur index actif et la seconde l’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 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 |
Indique 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 dorsale. |
q# | q#=string |
Le facettage (recherche dans un champ donné) se fait 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 nommées taille et couleur, vous pouvez avoir un élément du type q1=small;x1=size;q2=red;x2=color. Ce paramètre correspond aux paramètres de recherche du serveur principal sp_q_exact_# . Voir Paramètres CGI de recherche dorsale. |
x# | q#=string |
Le facettage (recherche dans un champ donné) se fait 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 nommées taille et couleur, vous pouvez avoir un élément du type q1=small;x1=size;q2=red;x2=color. Ce paramètre correspond aux paramètres de recherche du serveur principal sp_x_# . Voir Paramètres CGI de recherche dorsale. |
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 dorsale. |
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 dorsale. |
page | page=number |
Indique la page des résultats qui sont renvoyés. |
rang | rank=field |
Indique le champ de classement à utiliser pour le classement statique. Le champ doit être un champ de type Classement dont la pertinence est supérieure à 0. Ce paramètre correspond au paramètre principal sp_sr . Voir Paramètres CGI de recherche dorsale. |
sort | sort=number |
Indique l’ordre de tri. "0" est la valeur par défaut et est triée 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 paramètre sp_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 sp_s , les résultats sont triés par ce champ, puis subtriés par pertinence. Pour activer cette fonction, cliquez sur Settings > Metadata > Definitions. Sur la page Définitions, cliquez sur Add New Field ou sur Edit pour un nom de champ particulier. Dans la liste déroulante Sorting, sélectionnez Ascending ou Descending. Ce paramètre correspond au paramètre de recherche principal sp_s . Voir Paramètres [ CGI de recherche ]dorsale.(/docs/search-promote/using/appendices/c-cgiparameters.html?lang=fr#reference_582E85C3886740C98FE88CA9DF7918E8). |
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 d’ignorer le calque 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 |
|
|
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 |
|
|
Si |
3 |
sp_c |
|
|
Indique le nombre total de résultats à afficher. La valeur par défaut est de 10. |
4 |
sp_context_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 |
5 |
sp_d |
|
|
Indique le type de plage de dates à effectuer lors de la recherche. Les valeurs possibles pour le type sont toutes, ce qui signifie ne pas effectuer de recherche de plage de dates, personnalisées, ce qui indique que la valeur de |
6 |
|
sp_d_# |
|
Spécifie le type de plage de dates à effectuer pour la requête Vous pouvez définir |
7 |
sp_date_range |
|
|
Spécifie une plage de dates prédéfinie à appliquer à la recherche. Les valeurs supérieures ou égales à zéro spécifient le nombre de jours à rechercher avant 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 = "Dernier mois", 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 de l’année précédant l’année en cours. |
8 |
|
sp_date_range_# |
|
Spécifie une plage de dates prédéfinie à appliquer à la requête Les valeurs supérieures ou égales à zéro spécifient le nombre de jours de recherche avant aujourd’hui. Par exemple, une valeur de 0 indique aujourd’hui ; une valeur de 1 indique aujourd’hui et hier ; une valeur de 30 indique 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 = "Dernier mois", 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 de l’année précédant l’année en cours. |
9 |
sp_dedupe_field |
|
|
Indique un champ unique sur lequel dédupliquer les résultats de la recherche. Tous les résultats de duplicata de ce champ sont supprimés des résultats de la recherche. Par exemple, si pour |
10 |
sp_e |
|
|
Indique que l’extension automatique des caractères génériques doit avoir lieu pour tout mot de la chaîne de requête contenant plus de plusieurs caractères numériques. En d'autres termes, |
11 |
|
sp_e_# |
|
Indique que l’extension automatique des caractères génériques a lieu pour tout mot de la chaîne de requête |
12 |
sp_end_day, sp_end_month, sp_end_year |
|
|
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écifie le jeu de caractères des chaînes de paramètres de requête (par exemple |
14 |
sp_field_table |
|
|
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 : Les tableaux logiques sont particulièrement utiles en conjonction avec les champs dont les "Listes autorisées" sont cochées (sous Paramètres > Métadonnées > Définitions ). Tous les paramètres CGI et les balises de modèle qui utilisent un nom de champ comme valeur peuvent éventuellement spécifier un nom de table suivi d’un "". avant le nom du champ (par exemple, Par exemple, pour rechercher des documents contenant un ou plusieurs éléments "rouges" de taille "large" (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 : |
15 |
sp_i |
|
|
|
| ||||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
|
| |||
| ||||
|
| |||
| ||||
|
| |||
| sp_w_control
| |||
|
| |||
|
|
Les requêtes de liens suivantes début 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 plus de lisibilité. 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>
En règle générale, vous devez utiliser des paramètres par défaut lorsque vous lancez 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.
Les requêtes de formulaire suivantes affichent les résultats 25
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 support
est utilisée. Seuls les documents datés au cours 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>