Sobre as regras de pré-pesquisa

Use as Regras de pré-pesquisa para analisar o query recebido e determinar qual modelo de apresentação usar. As Regras de pré-pesquisa são executadas em sequência para cada query. 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.

Usando 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 no query recebido. Recursos mais avançados podem ser usados para alterar o query usado para uma pesquisa que está sendo feita para um modelo de apresentação. Você pode adicionar, excluir ou alterar o valor dos parâmetros do query, conforme necessário. Para cada query recebido, um módulo de processamento de pré-pesquisa examina as regras de pré-pesquisa para determinar se o query foi modificado 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 eles sejam copiados para cada pesquisa para cada modelo, use o módulo Limpeza de Query.

Condições de regras de pré-pesquisa

As condições são opcionais. Se você optar por ter ações especificadas para cada query, as ações sempre serão executadas. É considerada a prática recomendada para a primeira regra ser executada para cada query, onde seleciona o modelo de apresentação padrão. Dessa forma, você pode ter certeza de que, independentemente do que for o query recebido, selecionou um modelo de apresentação de pior cenário para usar. As condições podem ser baseadas em qualquer parâmetro de query 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 o query 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 query.
  • A extração de dados do query é feita dentro das regras de limpeza do query. É 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 query antes que qualquer outra Regra de pré-pesquisa as referencie.

Adicionando 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 no query recebido.

Para adicionar uma nova regra de pré-pesquisa

  1. No menu do produto, clique em Rules > Pre-Search Rules.

  2. Na página Pre-Search Rules, clique em Add New Rule.

  3. No campo Name, digite o nome da nova regra de limpeza de query.

  4. Na página Add Pre-Search Rule, use as listas suspensas e os campos de texto para desenvolver seu query.

    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 Query 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 query.

    • args

      A string inteira do query.

    • ambiente

      "Palco" ou "ao vivo", dependendo se o query recebido foi enviado para o ambiente preparado ou ao vivo.

    • 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 Query.

    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 Query.

    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 query de entrada acabam sendo convertidos em parâmetros de backend usados para executar a pesquisa.

    Consulte Parâmetros CGI de pesquisa de backend .

    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 loja o cliente está com base no nome do host ou no parâmetro de query gs_store , tendo o último precedência. Você pode criar condições fora da loja. Somente na limpeza de query, também é possível 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:

Editando uma regra de pré-pesquisa

Você pode editar as regras de pré-pesquisa existentes que você adicionou à página Pre-Search Rules.

Para editar uma regra de pré-pesquisa

  1. No menu do produto, clique em Rules > Pre-Search Rules.

  2. Na página Pre-Search Rules, na coluna Actions da tabela, clique em Edit para obter a regra associada que você deseja editar.

  3. Na página Edit Pre-Search Rule, use as listas suspensas e os campos de texto para desenvolver seu query.

    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 página Pre-Search Rules, na coluna Actions da tabela, clique em Delete para obter a regra associada que você deseja excluir.

  3. Na caixa de diálogo Confirmation, 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 página Pre-Search Rules. 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 página Pre-Search Rules, execute um dos procedimentos a seguir:

    • Clique no cabeçalho da coluna Order para classificar as regras em ordem crescente ou decrescente.
    • Na coluna Order, 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:

Nesta página