Show Menu
TEMAS×

Parámetros de CGI

Parámetros de CGI

Buscar parámetros CGI

Se proporciona el código de formulario de búsqueda que puede copiar y pegar en el HTML del sitio ( Design > Auto-Complete > Form Source ).
También puede definir los parámetros que aparecen en el propio formulario de búsqueda o en 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 activo. Puede solicitar varios alias para la URL base desde el administrador de cuentas. Por ejemplo: una empresa llamada Megacorp puede tener dos direcciones URL base asociadas con su cuenta: https://search.megacorp.com y https://stage.megacorp.com . La dirección URL anterior busca en su índice activo y la última URL busca en su índice escalonado.
Se admiten tres formatos de parámetros CGI. De forma predeterminada, su cuenta está configurada para separar parámetros CGI con un punto y coma, como en el ejemplo siguiente:
https://search.megacorp.com?q=shoes;page=2
Si lo prefiere, puede hacer que el administrador de cuentas configure su cuenta para que utilice ampersands a fin de 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 un signo igual al del 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 del sp_q servidor. Consulte Parámetros CGI de búsqueda back-end.
q#
q#=string
La faceta (búsqueda dentro de un campo determinado) se realiza mediante los parámetros numerados q y x. 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 de tamaño y color, puede tener algo como q1=small;x1=size;q2=red;x2=color. Este parámetro se asigna a los parámetros de búsqueda del sp_q_exact_# servidor.
Consulte Parámetros CGI de búsqueda back-end.
x#
q#=string
La faceta (búsqueda dentro de un campo determinado) se realiza mediante los parámetros numerados q y x. 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 de tamaño y color, puede tener algo como q1=small;x1=size;q2=red;x2=color. Este parámetro se asigna a los parámetros de búsqueda del sp_x_# servidor.
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 del sp_k servidor. 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 del sp_c servidor. Consulte Parámetros CGI de búsqueda back-end.
página
page=number
Especifica la página de resultados que se devuelven.
clasificación
rank=field
Especifica el campo de clasificación que se usará 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 sp_sr back-end. Consulte Parámetros CGI de búsqueda back-end.
ordenar
sort=number
Especifica el orden.
"0" es el valor predeterminado y ordena por puntuación de relevancia; "1" se ordenará por fecha; "-1" no se ordena. Los usuarios pueden especificar un nombre de campo para el valor del sp_s parámetro. 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 sp_s parámetro, los resultados se ordenan por ese campo y luego se subordenan por relevancia. To enable this feature, click Settings > Metadata > Definitions. En la página Definiciones, haga clic Add New Field o haga clic en Edit el nombre de un campo concreto. En la lista Sorting desplegable, seleccione Ascending o Descending. Este parámetro se asigna al parámetro de búsqueda del sp_s servidor.
Consulte Parámetros #back-end.(../c-appendices/c-cgiparameters.md#reference_582E85C3886740C98FE88CA9DF7918E8).

Parámetros CGI de búsqueda back-end

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 básica del servidor directamente utilizando los parámetros CGI que se describen en esta página.
Puede seleccionar parámetros CGI de búsqueda back-end en la tabla siguiente:
Compatibilidad con una sola consulta
Compatibilidad con múltiples consultas
Ejemplos
Descripción
1
sp_a
sp_a= cadena
Especifica la cadena de 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 la cuenta .
2
sp_advanced
sp_advanced= 0 o 1
Si sp_advanced=1 se envía con una consulta, se utiliza para el formulario de búsqueda todo el código entre la etiqueta <search-if-advanced> y la etiqueta </search-if-advanced> de la plantilla de búsqueda. Se ignora todo el código entre la etiqueta <search-if-not-advanced> y la etiqueta </search-if-not-advanced> . Si se envía sp_advanced=0 (o cualquier otro valor), se ignora el bloque de plantilla <search-if-advanced> y se utiliza el bloque de plantilla <search-if-not-advanced>.
3
sp_c
sp_c= número
Especifica el recuento total de resultados que se van a mostrar. El valor predeterminado es 10.
4
sp_context_field
sp_context_field= field
Recopila información contextual para el campo dado. La información recopilada se muestra en los resultados de la búsqueda mediante la etiqueta de plantilla <search-context> . El valor predeterminado es body .
5
sp_d
sp_d= type
Especifica el tipo de búsqueda de intervalo de fechas que se va a realizar. Los valores posibles para el tipo son cualquiera, lo que significa que no se realiza una búsqueda de intervalo de fechas, personalizado, lo que indica que se debe utilizar el valor de sp_date_range para determinar las fechas de búsqueda, y específico, lo que indica que los valores de sp_start_day , sp_start_month , sp_start_year , sp_end_day , sp_end_month y ss_end_year_year_year_year_ańana_aaaeo. para determinar el intervalo de fechas que se va a buscar. sp_d sólo es necesario si el formulario de búsqueda contiene la opción de buscar por un intervalo personalizado (por medio de sp_date_range ) o por un intervalo de fechas de inicio y finalización específico.
6
sp_d_#
sp_d_#= type
Especifica el tipo de búsqueda de intervalo de fechas para la consulta sp_q_# correspondiente. El "#" se sustituye por un número entre 1 y 16 (por ejemplo, sp_d_8 , se aplica a la consulta numerada sp_q_8 ).
Puede establecer el tipo en cualquiera, lo que significa que no debe realizar una búsqueda de intervalo de fechas, personalizada, lo que indica que el valor de sp_date_range_# se utiliza para determinar las fechas de búsqueda y específicas, lo que indica que los valores en sp_q_min_day_# , sp_q_min_month_# , sp_q_min_year_# , sp_q_max_day_# , sp_q_max_month_# , y sp__max_year_# deben utilizarse para determinar el intervalo de fechas. El uso de sp_d_# sólo es necesario si el formulario de búsqueda contiene la opción de buscar por un intervalo personalizado (mediante sp_date_range_# ) o por un intervalo de fechas de inicio y finalización específico.
7
sp_date_range
sp_date_range= number
Especifica un intervalo de fechas predefinido para aplicar a la búsqueda. Los valores buenos 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", y así sucesivamente.
Los valores por debajo de cero especifican un intervalo personalizado de la siguiente manera:
-1 = "Ninguno", lo mismo que especificar 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 en curso.
8
sp_date_range_#
sp_date_range_#= number
Especifica un intervalo de fechas predefinido para aplicar a la consulta sp_q_# correspondiente. El "#" se sustituye por un número entre 1 y 16 (por ejemplo, sp_date_range_8 , se aplica a la consulta numerada sp_q_8 ).
Los valores buenos o iguales a cero especifican el número de días de búsqueda anteriores a 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, y así sucesivamente.
Los valores por debajo de cero especifican un intervalo personalizado de la siguiente manera:
-1 = "Ninguno", lo mismo que especificar 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 en curso.
9
sp_dedupe_field
sp_dedupe_field= fieldname
Especifica un solo campo en el que se desduplicarán los resultados de la búsqueda. Todos los resultados duplicados de ese campo se eliminan de los resultados de búsqueda. Por ejemplo, si para sp_dedupe_field=title , solo se muestra el resultado superior de un título determinado en los resultados de la búsqueda (ningún resultado tendrá el mismo contenido de campo de título). Para los campos de tipo multivalor (lista de permitidos), se utiliza todo el contenido del campo para la comparación. Sólo se puede especificar un campo. No se permite un "calificador de tabla" en el nombre del campo.
10
sp_e
sp_e= número
Especifica que la expansión automática de comodines debe realizarse para cualquier palabra de la cadena de consulta con más de caracteres numéricos. En otras palabras, sp_e=5 especifica que las palabras con 5 o más caracteres, como "consulta" o "número", deben expandirse con el carácter comodín '*', haciendo que la búsqueda sea equivalente a una búsqueda de "consulta*" o "número*". Las palabras con menos caracteres no se expanden, por lo que una búsqueda de "palabra" no tendría expansión automática de comodines.
11
sp_e_#
sp_e_#= número
Especifica que la expansión automática de caracteres comodín se produce para cualquier palabra de la cadena de consulta sp_q_# correspondiente con más de caracteres numéricos. En otras palabras, sp_e_2=5 especifica que las palabras con cinco o más caracteres en la cadena de consulta sp_q_2 , como "consulta" o "número", deben expandirse con el carácter comodín ' * ', lo que equivale a una búsqueda de "consulta*" o "número*". Las palabras con menos caracteres no se expanden, por lo tanto una búsqueda de "palabra" en sp_q_2 no tendría expansión automática de comodines.
12
sp_end_day, sp_end_month, sp_end_year
sp_end_day= number ,sp_end_month= number , sp_end_year= number
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
sp_f= cadena
Especifica el conjunto de caracteres de las cadenas de parámetros de consulta (como sp_q ). Esta cadena siempre debe coincidir con el conjunto de caracteres de la página que contiene el formulario de búsqueda.
14
sp_field_table
sp_field_ table=table: field,field...
Define una tabla de datos lógica que consta de los campos dados. Por ejemplo, una tabla con el nombre "elementos" que consta de los campos "color", "tamaño" y "precio" se definiría de la siguiente manera:
sp_field_table=items:color,tamaño,precio
Las tablas lógicas son más útiles junto con los campos que tienen activada la opción "Permitir listas" (en Configuración > Metadatos > Definiciones ). Todos los parámetros 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, sp_x_1=tablename.fieldname ).
Por ejemplo, para realizar una búsqueda de documentos que contengan uno o varios elementos "rojos" en el tamaño "grande" (donde los elementos se representan como filas paralelas de metadatos), puede utilizar lo siguiente:
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= valor
Omite la búsqueda cuando se generan informes.
Utilice esta consulta para enmascarar determinadas búsquedas del servidor, como las búsquedas que generó el usuario o las búsquedas que genera un administrador en el centro de miembros. Dado que un usuario final no genera estos tipos de búsquedas, no se muestran en varios informes de Adobe Search&Promote.
Los valores válidos son sp_i=1 y sp_i=2 .
16
sp_k
sp_k= cadena
Especifica la colección que se usará para la búsqueda. El valor predeterminado no es ninguna colección, lo que significa que la búsqueda debe incluir todo el sitio.
17
sp_l
sp_l= cadena
Especifica el idioma de las cadenas de parámetros de consulta (como sp_q ). La cadena debe ser un ID de configuración regional estándar que contenga un código de idioma ISO-639, seguido opcionalmente por un código de país ISO-3166. Por ejemplo, "en" o "en_US" para inglés o "ja" o "ja_JP" para japonés.
18
sp_literal
sp_literal= 0 o 1
Al establecer sp_literal=1 se desactivan temporalmente todas las funciones que puedan interpretar las palabras de la consulta. Con este parámetro, solo coinciden las palabras literales de la consulta, independientemente de los sinónimos, los formularios de palabras alternativas y la coincidencia de sonido.
Tenga en cuenta que sp_literal=0 no tiene significado y se omite si se utiliza.
19
sp_m
sp_m= número
Especifica si se muestran los resúmenes. 1 es sí, 0 es no. El valor predeterminado es 1.
20
sp_n
sp_n= número
Especifica el número del resultado que inicia los resultados de búsqueda. El valor predeterminado es 1.
21
sp_not_found_page
sp_not_found_page= url
Especifica si se redirige a la dirección URL especificada si no hay resultados de búsqueda.
22
sp_p
sp_p= any/all/phrase
Especifica el tipo predeterminado de búsqueda que se va a realizar. El uso de cualquier medio busca documentos que contengan cualquier palabra de la cadena de consulta. El uso de todo significa buscar documentos que contengan todas las palabras de la cadena de consulta. El uso de frase significa que la cadena de consulta se trata como si fuera una frase citada y se omiten todas las comillas escritas por el usuario.
Para frase y todo , la especificación de "+" y "-" antes de las palabras de búsqueda está deshabilitada y esos caracteres se omiten. Si sp_p no está presente, o si está establecido en una cadena vacía o cualquiera, se permiten prefijos de palabras estándar "+" y "-".
Consulte la descripción de las sugerencias de búsqueda para obtener más información sobre el uso de más ("+") y menos ("-") en las búsquedas.
Consulte el formulario de búsqueda avanzada de ejemplo para ver ejemplos sobre el uso del parámetro sp_p .
23
sp_p_#
sp_p_#= any/all/phrase
Especifica el tipo predeterminado de búsqueda que se realizará con la consulta sp_q_# correspondiente. El "#" se sustituye por un número entre 1 y 16 (por ejemplo, sp_p_8 se aplica a la consulta numerada sp_q_8 ). El uso de cualquier significa que se devuelven documentos que contienen cualquier palabra de la cadena de consulta. El uso de todo significa que se devuelven documentos que contienen todas las palabras de la cadena de consulta. El uso de frase significa tratar la cadena de consulta como si fuera una frase completa (y se omiten todas las comillas escritas por el usuario).
Si especifica todo o frase , se omiten los signos más y menos antes de las palabras de búsqueda. Si sp_p_# se omite, o si se define en una cadena vacía o en cualquier , se permiten los prefijos estándar "+" y "-".
24
sp_pt
sp_pt= exact/equivalent/compatible
Especifica el tipo de coincidencia de objetivo que se va a aplicar. El uso de exacto significa que el objetivo de producción solo coincide en documentos que coinciden exactamente con la cadena de consulta dentro del contenido de destino. El uso de equivalentes es igual que exacto, excepto que el orden de las palabras no es importante. El uso de compatible establece automáticamente el tipo de coincidencia de objetivo en función del valor del parámetro sp_p . El uso de exacto se utiliza si sp_p es todo o frase , de lo contrario equivalente . El valor predeterminado de sp_pt es compatible .
25
sp_pt_#
sp_pt_#= exact/equivalent/compatible
Especifica el tipo de coincidencia de objetivos que se aplicará con la consulta sp_q_# correspondiente. El "#" se sustituye por un número entre 1 y 16 (por ejemplo, sp_p_8 se aplica a la consulta numerada sp_q_8 ). El uso de exacto significa que el objetivo de producción solo coincide en documentos que coinciden exactamente con la cadena de consulta dentro del contenido de destino. El uso de equivalentes es como exacto , excepto que el orden de las palabras no es importante. El uso de compatible establece automáticamente el tipo de coincidencia de objetivo en función del valor del parámetro sp_p_# correspondiente: exacto se utiliza si sp_p_# es todo o frase; de lo contrario, se utiliza equivalente. El valor predeterminado de sp_pt_# es compatible .
26
sp_q
sp_q= cadena
Especifica la cadena de consulta para la búsqueda. Una cadena vacía no produce ningún resultado.
27
sp_q_#
sp_q_#= texto
Este parámetro permite la creación de varias consultas en los formularios de búsqueda. El parámetro sp_q_# contiene la cadena de consulta que se utilizará en la consulta numerada dada. Una solicitud de búsqueda puede hacer referencia a hasta 16 consultas numeradas diferentes ( sp_q_1 a sp_q_16 ).
Por ejemplo, al enviar el siguiente formulario se devuelven todos los documentos que contienen las palabras "bueno" y "libros".
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= valor entero
sp_q_month= valor entero
sp_q_year= valor entero
sp_q_day_#= valor entero
sp_q_month_#= valor entero
sp_q_year_#= valor entero
Estos parámetros se utilizan para especificar una fecha exacta para una consulta en particular. Los parámetros sp_q_day , sp_q_month y sp_q_year se aplican a la consulta principal ( sp_q ).
El # parámetro se sustituye por un número entre 1 y 16 (por ejemplo, sp_q_day_6 , que se aplica a la consulta numerada sp_q_6 ). De forma predeterminada, se buscan todas las fechas en relación con la hora media de Greenwich.
La siguiente sección del código permite al usuario buscar la palabra "naranja" en documentos con fecha de "Ene. 1ro, 2000" en un campo definido por el usuario llamado Fecha de publicación :
<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
Estos parámetros asocian una ubicación con la consulta principal o numerada. El uso de sp_q_location afecta a la consulta principal, sp_q_location_# (donde # se reemplaza por un número del 1 al 16), afecta a la consulta numerada dada. Estos parámetros se utilizan para realizar búsquedas de proximidad de distancia mínima y/o máxima en comparación con los datos de ubicación indizados para cada página del sitio. El formato del valor determina su interpretación.
Un valor en la forma DDD (tres dígitos) se interpreta como un código de área telefónica de EE.UU.; un valor en el formulario DDDD o DDDDD-DDDD se interpreta como un código postal de EE.UU.; y un valor en la forma ±DD.DDDD±DDD.DDDD se interpreta como un par de latitud/longitud. Los signos son obligatorios para cada valor. Por ejemplo, +38.6317+120.5509 especifica la latitud 38.6317, la longitud 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
Estos parámetros controlan el cálculo de relevancia aplicado a las búsquedas de proximidad. El uso de sp_q_max_relevant_distance afecta a la consulta principal, sp_q_max_relevant_distance_# (donde # se reemplaza por un número del 1 al 16), afecta a la consulta numerada dada.
El valor predeterminado de sp_q_max_relevant_distance es 100.
Una puntuación de relevancia perfecta para el componente de proximidad representaría una distancia de 0. Una puntuación de relevancia mínima para el componente de proximidad representaría una distancia justo por encima del valor sp_q_max_relevant_distance_# especificado.
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
Estos parámetros se utilizan para establecer intervalos de fechas mínimos y máximos para una consulta en particular. Los parámetros sp_q_min_day , sp_q_min_month , sp_q_min_year , sp_q_max_day , sp_q_max_month ysp_max_year se aplican a la consulta principal ( sp_q_q ).
El # en el nombre del parámetro se reemplaza por un número entre 1 y 16 (por ejemplo, sp_q_min_day_6 se aplica a la consulta numerada sp_q_6 ).
Es legal especificar solamente una fecha mínima, solamente una fecha máxima o tanto una fecha mínima como una fecha máxima. Sin embargo, para un conjunto mínimo o máximo determinado, deben especificarse los tres parámetros de fecha (día, mes y año). De forma predeterminada, se buscan todas las fechas en relación con la hora media de Greenwich.
La siguiente sección de código permite al usuario buscar la palabra "naranja" en documentos con una fecha entre el 1 de enero de 2000 y el 31 de diciembre de 2000 en un campo definido por el usuario llamado Fecha de publicación :
<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 _exacto_#
sp_q_min= valor
sp_q_max= valor
sp_q_min_#= valor
sp_q_max_#= valor
sp_q_exacto_#=value
Estos parámetros especifican un valor mínimo (y/o máximo) que se aplicará a la consulta principal o numerada. El uso de sp_q_min , sp_q_max y sp_q_exacto afecta a la consulta principal ( sp_q ).
Reemplace # en el nombre del parámetro con un número entre 1 y 16 (por ejemplo, sp_q_min_8 se aplica a la consulta numerada sp_q_8 ).
El uso de sp_q_exacto_# es abreviado para especificar sp_q_min_# y sp_q_max_# con el mismo valor. Si se especifica sp_q_exacto_# , se omiten los parámetros correspondientes de sp_q_min_# o sp_q_max_# .
Los parámetros sp_q_min_# , sp_q_max_# y sp_q_exacto_# pueden especificar opcionalmente varios valores separados por "|". Por ejemplo, para buscar documentos que contengan el valor verde o rojo en el campo "color": ...&sp_q_exacto_1=green|red&sp_x_1=color .
33
sp_q_nocp
sp_q _nocp _#
sp_q_nocp= 1 o 0
sp_q_nocp_#= 1 o 0
El valor predeterminado del parámetro es 0 , lo que significa que se realizan expansiones de frase común.
Cuando se establece en 1 para la consulta de búsqueda correspondiente, no se realizan las expansiones de frases comunes.
El uso de sp_q_nocp afecta al parámetro de consulta de búsqueda principal sp_q . Para aplicar este parámetro a una consulta de búsqueda numerada, reemplace # en el nombre del parámetro por el número correspondiente. Por ejemplo, sp_q_nocp_8 se aplica a la consulta de búsqueda numerada sp_q_8 .
34
sp_q_required
sp_q_required _#
sp_q_required= 1 o 0 o -1
sp_q_required_#= 1 o 0 o -1
Este parámetro determina si una coincidencia debe (1), puede (0) o no debe (-1) producirse en la consulta correspondiente para que se devuelva un documento en la página de resultados.
El uso de sp_q_required afecta a la consulta principal ( sp_q ).
Para aplicar a una consulta numerada, reemplace el # en el nombre del parámetro por el número correspondiente (por ejemplo, sp_q_required_8 se aplica a la consulta numerada sp_q_8 ). El valor predeterminado del parámetro es 1 (debe coincidir).
Para buscar documentos que contengan la palabra "calc" pero NO contengan "mac", "win" o "all" en el campo "platform" definido por el usuario, el formulario de búsqueda HTML podría contener las siguientes líneas:
<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
Especifica si se redirige a la dirección URL del resultado de búsqueda si solo hay un resultado de búsqueda.
36
sp_referrer
sp_referrer= url
Especifica la dirección URL del referente para la búsqueda. Útil para las reglas de reescritura de búsqueda donde los resultados de búsqueda se vinculan al mismo sitio que el formulario de búsqueda.
El valor predeterminado es el valor CGI HTTP_REFERRER estándar que proporciona el explorador.
37
sp_ro
sp_ro= campo : relevancia
Permite el control de relevancia, por nombre de campo y tiempo de búsqueda opcional. La cadena "ro" en el nombre del parámetro significa "relevancia". El parámetro acepta uno o más nombres de campo, seguido de dos puntos de carácter, seguido de un valor de relevancia de 0 a 10.
Por ejemplo, para establecer el valor de relevancia del nombre de campo "body" en 10, en el momento en que un cliente realice una búsqueda, el parámetro aparecerá de la siguiente manera:
sp_ro=body:10
O bien, para especificar varias anulaciones de relevancia de campo en la cadena de parámetro, puede utilizar un delimitador de barra vertical. Por ejemplo, para establecer el valor de relevancia de los nombres de campo "body" y "title" en 9, en el momento en que un cliente realice una búsqueda, el parámetro aparecerá de la siguiente manera:
sp_ro=body:9|title:9
Nota: Especificar un campo que no esté involucrado en la búsqueda asociada no tiene ningún efecto. Por ejemplo, si establece sp_ro=title:10 , pero no se busca en el nombre del campo de título, el parámetro sp_ro no tendrá ningún efecto. En otras palabras, si se especifica un nombre de campo con el parámetro sp_ro , no se buscará automáticamente ese campo; en su lugar, solo anula la configuración de relevancia asociada a ese campo.
38
sp_s
sp_s= número
Especifica el orden. Cero (0) es el valor predeterminado y significa ordenar por puntuación de relevancia. Uno (1) significa ordenar por fecha y -1 significa no ordenar.
Puede 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.
Defina la opción Ordenar para el campo al que se hace referencia en Ascendente o Descendente en Configuración > Metadatos > Definiciones para activar esta función.
También puede asignar varios campos de ordenación a una sola consulta estableciendo el parámetro sp_s varias veces en el formulario de búsqueda. Las siguientes líneas de plantilla establecen los resultados de búsqueda que se ordenarán primero por nombre del artista, luego por nombre del álbum y, a continuación, por nombre de la pista.
<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">
También es posible ordenar los datos de campo coincidentes de la tabla especificando un calificador de nombre de tabla antes del nombre del campo, por ejemplo, items.price. Consulte el parámetro sp_field_table para obtener más información sobre la coincidencia de tablas.
Si realiza una búsqueda por proximidad, puede ordenar los resultados según la proximidad especificando un "campo de salida de proximidad".
39
sp_sr
sp_sr= field
Especifica el campo de clasificación que se usará para la clasificación estática. El campo debe ser un campo de tipo Clasificación con relevancia buena a 0. Si no se proporciona ningún parámetro sp_sr para la consulta, se selecciona automáticamente un campo de tipo Clasificación.
Para deshabilitar la clasificación estática de una consulta en particular, incluya un valor NULL para sp_sr (por ejemplo, <input type="hidden" name="sp_sr" value=""> ).
40
sp_sfvl_field
sp_sfvl_field= string
Especifica el nombre de un campo que se utilizará junto con la etiqueta <search-field-value-list> en la plantilla de búsqueda.
Puede especificar varios parámetros sp_sfvl_field .
41
sp_sfvl_df_count
sp_sfvl_df_count= <valor_entero>
Solicita hasta <integer_value> campos de búsqueda-campo-valor-lista de facetas dinámicas para esta búsqueda.
El valor predeterminado es 0. El valor máximo permitido es el número actual de campos de facetas dinámicas, recuento de campos de facetas dinámicas definido para un índice determinado. Los valores enteros inferiores a 0 se tratan como 0. Los valores enteros especificados arriba dynamic-facet-field-count se limitan al recuento de campos de facetas dinámicas . Se omiten los valores no enteros; se tratan como el valor predeterminado.
La búsqueda de una fracción dada se limita con un valor máximo permitido sp_sfvl_df_count del valor de recuento de campos de facetas dinámicas de esta fracción . Al combinar los resultados de la fracción, el valor máximo efectivo de sp_sfvl_df_count es el máximo de sp_sfvl_df_count real en todas las divisiones.
42
sp_sfvl_df_exclude
sp_sfvl_df_exclude= < nombre_campo >[|< nombre_campo >|...
Especifica una lista de campos de facetas dinámicas específicos para excluir de la consideración de esta búsqueda.
De forma predeterminada, se tienen en cuenta todos los campos de facetas dinámicas.
43
sp_sfvl_df_include
sp_sfvl_df_include= < nombre_campo >[|< nombre_campo >|...
Especifica una lista de campos de facetas dinámicas específicos que se incluirán en los resultados de búsqueda.
Nota: El parámetro sp_sfvl_df_count determina el número total de campos de facetas dinámicas que se devolverán, incluido cualquier especificado mediante sp_sfvl_df_include . Es decir, el uso de sp_sfvl_df_include no permite que el recuento total de campos de facetas dinámicas devueltos supere sp_sfvl_df_count .
44
sp_staged
sp_staged= 0 o 1
Si sp_staged=1 se envía con una consulta, la consulta que se ejecuta es una búsqueda por etapas.
Una búsqueda por etapas utiliza todos los componentes que se encuentran actualmente por etapas, incluidos el índice y las plantillas.
45
sp_start_day, sp_start_month, sp_start_year
sp_start_day= número
sp_start_month= número
sp_start_year= número
Este triplete de valores especifica el intervalo de fechas de inicio de la búsqueda y se proporciona como un conjunto.
46
sp_ sugerir _q
sp_offer_q= número
El parámetro sp_offer_q determina qué parámetro sp_q[_#] utilizar con el servicio Sugerir.
El valor predeterminado de sp_offer_q es 0, lo que significa que el motor de búsqueda utiliza el valor de sp_q para determinar las sugerencias.
Establezca sp_offer_q=1 para utilizar el valor de sp_q_1 para determinar las sugerencias, etc.
47
sp_t
sp_t= cadena
Especifica la plantilla de transporte que se va a utilizar.
Este parámetro es útil si desea controlar la apariencia de los resultados de búsqueda principales en el sitio web mediante el uso de distintas plantillas de transporte de búsqueda para cada área de la cuenta de búsqueda.
La plantilla de transporte predeterminada es "search".
48
sp_trace
sp_trace= 0 o 1
Cuando se configura como sp_stage=1 , habilita la capacidad de seguimiento de búsqueda principal en el simulador.
Nota: Si no se especifica este parámetro, la búsqueda principal no recopila la información de seguimiento y las etiquetas de plantilla de búsqueda principal relacionadas no tienen salida.
49
sp_w, sp_w_control
sp_w= sound-alike-enable
sp_w_control= sound-alike-control
Especifica que la coincidencia de sonido similar debe habilitarse o deshabilitarse para esta consulta en particular.
Se omite sp_w_control para "Exact". La coincidencia de ambos sonidos está deshabilitada.
Se omite sp_w_control para "Alike". Coincidencia de sonido similar habilitada
sp_w_control para Cualquiera es 1. La coincidencia de ambos sonidos está deshabilitada.
El sp_w_control para Cualquiera es cualquier otra cosa. La coincidencia de ambos sonidos está habilitada.
El parámetro sp_w_control permite crear una casilla de verificación con una redacción negativa o positiva para el control del usuario final de la coincidencia de sonido.
Si se utiliza sp_w_control=0 , se utiliza una casilla de verificación con una redacción negativa para establecer el parámetro sp_w como en el siguiente ejemplo:
<input type=hidden name="sp_w_control" value="0"><input type=checkbox name="sp_w" value="exact">No Sound-Alike matching
Si se utiliza sp_w_control=1 , se utiliza una casilla de verificación con una redacción positiva para establecer el parámetro sp_w como se indica a continuación:
<input type=hidden name="sp_w_control" value="1"><input type=checkbox name="sp_w" value="alike">Sound-Alike matching
Consulte el formulario de búsqueda avanzada de ejemplo para obtener más ejemplos sobre el uso de los parámetros sp_w_control y sp_w .
50
sp_x
sp_x= field
Especifica los campos en los que se buscará la cadena de consulta. por cualquier medio, busque todos los campos. title significa buscar solo campos de título. desc significa buscar sólo campos de descripción del documento. key significa buscar sólo palabras clave del documento. body significa buscar solo texto principal. alt significa buscar solo texto alternativo. url significa buscar solamente los valores de la dirección URL. target significa que la búsqueda solo dirige las palabras clave. En cualquiera de estos casos, se omiten las especificaciones del usuario de los prefijos de campo "text:", "desc:", "keys:", "body:", "alt:", "url:" y "target:" dentro del parámetro sp_q correspondiente. Si sp_x no está presente o si está establecido en una cadena vacía o cualquiera, se permiten los prefijos de campo de usuario estándar. Consulte la descripción de las sugerencias de búsqueda para obtener más información sobre los prefijos de campo.
Consulte la descripción del formulario de búsqueda avanzada de ejemplo para ver ejemplos de uso del parámetro sp_x .
Puede crear consultas que busquen en todos los campos definidos como Buscar por defecto en Opciones > Metadatos > Definiciones estableciendo sp_x=any . Los campos predefinidos y los definidos por el usuario pueden utilizarse como el valor del parámetro sp_x .
También puede asignar varios campos a una sola consulta estableciendo el parámetro sp_x varias veces. Las siguientes líneas de plantilla permiten a los usuarios consultar los campos "título" y "autor" para "Buenos libros".
<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_#= field-name
Este parámetro especifica qué campo buscar en la consulta sp_q_# correspondiente. El # se sustituye por un número entre 1 y 16 (por ejemplo, sp_x_8 ). El campo field-name es cualquier campo predefinido o definido por el usuario.
Si no se proporciona ningún parámetro sp_x_# para una consulta numerada concreta, esa consulta buscará todos los campos definidos como Buscar de forma predeterminada tal como se define en Configuración > Metadatos > Definiciones .
Por ejemplo, al enviar el siguiente formulario se devuelven todos los documentos que contienen la palabra "bueno" que también contienen la palabra "Fitzgerald" en el campo "autor":
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">
Puede asociar varios nombres de campo con una consulta o consulta numerada en particular proporcionando más de una instancia del mismo parámetro sp_x o sp_x_# en una sola solicitud de búsqueda.
Por ejemplo, para buscar la palabra "flor" en los campos "cuerpo" y "claves", puede crear un formulario de búsqueda con la siguiente información:
<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">

Ejemplo típico de uso de parámetros CGI de búsqueda back-end

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 el HTML, este vínculo debe estar en una sola 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, debe utilizar parámetros predeterminados al iniciar una búsqueda. De este modo, se muestra la primera página, ordenada 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.

Ejemplo detallado del uso de parámetros CGI de búsqueda back-end

Las siguientes consultas de formulario muestran 25 los resultados empezando por el resultado 10 . No se muestran los resúmenes, el orden es por fecha y se utiliza la colección denominada support . Sólo se devuelven los documentos fechados en 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>