Show Menu
TÓPICOS×

Sobre as regras de pré-pesquisa

Use as Regras de pré-pesquisa para analisar a consulta recebida e determinar qual modelo de apresentação usar. As Regras de pré-pesquisa são executadas em sequência para cada consulta. Para alterar a ordem de suas regras, é possível usar o recurso arrastar e soltar. A ordem real não é alterada até que você a salve.

Uso de regras de pré-pesquisa

Normalmente, as Regras de pré-pesquisa são usadas para selecionar qual modelo de apresentação exibe os resultados com base na consulta recebida. Recursos mais avançados podem ser usados para alterar a consulta usada para uma pesquisa que está sendo feita para um modelo de apresentação. Você pode adicionar, excluir ou alterar o valor dos parâmetros de consulta conforme necessário. Para cada consulta recebida, um módulo de processamento de pré-pesquisa examina as regras de pré-pesquisa para determinar se a consulta é modificada e qual modelo de apresentação é usado. Cada regra de pré-pesquisa consiste em dois elementos principais: as ações da regra e as condições opcionais. Você pode especificar um número ilimitado de regras e condições. A ordem dessas regras é importante, pois o conjunto de regras é repetido por regra. Quando as condições de uma regra são correspondidas, todas as ações associadas são executadas.
No módulo Processamento de pré-pesquisa, todos os modelos definidos e suas pesquisas nomeadas associadas são instanciadas, onde cada pesquisa recebe uma cópia local dos parâmetros cgi. Como resultado, você pode personalizar uma pesquisa adicionando, excluindo ou alterando um dos parâmetros cgi que a pesquisa usa sem alterar qualquer outra pesquisa nomeada que o modelo usa ou afetando qualquer outro modelo. Como resultado, se você tiver um modelo de apresentação que exibe mais de um conjunto de resultados, poderá personalizar cada pesquisa individualmente. Se você quiser realizar alterações nos parâmetros CGI globais antes que sejam copiados para cada pesquisa para cada modelo, use o módulo Limpeza de consulta.

Condições da regra de pré-pesquisa

As condições são opcionais. Se você optar por ter ações especificadas para cada consulta, as ações sempre serão executadas. É considerada a prática recomendada para sua primeira regra ser executada para cada consulta, onde seleciona o modelo de apresentação padrão. Dessa forma, você pode ter certeza de que, independentemente do que for a consulta recebida, você selecionou um modelo de apresentação de cenário pior para usar. As condições podem ser baseadas em qualquer parâmetro de consulta CGI, cookie ou variável personalizada que uma regra anterior tenha definido ou em uma variável do sistema.

Ações de regras de pré-pesquisa

Todas as ações dentro de uma Regra de pré-pesquisa que tem condições correspondentes são exercidas. Normalmente, as ações consistem em uma operação, nos dados para executar a operação e no valor a ser usado. A ação mais simples é especificar qual modelo de apresentação usar quando a consulta corresponder às condições da Regra de pré-pesquisa. Em seguida, defina o modelo direcionado com o nome do modelo de apresentação. Ações mais complicadas podem ser usadas para alterar a pesquisa que está sendo usada para um determinado modelo por meio da execução de uma operação no parâmetro de pesquisa de um modelo. Ao executar uma operação no parâmetro de pesquisa de um modelo, especifique um modelo de apresentação e uma pesquisa.

Regras genéricas

Ao executar operações no parâmetro de pesquisa de um modelo, existem dois valores especiais: *direcionado e *principal para o modelo de apresentação e a pesquisa nomeada, respectivamente. Com esses valores, você pode criar regras com base na pesquisa principal do modelo direcionado atual. Essas construções permitem criar regras genéricas onde você não precisa se preocupar com o que o modelo direcionado atual ou a pesquisa primária são chamados. Obviamente, uma Regra de pré-pesquisa anterior define o modelo direcionado atual. Caso contrário, um modelo de apresentação inicial será selecionado para você, produzindo resultados indesejados.

Exemplos

Defina o modelo padrão como guided.tmpl, quando o usuário passar em um parâmetro cgi chamado lang, definido como um idioma conhecido, use o modelo desse idioma.
    On condition: 
      Every Query 
    Perform the following actions: 
      Set targeted template to guided 
 
    On condition: 
      Query lang matches regular expression fr 
    Perform the following actions: 
      Set targeted template to guided_french 
 
    On condition: 
      Query lang matches regular expression de 
    Perform the following actions: 
      Set targeted template to guided_german

Práticas recomendadas

  • A primeira regra seleciona um modelo padrão para cada consulta.
  • A extração de dados da consulta é feita dentro das regras de limpeza de consulta. É possível referenciá-los no processamento pré-pesquisa.
  • Adicione quaisquer novas variáveis personalizadas que você introduziu nas Regras de pré-pesquisa a uma regra de pré-pesquisa que é executada para cada consulta antes que outras Regras de pré-pesquisa as referenciem.

Adicionar uma nova regra de pré-pesquisa

