Show Menu
TÓPICOS×

Parâmetros CGI

Parâmetros CGI

Pesquisar parâmetros CGI

O código do formulário de pesquisa é fornecido para que você possa copiar e colar no HTML do seu site ( Design > Auto-Complete > Form Source ).
Também é possível definir os parâmetros listados no próprio formulário de pesquisa ou em um script. Além dos parâmetros listados abaixo, também é possível usar os parâmetros de pesquisa de backend para controlar a pesquisa.
Consulte Parâmetros CGI de pesquisa de backend.
As solicitações de pesquisa consistem em um URL base. O URL básico indica que conta o cliente está pesquisando e um conjunto de parâmetros CGI (pares de valores chave) que indicam como retornar os resultados de pesquisa desejados para a conta associada.
O URL básico está associado a uma conta específica e a um ambiente ativo ou temporário. Você pode solicitar vários aliases para o URL básico do seu gerente de conta. Por exemplo, uma empresa chamada Megacorp pode ter dois URLs básicos associados à conta: https://search.megacorp.com e https://stage.megacorp.com . O URL anterior pesquisa seu índice ativo e o último URL pesquisa seu índice de preparo.
Há suporte para três formatos de Parâmetros CGI. Por padrão, sua conta é configurada para separar Parâmetros CGI com ponto-e-vírgula, como no exemplo a seguir:
https://search.megacorp.com?q=shoes;page=2
Se preferir, você pode fazer com que seu gerente de conta configure sua conta para usar e comercial para separar os parâmetros CGI, como no exemplo a seguir:
https://search.megacorp.com?q=shoes&page=2
Um terceiro formato, chamado de formato SEO, também é suportado quando uma barra / é usada no lugar do separador e sinal de igual como no exemplo a seguir:
https://search.megacorp.com/q/shoes/page/2
Sempre que o formato SEO for usado para enviar uma solicitação, todos os links de saída serão retornados no mesmo formato.
Parâmetro Pesquisa guiada
Exemplo
Descrição
q
q=string
Especifica a string de consulta para a pesquisa. Esse parâmetro mapeia para o parâmetro de pesquisa de sp_q backend. Consulte Parâmetros CGI de pesquisa de backend.
q#
q#=string
A facetagem (pesquisa em um determinado campo) é feita por meio de parâmetros q e x numerados. O parâmetro q define o termo que você está procurando na faceta, como denotado pelo parâmetro x numerado correspondente.
Por exemplo, se você tiver duas facetas nomeadas tamanho e cor, poderá ter algo como q1=small;x1=size;q2=red;x2=color. Esse parâmetro mapeia para os parâmetros de pesquisa de sp_q_exact_# backend.
Consulte Parâmetros CGI de pesquisa de backend.
x#
q#=string
A facetagem (pesquisa em um determinado campo) é feita por meio de parâmetros q e x numerados. O parâmetro q define o termo que você está procurando na faceta, como denotado pelo parâmetro x numerado correspondente.
Por exemplo, se você tiver duas facetas nomeadas tamanho e cor, poderá ter algo como q1=small;x1=size;q2=red;x2=color. Esse parâmetro mapeia para os parâmetros de pesquisa de sp_x_# backend.
Consulte Parâmetros CGI de pesquisa de backend.
coleção
collection=string
Especifica a coleção a ser usada para a pesquisa. Esse parâmetro mapeia para o parâmetro de pesquisa de sp_k backend. Consulte Parâmetros CGI de pesquisa de backend.
count
count=number
Especifica a contagem total de resultados que são mostrados. O padrão é definido em Settings > Searching > Searches. . Esse parâmetro mapeia para o parâmetro de pesquisa de sp_c backend. Consulte Parâmetros CGI de pesquisa de backend.
página
page=number
Especifica a página de resultados que são retornados.
classificação
rank=field
Especifica o campo de classificação a ser usado para classificação estática. O campo deve ser do tipo Classificação com relevância maior que 0. Esse parâmetro mapeia para o parâmetro sp_sr backend. Consulte Parâmetros CGI de pesquisa de backend.
espécie
sort=number
Especifica a ordem de classificação.
"0" é o padrão e classifica por pontuação de relevância; "1" ordena por data; "-1" não classifica. Os usuários podem especificar um nome de campo para o valor do sp_s parâmetro. Por exemplo, sp_s=title classifica os resultados de acordo com os valores contidos no campo de título. Quando um nome de campo é usado para o valor de um sp_s parâmetro, os resultados são classificados por esse campo e, em seguida, subclassificados por relevância. To enable this feature, click Settings > Metadata > Definitions. Na página Definições, clique Add New Field ou clique Edit para obter um nome de campo específico. Na lista Sorting suspensa, selecione Ascending ou Descending. Esse parâmetro mapeia para o parâmetro de pesquisa de sp_s backend.
Consulte Parâmetros #backend.(../c-appendices/c-cgiparameters.md#reference_582E85C3886740C98FE88CA9DF7918E8).

Parâmetros CGI de pesquisa de backend

Normalmente, os clientes interagem com uma camada de apresentação chamada Pesquisa guiada. No entanto, é teoricamente possível ignorar a camada de Pesquisa guiada e interagir com a pesquisa principal de backend diretamente usando os parâmetros CGI descritos nesta página.
Você pode selecionar parâmetros CGI de pesquisa de backend na seguinte tabela:
Suporte a consulta única
Suporte a várias consultas
Exemplos
Descrição
1
sp_a
sp_a= string
Especifica a string do número da conta. Esse parâmetro é obrigatório e deve ser uma string válida de número de conta. Você pode encontrar sua string de número de conta em Configurações > Opções de conta > Configurações da conta .
2
sp_advanced
sp_advanced= 0 ou 1
Se sp_advanced=1 for submetido com uma consulta, então todo o código entre a tag <search-if-advanced> e a tag </search-if-advanced> no modelo de pesquisa será usado para o formulário de pesquisa. Todo o código entre a tag <search-if-not-advanced> e a tag </search-if-not-advanced> é ignorado. Se sp_advanced=0 (ou qualquer outro valor) for submetido, o bloco de modelo <search-if-advanced> será ignorado e o bloco de modelo <search-if-not-advanced> será usado.
3
sp_c
sp_c= número
Especifica a contagem total de resultados a serem exibidos. O padrão é 10.
4
sp_context_field
sp_context_field= field
Coleta informações contextuais para o campo em questão. As informações coletadas são geradas nos resultados da pesquisa por meio da tag de modelo <search-context> . O valor padrão é body .
5
sp_d
sp_d= tipo
Especifica o tipo de pesquisa do intervalo de datas a ser executado. Os valores possíveis para o tipo são quaisquer, o que significa que não realiza pesquisa por intervalo de datas, personalizado, que indica que o valor de sp_date_range deve ser usado para determinar as datas de pesquisa, e específico, que indica que os valores em sp_start_day , sp_start_month, _start_year , sp_end_day, e sp_end_year usado para determinar o intervalo de datas a ser pesquisado. sp_d é necessário somente se o formulário de pesquisa contiver a opção de pesquisar por um intervalo personalizado (por meio de sp_date_range ) ou por um intervalo de datas inicial e final específico.
6
sp_d_#
sp_d_#= type
Especifica o tipo de pesquisa do intervalo de datas a ser executado para a consulta sp_q_# correspondente. O "#" é substituído por um número entre 1 e 16 (por exemplo, sp_d_8 , se aplica à consulta numerada sp_q_8 ).
Você pode definir o tipo como qualquer um, o que significa não executar pesquisa no intervalo de datas, personalizado, que indica que o valor de _date_range_# é usado para determinar as datas de pesquisa, e específico, que indica que os valores em sp_q_min_day_# , _q_month_# , _q_year_# , sp_q_max_day_# , sp_q_max_month_#, e sp_q_max_year_# devem ser usadas para determinar o intervalo de datas. O uso de sp_d_# só é necessário se o formulário de pesquisa contiver a opção de pesquisar por um intervalo personalizado (por meio de sp_date_range_# ) ou por um intervalo de datas inicial e final específico.
7
sp_date_range
sp_date_range= number
Especifica um intervalo de datas predefinido a ser aplicado à pesquisa. Valores maiores ou iguais a zero especificam o número de dias para pesquisar antes de hoje — por exemplo, um valor de "0" especifica "hoje", um valor de "1" especifica "hoje e ontem", um valor de "30" especifica "nos últimos 30 dias" e assim por diante.
Valores abaixo de zero especificam um intervalo personalizado da seguinte maneira:
-1 = "Nenhum", o mesmo que não especificar um intervalo de datas.
-2 = "Esta semana", que pesquisa de domingo a sábado da semana atual.
-3 = "Última semana", que pesquisa de domingo a sábado da semana anterior à semana atual.
-4 = "Este mês", que pesquisa datas dentro do mês atual.
-5 = "Último mês", que pesquisa datas dentro do mês anterior ao mês atual.
-6 = "Este ano", que pesquisa datas dentro do ano atual.
-7 = "Ano passado", que pesquisa datas no ano anterior ao ano atual.
8
sp_date_range_#
sp_date_range_#= number
Especifica um intervalo de datas predefinido a ser aplicado à consulta sp_q_# correspondente. O "#" é substituído por um número entre 1 e 16 (por exemplo, sp_date_range_8 , se aplica à consulta numerada sp_q_8 ).
Valores maiores ou iguais a zero especificam o número de dias para pesquisar antes de hoje. Por exemplo, um valor de 0 especifica hoje; um valor de 1 especifica hoje e ontem; um valor de 30 especifica nos últimos 30 dias e assim por diante.
Valores abaixo de zero especificam um intervalo personalizado da seguinte maneira:
-1 = "Nenhum", o mesmo que não especificar um intervalo de datas.
-2 = "Esta semana", que pesquisa de domingo a sábado da semana atual.
-3 = "Última semana", que pesquisa de domingo a sábado da semana anterior à semana atual.
-4 = "Este mês", que pesquisa datas dentro do mês atual.
-5 = "Último mês", que pesquisa datas dentro do mês anterior ao mês atual.
-6 = "Este ano", que pesquisa datas dentro do ano atual.
-7 = "Ano passado", que pesquisa datas no ano anterior ao ano atual.
9
sp_dedupe_field
sp_dedupe_field= fieldname
Especifica um único campo no qual os resultados da pesquisa serão removidos. Todos os resultados duplicados nesse campo são removidos dos resultados da pesquisa. Por exemplo, se para sp_dedupe_field=title , somente o resultado superior de um determinado título é exibido nos resultados da pesquisa (nenhum dos dois resultados terá conteúdo de campo de título idêntico). Para campos do tipo de vários valores (lista de permissões), todo o conteúdo do campo é usado para comparação. Somente um campo pode ser especificado. Um "qualificador de tabela" não é permitido no nome do campo.
10
sp_e
sp_e= número
Especifica que a expansão automática de caracteres curinga deve ocorrer para qualquer palavra da string de consulta com mais de caracteres numéricos. Em outras palavras, sp_e=5 especifica que palavras com 5 ou mais caracteres, como "consulta" ou "número", devem ser expandidas com o caractere curinga '*', tornando a pesquisa equivalente a uma pesquisa por "consulta*" ou "número*". Palavras com menos caracteres não são expandidas, portanto, uma pesquisa por "palavra" não teria expansão automática de caracteres curinga.
11
sp_e_#
sp_e_#= número
Especifica que a expansão automática de caracteres curinga ocorre para qualquer palavra da string de consulta sp_q_# correspondente com mais de caracteres numéricos. Em outras palavras, sp_e_2=5 especifica que palavras com cinco ou mais caracteres na string de consulta sp_q_2, como "query" ou "number", devem ser expandidas com o caractere curinga ' * ', tornando a pesquisa equivalente a uma pesquisa por "query*" ou "number*". Palavras com menos caracteres não são expandidas, portanto, uma pesquisa por "palavra" em sp_q_2 não teria expansão automática de caracteres curinga.
12
sp_end_day, sp_end_month, sp_end_year
sp_end_day= number ,sp_end_month= number , sp_end_year= number
Esse triplo de valores especifica o intervalo de datas final para a pesquisa e deve ser fornecido como um conjunto.
13
sp_f
sp_f= string
Especifica o conjunto de caracteres das sequências de caracteres do parâmetro de consulta (como sp_q ). Essa string deve sempre corresponder ao conjunto de caracteres da página que contém o formulário de pesquisa.
14
sp_field_table
sp_field_ table=table: field,field...
Define uma tabela de dados lógica que consiste nos campos especificados. Por exemplo, uma tabela chamada "itens" que consiste nos campos "cor", "tamanho" e "preço" seria definida como:
sp_field_table=items:color,size,price
Tabelas lógicas são mais úteis em conjunto com campos que têm a opção "Permitir listas" marcada (em Configurações > Metadados > Definições ). Todos os parâmetros CGI e tags de modelo que usam um nome de campo como um valor podem, opcionalmente, especificar um nome de tabela seguido por um "". antes do nome do campo (por exemplo, sp_x_1=tablename.fieldname ).
Por exemplo, para realizar uma pesquisa por documentos que contêm um ou mais itens "vermelhos" de tamanho "grande" (onde os itens são representados como linhas paralelas de metadados), você pode usar o seguinte:
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
Ignora a pesquisa quando você gera relatórios.
Use essa consulta para mascarar determinadas pesquisas de backend, como pesquisas geradas pelo Você quis dizer ou pesquisas geradas por um Administrador no centro membro. Como um usuário final não gera esses tipos de pesquisa, eles não são exibidos em vários relatórios do Adobe Search&Promote.
Os valores válidos são sp_i=1 e sp_i=2 .
16
sp_k
sp_k= string
Especifica a coleção a ser usada para a pesquisa. O padrão é nenhuma coleção, o que significa que a pesquisa deve incluir o site inteiro.
17
sp_l
sp_l= string
Especifica o idioma das strings de parâmetro de consulta (como sp_q ). A sequência de caracteres deve ser uma ID de localidade padrão contendo um código de idioma ISO-639 seguido opcionalmente por um código de país ISO-3166. Por exemplo, "en" ou "en_US" para inglês ou "ja" ou "ja_JP" para japonês.
18
sp_literal
sp_literal= 0 ou 1
A configuração sp_literal=1 desativa temporariamente todos os recursos que podem interpretar as palavras na consulta. Com esse parâmetro, somente as palavras literais da consulta correspondem a documentos, independentemente de sinônimos, formulários de palavras alternativas e correspondência de som.
Observe que sp_literal=0 não tem significado e é ignorado se for usado.
19
sp_m
sp_m= número
Especifica se os resumos são exibidos. 1 é sim, 0 é não. O padrão é 1.
20
sp_n
sp_n= número
Especifica o número do resultado que inicia os resultados da pesquisa. O padrão é 1.
21
sp_not_found_page
sp_not_found_page= url
Especifica se é necessário redirecionar para o URL especificado se não houver resultados de pesquisa.
22
sp_p
sp_p= any/all/frase
Especifica o tipo padrão de pesquisa a ser executado. O uso de qualquer meio significa pesquisar documentos que contenham qualquer palavra da string de consulta. O uso de todos significa procurar documentos que contenham todas as palavras na string de consulta. O uso de frase significa que a string de consulta é tratada como se fosse uma frase citada e todas as aspas digitadas pelo usuário são ignoradas.
Para frase e todos , a especificação de "+" e "-" antes das palavras de pesquisa é desativada e esses caracteres são ignorados. Se sp_p não estiver presente, ou se estiver definida como uma string vazia ou qualquer outra, os prefixos de palavras "+" e "-" padrão são permitidos.
Consulte a descrição das Dicas de pesquisa para obter mais informações sobre como usar mais ("+") e menos ("-") em pesquisas.
Consulte o formulário de pesquisa avançada de exemplo para obter exemplos sobre como usar o parâmetro sp_p .
23
sp_p_#
sp_p_#= any/all/frase
Especifica o tipo padrão de pesquisa a ser realizada com a consulta sp_q_# correspondente. O "#" é substituído por um número entre 1 e 16 (por exemplo, sp_p_8 se aplica à consulta numerada sp_q_8 ). O uso de qualquer meio para retornar documentos que contenham qualquer palavra da string de consulta. O uso de todos significa documentos de retorno que contêm todas as palavras na string de consulta. O uso de frase significa tratar a string de consulta como se fosse uma frase completa (e todas as aspas digitadas pelo usuário são ignoradas).
Se você especificar todas as palavras ou frases , todos os sinais de mais e menos antes das palavras de pesquisa serão ignorados. Se sp_p_# for omitido, ou se estiver definido como uma string vazia ou qualquer prefixo , são permitidos os prefixos "+" e "-" padrão.
24
sp_pt
sp_pt= exact/equivalent/compatible
Especifica o tipo de correspondência de destino a ser aplicado. O uso de exatas significa que o destino do rendimento corresponde somente a documentos que correspondem exatamente à sequência de caracteres de consulta no conteúdo de destino. O uso do equivalente é exatamente igual, exceto que a ordem das palavras não é importante. O uso de compatível define automaticamente o tipo de correspondência de destino com base no valor do parâmetro sp_p . O uso de exato é usado se sp_p for tudo ou frase , caso contrário é usado o equivalente . O valor padrão de sp_pt é compatível .
25
sp_pt_#
sp_pt_#= exact/equivalent/compatible
Especifica o tipo de correspondência de destino a ser aplicado com a consulta sp_q_# correspondente. O "#" é substituído por um número entre 1 e 16 (por exemplo, sp_p_8 se aplica à consulta numerada sp_q_8 ). O uso de exatas significa que o destino do rendimento corresponde somente a documentos que correspondem exatamente à sequência de caracteres de consulta no conteúdo de destino. O uso do equivalente é como exato , exceto que a ordem das palavras não é importante. O uso de compatível define automaticamente o tipo de correspondência de destino com base no valor do parâmetro sp_p_# correspondente: exato é usado se sp_p_# for tudo ou frase, caso contrário, é equivalente . O valor padrão de sp_pt_# é compatível .
26
sp_q
sp_q= string
Especifica a string de consulta para a pesquisa. Uma string vazia leva a que nenhum resultado seja exibido.
27
sp_q_#
sp_q_#= texto
Esse parâmetro permite a criação de várias consultas em formulários de pesquisa. O parâmetro sp_q_# contém a string de consulta a ser usada na consulta numerada fornecida. Uma solicitação de pesquisa pode fazer referência a até 16 consultas numeradas diferentes ( sp_q_1 para sp_q_16 ).
Por exemplo, o envio do formulário a seguir retorna todos os documentos que contêm as palavras "ótimo" e "livros".
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 inteiro
sp_q_month= valor inteiro
sp_q_year= valor inteiro
sp_q_day_#= valor inteiro
sp_q_month_#= valor inteiro
sp_q_year_#= valor inteiro
Esses parâmetros são usados para especificar uma data exata para uma consulta específica. Os parâmetros sp_q_day , sp_q_month e sp_q_year se aplicam à consulta principal ( sp_q ).
O # parâmetro é substituído por um número entre 1 e 16 (por exemplo, sp_q_day_6 , que se aplica à consulta numerada sp_q_6 ). Por padrão, todas as datas são pesquisadas em relação ao Tempo médio de Greenwich.
A seguinte seção do código permite que o usuário pesquise a palavra "laranja" em documentos com data de "Jan. 1º, 2000" em um campo definido pelo usuário chamado PublicarData :
<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
Esses parâmetros associam um local à consulta principal ou numerada. O uso de sp_q_location afeta a consulta principal, sp_q_location_# (onde # é substituído por um número de 1 a 16), afeta a consulta numerada fornecida. Esses parâmetros são usados para realizar pesquisas de proximidade de distância mínima e/ou máxima em relação aos dados de localização indexados para cada página do site. O formato do valor determina sua interpretação.
Um valor na forma DDD (três dígitos) é interpretado como uma área telefônica dos EUA; um valor na forma DDDDD ou DDDDD-DDDD é interpretado como um código postal dos EUA; e um valor na forma ±DD.DDDD±DDD.DDDD é interpretado como um par de latitude/longitude. Os sinais são necessários para cada valor. Por exemplo, +38.6317+120.5509 especifica latitude 38.6317, 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
Esses parâmetros controlam o cálculo de relevância aplicado às pesquisas de proximidade. O uso de sp_q_max_relevant_distance afeta a consulta principal, sp_q_max_relevant_distance_# (onde # é substituído por um número de 1 a 16), afeta a consulta numerada fornecida.
O valor padrão de sp_q_max_relevant_distance é 100.
Uma pontuação de relevância perfeita para o componente de proximidade representaria uma distância de 0. Uma pontuação de relevância mínima para o componente de proximidade representaria uma distância bem acima do 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
Esses parâmetros são usados para definir intervalos de datas mínimos e máximos para uma consulta específica. Os parâmetros sp_q_min_day , sp_q_min_month , sp_q_min_year , sp_q_max_day , sp_q_max_month e os parâmetros sp_q_max_year aplicam-se à consulta principal ( _q).
O # no nome do parâmetro é substituído por um número entre 1 e 16 (por exemplo, sp_q_min_day_6 se aplica à consulta numerada sp_q_6 ).
É legal especificar apenas uma data mínima, apenas uma data máxima ou ambas as datas mínima e máxima. No entanto, para um determinado conjunto mínimo ou máximo, todos os três parâmetros de data devem ser especificados (dia, mês e ano). Por padrão, todas as datas são pesquisadas em relação ao Tempo médio de Greenwich.
A seguinte seção do código permite que um usuário pesquise a palavra "laranja" em documentos com uma data entre 1º de janeiro de 2000 e 31 de dezembro de 2000 em um campo definido pelo usuário chamado Data de publicação :
<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 _exato_#
sp_q_min= valor
sp_q_max= valor
sp_q_min_#= valor
sp_q_max_#= valor
sp_q_exato_#=value
Esses parâmetros especificam um valor mínimo (e/ou máximo) a ser aplicado à consulta principal ou numerada. O uso de sp_q_min , sp_q_max e sp_q_exato afeta a consulta principal ( sp_q ).
Substitua # no nome do parâmetro por um número entre 1 e 16 (por exemplo, sp_q_min_8 se aplica à consulta numerada sp_q_8 ).
O uso de sp_q_exato_# é abreviado para especificar sp_q_min_# e sp_q_max_# com o mesmo valor. Se sp_q_exato_# for especificado, quaisquer parâmetros sp_q_min_# ou sp_q_max_# correspondentes serão ignorados.
Os parâmetros sp_q_min_# , sp_q_max_# e sp_q_exato_# podem, opcionalmente, especificar vários valores separados "|". Por exemplo, para procurar documentos que contenham o valor verde ou vermelho no campo "color": ...&sp_q_exatas_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
O valor padrão do parâmetro é 0, o que significa que as expansões de Frase Comum são executadas.
Quando definido como 1 para a consulta de pesquisa correspondente, as expansões de Frases Comuns não são executadas.
O uso de sp_q_nocp afeta o parâmetro de consulta de pesquisa principal sp_q . Para aplicar esse parâmetro a uma consulta de pesquisa numerada, substitua # no nome do parâmetro pelo número correspondente. Por exemplo, sp_q_nocp_8 se aplica à consulta de pesquisa numerada sp_q_8 .
34
sp_q_required
sp_q _obrigatório _#
sp_q_required= 1 ou 0 ou -1
sp_q_required_#= 1 ou 0 ou -1
Esse parâmetro determina se uma correspondência deve (1), pode (0) ou não deve ocorrer (-1) na consulta correspondente para que um documento seja retornado na página de resultado.
O uso de sp_q_required afeta a consulta principal ( sp_q ).
Para aplicar a uma consulta numerada, substitua o # no nome do parâmetro pelo número correspondente (por exemplo, sp_q_required_8 se aplica à consulta numerada sp_q_8 ). O valor padrão do parâmetro é 1 (deve corresponder).
Para procurar documentos que contenham a palavra "calc", mas NÃO contenham "mac", "win" ou "all" no campo "platform" definido pelo usuário, o formulário de pesquisa HTML pode conter as seguintes linhas:
<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 se é necessário redirecionar para o URL do resultado da pesquisa se houver apenas um resultado da pesquisa.
36
sp_referrer
sp_referrer= url
Especifica o URL do referenciador para a pesquisa. Útil para regras de regravação de pesquisa nas quais os resultados da pesquisa são vinculados de volta ao mesmo site que o formulário de pesquisa.
O valor padrão é o valor padrão CGI HTTP_REFERRER fornecido pelo navegador.
37
sp_ro
sp_ro= campo : relevância
Permite tempo de pesquisa opcional, por nome de campo, controle de relevância. O ou no nome do parâmetro significa "substituição de relevância". O parâmetro aceita um ou mais nomes de campo, seguidos por um caractere de dois pontos, seguido por um valor de relevância de 0 a 10.
Por exemplo, para definir o valor de relevância para o nome de campo "body" como 10, no momento em que um cliente realiza uma pesquisa, o parâmetro aparece da seguinte forma:
sp_ro=body:10
Ou, para especificar várias substituições de relevância de campo na string do parâmetro, é possível usar um delimitador de barra vertical. Por exemplo, para definir o valor de relevância para os nomes de campo "body" e "title" como 9, no momento em que um cliente realiza uma pesquisa, o parâmetro aparecerá da seguinte forma:
sp_ro=body:9|title:9
Observação: A especificação de um campo que não esteja envolvido na pesquisa associada não tem efeito. Por exemplo, se você definir sp_ro=title:10 , mas o nome do título do campo não for pesquisado, o parâmetro sp_ro não terá efeito. Em outras palavras, a especificação de um nome de campo usando o parâmetro sp_ro não pesquisa automaticamente esse campo; em vez disso, ele apenas substitui a configuração de relevância associada a esse campo.
38
sp_s
sp_s= número
Especifica a ordem de classificação. Zero (0) é o padrão e o meio para classificar por pontuação de relevância. Um (1) significa classificar por data e -1 significa não classificar.
Você pode especificar um nome de campo para o valor do parâmetro sp_s . Por exemplo, sp_s=title classifica os resultados de acordo com os valores contidos no campo de título. Quando um nome de campo é usado para o valor de um parâmetro sp_s , os resultados são classificados por esse campo e, em seguida, subclassificados por relevância.
Defina Classificação para o campo referenciado como Crescente ou Decrescente em Configurações > Metadados > Definições para ativar esse recurso.
Também é possível atribuir vários campos de classificação a uma única consulta definindo o parâmetro sp_s várias vezes no formulário de pesquisa. As linhas de modelo a seguir definem os resultados da pesquisa a serem classificados primeiro por nome de artista, depois por nome de álbum e, em seguida, por nome de rastreamento.
<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">
Também é possível classificar na tabela dados de campo correspondentes especificando um qualificador de nome de tabela antes do nome do campo, por exemplo, items.price. Consulte o parâmetro sp_field_table para obter mais informações sobre a correspondência de tabelas.
Se você pesquisar por proximidade, poderá classificar os resultados de acordo com a proximidade especificando um "campo de saída de proximidade".
39
sp_sr
sp_sr= campo
Especifica o campo de classificação a ser usado para classificação estática. O campo deve ser do tipo Classificação com relevância maior que 0. Se nenhum parâmetro sp_sr for fornecido para a consulta, um campo do tipo Classificação será selecionado automaticamente.
Para desativar a classificação estática para uma consulta específica, inclua um valor NULL para sp_sr (por exemplo, <input type="hidden" name="sp_sr" value=""> ).
40
sp_sfvl_field
sp_sfvl_field= string
Especifica o nome de um campo a ser usado juntamente com a tag <search-field-value-list> no modelo de pesquisa.
Você pode especificar vários parâmetros sp_sfvl_field .
41
sp_sfvl_df_count
sp_sfvl_df_count= <valor_inteiro>
Solicita até <integer_value> campos de pesquisa-campo-valor-lista- de facetas dinâmicas para esta pesquisa.
O valor padrão é 0. O valor máximo permitido é o número atual de campos de aspecto dinâmico, contagem de campos de aspecto dinâmico definida para um determinado índice. Valores inteiros abaixo de 0 são tratados como 0. Os valores inteiros especificados acima de dynamic-facet-field-count são limitados a dynamic-facet-field-count . Valores que não sejam inteiros são ignorados; são tratados como valor padrão.
Uma determinada pesquisa de fatia é limitada com um valor máximo permitido sp_sfvl_df_count do valor dynamic-facet-field-count dessa fatia . Ao mesclar os resultados da fatia, o valor máximo efetivo de sp_sfvl_df_count é o valor máximo real sp_sfvl_df_count em todas as fatias.
42
sp_sfvl_df_exclude
sp_sfvl_df_exclude= < nome_do_campo >[|< nome_do_campo >|...
Especifica uma lista de campos de aspecto dinâmico específicos a serem excluídos da consideração para esta pesquisa.
Por padrão, todos os campos de aspecto dinâmico são considerados.
43
sp_sfvl_df_include
sp_sfvl_df_include= < nome_do_campo >[|< nome_do_campo >|...
Especifica uma lista de campos de aspecto dinâmico específicos a serem incluídos nos resultados da pesquisa.
Observação: O parâmetro sp_sfvl_df_count determina o número total de campos de aspecto dinâmicos a serem retornados, incluindo qualquer especificado por meio de sp_sfvl_df_include . Ou seja, usar sp_sfvl_df_include não permite que a contagem total de campos de facetas dinâmicas retornados exceda sp_sfvl_df_count .
44
sp_staged
sp_staged= 0 ou 1
Se sp_staged=1 for submetido com uma consulta, a consulta executada será uma pesquisa em etapas.
Uma pesquisa por etapas usa todos os componentes que estão preparados no momento, incluindo o índice e os modelos.
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
Esse triplo de valores especifica o intervalo de datas inicial da pesquisa e você o fornece como um conjunto.
46
sp_ sugere _q
sp_Sudan_q= número
O parâmetro sp_sugestivo_q determina qual parâmetro sp_q[_#] deve ser usado com o serviço Sugestão.
O valor padrão de sp_sugestivo_q é 0, o que significa que o mecanismo de pesquisa usa o valor de sp_q para determinar as sugestões.
Defina sp_sugestivo_q=1 para usar o valor de sp_q_1 para determinar as sugestões e assim por diante.
47
sp_t
sp_t= string
Especifica o modelo de transporte a ser usado.
Esse parâmetro é útil se você deseja controlar a aparência dos principais resultados de pesquisa em seu site usando diferentes modelos de transporte de pesquisa para cada área na sua conta de pesquisa.
O modelo de transporte padrão é "pesquisar".
48
sp_trace
sp_trace= 0 ou 1
Quando definido como sp_stage=1, ativa o recurso principal de rastreamento de pesquisa no Simulator.
Observação: Se esse parâmetro não for especificado, a pesquisa principal não coletará as informações de rastreamento e as tags do modelo de pesquisa principal relacionadas não terão saída.
49
sp_w, sp_w_control
sp_w= sound-alike-enable
sp_w_control= sound-alike-control
Especifica que a correspondência de som semelhante deve ser ativada ou desativada para esta consulta específica.
O sp_w_control para "Exato" é Ignorado. A correspondência de som é Desativada.
O sp_w_control para "Alike" é Ignorado. A correspondência de som semelhante está ativada
O sp_w_control para qualquer outra opção é 1. A correspondência de som é Desativada.
O sp_w_control para qualquer outra coisa é qualquer outra. A correspondência de som é Ativada.
O parâmetro sp_w_control permite criar uma caixa de seleção com palavras negativas ou positivas para o controle do usuário final de correspondência de som.
Se sp_w_control=0 for usado, uma caixa de seleção com palavras negativas é usada para definir o parâmetro sp_w como no exemplo a seguir:
<input type=hidden name="sp_w_control" value="0"><input type=checkbox name="sp_w" value="exact">No Sound-Alike matching
Se sp_w_control=1 for usado, uma caixa de seleção com uma palavra positiva será usada para definir o parâmetro sp_w como a seguir:
<input type=hidden name="sp_w_control" value="1"><input type=checkbox name="sp_w" value="alike">Sound-Alike matching
Consulte o formulário de pesquisa avançada de amostra para obter mais exemplos sobre o uso de parâmetros sp_w_control e sp_w .
50
sp_x
sp_x= field
Especifica os campos a serem pesquisados pela string de consulta. qualquer meio de pesquisa em todos os campos. título significa pesquisar somente campos de título. desc significa pesquisar somente campos de descrição do documento. teclas significa pesquisar somente palavras-chave do documento. body significa pesquisar somente texto do corpo. alt significa pesquisar somente texto alternativo. url significa pesquisar somente os valores de URL. target significa pesquisar somente palavras-chave alvo. Em qualquer um desses casos, as especificações do usuário dos prefixos de campo "text:", "desc:", "keys:", "body:", "alt:", "url:" e "target:" dentro do parâmetro sp_q correspondente são ignoradas. Se sp_x não estiver presente ou se estiver definida como uma string vazia ou qualquer outra, os prefixos de campo do usuário padrão serão permitidos. Consulte a descrição Dicas de pesquisa para obter mais informações sobre os prefixos de campo.
Consulte a descrição do formulário de pesquisa avançada de exemplo para obter exemplos usando o parâmetro sp_x .
Você pode criar consultas que pesquisam todos os campos definidos como Pesquisar por padrão em Opções > Metadados > Definições definindo sp_x=any . Os campos predefinidos e definidos pelo usuário podem ser usados como o valor do parâmetro sp_x .
Você também pode atribuir vários campos a uma única consulta definindo o parâmetro sp_x várias vezes. As linhas de modelo a seguir permitem que os usuários consultem os campos "título" e "autor" para "Grandes Livros".
<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_#= nome do campo
Esse parâmetro especifica qual campo pesquisar na consulta sp_q_# correspondente. O # é substituído por um número entre 1 e 16 (por exemplo, sp_x_8 ). O nome do campo é qualquer campo predefinido ou definido pelo usuário.
Se nenhum parâmetro sp_x_# for fornecido para uma consulta numerada específica, todos os campos definidos como Pesquisar por padrão como definidos em Configuração > Metadados > Definições serão pesquisados por essa consulta.
Por exemplo, o envio do formulário a seguir retorna todos os documentos que contêm a palavra "ótimo" que também contêm a palavra "Fitzgerald" no 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">
É possível associar vários nomes de campo a uma consulta específica ou a uma consulta numerada, fornecendo mais de uma instância do mesmo parâmetro sp_x ou sp_x_# em uma única solicitação de pesquisa.
Por exemplo, para pesquisar a palavra "flor" nos campos "corpo" e "chaves", é possível criar um formulário de pesquisa com as seguintes informações:
<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">

Um exemplo típico do uso de parâmetros CGI de pesquisa de backend

As seguintes consultas de link iniciam uma pesquisa usando "Música" como consulta de pesquisa e usam todos os parâmetros padrão. Observe que o URL é dividido em duas linhas para facilitar a leitura. Em seu HTML, esse link deve estar em uma linha.
<a href="https://search.atomz.com/search/?sp_q=Music&sp_a=sp99999999"> 
Testing...</a>

A mesma funcionalidade é mais tipicamente definida com um formulário:
<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, você deve usar parâmetros padrão ao iniciar uma pesquisa. Dessa forma, a primeira página é mostrada, classificada por relevância, e permite que o cliente escolha outras páginas e outras opções. Se o formulário de pesquisa em seu site incluir opções para coleções, passe o nome da coleção como um parâmetro.

Um exemplo detalhado do uso de parâmetros CGI de pesquisa de backend

As consultas de formulário a seguir exibem 25 resultados que começam com o resultado 10 . Resumos não são exibidos, a ordem de classificação é por data e a coleção nomeada support é usada. Somente documentos datados dos últimos 30 dias são retornados.
<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>