Se proporciona código de formulario de búsqueda que puede copiar y pegar en el HTML del sitio ( Design > Auto-Complete > Form Source).
Consulte Copia del código HTML del formulario de búsqueda en el….
También puede definir los parámetros que se enumeran en el propio formulario de búsqueda o desde una secuencia de comandos. Además de los parámetros que se enumeran a continuación, también puede utilizar los parámetros de búsqueda back-end para controlar la búsqueda.
Consulte Parámetros CGI de búsqueda back-end.
Las solicitudes de búsqueda constan de una dirección URL base. La dirección URL base indica qué cuenta está buscando el cliente y un conjunto de parámetros CGI (pares clave-valor) que indican cómo devolver los resultados de búsqueda deseados para la cuenta asociada.
La dirección URL base está asociada a una cuenta específica y a un entorno de ensayo o lanzamiento. El administrador de cuentas puede solicitar varios alias para la URL base. Por ejemplo, una empresa llamada Megacorp puede tener dos direcciones URL base asociadas a su cuenta: https://search.megacorp.com
y https://stage.megacorp.com
. La URL anterior busca su índice activo y la segunda URL busca su índice por etapas.
Se admiten tres formatos de parámetros CGI. De forma predeterminada, su cuenta está configurada para separar los parámetros CGI con un punto y coma, como en el siguiente ejemplo:
https://search.megacorp.com?q=shoes;page=2
Si lo prefiere, puede hacer que su administrador de cuentas configure su cuenta para que utilice el símbolo & para separar los parámetros CGI como en el siguiente ejemplo:
https://search.megacorp.com?q=shoes&page=2
También se admite un tercer formato, denominado formato SEO, en el que se utiliza una barra diagonal /
en lugar del separador y el signo igual como en el siguiente ejemplo:
https://search.megacorp.com/q/shoes/page/2
Cada vez que se utiliza el formato SEO para enviar una solicitud, todos los vínculos de salida se devuelven en el mismo formato.
Parámetro de búsqueda guiada | Ejemplo | Descripción |
---|---|---|
q | q=string |
Especifica la cadena de consulta para la búsqueda. Este parámetro se asigna al parámetro de búsqueda back-end sp_q . Consulte Parámetros CGI de búsqueda back-end. |
q# | q#=string |
La faceta (búsqueda dentro de un campo determinado) se realiza mediante parámetros q y x numerados. El parámetro q define el término que está buscando en la faceta como se indica en el parámetro x numerado correspondiente. Por ejemplo, si tiene dos facetas con nombres tamaño y color, puede tener algo como q1=pequeño;x1=tamaño;q2=rojo;x2=color. Este parámetro se asigna a los parámetros de búsqueda back-end sp_q_exact_# . Consulte Parámetros CGI de búsqueda back-end. |
x# | q#=string |
La faceta (búsqueda dentro de un campo determinado) se realiza mediante parámetros q y x numerados. El parámetro q define el término que está buscando en la faceta como se indica en el parámetro x numerado correspondiente. Por ejemplo, si tiene dos facetas con nombres tamaño y color, puede tener algo como q1=pequeño;x1=tamaño;q2=rojo;x2=color. Este parámetro se asigna a los parámetros de búsqueda back-end sp_x_# . Consulte Parámetros CGI de búsqueda back-end. |
colección | collection=string |
Especifica la colección que se usará para la búsqueda. Este parámetro se asigna al parámetro de búsqueda back-end sp_k . Consulte Parámetros CGI de búsqueda back-end. |
count | count=number |
Especifica el recuento total de resultados que se muestran. El valor predeterminado se define en Settings > Searching > Searches . . Este parámetro se asigna al parámetro de búsqueda back-end sp_c . Consulte Parámetros CGI de búsqueda back-end. |
página | page=number |
Especifica la página de resultados que se devuelven. |
rank | rank=field |
Especifica el campo de clasificación que se utilizará para la clasificación estática. El campo debe ser un campo de tipo Clasificación con relevancia buena a 0. Este parámetro se asigna al parámetro back-end sp_sr . Consulte Parámetros CGI de búsqueda back-end. |
sort | sort=number |
Especifica el orden. "0" es el valor predeterminado y se ordena por puntuación de relevancia; "1" se clasifica por fecha; "-1" no se ordena. Los usuarios pueden especificar un nombre de campo para el valor del parámetro sp_s . Por ejemplo, sp_s=title ordena los resultados según los valores contenidos en el campo de título. Cuando se utiliza un nombre de campo para el valor de un parámetro sp_s , los resultados se ordenan por ese campo y luego se subordenan por relevancia. Para habilitar esta función, haga clic en Settings > Metadata > Definitions . En la página Definiciones , haga clic Add New Field o haga clic Edit para un nombre de campo determinado. En la lista desplegable Sorting , seleccione Ascending o Descending . Este parámetro se asigna al parámetro de búsqueda back-end sp_s . Consulte [Parámetros CGI de búsqueda back-end].(/docs/search-promote/using/appendices/c-cgiparameters.html?lang=es#reference_582E85C3886740C98FE88CA9DF7918E8). |
Normalmente, los clientes interactúan con una capa de presentación denominada Búsqueda guiada. Sin embargo, teóricamente es posible omitir la capa Búsqueda guiada e interactuar con la búsqueda principal del servidor directamente utilizando los parámetros CGI que se describen en esta página.
Puede seleccionar parámetros CGI de búsqueda backend de la siguiente tabla:
Compatibilidad con una sola consulta |
Compatibilidad con múltiples consultas |
Ejemplos |
Descripción |
|
---|---|---|---|---|
1 |
sp_a |
|
|
Especifica la cadena del número de cuenta. Este parámetro es obligatorio y debe ser una cadena de número de cuenta válida. Puede encontrar la cadena del número de cuenta en Configuración > Opciones de cuenta > Configuración de cuenta . |
2 |
sp_advanced |
|
|
Si |
3 |
sp_c |
|
|
Especifica el recuento total de resultados que se van a mostrar. El valor predeterminado es 10. |
4 |
sp_context_field |
|
|
Recopila información contextual para el campo dado. La información recopilada se muestra en los resultados de búsqueda mediante la etiqueta de plantilla |
5 |
sp_d |
|
|
Especifica el tipo de búsqueda de intervalo de fechas que se va a realizar. Los valores posibles de tipo son cualquiera, lo que significa que no realice búsquedas de intervalos de fechas, personalizadas, lo que indica que el valor de |
6 |
|
sp_d_# |
|
Especifica el tipo de intervalo de fechas que se busca para la consulta Puede establecer |
7 |
sp_date_range |
|
|
Especifica un intervalo de fechas predefinido que se aplicará a la búsqueda. Los valores buenos que son iguales o iguales a cero especifican el número de días que se buscarán antes de hoy; por ejemplo, un valor de "0" especifica "hoy", un valor de "1" especifica "hoy y ayer", un valor de "30" especifica "en los últimos 30 días", etc. Los valores por debajo de cero especifican un intervalo personalizado de la siguiente manera: -1 = "Ninguno", del mismo modo que se especifica sin intervalo de fechas. -2 = "Esta semana", que busca de domingo a sábado de la semana actual. -3 = "Última semana", que busca de domingo a sábado de la semana anterior a la semana actual. -4 = "Este mes", que busca fechas dentro del mes actual. -5 = "Último mes", que busca fechas dentro del mes anterior al mes actual. -6 = "Este año", que busca fechas dentro del año actual. -7 = "Último año", que busca fechas dentro del año anterior al año actual. |
8 |
|
sp_date_range_# |
|
Especifica un intervalo de fechas predefinido para aplicar a la consulta Los valores buenos o iguales a cero especifican la cantidad de días que se buscarán antes de hoy. Por ejemplo, un valor de 0 especifica hoy; un valor de 1 especifica hoy y ayer; un valor de 30 especifica en los últimos 30 días, etc. Los valores por debajo de cero especifican un intervalo personalizado de la siguiente manera: -1 = "Ninguno", del mismo modo que se especifica sin intervalo de fechas. -2 = "Esta semana", que busca de domingo a sábado de la semana actual. -3 = "Última semana", que busca de domingo a sábado de la semana anterior a la semana actual. -4 = "Este mes", que busca fechas dentro del mes actual. -5 = "Último mes", que busca fechas dentro del mes anterior al mes actual. -6 = "Este año", que busca fechas dentro del año actual. -7 = "Último año", que busca fechas dentro del año anterior al año actual. |
9 |
sp_dedupe_field |
|
|
Especifica un solo campo en el que se van a desduplicar los resultados de búsqueda. Todos los resultados duplicados en ese campo se eliminan de los resultados de búsqueda. Por ejemplo, si para |
10 |
sp_e |
|
|
Especifica que la expansión automática de caracteres comodín debe realizarse para cualquier palabra de la cadena de consulta con más de caracteres numéricos. En otras palabras, |
11 |
|
sp_e_# |
|
Especifica que la expansión automática de caracteres comodín tiene lugar para cualquier palabra de la cadena de consulta |
12 |
sp_end_day, sp_end_month, sp_end_year |
|
|
Este triplete de valores especifica el intervalo de fechas de finalización de la búsqueda y debe proporcionarse como un conjunto. |
13 |
sp_f |
|
|
Especifica el conjunto de caracteres de las cadenas de parámetros de consulta (como |
14 |
sp_field_table |
|
|
Define una tabla de datos lógica que consta de los campos dados. Por ejemplo, una tabla denominada "elementos" que consta de los campos "color", "tamaño" y "precio" se definiría de la siguiente manera: Las tablas lógicas son más útiles junto con los campos que tienen activada la opción "Listas de permitidos" (en Configuración > Metadatos > Definiciones ). Todos los parámetros de CGI y las etiquetas de plantilla que toman un nombre de campo como valor pueden especificar opcionalmente un nombre de tabla seguido de "." antes del nombre del campo (por ejemplo, Por ejemplo, para realizar una búsqueda de documentos que contengan uno o más elementos "rojos" de tamaño "grande" (donde los elementos se representan como filas paralelas de metadatos), puede utilizar lo siguiente: |
15 |
sp_i |
|
|
|
| ||||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
| ||||
|
| |||
|
| |||
|
| |||
| ||||
| ||||
|
| |||
| ||||
|
| |||
| ||||
|
| |||
| sp_w_control
| |||
|
| |||
|
|
Las siguientes consultas de vínculos inician una búsqueda utilizando "Música" como consulta de búsqueda y utilizan todos los parámetros predeterminados. Tenga en cuenta que la dirección URL está dividida en dos líneas para facilitar la lectura. En su HTML, este vínculo debe estar en una línea.
<a href="https://search.atomz.com/search/?sp_q=Music&sp_a=sp99999999">
Testing...</a>
La misma funcionalidad se define más generalmente con un formulario:
<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>
Normalmente, se deben usar parámetros predeterminados al iniciar una búsqueda. De este modo, se muestra la primera página, se ordena por relevancia y permite al cliente elegir otras páginas y otras opciones. Si el formulario de búsqueda del sitio incluye opciones para las colecciones, pase el nombre de la colección como parámetro.
Las siguientes consultas de formulario muestran 25
resultados que comienzan por el resultado 10
. No se muestran los resúmenes, el criterio de ordenación es por fecha y se utiliza la colección denominada support
. Solo se devuelven los documentos con fecha de los últimos 30 días.
<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>