Sobre as regras de pré-pesquisa

Use 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, você pode usar o recurso de arrastar e soltar. A ordem real não é alterada até que você a salve.

Uso das regras de pré-pesquisa

Normalmente, as Regras 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 query recebida, um módulo de pré-pesquisa examina as regras de pré-pesquisa para determinar se a query é modificada e qual template 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 é loopado por regra. Quando as condições de uma regra são satisfeitas, todas as ações associadas são executadas.

No módulo de 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 da cgi. Como resultado, você pode personalizar uma pesquisa adicionando, excluindo ou alterando um dos parâmetros de cgi que a pesquisa usa sem alterar qualquer outra pesquisa nomeada que o modelo usa ou afetando qualquer um dos outros modelos. 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 executar alterações nos parâmetros CGI globais antes que sejam copiados para cada pesquisa de 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 query, as ações serão sempre executadas. É considerada 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 é o query de entrada, selecionou um modelo de apresentação do pior cenário 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 da regra de pré-pesquisa

Todas as ações em uma Regra de pré-pesquisa que têm condições correspondentes são exercidas. As ações normalmente consistem em uma operação, os dados para executar a operação e o 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 template de target para o nome do template de apresentação. Ações mais complicadas podem ser usadas para alterar a pesquisa 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 baseadas na pesquisa principal do modelo direcionado atual. Essas construções permitem a criação de regras genéricas, onde não é necessário se preocupar com o nome do modelo direcionado ou da pesquisa primária atual. Obviamente, uma Regra pré-pesquisa anterior define o modelo direcionado atual. Caso contrário, um modelo de apresentação inicial será selecionado para você, o que produzirá resultados indesejados.

Exemplos

Defina o modelo padrão como guided.tmpl, quando o usuário passa um parâmetro de 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 da consulta é feita dentro das regras de limpeza de consulta. Você pode referenciá-los no processamento anterior à pesquisa.
  • Adicione 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 query recebida.

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

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

    Opção

    Descrição

    Cookie

    Um cookie HTTP. O nome e os valores dos cookies devem ser codificados com o 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.

    Você pode fazer referência a qualquer variável definida no módulo Limpeza de Consulta nas Regras Pré-Pesquisa.

    Variável de sistema

    Variáveis somente leitura definidas pelo sistema interno que você pode verificar. As seguintes variáveis de sistema são compatíveis:

    • hostname

      O nome do host do servidor.

    • uri

      O URI solicitado sem a cadeia de caracteres de consulta.

    • args

      A string de consulta inteira.

    • ambiente

      "Stage" ou "live" dependendo se a consulta recebida foi enviada para o seu ambiente temporário ou ativo.

    • referrer

      O URL de onde o cliente veio.

    Faceta

    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 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 traduzidos 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 deseja aplicar a uma pesquisa dos seus clientes. O parâmetro é local para uma pesquisa específica em um modelo de apresentação. As ações nos parâmetros de back-end são vinculação tardia; ou seja, elas são aplicadas antes do envio da pesquisa.

    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 template de apresentação direcionado atual. Você pode ler ou definir essa variável especificando a variável personalizada "targeted_template".

    Classificação

    Permite que você especifique a regra de classificação a ser usada 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 , com a última prioridade. Você pode criar condições fora da loja. Apenas na limpeza de consultas, 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 regras adicionais após a ação da regra correspondente. Essa ação é útil para quando você define ações que fazem com que uma regra posterior seja correspondente, mas não deseja que a regra posterior seja executada.

    Suspender

    Desativa a execução da regra, mas não a exclui.

  5. Clique em Add.

  6. (Opcional) Siga um destes procedimentos:

Editar uma regra de pré-pesquisa

É possível 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 a regra associada que deseja editar.

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

    Consulte a tabela de opções em Adicionar uma nova regra pré-pesquisa.

  4. Clique em Save Changes.

  5. (Opcional) Siga um destes procedimentos:

Excluindo uma regra de pré-pesquisa

É possível excluir regras de pré-pesquisa que não são mais necessárias ou 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 a regra associada que deseja excluir.

  3. Na caixa de diálogo Confirmation, clique em OK.

  4. (Opcional) Siga um destes procedimentos:

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

Você pode 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 inserindo 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.

Para alterar a ordem de execução das regras de pré-pesquisa

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

  2. Na página Pre-Search Rules, execute um dos seguintes procedimentos:

    • 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 seja executada.
    • 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) Siga um destes procedimentos:

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now