Você pode usar Pre-Search Rules para selecionar qual modelo de apresentação é usado para exibir os resultados da pesquisa com base na consulta recebida.
Para adicionar uma nova regra de pré-pesquisa
  1. No menu do produto, clique em Rules > Pre-Search Rules .
  2. Na Pre-Search Rules página, clique em Add New Rule .
  3. No Name campo, digite o nome da nova regra de limpeza de consulta.
  4. Na Add Pre-Search Rule página, use as listas suspensas e os campos de texto para desenvolver sua consulta.
    Opção
    Descrição
    Cookie
    Um cookie HTTP. O nome e os valores dos cookies devem estar codificados no Identificador de recurso uniforme.
    Variável personalizada
    Uma variável definida pelo usuário. Adicione, exclua ou defina uma quantidade ilimitada de variáveis definidas pelo usuário.
    É possível fazer referência a quaisquer variáveis que você definiu no módulo Limpeza de consulta dentro das Regras de pré-pesquisa.
    Variável do sistema
    Variáveis somente leitura definidas pelo sistema interno que você pode verificar. As seguintes variáveis do sistema são suportadas:
    • nome do host
      O nome do host do servidor.
    • uri
      O URI solicitado sem a string de consulta.
    • args
      A string de consulta inteira.
    • ambiente
      "Stage" ou "live", dependendo se a consulta recebida foi enviada para o seu ambiente ativo ou temporário.
    • referrer
      O URL de onde o cliente veio.
    Aspecto
    Parâmetros CGI especiais na coleção global que estão associados a uma faceta específica. Todos os parâmetros CGI são copiados para cada pesquisa nomeada dentro de um modelo após a Limpeza de consulta.
    Parâmetro de consulta
    Parâmetro CGI na coleção global. Esses parâmetros são copiados para cada pesquisa nomeada dentro de um modelo após a Limpeza de consulta.
    Parâmetro de pesquisa do modelo
    Um parâmetro CGI que é local para uma pesquisa nomeada associada a um modelo de apresentação.
    Parâmetro de backend do modelo
    Os parâmetros de consulta de entrada eventualmente são convertidos em parâmetros de backend usados para executar a pesquisa.
    Os parâmetros de backend não são exibidos nos elementos de navegação. Como resultado, você pode ocultar quaisquer parâmetros adicionais que você deseja aplicar a uma pesquisa de seus clientes. O parâmetro é local para uma pesquisa específica em um modelo de apresentação. As ações nos parâmetros de backend são vinculação tardia; ou seja, eles são aplicados logo antes da pesquisa ser enviada.
    Modelo direcionado
    Uma instância especial de uma variável personalizada definida pelo sistema que não pode ser excluída. Essa variável contém o modelo de apresentação direcionado atual. Você pode ler ou definir essa variável especificando a variável personalizada "target_template".
    Classificação
    Permite que você especifique qual regra de classificação usar na pesquisa. Essa opção só aparece quando você definiu campos de classificação e regras de classificação.
    Loja
    O mecanismo de pesquisa detecta automaticamente em qual armazenamento o cliente está com base no nome do host ou no parâmetro de consulta gs_store, tendo o último precedência. Você pode criar condições fora da loja. Somente na limpeza de consulta, você também pode usar uma ação para substituir a loja atual.
    Última regra
    Quando marcado, o módulo de processamento de pré-pesquisa não executa nenhuma regra adicional após a ação da regra de correspondência. Essa ação é útil para quando você define ações que fazem com que uma regra posterior corresponda, mas não quer que a regra posterior seja executada.
    Suspender
    Desativa a execução da regra, mas não a exclui.
  5. Clique em Add .
  6. (Opcional) Execute um dos procedimentos a seguir:

Editing a pre-search rule

Você pode editar as regras de pré-pesquisa existentes que você adicionou à Pre-Search Rules página.
Para editar uma regra de pré-pesquisa
  1. No menu do produto, clique em Rules > Pre-Search Rules .
  2. Na Pre-Search Rules página, na Actions coluna da tabela, clique Edit para a regra associada que você deseja editar.
  3. Na Edit Pre-Search Rule página, use as listas suspensas e os campos de texto para desenvolver sua consulta.
    Consulte a tabela de opções em Adicionar uma nova regra de pré-pesquisa.
  4. Clique em Save Changes .
  5. (Opcional) Execute um dos procedimentos a seguir:

Excluindo uma regra de pré-pesquisa

É possível excluir regras de pré-pesquisa que não são mais necessárias ou não são mais usadas.
Quando você exclui uma regra, a ordem em que as regras restantes são executadas é ajustada automaticamente para contabilizar a exclusão.
Para excluir uma regra de pré-pesquisa
  1. No menu do produto, clique em Rules > Pre-Search Rules .
  2. Na Pre-Search Rules página, na Actions coluna da tabela, clique Delete para a regra associada que deseja excluir.
  3. Na caixa de Confirmation diálogo, clique em OK .
  4. (Opcional) Execute um dos procedimentos a seguir:

Alteração da ordem em que as regras de pré-pesquisa são executadas

É possível reordenar as regras de pré-pesquisa para alterar a ordem em que são executadas nos modelos de apresentação.
As regras de pré-pesquisa são executadas na ordem em que foram definidas. Quanto maior for o número do pedido de uma regra, mais tarde ela será executada no processo, superando as regras anteriores. Você reorganiza as regras digitando um novo número na coluna Ordem da tabela na Pre-Search Rules página. Também é possível usar as regras de arrastar e soltar para alterar a ordem de execução.
Alteração da ordem em que as regras de pré-pesquisa são executadas
  1. No menu do produto, clique em Rules > Pre-Search Rules .
  2. Na Pre-Search Rules página, execute um dos procedimentos a seguir:
    • Clique no cabeçalho da Order coluna para classificar as regras em ordem crescente ou decrescente.
    • Na Order coluna, no campo de texto à esquerda de um nome de regra de pré-pesquisa, digite o número do pedido que deseja que a regra execute.
    • Arraste e solte uma linha de tabela na posição em que deseja que a regra seja executada. Todos os números de pedido são atualizados para refletir a nova ordem em que as regras são executadas.
  3. Clique em Save Changes .
  4. (Opcional) Execute um dos procedimentos a seguir: