Modelos

Modelos

Tags de modelo de apresentação

Uma lista de tags e atributos de pesquisa/comercialização do site para modelos de apresentação.

Um modelo de apresentação é um arquivo HTML que inclui tags de modelo de apresentação definidas por pesquisa/merchandising de site. Essas tags indicam como os resultados da pesquisa que os clientes veem são formatados.

Consulte Sobre Modelos.

Você pode selecionar entre os seguintes grupos de tags de apresentação:

Declarações

As declarações são tags especiais de declaração guiada que podem ser definidas no topo de um modelo de apresentação de nível superior. Quaisquer declarações subsequentes são ignoradas, incluindo declarações em modelos incluídos.

Adicionar tag

Descrição

1

<guided-content-type-header content="content-type">

Por padrão, o template de apresentação é enviado de volta com um tipo MIME de texto/html. Você pode alterar o tipo de conteúdo usado com essa tag.

Declare essa tag o mais alto possível em seu modelo de apresentação. Não adicione outro texto na mesma linha com essa tag.

2

<guided-xml-declare>

Se estiver retornando XML, você poderá usar essa tag para criar a declaração XML. Transforme essa tag na primeira linha do modelo de apresentação. Ao usar essa tag, o tipo de conteúdo é automaticamente definido como text/xml, a menos que você a substitua por <guided-content-type-header> na primeira linha. Se você não especificar um charset, o padrão será UTF-8. Essa tag resulta na seguinte saída em seu documento XML:

<?xml version="1.0" encoding="charset-name" standalone="yes" ?>

Resultados

Adicionar tag

Descrição

1

<guided-results></guided-results>

A tag guided-results define os limites de um loop de resultados. Qualquer conjunto de resultados pode ser acessado especificando um atributo gsname . Se nenhum gsname for fornecido, os resultados de pesquisa padrão serão exibidos.

2

<guided-result-link></guided-result-link>

Para criar um link para um determinado resultado, use a tag guided-result-link . Ao definir um atributo gsname , você pode usar um campo do índice em vez da tag "loc" padrão que faz referência ao "search-url". Quaisquer outros atributos, como classe e destino, também podem ser transmitidos, que são gerados na tag de âncora resultante.

3

<guided-result-img gsname="fieldname">

A tag <guided-result-img> ajuda a criar tags de imagem em vez de incorporar variáveis dentro de uma tag img bruta.

Especifique o campo a ser usado para o caminho da imagem no atributo gsname . O resultado é uma tag img com qualquer atributo HTML padrão que você tenha definido, passado. Assim, o exemplo a seguir:

<guided-result-img gsname="thumbnail"  class="thumb" border="0"/>

becomes:

<img src="prod8172.jpg" class="thumb"  border="0"/>

4

<guided-result-field gsname="fieldname">

Qualquer informação a ser apresentada nos resultados é exibida como uma tag <guided-result-field> (exceto ao usar tags de geração automática como a tag <guided-result-img> ).

Especifique o nome do campo Search index em gsname . A sequência exata transmitida é a saída no modelo.

Você pode especificar uma opção de escape se quiser que esse campo escape de forma diferente do que foi especificado no modelo de transporte.

Essa codificação é aplicada sobre qualquer codificação especificada no modelo de transporte.

5

<guided-if></guided-if-result-field>

Esse conjunto de tags condicionais é verdadeiro se houver conteúdo no campo específico a ser exibido. Se não houver conteúdo, a condição será false. Você pode usar as tags para decidir se o HTML circundante é exibido ou não, se um valor não existe, ou se uma imagem diferente é exibida, e assim por diante.

<guided-if-result-field gsname="thumbnail">     <guided-result-img gsname="thumbnail" class="thumb" /> <guided-else-result-field>     <img src="nothumb.jpg" class="nothumb" /> </guided-if-result-field>

6

<guided-if[-not]-result-wrap> <guided-else-result-wrap> </guided-if[-not]-result-wrap>

Ao exibir resultados em colunas, essa tag é usada para identificar se o resultado atual marca o final de uma coluna.

Quando a condição Booleana é verdadeira, HTML é adicionado ao final do resultado para terminar a linha e iniciar uma nova. Quando for a última, uma nova linha não será iniciada.

Consulte <guided-if-not-last> para saber mais sobre essa tag.

<guided-if-result-wrap>      </div>      <guided-if-not-last>          <div>      </guided-if-not-last>  </guided-if-result-wrap>

7

<guided-results-found>

Retorna um 1 se a solicitação de pesquisa de back-end retornou resultados e 0 se não retornou. Se nenhum gsname for especificado, a tag assumirá a pesquisa primária. Essa tag é útil para transmitir lógica às rotinas do JavaScript.

8

<guided-results-total>

Retorna o número total de resultados no conjunto de resultados especificado. Assume a pesquisa padrão quando nenhum gsname é fornecido.

9

<guided-results-lower>

Retorna o número do resultado menor na página para o conjunto de resultados especificado. Assume a pesquisa padrão quando nenhum gsname é fornecido.

10

<guided-results-upper>

Retorna o número do resultado superior na página para o conjunto de resultados especificado. Assume a pesquisa padrão quando nenhum gsname é fornecido.

11

&amp;lt;/guided-if[-not]-results-found&amp;gt;   &lt;/p>  &lt;/td>

Mostra o conteúdo quando os resultados são encontrados. Ou não mostra resultados em HTML quando os resultados não são encontrados.

<guided-if-results-found gsname="products">     <guided-results gsname="products">         ...     </guided-results> <guided-else-results-found>      No results were found. </guided-if-results-found>

12

<guided-result-title />

A tag <guided-result-title> fornece o valor do campo do modelo de transporte de título especificado com <title> tag de transporte.

13

<guided-result-description />

A tag <guided-result-description> fornece o valor do campo de modelo de transporte de descrição especificado com a tag de transporte <description> .

14

<guided-result-loc />

A tag < guided-result-loc> fornece o valor do campo do modelo de transporte loc especificado com a tag de transporte <loc> .

15

&amp;lt;/guided-if-result-field&amp;gt;   &lt;/p>  &lt;/td>

True se houver conteúdo no campo específico a ser exibido. Se não houver conteúdo, a condição será false. Use as tags para decidir se o HTML circundante é exibido ou não, se um valor não existe, ou se uma imagem diferente é exibida, e assim por diante.

<guided-if-result-field gsname="thumbnail">      <guided-result-img gsname="thumbnail" class="thumb"/> <guided-else-result-field>      <img src="nothumb.jpg" class="nothumb"/> </guided-if-result-field>

16

<guided-result-attribute-table gsname="tablename">

Esta tag fornece um loop pela tabela de atributos definida no modelo de transporte com a tag de transporte <attribute_table> . Existe uma tag <guided-result-attribute-table-field> para exibir valores de campos da tabela de atributos. Além disso, é possível usar a tag simples guided-result-field dentro do loop para exibir outros campos de resultado.

17

<guided-result-attribute-table-field gsname="fieldname">

Exibe o campo da tabela do atributo conforme definido no modelo de transporte.

...

&amp;lt;ul&amp;gt;

&amp;lt;guided-result-attribute-table&amp;nbsp;gsname=&quot;downloads&quot;&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;lt;li&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;a&amp;nbsp;href=&quot; lt;guided-result-attribute-table-field&amp;nbsp;gsname=&quot;download_link&quot;&amp;nbsp;/&amp;gt;&quot;&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;guided-result-attribute-attribute-table -field&amp;nbsp;gsname=&quot;download_title&quot;&amp;nbsp;/&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;/a&amp;gt;&amp;nbsp;(&amp;lt;guided-result-field&amp;nbsp;gsname=&quot;title&quot;/&amp;gt;)
&amp;nbbsp sp;&amp;nbsp;&amp;lt;/li&amp;gt;
&amp;lt;/guided-result-attribute-table&amp;gt;

&amp;lt;/ul&amp;gt;

...

&amp;lt;/guided-results&amp;gt;   &lt;/p>  &lt;/td>

18

<guided-trace>

Gera as informações de rastreamento encontradas nos dados de rastreamento na seção geral da saída de dados JSON pelo modelo de transporte para a pesquisa fornecida.

Se nenhum nome de pesquisa for fornecido, padrão será assumido.

19

<guided-result-trace />

Gera o conteúdo JSON encontrado em resultados > informações de rastreamento da saída de dados JSON pelo modelo de transporte para o resultado de pesquisa atual.

Essa tag é válida somente no loop <guided-results></guided-results> .

Aspectos

As facetas são componentes de navegação que permitem detalhar os resultados da pesquisa. Você pode usar as tags de faceta para exibir várias facetas no modelo de apresentação. Você faz referência a aspectos por nome.

Consulte Sobre facetas.

Consulte Sobre o Facet Rail.

Consulte Sobre Aspectos Dinâmicos.

Adicionar tag

Descrição

3

<guided-dynamic-facets></guided-dynamic-facets>

Um contexto de loop para quaisquer aspectos dinâmicos de uma determinada pesquisa.

A tag do modelo de apresentação <guided-facet> é editada para que o atributo gsname seja automaticamente fornecido pelo contexto de loop <guided-dynamic-facets> .

2

<guided-facet-display-name gsname=" facetname " />

Retorna o rótulo de exibição da faceta.

Se a faceta usar a tag <display-name> no modelo de transporte, o conteúdo dessa tag se tornará o rótulo.

3

<guided-facet-rail></guided-facet-rail>

Define uma seção no modelo de apresentação que é usada como um padrão de repetição para cada faceta no painel de facetas.

Cada faceta que pertence ao painel de facetas usa esta seção para avaliar sua saída.

Este é um exemplo de um painel de faceta:

<guided-facet-rail>   <guided-facet>     <guided-facet-display-name/>     ...     </guided-facet>   </guided-facet-rail>

Observe que as tags a seguir não precisam do atributo gsname quando dentro da tag <guided-facet-Rail> o valor é determinado dinamicamente no tempo de pesquisa e é substituído corretamente:

  • aspecto guiado
  • guided-facet-display-name
  • contagem total de facetas guiadas
  • guided-facet-undo-link
  • guided-facet-undo-path
  • comportamento orientado de faceta

Os critérios de classificação na página Facet Rail determinam a posição das facetas. Você pode escolher a ordem de classificação na lista suspensa Método de classificação de aspectos .

Como opção, essa tag pode aceitar um valor de atributo gsname de _dynamic_facets , que fornece um contexto de loop para quaisquer aspectos dinâmicos para essa pesquisa. Esse painel de facetas predefinido também é exposto na interface do usuário das Regras de negócios para a ação empurrar o aspecto X no painel de facetas '_dynamic_facets' para posicionar Y ".

Consulte Sobre o Facet Rail .

Consulte também Sobre Aspectos Dinâmicos .

4

<guided-facet gsname=" facetname " height=" 60px " width=" 120px "></guided-facet>

Use a tag guiada-faceta para definir uma área dentro da qual todas as tags de faceta se relacionam a uma faceta específica. Essa tag também é uma tag booleana que oculta todo o conteúdo se nenhum valor na faceta existir. Nesse caso, não faz sentido colocar os valores de faceta).

Os atributos de altura e largura são opcionais e as dimensões são especificadas em pixels (px). O Visual Rule Builder (VRB) usa esses dois atributos e exibe uma caixa pontilhada como um espaço reservado interativo quando a faceta está oculta.

Quando o nome de exibição está na faceta e a faceta está oculta, o nome também fica oculto. No entanto, se o nome estiver fora da faceta, você só poderá ocultar o nome se uma tag zone ou uma tag guided-if-facet-visible estiver envolta.

5

<guided-if></guided-if>

Essa tag condicional é verdadeira quando o número de valores de faceta está acima do limite de comprimento definido na configuração. Use-o para exibir uma faceta como um elemento de interface do usuário diferente (como uma lista truncada ou uma caixa de rolagem) quando a lista for muito longa.

<guided-facet name="category">     <guided-if-facet-long>         <select>             <guided-facet-values>                 <guided-facet-option />             </guided-facet-values>         </select>     <guided-else-facet-long>         <guided-facet-values>             <guided-facet-value-link><guided-facet-value /></guided-facet-link>         </guided-facet-values>     </guided-if-facet-long> </guided-facet>

Também é possível usar essa condição fora do contexto de um bloco nomeado guided-facet referenciando uma faceta específica diretamente por meio do uso do atributo gsname .

<guided-if-facet-long gsname="category">     The category facet is very long! </guided-if-facet-long>

6

<guided-if></guided-if>

Essa tag condicional é verdadeira quando a faceta é clicada pelo menos uma vez e um valor de faceta é selecionado no momento. Ele é usado para mostrar ou ocultar tags HTML ou gs , dependendo se uma faceta foi clicada.

<guided-facet name="category">     <guided-if-facet-selected>         This facet has been selected.  You can no longer refine it.     <guided-else-facet-selected>     <guided-facet-values>         <guided-facet-value-link><guided-facet-value /></guided-facet-link>     </guided-facet-values>     </guided-if-facet-selected> </guided-facet>

Também é possível usar essa condição fora do contexto de um bloco nomeado guided-facet referenciando uma faceta específica diretamente por meio do uso do atributo gsname .

<guided-if-facet-selected gsname="category">     The category facet is selected! </guided-if-facet-selected>

7

<guided-if></guided-if>

Essa tag condicional é verdadeira quando há apenas um valor de faceta. Use a tag para alterar a exibição da faceta quando ela não tiver capacidade de refinar os resultados.

<guided-facet name="category">     <guided-if-facet-single>         Facet is not refinable.     <guided-else-facet-single>         <guided-facet-values>             <guided-facet-value-link><guided-facet-value /></guided-facet-link>         </guided-facet-values>     </guided-if-facet-single> </guided-facet>

Também é possível usar essa condição fora do contexto de um bloco nomeado guided-facet referenciando uma faceta específica diretamente por meio do uso do atributo gsname .

<guided-if-facet-single gsname="category">     There is only one value in the category facet! </guided-if-facet-single>

8

<guided-if></guided-if>

Essa tag condicional é verdadeira quando a faceta é de seleção múltipla. Use a tag para alterar a exibição da faceta dentro das tags <guided-facet-Rail> ou <guided-dynamic-facets> .

&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;guided-if-facet-multiselect&amp;gt;
&amp;nbsp;...
&amp;nbsp;&amp;lt;guided-else-facet-multiselect&amp;gt;
&amp;nbsp;...
&amp;nbsp;&amp;lt;/guided-if-facet-multiselect&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;....
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;/guided-facet&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;lt;/guided-facet-Rail&amp;gt;   &lt;/p>  &lt;/td>

9

<guided-facet-values> facetname "]></guided-facet-values>

Esta é a tag iteradora do loop de valores de faceta. Você pode defini-lo no contexto de um bloco guiado-faceta nomeado, nesse caso, você pode omitir o gsname . Ou você pode defini-lo fora de qualquer bloco guiado-faceta , mas isso exigiria o atributo gsname para identificar qual conjunto de valores de faceta é exibido.

Também é possível usar essa tag para exibir os valores de faceta fora do contexto de um bloco nomeado guided-facet . Você faz referência a uma faceta específica diretamente usando o atributo gsname .

<script>      registerFacetValues('category', '<guided-facet-values gsname="category"><guided-facet-value/>,</guided-facet-values>'); </script>

10º

<guided-facet-value>

Gera a string do valor da faceta atual.

Por padrão, o valor é HTML escaped. Você pode usar a opção de escape para alterar como o valor é evitado.

11º

<guided-facet-count />

Gera o número de resultados que correspondem ao valor de aspecto atual.

12º

<guided-facet-value-link></guided-facet-value-link>

Cria um link ao redor da string de valor de faceta para o visitante do site clicar. O caminho é gerado automaticamente para limitar os resultados pelo valor de aspecto atual. Ele suporta a transmissão de qualquer atributo diretamente para a tag de âncora.

<guided-facet-values>     <guided-facet-value-link class="facetlink"><guided-facet-value /></guided-facet-value-link> </guided-facet-values>

13º

<guided-if-facet-value-selected> <guided-else-facet- value-selected> </guided-if-facet-value-selected>

Altera a exibição do valor da faceta quando ele está selecionado no momento. Se já tiver sido escolhido, na maioria dos casos, já não é vinculável.

<guided-facet-values>      <guided-if-facet-value-selected>          <b><guided-facet-value/></b>      <guided-else-facet-value-selected>          <guided-facet-link><guided-facet-value/></guided-facet-link>         </guided-if-facet-value-selected> </guided-facet-values>

14.

&amp;lt;/guided-if[-not]-facet-value-ghost&amp;gt;   &lt;/p>  &lt;/td>

Altera a exibição do valor da faceta quando ele é um valor fantasma. Quando um valor de faceta é um valor fantasma, ele normalmente é exibido em itálico para indicar que o valor está ausente ou "fantasma".

O seguinte trecho de código é um exemplo de um bloco de faceta:

<guided-facet-values>     <guided-if-facet-value-selected>         <b><guided-facet-value /> (<guided-facet-count />)</b>             <guided-else-facet-value-selected>                 <guided-if-facet-value-ghost>                     <i><guided-facet-value /> (0)</i>                 <guided-else-facet-value-ghost>             <guided-facet-link class="link"><guided-facet-value /></guided-facet-link> (<guided-facet-count />)         </guided-if-facet-value-ghost>     </guided-if-facet-value-selected> </guided-facet-values>

15.

<guided-facet-undo-link gsname=" facetname "></guided-facet-undo-link>

Exibe um link para desfazer para uma determinada faceta. Se houver facetas de várias seleções, esse link desmarque todos os valores de facetas fornecidos. Dê um nome à faceta. Se a faceta não estiver selecionada no momento, o link será o caminho atual.

Este é um exemplo do uso dessa tag:

<guided-if-facet-selected gsname="category">     <guided-facet-undo-link gsname="category">Undo Category</guided-facet-undo-link> </guided-if-facet-selected>

16º

<guided-if-facet-long [gsname="facetname"]> <guided-else-facet-long></guided-if-facet-long>

Essa tag condicional é verdadeira quando o número de valores de faceta está acima do limite de comprimento definido na configuração. Use-o para exibir uma faceta como um elemento diferente da interface do usuário (como uma lista truncada ou uma caixa de rolagem) quando a lista for muito longa.

<guided-facet gsname="category">      <guided-if-facet-long>          <div class="long_facet">              <guided-facet-values>                  <guided-facet-link><guided-facet-value/></guided-facet-link>              </guided-facet-values>          </div>      <guided-else-facet-long>          <div class="facet">              <guided-facet-values>                  <guided-facet-link><guided-facet-value/></guided-facet-link>              </guided-facet-values>          </div>      </guided-if-facet-long>  </guided-facet>

Também é possível usar essa condição fora do contexto de um bloco nomeado guided-facet referenciando uma faceta específica diretamente por meio do uso do atributo gsname .

<guided-if-facet-long gsname="category">      The category facet is very long! </guided-if-facet-long>

17º

<guided-if-facet-selected [gsname="facetname"]> <guided-else-facet-selected></guided-if-facet-selected>

Essa tag condicional é verdadeira quando a faceta é clicada pelo menos uma vez e um valor de faceta é selecionado no momento. Ele pode ser usado para mostrar ou ocultar tags HTML ou gs , dependendo se uma faceta é clicada.

<guided-facet gsname="category">      <guided-if-facet-selected>          This facet has been selected.  You can no longer refine it.      <guided-else-facet-selected>          <guided-facet-values>              <guided-facet-link><guided-facet-value/></guided-facet-link>          </guided-facet-values>      </guided-if-facet-selected> </guided-facet>

Também é possível usar essa condição fora do contexto de um bloco nomeado guided-facet referenciando uma faceta específica diretamente por meio do uso do atributo gsname .

<guided-if-facet-selected gsname="category">      The category facet is selected! </guided-if-facet-selected>

18º

<guided-if-facet-single [gsname="facetname"]> <guided-else-facet-single></guided-if-facet-single>

Essa tag condicional é verdadeira quando há apenas um valor de faceta. Ele pode ser usado para alterar a exibição da faceta quando não tem capacidade de refinar os resultados.

<guided-facet gsname="category">      <guided-if-facet-single>          Facet is not refinable.      <guided-else-facet-single>          <guided-facet-values>              <guided-facet-link><guided-facet-value/></guided-facet-link>          </guided-facet-values>      </guided-if-facet-single> </guided-facet>

Também é possível usar essa condição fora do contexto de um bloco nomeado guided-facet referenciando uma faceta específica diretamente por meio do uso do atributo gsname .

<guided-if-facet-single gsname="category">      There is only one value in the category facet! </guided-if-facet-single>

19º

<guided-if-facet-has-values [gsname="facetname"]> <guided-else-facet-has-values></guided-if-facet-has-values>

Essa condição permite verificar se a faceta especificada tem algum valor. Você pode usá-lo para mostrar outra faceta em vez de vazia.

20

<guided-facet-total-count gsname=" facetname " />

Gera o número total de resultados que estão dentro de uma determinada faceta.

21

<guided-facet-value gsname=" associated custom facet value ">

Gera a string de um valor associado à faceta. Você pode ter 0 ou mais campos associados a uma faceta. Ter campos associados é raro e ser compatível com isso, basta configurar o template de transporte.

22

<guided-if-facet-value gsname=" associated custom facet value " /><guided-else-facet-value></guided-if-facet-value>

Testa se o valor da faceta tem um valor de campo associado.

23

<guided-facet-link> valor "]+></guided-facet-link>

Cria um link ao redor da string de valor de faceta para o cliente clicar. O caminho é gerado automaticamente para limitar os resultados pelo valor de aspecto atual. Ele suporta a transmissão de qualquer atributo diretamente para a tag de âncora.

<guided-facet-values>      <guided-facet-link class="facetlink"><guided-facet-value/></guided-facet-link> </guided-facet-values>

24

<guided-facet-value-path>

Cria seu próprio link para um valor de faceta.

<guided-facet-values>      <guided-lt/>a href="<guided-facet-value-path/>"<guided-gt/><guided-facet-value/></a> </guided-facet-values>

Por padrão, o valor é URL escaped. Entretanto, é possível adicionar outra camada de codificação especificando qual modo de escape você deseja usar por meio do parâmetro escape.

25

<guided-facet-value-children></guided-facet-value-children>

Como <guided-facet-values> itera por cada valor de faceta, esta tag itera por todos os valores secundários de uma faceta aninhada. Dentro dessa tag, use as tags de faceta típicas para criar links, criar links para desfazer e exibir valores de faceta. Essa tag deve estar dentro de <guided-facet-values> porque faz o loop aninhado.

Um exemplo de uso dessa tag é o seguinte:

<guided-facet-values>   <guided-facet-link title='<guided-facet-value />'><guided-facet-value /> (<guided-facet-count />)</guided-facet-link>   <guided-if-facet-value-has-children>    <guided-facet-value-children>     <guided-facet-link title='<guided-facet-value />'><guided-facet-value /> (<guided-facet-count />)</guided-facet-link>    </guided-facet-value-children>   </guided-if-facet-value-has-children> </guided-facet-values>

26

<guided-if-facet-value-has-children> <guided-else-facet- value-has-children> </guided-if-facet-value-has-children>

Testa se o valor da faceta atual tem valores filhos. Recomendado para usar antes de usar as tags <guided-facet-children> . A cláusula "else" é opcional.

27

&amp;lt;guided-else[-not]-facet-value-above-length-threshold&amp;gt;

&amp;lt;/guided-if[-not]-facet-value-above-length-threshold&amp;gt;   &lt;/p>  &lt;/td>

Determina se o valor da faceta atual dentro do loop de valores de faceta está acima do limite de comprimento. Normalmente, é usado para exibir apenas valores abaixo do limite em uma faceta longa (a menos que o usuário tenha selecionado anteriormente um link "Ver mais" exibido abaixo da faceta).

28

&amp;lt;guided-else[-not]-facet-value-equals-length-threshold&amp;gt;

&amp;lt;/guided-if[-not]-facet-value-equals-length-threshold&amp;gt;   &lt;/p>  &lt;/td>

Determina se o valor da faceta atual no loop de valores de faceta é igual ao limite de comprimento.

29

<guided-facet-value-undo-link></guided-facet-value-undo-link>

Exibe um link para desfazer para um determinado valor de faceta selecionado. Use-o para exibir um link para desfazer ao lado de um valor de faceta selecionado. Como esse link desfazer apenas desfaz o valor selecionado em particular, ele é diferente de <guided-facet-undo-link> que desmarca todos os valores selecionados.

Observação: Se a faceta não tiver um comportamento de seleção múltipla, os dois links desfazer terão o mesmo comportamento. Ou seja, a faceta só pode ter um valor selecionado.

Se a faceta não estiver selecionada no momento, o link será o caminho atual. Use essa tag somente em um loop guided-facet-values .

30

<guided-facet-value-undo-path />

Crie seu próprio link para desfazer o valor da faceta.

31

<guided-facet-undo-path gsname=" facetname " />

Crie seu próprio link para desfazer a faceta.

Semelhante à tag <guided-facet-undo-link> , exceto que fornece o caminho bruto para criar seu próprio link para desfazer.

32

<guided-if-facet-value-matches facetname="facetname" value="value"><guided-else-facet-value-matches> </guided-if-facet-value-matches>

Exiba o HTML condicionalmente quando a faceta em questão tiver o "valor" de valor único ou selecionado. Esse conjunto de tags geralmente é usado para exibir uma faceta com base no valor selecionado em outra faceta.

33

<guided-facet-behavior gsname=" facetname " />

Determine o comportamento de uma faceta, como normal, aderente ou de várias seleções. É útil para clientes que recebem resultados XML e desejam alterar dinamicamente como a faceta é exibida com base em seu comportamento.

34

&amp;lt;/guided-if-facet[-not]-visible&amp;gt;   &lt;/p>  &lt;/td>

O conteúdo que essa tag envolve é oculto ou revelado com base no estado de visibilidade da faceta. Se uma regra de negócios ocultar ou revelar a faceta diretamente, qualquer conteúdo dentro da faceta será oculto ou revelado. Não é necessário que essas tags contornem a faceta.

Um uso comum para essa tag é ocultar o nome de exibição quando o nome estiver fora da faceta. A vinculação dessa tag ao redor do nome de exibição faz com que o nome desapareça quando a faceta estiver oculta.

Essa tag substitui a zona e tem muitos dos mesmos benefícios de desempenho que o uso de zonas.

Caminho

Consulte Sobre navegação estrutural.

Adicionar tag

Descrição

3

<guided-breadcrumb> breadcrumbname "]></guided-breadcrumb>

A tag de loop da navegação estrutural. Qualquer conteúdo entre as tags de abertura e fechamento é repetido para cada número de consulta do estado atual.

Se gsname for omitido, a navegação estrutural chamada "default" será usada.

2

<guided-breadcrumb-link></guided-breadcrumb-link>

Cria um link na navegação estrutural. O comportamento padrão é o comportamento "goto". Se o link se comportar de forma diferente, use o atributo opcional gsname para especificar "remover" ou "soltar". Qualquer atributo incluído na tag é passado para a tag de âncora resultante.

<guided-breadcrumb>      <guided-breadcrumb-link gsname="remove" class="bc_link">          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>

3

<guided-breadcrumb-value />

A tag value imprime o valor transformado da iteração de navegação estrutural atual. Ele é usado somente no contexto de um bloco guided-breadcrumb .

<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>

4

<guided-breadcrumb-label />

A tag label gera um rótulo para um valor de navegação estrutural detalhando qual faceta foi selecionada para gerar esse item de navegação estrutural. Ela é usada somente no contexto de um bloco guided-breadcrumb .

<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-label/>: <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>

5

<guided-if-breadcrumb-label> <guided-else- breadcrumb-label> <guided-if-breadcrumb-label />

Essa tag condicional é usada para exibir condicionalmente o conteúdo se o valor da navegação estrutural atual tiver um rótulo. É usado para exibir somente rótulos e conteúdo relacionado quando um rótulo realmente existe. Ela é usada somente no contexto de um bloco guided-breadcrumb .

<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-if-breadcrumb-label>              <guided-breadcrumb-label/>:          </guided-if-breadcrumb-label>      <guided-breadcrumb-value/></guided-breadcrumb-link> </guided-breadcrumb>

6

<guided-breadcrumb-path>

Usado para criar seu próprio link de navegação estrutural.

Menus

Consulte Sobre menus.

Adicionar tag

Descrição

3

<guided-menu gsname="menuname"></guided-menu>

Esta é a tag do iterador de loop de valor de menu. Use o atributo gsname para identificar qual conjunto de itens de menu será exibido.

2

<guided-menu-item-link></guided-menu-item-link>

Fornece o URL para refinar a pesquisa atual para o item de menu.

3

<guided-menu-item-option>

Normalmente, um menu é exibido em um controle selecionado em um modelo. Essa tag facilita a construção do controle selecionado, pois gera o HTML para gerar a opção do controle selecionado.

Por exemplo, o seguinte bloco de código:

<select name="sort" onchange="gcGo(this);"> <guided-menu gsname="sort"> <guided-menu-item-option/> </guided-menu> </select>

Pode gerar HTML da mesma forma:

<select name="sort" onchange="gcGo(this);">   <option value="?sort=relevance;sp_sfvl_field=product-type|category|size;" selected="selected">Sort by Relevance</option>   <option value="?sort=avail-code;sp_sfvl_field=product-type|category|size;">Sort by Availability</option>   <option value="?sort=price;sp_sfvl_field=product-type|category|size;">Sort by Price</option> </select>

4

<guided-menu-item-value />

Retorna a string do valor associado ao menu.

5

<guided-menu-item-label />

Retorna a string do rótulo associado ao menu.

6

<guided-menu-item-path />

Retorna a string do caminho. Use a tag se desejar adicionar um parâmetro ao caminho e criar um link personalizado.

7

<guided-if-menu-item-selected> <guided-else-menu- item-selected> </guided-if-menu-item-selected>

Retorna 1 ou 0 indicando se o item de menu atual está selecionado.

Pagenav

As tags de navegação da página podem ser usadas para criar um conjunto de links que permitem que um usuário pague pelos resultados da pesquisa.

Adicionar tag

Descrição

3

<guided-pages></guided-pages>

A tag de loop para a navegação da página. Qualquer conteúdo entre as tags de abertura e fechamento é repetido para cada página.

2

<guided-page-link></guided-page-link>

Cria um link na navegação da página.

3

<guided-page-link gsname="first|prev|next|last|viewall|viewpages"></guided-page-link>

Cria um link para a primeira, a anterior, a próxima ou a última página. Também é possível criar um link para exibir todas as páginas em uma página.

4

<guided-page-number />

Retorna uma string com o número de página atual.

5

<guided-if-page-selected> <guided-else-page- selected> </guided-if-page-selected>

Esse conjunto de tags condicionais é verdadeiro se a página que está atualmente repetida estiver selecionada. Normalmente, é usado para exibir de forma diferente o número da página no controle de navegação da página.

6

<guided-if[-not]-page-prev> <guided-else-page- prev> </guided-if[-not]-page-prev>

Esse conjunto de tags condicionais é verdadeiro se a página atual tiver uma página anterior. Normalmente, é usado para exibir um link anterior na navegação da página, quando faz sentido.

7

<guided-if[-not]-page-next> <guided-else-page- next> </guided-if[-not]-page-next>

Esse conjunto de tags condicionais é verdadeiro se a página atual tiver uma próxima página. Normalmente, é usado para exibir um link anterior na navegação da página, quando faz sentido.

8

<guided-if[-not]-page-viewall> <guided-else-page- viewall> </guided-if[-not]-page-viewall>

Quando uma pesquisa retorna um grande conjunto de resultados, talvez você não queira oferecer a capacidade de exibir todos os resultados. Portanto, você pode usar esse conjunto de tags condicionais para determinar quando exibir o link Exibir todos .

9

<guided-if[-not]-page-viewpages> <guided-else-page- viewpages> </guided-if[-not]-page-viewpages>

Você pode usar esse conjunto de tags condicionais para determinar quando exibir o link Exibir páginas . Normalmente, é usado para permitir que um cliente visualize determinadas páginas.

10º

&amp;lt;guided-else-page-link&amp;gt;
&amp;lt;/guided-if[-not]-page-link&amp;gt;   &lt;/p>  &lt;/td>

Testa se a navegação da página tem uma primeira página, página anterior, próxima página e assim por diante.

11º

<guided-page-total />

Retorna uma string com o número total de páginas de resultados de pesquisa.

12º

<guided-pagination gsname= "pagination_name"></guided-pagination>

Use a tag de paginação guiada para definir uma área na qual todas as tags de paginação se relacionam a uma configuração de paginação específica caso você tenha poucas Configurações de navegação de página definidas.

13º

next|last|viewall|viewall|viewpages&rbrack;/&amp;gt;   &lt;/p>  &lt;/td>

Cria seu próprio link na navegação da página.

14.

<guided-if-page-high-eq-last> <guided-else-page- high-eq-last> </guided-if-page-high-eq-last>

Testa se a página mais alta na navegação da página é igual ao número total de páginas.

15.

<guided-if-page-low-eq-first> <guided-else-page-low-eq-first> </guided-if-page-low-eq-first>

Testa se a página mais baixa na navegação da página é igual à página mais baixa.

16º

<guided-if-page-is-multipage> <guided-else-page-is-multipage> </guided-if-page-is-multipage>

Testa se há uma única página de resultados ou várias páginas de resultados.

Pesquisas recentes

Você pode usar tags de pesquisas recentes para criar um conjunto de links que permitem que um usuário execute rapidamente uma pesquisa anterior, como no exemplo a seguir:

<guided-if-recent-searches> 
    <span>Recent Searches</span><br/> 
    <guided-recent-searches> 
        <guided-recent-searches-link><guided-recent-searches-value></guided-recent-searches-link><br/> 
    </guided-recent-searches> 
    <guided-recent-searches-clear-link>Clear Recent Searches</guided-recent-searches-clear-link> 
</guided-if-recent-searches>

Consulte Configurando pesquisas recentes.

Adicionar tag

Descrição

3

<guided-recent-searches></guided-recent-searches>

A tag de loop para pesquisas recentes. Qualquer conteúdo entre as tags de abertura e fechamento é repetido para cada página.

2

<guided-recent-searches-link [attr="value"]+> </guided-recent-searches-link>

Permite criar um link para uma pesquisa recente. Ele suporta a transmissão de qualquer atributo HTML diretamente para a tag âncora.

3

<guided-recent-searches-path />

Permite capturar o caminho relativo do URL para uma pesquisa recente, em um loop guided-recent-search . Normalmente, você usaria guided-recent-search-link . No entanto, se você quiser criar seu próprio link, poderá usar essa tag. Este é um exemplo:

<guided-lt/>a&nbsp;href="<guided_recent_searches_path>"><guided-recent-searches-value></a>

4

<guided-recent-searches-value>

Permite capturar o termo de consulta associado a uma pesquisa recente.

5

<guided-recent-searches-clear-link></guided-recent-searches-clear-link>

Permite que você ofereça aos clientes a capacidade de apagar pesquisas salvas recentemente.

6

<guided-recent-searches-clear-path />

Retorna o caminho que <guided-recent-search-clear-link> usa para que você possa criar seu próprio link.

7

&amp;lt;/guided-if-recent-search&amp;gt;   &lt;/p>  &lt;/td>

Permite exibir as pesquisas recentes quando um cliente realizou uma pesquisa recente.

Você quis dizer

Você pode usar as tags Você quis dizer para criar um conjunto de links para sugestões quando uma pesquisa não retornar resultados e o termo Pesquisa não estiver no dicionário da conta. Este é um exemplo de uso das tags Você quis dizer :

<guided-if-suggestions> 
    <span>Did You Mean?</span><br/> 
    <guided-suggestions> 
        <guided-suggestion-link><guided-suggestion/></guided-suggestion-link><br/> 
    </guided-suggestions> 
</guided-if-suggestions>

Consulte Sobre você quis dizer.

Adicionar tag

Descrição

1

<guided-suggestions></guided-suggestions>

Esta é a tag de loop para fazer looping nas sugestões.

2

<guided-suggestion-link></guided-suggestion-link>

Cria um link para a sugestão fornecida.

3

<guided-suggestion-value />

4

<guided-if[-not]-suggestions><guided-else[-not]- suggestions></guided-if[-not]-suggestions>

Permite testar se há sugestões.

5

<guided-suggestion-path />

Retorna a string do caminho para a sugestão. Você pode usá-lo para criar sua própria tag de âncora. Normalmente, guided-sugestion-link é usado.

6

<guided-suggestion />

Uma sugestão.

7

<guided-suggestion-result-count />

Contagem de resultados para a sugestão.

8

<guided-if[-not]-suggestion-autosearch> <guided-else[-not]-suggestion-autosearch> </guided-if[-not]-suggestion-autosearch>

Permite testar se a pesquisa automática por sugestão em resultados zero foi realizada, caso esse recurso esteja ativado.

9

<guided-suggestion-original-query />

Retorna a consulta original se a pesquisa automática foi executada.

Exemplo de uso:

<guided-if-suggestion-autosearch>     Search for <guided-query-param gsname="q" /> instead of <guided-suggestion-original-query /> </guided-if-suggestion-autosearch>

10º

<guided-if[-not]-suggestion-low-results> <guided-else[-not]-suggestion-low-results> </guided-if[-not]-suggestion-low-results>

Essa condição é verdadeira se houver sugestões devido a uma contagem de resultados baixa, caso esse recurso esteja ativado.

Este é um exemplo de uso dessa tag:

<guided-if-suggestion-low-results>    You have a low result count for <guided-query-param gsname="q" />.    Did you mean: <guided-suggestions>        <guided-suggestion-link>           <guided-suggestion />        </guided-suggestion-link><guided-if-not-last>, </guided-if-not-last>    </guided-suggestions> </guided-if-suggestion-low-results>

Preencher automaticamente

As tags a seguir podem ser usadas para adicionar o preenchimento automático ao formulário de pesquisa. As tags head-content e form-content são necessárias para que a função de preenchimento automático funcione corretamente. Recomenda-se usar as tags em vez de codificar o Javascript e o CSS de preenchimento automático no modelo de apresentação. O motivo é que as tags permitem que seus modelos capturem quaisquer novas IDs de cache de derrota sempre que você alterar as configurações de preenchimento automático sem precisar atualizar manualmente o modelo.

Consulte Sobre a Conclusão Automática.

Adicionar tag

Descrição

3

<guided-if-autocomplete> <guided-else-autocomplete> </guided-if-autocomplete>

Detecta se o recurso de preenchimento automático está ativado. Você poderia usar as tags para, opcionalmente, coletar o cabeçalho e o conteúdo do formulário necessários para o preenchimento automático. Por sua vez, isso permite que você ative e desative o recurso e não precise alterar os modelos de apresentação.

2

<guided-ac-css />

Usado no cabeçalho do modelo de apresentação e substituído pelo script CSS apropriado inclui para preenchimento automático.

3

<guided-ac-form-content />

Usado no formulário de pesquisa (entre as tags <form> e </form> ) do modelo de apresentação, em vez de codificar as tags de preenchimento automático no formulário. As tags são substituídas pelo HTML apropriado que é necessário para fazer o preenchimento automático funcionar.

4

<guided-ac-javascript />

Gera os links para o JavaScript de preenchimento automático. Para melhor desempenho, é recomendável colocar essa tag perto da parte inferior da página antes de fechar a tag "body" .

Armazenar

Use as tags a seguir para testar e exibir a loja em que um usuário está no momento.

Adicionar tag

Descrição

3

<guided-store />

Gera a loja atual.

2

<guided-if-store-defined> <guided-else-store-defined> </guided-if-store-defined>

Detecta se o usuário está em uma loja.

1

<guided-if-store gsname="store"> <guided-else-store> </guided-if-store>

Detecta se o usuário está no armazenamento que o parâmetro gsname especifica.

Zonas

Adicionar tag

Descrição

3

<guided-zone gsname="zone area">

Você pode envolver qualquer conteúdo em tags de zona para criar uma zona fora dessa área. Isso permite usar regras comerciais para exibir a zona conforme necessário. Por padrão, as zonas são sempre exibidas. Você pode usar os parâmetros de pesquisa e de faceta opcionais para indicar qual pesquisa ou faceta está associada à zona. Essa funcionalidade permite que o software ignore pesquisas ou facetas quando uma zona está oculta, melhorando o desempenho do tempo de pesquisa. Os atributos de altura e largura são opcionais e são usados para configurar como o espaço reservado é exibido no Construtor visual de regras quando uma zona é removida.

Use a tag guided-if-facet[-not]-visible em vez da zona onde for possível. Ele simplifica o modelo de apresentação.

2

<guided-if-zone gsname="zone area"> <guided-else-zone> </guided-if-zone>

Esse conjunto de tags permite o teste se uma zona estiver sendo exibida no momento. É útil quando você tem conteúdo em outro lugar da página que deseja exibir apenas quando a zona for exibida.

Indicadores de loop

Você pode usar cada um dos seguintes indicadores de loop em qualquer um desses blocos de loop:

  • resultados guiados
  • valores de faceta guiada
  • navegação estrutural guiada
  • itens de menu guiado
  • páginas guiadas

Adicionar tag

Descrição

3

<guided-if[-not]-first><guided-else[-not]-first> </guided-if[-not]-first>

Essa condição é verdadeira quando a iteração atual é a primeira iteração do loop. Isso não significa necessariamente o primeiro resultado ou a primeira página, mas o primeiro mostrado. Se o visitante do site estiver na página 2 de um conjunto de resultados que seja 10 por página, a primeira iteração será resultado 11.

2

<guided-if[-not]-last><guided-else[-not]-last> </guided-if[-not]-last>

Essa condição é verdadeira quando a iteração atual é a última iteração do loop. Isso não significa necessariamente o último resultado ou a última página, mas o último mostrado no contexto atual (página). Se o visitante do site estiver na página 1 de um conjunto de resultados que contém 200 resultados, mas apenas 10 resultados por página, a última iteração será resultado 10 em vez de resultado 200.

3

<guided-if[-not]-odd><guided-else[-not]-odd> </guided-if[-not]-odd>

Essa condição é verdadeira quando a iteração atual é uma iteração ímpar do loop (versus uma iteração par). Isso é útil para exibir cores de linha variáveis.

4

<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>

Essa condição é verdadeira quando a iteração atual é uma iteração par do loop (versus uma iteração ímpar). Isso é útil para exibir cores de linha variáveis.

5

<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>

Essa condição é verdadeira quando a iteração atual é uma iteração par do loop. Isso é útil para exibir cores de linha variáveis.

6

<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>

Inclui o texto entre eles se a iteração atual não for a primeira ou a última.

7

<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>

Inclui o texto entre eles se a iteração atual for a primeira ou a última.

8

<guided-loop-index>

Um número inteiro (começando em 0) cujo valor é incrementado para cada iteração do loop.

9

<guided-loop-counter>

Um número inteiro (começando em 1) cujo valor é incrementado para cada iteração do loop.

Idioma Diverso

As tags a seguir estão disponíveis para permitir que você faça coisas mais avançadas com seu modelo, como criar sua própria mini faceta.

Adicionar tag

Descrição

3

<guided-current-path>

Fornece o caminho atual usado. Normalmente, é usado para criar um link que adiciona um novo parâmetro à pesquisa existente. Por padrão, o caminho é URL escapado. Você pode especificar qual modo de escape deseja usar por meio do parâmetro escape.

Exemplo:

<a href="<guided-current-path />&lang=fr"> French Version

Neste exemplo, uma regra de processamento de pesquisa usa lang para selecionar a versão em francês.

O caminho atual sempre tem pelo menos um parâmetro de consulta. Se não houver nenhum outro parâmetro de consulta, ele será definido como q=* facilitando a adição de mais parâmetros.

2

Caminho básico

Se quiser criar um link usando o basepath, use / no início do href e adicione parâmetros.

<a href="/">All Products</a> Would create a link "All Products" to your basepath, for example https://search.mycompany.com/

1

<guided-query-param gsname="query_parameter">

Permite capturar o valor existente de um parâmetro de consulta que está no URL. Se o seu parâmetro não existir, essa tag retornará uma string vazia. Se você não especificar uma opção de escape a sequência de caracteres retornada é automaticamente um escape HTML, você pode especificar um escape de HTML ou URL.

Exemplo:

&amp;lt;guided-query-param&amp;nbsp;gsname=&quot;q&quot;&amp;nbsp;/&amp;gt;
dá&amp;nbsp;o&amp;nbsp;value&amp;nbsp;calças

&amp;lt;guided-query-param&amp;nbsp;gsname=&quot;lang&quot;&amp;nbsp;/&amp;gt;
dá nbsp;você&amp;nbsp;o&amp;nbsp;value&amp;nbsp;en

&amp;lt;guided-query-param&amp;nbsp;gsname=&quot;test&quot;&amp;nbsp;/&amp;gt;
dá&amp;nbsp;an&amp;nbsp;empty&amp;nbsp;string
&amp;nbsp;
&amp;nbsp;nbsp; nbsp; bsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;   &lt;/p>  &lt;/td>

4

<guided-query-param-name gsname="param#" offset="offset_number" />

A Pesquisa guiada tem a noção de um número de consulta, que é usado no controle de navegação estrutural. guided-query-param-name permite definir parâmetros como parte de um link no modelo de apresentação, onde a Pesquisa guiada calcula o número de consulta correto para você. O gsname contém um "x", que a Pesquisa guiada substitui pelo número correto. O valor de deslocamento pode ser 0 - 15, onde 0 indica que o próximo número de consulta disponível é usado. Um 1 indica que você deseja adicionar 1, e assim por diante.

Combinado com guided-current-path , você pode criar seu próprio link de mini faceta ou permitir um nível de detalhamento adicional.

Exemplo:

<a href="<guided-current-path         />&<guided-query-param-name gsname="q#" offset="0"         />=mens&<guided-query-param-name gsname="x#" offset="0"         />=category" >Category:Men</a>        

<a href="<guided-current-path         />&<guided-query-param-name gsname="sp_q_exact_#" offset="0"         />=mens&<guided-query-param-name gsname="sp_x_#" offset="0"         />=category&<guided-query-param-name gsname="sp_q_exact_#" offset="1"         />=Jeans&<guided-query-param-name gsname="sp_x_#" offset="1"         />=product-type" >Cat:Men - Product:Jeans</a>

5

<guided-include gsfile="filename" />

Permite incluir outros arquivos de modelo. Essa funcionalidade significa que você pode criar vários modelos usando submodelos como módulos.

No exemplo a seguir, os arquivos de navegação estrutural e facetas são incluídos:

<guided-include gsfile='breadcrumbs.tmpl' /> <guided-include gsfile='facets.tmpl' />

As inclusões dinâmicas não são compatíveis. Em outras palavras, gsfile não pode ser uma variável.

6

<guided-search-time>

Identifica quanto tempo a pesquisa demorou. O valor de tempo de pesquisa retornado é especificado em ms.

7

<guided-fall-through-searches>

Retorna a contagem de pesquisas de núcleos usadas para criar a página de resultados de pesquisa.

8

<guided-if-fall-through-search></guided-if-fall-through-search>

Testa se a contagem de pesquisas principais é maior que uma.

9

<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>

Essa condição é verdadeira quando a iteração atual é uma iteração par do loop (versus uma iteração ímpar). Isso é útil para exibir cores de linha variáveis.

10º

<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>

Essa condição é verdadeira quando a iteração atual é uma iteração par do loop. Isso é útil para exibir cores de linha variáveis.

11º

<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>

Inclui o texto entre eles se a iteração atual não for a primeira ou a última.

12º

<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>

Inclui o texto entre eles se a iteração atual for a primeira ou a última.

13º

<guided-if-first-search><guided-else-first-search> </guided-if-first-search>

Permite verificar se você está ou não na pesquisa inicial (a consulta foi o resultado de uma pesquisa na caixa de pesquisa).

14.

<guided-search-url />

Você pode usar essa tag no modelo para salvar você da codificação rígida da ação do formulário de pesquisa. Ele detecta quando você está no ambiente Preparado ou Ao vivo e as alterações são feitas de forma correspondente.

15.

<guided-if-query-param-defined gsname="query_parameter"> <guided-else-query-param-defined> </guided-if-query-param-defined>

Esse conjunto de tags permite testar quais parâmetros de CGI são definidos no caminho de pesquisa. Você pode testar os valores dos parâmetros somente se eles estiverem definidos.

16º

<guided-next-query-number>

O mecanismo de pesquisa guiada que direciona o modelo tem a noção de números de consulta flutuantes em que cada novo link gerado pelo mecanismo usa o próximo número de consulta disponível. Essa tag permite que você capture o próximo número ou deslocamentos da consulta para que possa criar links personalizados que aprofundem o conjunto de resultados. Offset permite deslocar para o próximo número de query. Por exemplo, se você selecionou uma faceta, o próximo número da consulta é 2, com um deslocamento de 1, o número da consulta retornado é 3.

17º

<guided-custom-var gsname="custom_variable">

Permite capturar o valor existente de uma variável personalizada que suas regras de processamento definem. Se você não especificar uma opção de escape a cadeia de caracteres retornada é um escape HTML automático, poderá especificar html , url , js ou 0 . Se você usar uma regra de processamento para copiar um parâmetro CGI de entrada para uma variável personalizada e, em seguida, exibir ou usar essa variável no modelo com escape definido como nenhum ou js, será possível criar uma vulnerabilidade XSS na pesquisa.

18º

<guided-if-custom-var-defined gsname="custom_variable"> <guided-else-custom-var-defined> </guided-if-custom-var-defined>

Habilita o teste se uma variável personalizada estiver definida nas regras de processamento (limpeza de consulta, processamento pré-pesquisa e processamento pós-pesquisa).

19º

<guided-general-field gsname="searchname" field="fieldname">

Permite exibir o conteúdo de um campo geral definido no template de transporte. Se você não especificar uma opção de escape, a cadeia de caracteres retornada será codificada no formato especificado no modelo de transporte para esse campo. A especificação de uma opção de escape se aplica sobre qualquer formato em que você estiver codificando o campo como no modelo de transporte. Você pode especificar html , url , js , json ou 0 .

20º

<guided-if-general-field gsname="searchname" field="fieldname"> <guided-else-general-field> </guided-if-general-field>

Permite o teste se o conteúdo de um campo geral, conforme definido no modelo de transporte, existir.

21º

<guided-cookie-value gsname="cookie_name">

Permite capturar o valor de um cookie, supondo que o cookie esteja disponível. Se você não especificar uma opção de escape a cadeia de caracteres retornada é um escape HTML automático, poderá especificar html , url , js , json ou 0 .

22º

<guided-if-cookie gsname="cookie_name"> <guided-else-cookie> </guided-if-cookie>

Habilita o teste se houver um cookie.

23º

<guided-banner gsname="banner area">

Gera o banner para uma determinada área. Os atributos opcionais de largura e altura são usados no Construtor visual de regras para permitir a exibição de um espaço reservado significativo para permitir que os usuários selecionem um banner. Por padrão, os banners não são escapados. Em vez disso, você deseja inserir HTML no template de apresentação. No entanto, se você estiver criando um modelo JSON, considere usar a opção de escape js .

Exemplo:

<guided-banner gsname="top" width="400px"  height="50px"/>

24º

<guided-if-banner-set gsname="banner area"> <guided-else-banner-set> </guided-if-banner-set>

Ativa o teste se uma área de banner estiver definida.

25.

<guided-if-simulator-mode> <guided-else-simulator-mode> </guided-if-simulator-mode>

Permite detectar quando você está visualizando sua pesquisa no Simulador ou no Construtor visual de regras. Normalmente, é usado para exibir informações de depuração adicionais para você.

26º

<guided-if-tnt-business-rules> <guided-else-tnt-business-rules> </guided-if-tnt-business-rules>

Permite detectar se você tem alguma regra comercial referenciando uma campanha Adobe Target . Normalmente, é usada como parte da integração com Adobe Target para evitar a ocorrência dos servidores Target quando não é necessário.

27º

<guided-redirect />

Por padrão, os redirecionamentos são executados automaticamente. No entanto, se você configurou pesquisa/merchandising do site para retornar uma resposta XML ou JSON ao seu aplicativo da Web, é possível optar por analisar a resposta 302/301 no aplicativo da Web ou enviar o redirecionamento para você como parte do conjunto de resultados. Se você estiver transmitindo o redirecionamento como parte do conjunto de resultados, essa tag poderá ser usada no modelo para exibir o local de redirecionamento.

28º

<guided-if-redirect> <guided-else-redirect> </guided-if-redirect>

Quando você configura a pesquisa/comercialização do site para redirecionar redirecionamentos no conjunto de resultados, esse conjunto de tags pode ser usado para determinar se há um redirecionamento para a saída.

29º

<guided-lt /> <guided-gt />

Esse conjunto de tags permite que você incorpore tags de modelo guiadas em atributos HTML.

Exemplo:

<guided-lt/>div <guided-if-facet-long>         style="height: 125px; overflow:         auto;"</guided-if-facet-long><guided-gt/>

Tags de modelo de transporte

Os modelos de transporte são modelos XML que passam dados da pesquisa de backend para a camada de apresentação da Pesquisa guiada.

Na camada de apresentação, você pode ter um único modelo de apresentação que apresente os resultados de várias pesquisas. Cada pesquisa pode usar o mesmo modelo de transporte ou um modelo de transporte personalizado para passar os dados para a camada de apresentação.

Como o modelo de transporte é usado apenas para transmitir dados para a camada de apresentação, ele não tem nenhum HTML preocupado com a exibição dos resultados de pesquisa. O modelo de transporte usa tags XML de modelo de transporte para transmitir os resultados da pesquisa para preencher os componentes de Pesquisa guiada, como facetas, navegação estrutural e menus. Dentro dessas tags, as tags de modelo de pesquisa padrão são usadas para exibir os valores reais.

Consulte Edição de uma apresentação ou de um modelo de transporte.

Consulte Pesquisar marcas de modelo.

Tag do modelo de transporte

Descrição

<guided-xml></guided-xml>

As tags XML raiz que a camada de apresentação usa para detectar o que é analisado do modelo de transporte.

<general></general>

As tags delimitam as tags do modelo de pesquisa que fornecem dados de resumo com base no conjunto de resultados. Normalmente, essas tags contêm tags de pesquisa para o número total de resultados, resultado menor e resultado mais alto. Você pode definir qualquer número de campos globais adicionais desejados com a tag de campo geral , como no exemplo a seguir:

<general>   <total><search-total /></total>   <lower><search-lower /></lower>   <upper><search-upper /></upper>   <general-field name="my_custom_field">Some global content</general-field> </general>

<results></results>

As tags são vinculadas aos resultados da pesquisa, de modo que a Pesquisa guiada saiba onde procurá-las.

<result></result>

As tags são vinculadas a cada resultado de pesquisa, de modo que a Pesquisa guiada reconheça onde o conteúdo de um único resultado de pesquisa começa e termina, como no exemplo a seguir:

<results>   <search-results>     <result>       <index><search-index /></index>       <loc><search-cdata><search-url length="500" /></search-cdata></loc>     </result>   </search-results> </results>

<attribute-table name="tablename">

Permite executar um loop por cada item em uma lista de vários valores para um único resultado. Use essa tag somente em um resultado. Sua finalidade é permitir a iteração sobre atributos que pertencem a um campo de resultado, como no exemplo a seguir:

<results>   <search-results>     <result>       <index><search-index /></index>       <loc><search-url /></loc>       <title><search-title /></title>       <attribute-table name="downloads">         <field name="download_title"><search-display-field name="download_title" /></field>         <field name="download_link" delimiter="|"><search-display-field name="download_link" /></field>       </attribute-table>     </result>   </search-results> </results>

<facets></facets>

Transmite os resultados que preenchem as facetas.

<dynamic-facet></dynamic-facet>

Você pode designar uma faceta como uma faceta dinâmica e como membro de um painel de facetas. No entanto, seu tratamento é independente em relação às tags de modelo de apresentação relacionadas.

Em outras palavras, o aninhamento de um contexto de loop do painel de facetas em um contexto de loop de facetas dinâmico, ou vice-versa, não é permitido.

Para facetas dinâmicas e retornadas, somente as facetas dinâmicas que foram retornadas para uma determinada pesquisa são visíveis no contexto de loop do painel de facetas.

<facet name="name"></facet>

Cada faceta tem suas próprias tags de faceta, onde o parâmetro name corresponde ao nome da faceta. As tags de pesquisa são usadas nas tags de faceta para os valores de faceta, como no exemplo a seguir:

<facets>   <facet name="brand">     <values><search-field-value-list name="brand" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="brand" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet>   <facet name="category">     <values><search-field-value-list name="category" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="category" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet> </facets>

As contas que usam facetas com slot podem usar a tag dinâmica e a tag de nomes para exibição. Ambas as tags ajudam a facilitar o mapeamento entre facetas com slot e aspectos reais ao criar regras de negócios.

<facets>   <facet name="facet_values01">  <dynamic>1</dynamic>  <display-names><search-field-value-list name="facet_names01" quotes="no" commas="yes" data="values" sortby="values" /></display-names>     <values><search-field-value-list name="facet_values01" quotes="no" commas="yes" data="values" sortby="values" /></values>     <counts><search-field-value-list name="facet_values01" quotes="no" commas="yes" data="counts" sortby="values" /></counts>   </facet>

<search-display-field separator=",">

O atributo separator permite alterar o delimitador usado ao gerar dados de campo de exibição de pesquisa para listas. O padrão é uma vírgula.

Geralmente, o delimitador usado deve ser algo que não aparece imediatamente no conteúdo do campo.

<suggestions></suggestions>

Encapsule suas sugestões de Você quis dizer com as tags para que a Pesquisa guiada reconheça quais nós XML contêm sugestões.

Consulte Sobre você quis dizer.

<suggestion></suggestion>

Vincule cada sugestão Você quis dizer com tags, como no exemplo a seguir:

<search-if-suggestions>   <suggestions>     <search-suggestions>       <suggestion><search-suggestion-text /></suggestion>     </search-suggestions>   </suggestions> </search-if-suggestions>

Consulte Sobre você quis dizer.

Pesquisar tags de modelo

Um modelo de pesquisa é um arquivo HTML que inclui tags de modelo definidas por pesquisa/comercialização do site. Essas tags indicam como os resultados da pesquisa são formatados. A referência a seguir contém uma breve descrição de cada tag de modelo de pesquisa e seus atributos.

OBSERVAÇÃO

Use somente as tags do modelo de pesquisa nos arquivos do modelo de transporte (.tpl).

Você pode selecionar entre os seguintes grupos de tags de modelo de pesquisa e material de referência.

As tags válidas somente no loop de resultados incluem o seguinte:

As tags válidas em todo o modelo incluem o seguinte:

Tópicos de referência do modelo de pesquisa

Sobre as tags de loop Resultados

A tag de loop de resultados é o método de trabalho do sistema de modelo. Quando a tag é encontrada durante uma pesquisa, o HTML é repetido e outras tags entre as tags de loop de resultados inicial e final, substituindo quaisquer outras tags pelos resultados da pesquisa.

<search-results> ... </search-results>

As tags de loop de resultados rodam o HTML que mostra os resultados da pesquisa. O HTML entre as tags é repetido para cada resultado e é exibido na página.

As tags a seguir são válidas somente no loop de resultados:

Tags de sequência de loop de resultados

As tags a seguir retornam uma string.

Consulte Sobre as tags de loop de Resultados.

Adicionar tag

Descrição

3

<search-index>

Retorna o índice numérico do resultado atual.

2

<search-title length="XX">

Retorna o título da página do resultado atual. O atributo de comprimento opcional é usado para limitar o comprimento das sequências de caracteres exibidas, com um padrão de 80 caracteres.

3

<search-bodytext length="XX" encoding="html/javascript/json/perl/url/none">

Retorna o texto do corpo, começando na parte superior da página. Os termos relevantes são mostrados em negrito. O atributo de comprimento opcional é usado para limitar o comprimento das sequências de caracteres exibidas, com um padrão de 80 caracteres. O atributo de codificação é opcional e pode codificar caracteres de saída com codificação HTML (padrão), codificação Javascript, codificação Perl ou nenhum.

4

<search-description length="XX" encoding="html/javascript/json/perl/url/none">

Retorna a descrição do resultado atual. Se a meta tag de descrição existir e o atributo de conteúdo não estiver vazio, esse texto será exibido. Caso contrário, o início do texto do corpo da página será exibido. O atributo de comprimento opcional é usado para limitar o comprimento das sequências de caracteres exibidas, com um padrão de 80 caracteres.

O atributo opcional de codificação controla se a saída é codificada em HTML, codificada em JavaScript, Codificada em Perl, codificada em URL ou não, para saída na página de resultados. O valor padrão da codificação é html . Normalmente, não é necessário especificar o atributo de codificação.

5

<search-score rank="dynamic/static/dynamic-raw/static-raw/final-raw" precision="XX">

Retorna a pontuação do resultado atual, que é um número 0 - 100. Se você tiver definido um campo de classificação em Opções > Metadados > Definições , poderá exibir a classificação de página dinâmica definindo o atributo de classificação como dinâmico ( <search-score rank="dynamic"> ). Você pode exibir a classificação de página estática definindo o atributo de classificação como estático ( <search-score rank="static"> ). Você pode usar o atributo de precisão opcional para especificar o número de casas decimais a serem exibidas. O padrão é 0, que exibe a pontuação inteira).

6

<search-date length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id">

Retorna a data do resultado atual. O valor de texto opcional "nenhum" será exibido se não houver uma data associada ao resultado atual. Se o valor opcional "nenhum" não for fornecido, o texto "Nenhuma data" será exibido se não houver uma data associada ao resultado atual.

O atributo "date-format" tem uma cadeia de caracteres de formato de data no estilo UNIX, como "%A, %B %d, %Y" (para "segunda-feira, 25 de julho de 2016"). O padrão "gmt" é "yes" e controla se a parte de tempo da string de data deve ser saída em GMT ("yes") ou no fuso horário da conta ("no").

O atributo "language" controla o idioma e as convenções de localidade da string de data de saída. "0" (padrão) significa "Usar idioma da conta". "2" significa "Usar Idioma do Documento". O valor "language" "1" é reservado para uso futuro. Qualquer outro valor de "idioma" é interpretado como um identificador de idioma específico, por exemplo, "en_US" significa "inglês (Estados Unidos)".

O atributo de comprimento opcional é usado para limitar o comprimento das sequências de caracteres exibidas, com um padrão de 80 caracteres.

7

<search-size>

Retorna o tamanho do resultado atual em bytes.

8

<search-url length="XX" encoding="html/javascript/json/perl/url/none">

Retorna o URL do resultado atual.

Use o atributo opcional length para limitar o comprimento das sequências de caracteres exibidas, com um padrão de caracteres ilimitados.

O atributo de codificação é opcional e pode codificar caracteres de saída com codificação HTML, codificação Javascript, codificação Perl ou nenhum.

9

<search-url-path-query length="XX">

Retorna as partes do caminho e da consulta, incluindo o ponto de interrogação do URL do resultado atual.

Use o atributo opcional length para limitar o comprimento das sequências de caracteres exibidas, com um padrão de caracteres ilimitados.

10º

<search-context length="XX" encoding="html/javascript/json/perl/url/none">

Retorna a próxima linha de contexto do termo de pesquisa. Os termos relevantes são mostrados em negrito. Chame essa tag repetidamente para exibir mais de uma linha de contexto para o resultado atual.

Use o atributo opcional length para limitar o comprimento das sequências de caracteres exibidas, com um padrão de 80 caracteres. O atributo length é ignorado se essa tag for colocada por conjuntos de tags <search-if-context> ou <search-if-any-context> que contêm um atributo de comprimento.

O atributo de codificação é opcional e pode codificar caracteres de saída com codificação HTML (padrão), codificação Javascript, codificação Perl ou nenhum.

11º

<search-display-field name="field-name" length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id" encoding="html/javascript/json/perl/url/none" quotes="yes/no" commas="yes/no" units="miles/kilometers" separator="|">

Essa tag avançada exibe o conteúdo do campo de metadados (url, título, desc, chaves, target, corpo, alt, data, charset e idioma ou campos definidos em Opções > Metadados > Definições) especificados no atributo name , para o resultado atual. Por exemplo:

<search-display-field name="title" length="70" none="no title">

Gera o título da página para um resultado de pesquisa. Se o atributo opcional nenhum for especificado, seu valor será exibido na página de resultados somente se não houver conteúdo associado ao campo.

Os atributos date-format , gmt e language só são relevantes se o tipo de conteúdo do campo especificado for date .

O atributo date-format tem uma cadeia de caracteres de formato de data no estilo UNIX como %A, %B %d, %Y (para segunda-feira, 25 de julho de 2016). o gmt assume como padrão sim e controla se a parte de tempo da string de data é saída em GMT ( sim ) ou o fuso horário da conta ( não ).

Consulte Sequências de caracteres do formato de data.

O atributo de idioma controla as convenções de idioma e localidade da string de data de saída. 0 (padrão) significa "Usar idioma da conta". 2 significa "Usar idioma do documento". O valor do idioma 1 é reservado para uso futuro). Qualquer outro valor de idioma é interpretado como um identificador de idioma específico, por exemplo, en_US significa "Inglês (Estados Unidos)".

Consulte Identificadores de idioma.

O atributo opcional length é usado para limitar o comprimento das sequências de caracteres exibidas, com um padrão de 80 caracteres.

O atributo opcional de codificação controla se a saída é codificada em HTML, codificada em JavaScript, Codificada em Perl, codificada em URL ou não, para saída na página de resultados. O valor padrão da codificação é html . Normalmente, não é necessário especificar o atributo de codificação.

O atributo opcional aspas controla se a saída dos itens individuais é rodeada por aspas duplas (ou aspas simples, se encoding=perl ). O valor padrão de aspas é não .

O atributo opcional de vírgulas controla se a saída de itens individuais é separada por vírgulas. O valor padrão de vírgulas é sim . O atributo de vírgulas é ignorado para campos de tipo não listado.

O atributo unidades opcional controla as unidades de distância aplicadas a um campo de saída de pesquisa de proximidade. O valor padrão de unidades é determinado a partir da configuração "Unidades padrão" do campo de tipo de local associado ao campo de saída de pesquisa de proximidade especificado.

Consulte Sobre pesquisa de proximidade.

O atributo separator opcional define o caractere único, ou delimitador, que é inserido entre os valores da saída para campos de tipo de lista.

12º

<search-display-field-values name="field-name"> ...<search-display-field-values>

Essa tag cria um loop para enumerar valores de campos de metadados (url, título, desc, chaves, target, corpo, alt, data, charset e idioma ou campos definidos em Opções > Metadados > Definições ) para o resultado atual. Não aninhe esta tag dentro de outra tag <search-display-field-values> . O atributo name especifica o nome do campo que contém os valores a serem enumerados. Essa tag é mais útil com campos que têm o atributo Lista de permissões marcado (em Opções > Metadados > Definições ).

13º

<search-display-field-value date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">

Essa tag gera o valor do campo de metadados (url, título, desc, chaves, target, corpo, alt, data, charset e idioma ou campos definidos em Opções > Metadados > Definições ) para a iteração de loop <search-display-field-values> atual. Esta tag só é válida dentro de um loop <search-display-field-values> . Os atributos date-format , gmt e language só são relevantes se o tipo de conteúdo do nome do campo especificado na tag <search-display-field-values> de inclusão for date . O atributo date-format pega uma cadeia de caracteres de formato de data no estilo UNIX como "%A , %B %d , %Y " (para "segunda-feira, 25 de julho de 2016"). O atributo gmt assume como padrão sim e controla se a parte de tempo da cadeia de data é de saída em GMT ( sim ) ou o fuso horário da conta ( não ).

O atributo de idioma controla as convenções de idioma e localidade da string de data de saída. 0 (padrão) significa "Usar idioma da conta". Qualquer outro valor de idioma é interpretado como um identificador de idioma específico, por exemplo, en_US significa "Inglês (Estados Unidos)".

O atributo opcional de codificação controla se a saída é codificada em HTML, codificada em JavaScript, Codificada em Perl, codificada em URL ou não, para saída na página de resultados. O valor padrão da codificação é html . Normalmente, não é necessário especificar o atributo de codificação.

14.

<search-display-field-value-count name="field-name">

Gera o número total de valores no resultado atual para o campo de metadados (url, título, desc, chaves, target, corpo, alt, data, charset e idioma ou campos definidos em Opções > Metadados > Definições ) especificado com o atributo de nome. Essa tag pode aparecer em qualquer lugar no loop de resultados.

15.

<search-display-field-value-counter>

Gera o contador ordinal (1, 2, 3 e assim por diante) para a iteração de loop <search-display-field-values> atual. Esta tag só é válida dentro de um loop <search-display-field-values> .

16º

<search-dynamic-facet-fields>

Inicia um contexto de loop para qualquer campo de aspecto dinâmico retornado para esta pesquisa.

17º

<search-dynamic-facet-field-name>

Gera o nome do campo de faceta dinâmica atual, para essa iteração de loop.

18º

<search-result-trace encoding="html/javascript/ json/perl/url/none">

Gera informações relacionadas à colocação do resultado atual, por exemplo, quaisquer ações baseadas em resultados que afetaram a posição do resultado.

O formato de saída dessa tag é JSON, como no exemplo a seguir:

{   "sliceID": 5,   "indexID": 5894,   "finalScore": 98.5,   "dynamicScore": 15.3,   "staticScore": 55.456,   "position": 1,   "rbtaActionListID": 117,   "rbtaActionID": 57 }

O atributo de codificação é opcional; o valor padrão é html .

Observação: Esta tag só tem saída se sp_trace=1 for especificado com os parâmetros de consulta de pesquisa principais.

Consulte a linha 48 na tabela localizada em Backend search CGI parameters.

Tags condicionais do loop de resultados

As tags a seguir incluem condicionalmente o HTML entre elas.

Consulte Sobre as tags de loop de Resultados.

Adicionar tag

Descrição

3

<search-if-title> ... </search-if-title>

<search-if-not-title> ... </search-if-not-title>

Essas tags incluem o HTML entre elas se a próxima chamada para <search-title> retornar (ou não retornar) o texto do título do documento.

2

<search-if-description length="XX"> ... /search-if-description>

<search-if-not-description> ... </search-if-not-description>

Essas tags incluem o HTML entre elas se a próxima chamada para <search-description> retornar (ou não retornar) o texto da descrição do documento.

3

<search-if-bodytext> ... </search-if-bodytext>

<search-if-not-bodytext> ... </search-if-not-bodytext>

Essas tags incluem o HTML entre elas se a próxima chamada para <search-body-text> retornar (ou não retornar) o texto do corpo do documento.

4

<search-if-context length="XX"> ... </search-if-context>

<search-if-not-context> ... </search-if-not-context>

Essas tags incluem o HTML entre elas se a próxima chamada para <search-context> retornar (ou não retornar) uma string de contexto não vazia. O atributo length substitui o atributo length em qualquer tag <search-context> fechada.

5

<search-if-any-context length="XX"> ... /search-if-any-context>

<search-if-not-any-context> ... </search-if-not-any-context>

Essas tags incluem o HTML entre elas se houver (ou não) uma string de contexto associada ao resultado. O atributo length substitui o atributo length em qualquer tag <search-context> fechada.

6

<search-if-score lower="XX" upper="yy" rank="dynamic/static/dynamic-raw/static-raw/final-raw"> ... </search-if-score>

<search-if-not-score lower="XX" upper="yy" rank="dynamic/static"> ... </search-if-not-score>

Essas tags incluem o HTML entre elas se a pontuação do resultado atual for (ou não for) entre XX e YY. Útil para adicionar marcadores ou gráficos para mostrar a relevância do resultado. Se você tiver definido um campo de tipo de classificação em Opções > Metadados > Definições , poderá verificar a classificação de página dinâmica definindo o atributo de classificação como dinâmico ( <search-if-score rank="dynamic" lower=XX upper=YY> ). Você pode verificar a classificação de página estática definindo o atributo de classificação como estático ( <search-if-score rank="static" lower=XX upper=YY> ).

7

<search-if-field name="field-name" value="value"> ... </search-if-field>

<search-if-not-field name="field-name" value="value"> ... </search-if-not-field>

Essas tags avançadas incluem o HTML entre elas com base no fato de o campo especificado no atributo "name" ter ou não conteúdo. Se o atributo "valor" opcional for especificado, as tags incluirão o HTML entre elas, com base no fato de o valor especificado corresponder (ou não) ao valor do campo no resultado atual. Essas tags funcionam somente no loop de resultados (entre <search-results> e </search-results> tags).

Tags de link da âncora de loop de resultados

Consulte Sobre as tags de loop de Resultados.

Adicionar tag

Descrição

1

<search-link target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX"> ... </search-link>

Esse par de tags cria um link de âncora em torno do HTML entre elas. Quando o link é clicado, a página de resultados é exibida. Um atributo de destino opcional especifica a janela nomeada na qual os navegadores compatíveis com quadros devem exibir a página de resultados.

Defina o atributo hbx-enable como "sim" para aproveitar as vantagens da análise disponível por meio do HBX. Defina hbx-linboy-name com o nome de um campo Meta-data que você gostaria de rastrear. Por exemplo, para rastrear os resultados da pesquisa por número de SKU, defina hbx-linboy-name como o nome do campo Meta-data que contém as informações de SKU.

Campos do tipo data não são suportados no momento. O valor de hbx-linboy-name é anexado à ID do link na âncora gerada. O valor do atributo hbx-linboy-none é anexado à ID do link sempre que o campo Metadados nomeado estiver vazio. O valor de hbx-linboy-length limita o número de caracteres obtidos e exibidos da tag Meta. O número padrão de caracteres é 12.

2

<search-smart-link target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX"> ... </search-smart-link>

Esse par de tags é semelhante às tags <search-link> ... </search-link> . Quando os links de âncora gerados são clicados, a página de resultados é exibida, mas com a página rolada para a tag de âncora mais próxima antes do resultado. Para links de PDF, o visualizador do Acrobat exibe a página que contém o resultado. Um atributo de destino opcional especifica a janela nomeada na qual os navegadores compatíveis com quadros devem exibir a página de resultados.

Defina o atributo hbx-enable como "sim" para aproveitar as vantagens da análise disponível por meio do HBX. Defina hbx-linboy-name com o nome de um campo Meta-data que você gostaria de rastrear. Por exemplo, para rastrear os resultados da pesquisa por número de SKU, defina hbx-linboy-name como o nome do campo Meta-data que contém as informações de SKU.

Campos do tipo data não são suportados no momento. O valor de hbx-linboy-name é anexado à ID do link na âncora gerada. O valor do atributo hbx-linboy-none é anexado à ID do link sempre que o campo Metadados nomeado estiver vazio. O valor de hbx-linboy-length limita o número de caracteres obtidos e exibidos da tag Meta. O número padrão de caracteres é 12.

3

<search-if-link-extension> ... </search-if-link-extension>

<search-if-not-link-extension> ... </search-if-not-link-extension>

Essas tags incluem o HTML entre elas se um atributo de valor especificar uma extensão que corresponde ao final do URL para o resultado. Essa tag é útil para incluir um gráfico nos resultados da pesquisa com base na extensão do link. O atributo value é uma lista de uma ou mais extensões (separadas por espaço) da seguinte maneira: VALUE=".pdf" ou VALUE=".html .htm".

Tags condicionais de posição de loop

As tags a seguir incluem condicionalmente o texto entre elas. Eles só podem aparecer dentro das tags "looping": < search-results> e <search-field-values>. Eles são usados para testar a posição do resultado atual dentro do conjunto de resultados.

Consulte Sobre as tags de loop de Resultados.

Adicionar tag

Descrição

3

<search-if-first> ... </search-if-first>

<search-if-not-first> ... </search-if-not-first>

Essas tags incluem o texto entre elas se o resultado atual for (ou não for) o primeiro resultado na página (quando usado dentro de <search-results> ) ou o primeiro valor de campo (quando usado dentro de <search-field-values> ).

2

<search-if-last> ... </search-if-last>

<search-if-not-last> ... </search-if-not-last>

Essas tags incluem o texto entre elas se o resultado atual for (ou não for) o último resultado na página (quando usado dentro de <search-results> ) ou o último valor de campo (quando usado dentro de <search-field-values> ). Essa tag pode ser usada para inserir um separador entre os resultados. Por exemplo, isso insere uma tag <hr> entre os resultados:

<search-results>    <search-lt>tr<search-if-alt> class="alt"</search-if-alt><search-gt>       <td><search-url></td>    </tr> </search-results>

3

<search-if-inner> ... </search-if-inner>

<search-if-not-inner> ... </search-if-not-inner>

Essas tags incluem o texto entre elas se o resultado atual não for o primeiro nem o último resultado na página (quando usado dentro de <search-results> ) ou se não for o primeiro nem o último valor do campo (quando usado dentro de <search-field-values> ). A versão not da tag testa se o resultado é o primeiro ou o último.

4

<search-if-alt> ... </search-if-alt>

<search-if-not-alt> ... </search-if-not-alt>

Essas tags incluem o texto entre elas se o resultado atual for (ou não for) um resultado alternativo na página (quando usado dentro de <search-results> ) ou um valor de campo alternativo (quando usado dentro de <search-field-values> ). Os resultados "alternativos" são o segundo, o quarto, o sexto e assim por diante, na página. Este exemplo aplica uma classe diferente a linhas de tabela alternativas. Observe o uso de <search-lt> e <search-gt> para permitir que a tag <search-if-alt> seja colocada "dentro" da tag <tr> .

    <search-results>        <search-lt>tr<search-if-alt> class="alt"</search-if-alt><search-gt>           <td><search-url></td>        </tr>     </search-results>

5

<search-if-even> ... </search-if-even>

<search-if-not-even> ... </search-if-not-even>

Essas tags incluem o texto entre elas se o resultado atual for (ou não for) um resultado par numerado (quando usado dentro de <search-results> ) ou um valor de campo par numerado (quando usado dentro de <search-field-values> ). Um resultado de pesquisa é par se seu valor <search-index> for par. Em outras palavras, se sua posição dentro de todo o conjunto de resultados for par. Isso pode ser diferente de <search-if-alt> que testa a posição de um resultado na página, não dentro do conjunto de resultados inteiro. Os dois quadros seguintes ilustram a diferença:

Primeira página, sp_n=1

Índice

Resultado

Mesmo?

Alt?

3

Primeiro resultado

Não

Não

2

Segundo resultado

Sim

Sim

3

Terceiro resultado

Não

Não

4

Quarto resultado

Sim

Sim

5

Quinto resultado

Não

Não

Página posterior, sp_n=10

Índice

Resultado

Mesmo?

Alt?

10º

Décimo resultado

Sim

Não

11º

Décimo primeiro resultado

Não

Sim

12º

Décimo segundo resultado

Sim

Não

13º

Décimo terceiro resultado

Não

Sim

14.

Décimo quarto resultado

Sim

Não

Finalmente, observe que <search-if-even> é sempre o mesmo que <search-if-alt> para valores de campo de pesquisa, pois valores de campo não são paginados.

Tags de lista de valores de campo

Os seguintes valores de campo de saída de tags avançadas e dados relacionados do conjunto inteiro de resultados de pesquisa. Essas tags só produzem saída para campos especificados pelos parâmetros CGI sp-sfvl-field na consulta de pesquisa.

Adicionar tag

Descrição

1

<search-field-value-list name="field-name" quotes="yes/no" commas="yes/no" data="values/counts/results" separator="X" sortby="none/values/counts/results" max-items="XX" date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">

Essa tag exibe uma lista de valores de campo exclusivos, contagens de valor ou contagens de resultado em todo o conjunto de resultados.

Essa tag só gera saída para campos especificados pelos parâmetros CGI sp_sfvl_field na consulta de pesquisa. O atributo opcional "aspas" controla se a saída de itens individuais é rodeada por aspas duplas (ou aspas simples, se encoding=perl). O valor padrão de "aspas" é "sim". O atributo opcional "vírgulas" controla se a saída de itens individuais é separada por vírgulas. O valor padrão de "vírgulas" é "sim". O atributo opcional "data" controla se cada valor de campo exclusivo é de saída (data="values"), a contagem total de cada valor de campo exclusivo é de saída (data="count") ou o número de resultados que contém cada valor exclusivo (data="results") é de saída. O valor padrão de "dados" é "valores". Para campos que não são do tipo lista, data="count" e data="results" são equivalentes. O atributo separator define o caractere único, ou delimitador, a ser inserido entre os valores da saída. O atributo opcional "sortby" controla a ordem da saída; Sortby="none" significa sem uma ordem específica, sortby="values" significa classificar por valores de campo (em ordem crescente ou decrescente de acordo com a propriedade Sorting do campo), sortby="count" significa classificar em ordem decrescente de contagens de valor de campo e ordenar por="results" significa classificar em ordem decrescente do número de resultados que contém cada valor.

Observe que sortby="count" e sortby="results" são equivalentes para campos de tipo não listado. O atributo opcional "itens máximos" limita o número de itens a serem enviados. O valor padrão de "itens máximos" é -1, o que significa "saída de todos os itens".

Existe um limite absoluto de 100 para itens máximos. Os atributos "date-format", "gmt" e "language" só são relevantes se o tipo de conteúdo do campo especificado for "date". O atributo "date-format" tem uma cadeia de caracteres de formato de data no estilo UNIX, como "%A, %B %d, %Y" (para "segunda-feira, 25 de julho de 2016"). O padrão "gmt" é "yes" e controla se a parte de tempo da string de data deve ser saída em GMT ("yes") ou no fuso horário da conta ("no").

Consulte Sequências de caracteres do formato de data.

O atributo "language" controla o idioma e as convenções de localidade da string de data de saída. "0" (padrão) significa "Usar idioma da conta". Qualquer outro valor de "idioma" é interpretado como um identificador de idioma específico, por exemplo, "en_US" significa "inglês (Estados Unidos)". O atributo opcional "encoding" controla se os caracteres da string de saída são codificados em HTML, codificados em JavaScript, codificados em Perl, codificados em URL ou não, para saída na página de resultados. O valor padrão de "encoding" é "html".

Consulte Identificadores de idioma.

2

<search-field-value-list-count name="field-name" value="field-value" results="yes/no">

Essa tag exibe informações de contagem para uma determinada lista de valores de campo de pesquisa. Há três usos distintos para essa tag. Se somente o atributo "name" for fornecido, essa tag resultará no número de valores exclusivos para o campo nomeado em todo o conjunto de resultados. Se os atributos "name" e "value" forem fornecidos, essa tag resultará na contagem total do valor fornecido dentro de todo o conjunto de resultados (para results="no") ou na contagem total de resultados contendo o valor especificado em todo o conjunto de resultados (para results="yes"). O valor padrão de "resultados" é "não". Observação: Para campos de tipo não listado, results="yes" e results="no" são equivalentes. O valor de "results" é ignorado se o atributo "value" não for fornecido. Essa tag só gera saída para campos especificados pelos parâmetros CGI sp-sfvl-field na consulta de pesquisa.

3

<search-if-field-value-list-count name="field-name" value="field-value"> ... </search-if-field-value-list-count>

<search-if-not-field-value-list-count name="field-name" value="field-value"> ... </search-if-not-field-value-list-count>

Essas tags exibem o HTML entre elas se a chamada equivalente para <search-field-value-list-count name="field-name" value="field-value"> com os atributos fornecidos retornasse (ou não) um valor maior que zero.

4

<search-if-single-field-value-list-count name="field-name"> ... </search-if-single-field-value-list-count>

Essas tags exibem o conteúdo entre elas se a chamada equivalente para <search-field-value-list-count name="field-name" value="field-value"> com os atributos fornecidos retornasse (ou não) um único valor. Normalmente, isso é usado quando uma conta está usando slots de facetas. Com slots de faceta, você geralmente só deseja exibir o slot de valor quando o slot de nome associado tem um único item. Fazer essa verificação no template de transporte é mais eficiente do que fazer isso na camada de apresentação.

Tags de loop da lista de valores do campo

As tags avançadas a seguir enumeram os valores de campo de saída e os dados relacionados de todo o conjunto de resultados de pesquisa usando uma construção de loop. Essas tags só produzem saída para campos especificados pelos parâmetros CGI sp-sfvl-field na consulta de pesquisa.

Adicionar tag

Descrição

1

<search-field-values name="field-name" sortby="none/values/counts/results" max-items="XX"> ... </search-field-values>

Essa tag cria um loop para enumerar valores de campo e dados relacionados para um campo específico em todo o conjunto de resultados. Não aninhe esta tag dentro de outra tag <search-field-values> . O atributo "name" especifica o nome do campo que contém os valores a serem enumerados. O atributo opcional "sortby" controla a ordem de enumeração: "none" significa sem uma ordem específica, "values" significa classificar por valores de campo (em ordem crescente ou decrescente de acordo com a propriedade Sorting do campo), sortby="count" significa classificar em ordem decrescente de contagens de valor de campo, e sortby="results" significa classificar em ordem decrescente do número de resultados que contém cada valor.

Observe que sortby="count" e sortby="results" são equivalentes para campos de tipo não listado. . O atributo opcional "itens máximos" limita o número de iterações ao valor especificado. O valor padrão para "itens máximos" é -1, o que significa "enumerar todos os valores".

2

<search-field-value date-format="date-format-string" encoding="html/javascript/json/perl/url/none" gmt="yes/no" language="0/language-id">

Essa tag gera o valor do campo para a iteração de loop <search-field-values> atual. Esta tag só é válida dentro de um loop <search-field-values> . Os atributos "date-format", "gmt" e "language" só são relevantes se o tipo de conteúdo do nome do campo especificado na tag <search-field-values> de inclusão for "date". O atributo "date-format" tem uma cadeia de caracteres de formato de data no estilo UNIX, como "%A, %B %d, %Y" (para "segunda-feira, 25 de julho de 2020").

Consulte Sequências de caracteres do formato de data.

O atributo opcional "encoding" controla se os caracteres da string de saída são codificados em HTML, codificados em JavaScript, codificados em Perl, codificados em URL ou não, para saída na página de resultados. O valor padrão de "encoding" é "none". Normalmente, não é necessário especificar o atributo de codificação. O padrão "gmt" é "yes" e controla se a parte de tempo da string de data deve ser saída em GMT ("yes") ou no fuso horário da conta ("no"). O atributo "language" controla o idioma e as convenções de localidade da string de data de saída. "0" (padrão) significa "Usar idioma da conta". Qualquer outro valor de "idioma" é interpretado como um identificador de idioma específico, por exemplo, "en_US" significa "inglês (Estados Unidos)".

Consulte Identificadores de idioma.

3

<search-field-value-count results="yes/no">

Essa tag gera a contagem associada à iteração de loop <search-field-values> atual. A contagem de saída é o número de resultados em todo o conjunto de resultados que contém o valor do campo (results="yes") ou a contagem total do valor do campo em todo o conjunto de resultados. O valor padrão de "resultados" é "não".

Para campos de tipo não listado, results="yes" e results="no" são equivalentes. Esta tag só é válida dentro de um loop <search-field-values> .

4

<search-field-value-counter>

Essa tag gera o contador ordinal para a iteração de loop <search-field-values> atual. Esta tag só é válida dentro de um loop <search-field-values> .

Sugerir tags

A sugestão oferece um "Você quer dizer?" amigável serviço para sugerir termos de pesquisa alternativos. Se um usuário tiver escrito incorretamente um termo de pesquisa, por exemplo, Sugerir pode ajudar o usuário a encontrar resultados sugerindo uma ortografia correta. O sistema também pode sugerir palavras-chave relacionadas que possam ajudar um usuário a descobrir resultados. Ao gerar sugestões, o serviço Sugerir usa dois dicionários: um com base no idioma da conta (definido em Indexing > Words and Languages > Language) e o outro com base exclusivamente nas palavras-chave no índice da conta.

OBSERVAÇÃO

O serviço Suggest não funciona para chinês, japonês ou coreano.

Adicionar tag

Descrição

1

<search-if-suggestions> ... </search-if-suggestions>

Marque essas tags com qualquer tag de modelo "Sugerir", como <search-sugestion> , <search-sugestion-link> e assim por diante. Se a pesquisa gerar sugestões, o mecanismo de pesquisa gerará e processará tudo entre a tag de abertura e fechamento. Se a pesquisa não gerar sugestões, nenhum do conteúdo aninhado será gerado.

2

<search-suggestions> ... </search-suggestions>

Essa tag gera o loop "Sugestão", que contém uma lista de termos de pesquisa sugeridos (por exemplo, "intenção", "intenção" e "intenção", para um query originalmente inserido como "intenção"). Ao gerar a lista de termos, o mecanismo de pesquisa repete qualquer tag de modelo e/ou HTML aninhada até cinco vezes, que é o número máximo de sugestões. Use o atributo count para especificar o número de sugestões geradas (entre 0 e 5).

A tag <search-sugestões> pode aparecer várias vezes na página para repetir a lista de sugestões. Várias sugestões são classificadas de acordo com o número de resultados cada produtividade.

Aninhe a tag <search-recommendations> entre as tags <search-if-sugestivas> abertas e ocultas.

1

<search-suggestion-link> ... </search-suggestion-link>

Essa tag gera um link para a consulta de pesquisa original usando o termo de pesquisa sugerido selecionado em vez do termo original. A tag aceita e simplesmente imprime qualquer atributo HTML, como classe, destino e estilo. A tag também pode aceitar um atributo de URL, cujo valor é usado como URL base para o link gerado. As tags só podem aparecer dentro do loop <search-sugestões> .

4

<search-suggestion-text />

Essa tag imprime o termo de consulta sugerido no momento (por exemplo, "pretende" para uma consulta originalmente inserida como "intenções"). A tag não tem atributos e só pode aparecer dentro do loop <search-sugestões> .

5

<search-if-not-suggestions> ... </search-if-not-suggestions>

Se a pesquisa não gerar sugestões, o mecanismo de pesquisa gerará e processará tudo entre a tag de abertura e fechamento. Se a pesquisa gerar sugestões, nenhum do conteúdo aninhado será gerado.

6

<search-if> ... </search-if>

Essas tags condicionais incluem o HTML entre elas com base no fato de o termo sugerido ser o primeiro termo no loop Sugerir. As tags devem aparecer entre as tags open e close <search-sugestion> .

7

<search-if> ... </search-if>

Essas tags condicionais incluem o HTML entre elas com base no fato de o termo sugerido ser o último termo no loop Sugerir. As tags devem aparecer entre as tags open e close <search-sugestion> .

8

<search-suggestion-index>

Essa tag retorna o índice numérico do termo de pesquisa sugerido atual. A tag deve aparecer entre as tags <search-sugestion> e fechar.

9

<search-suggestion-total>

Essa tag retorna o número total de termos de pesquisa sugeridos gerados. A tag deve aparecer entre as tags <search-sugestion> e fechar.

10º

<search-suggestion-result-count>

Essa tag retorna o número total de resultados para o termo de pesquisa sugerido. A tag deve aparecer entre as tags <search-sugestion> e fechar.

Tags de string de modelo

As tags a seguir exibem uma string no HTML nesse ponto do modelo.

Adicionar tag

Descrição

1

<search-body>

A tag do corpo HTML com qualquer configuração de Cor do link de pesquisa que a Seção de aparência básica define no link Modelo . Adicione um atributo de plano de fundo a essa tag para exibir imagens de plano de fundo na página de resultados. Qualquer atributo de cor adicionado a essa tag substitui as configurações de Cor do link de pesquisa que a seção Aparência básica define.

2

<search-header>

O HTML para o Cabeçalho de resultados da pesquisa, conforme definido na seção Aparência básica sob o link Modelo .

3

<search-cdata> ... </search-cdata>

As tags search-data são substituídas por seus equivalentes XML: <search-cdata> é substituído por <![CDATA[" e a tag </search-cdata> é substituída por " ]]> ". Um analisador XML não analisa nenhuma informação entre a tag de abertura e fechamento.

4

<search-query query-number="XX" encoding="html/javascript/json/perl/url/none">

A consulta que o visitante inseriu. O atributo avançado e opcional "número de consulta" controla qual sequência de consulta numerada é gerada por essa tag. Por exemplo, <search-query-number=1> gera o conteúdo do parâmetro de cgi sp_q_1 . Se "query-number" não for especificado, ou se o query-number for "0", a consulta principal ( sp_q ) será realizada. O atributo opcional "encoding" controla se a saída é codificada em HTML, codificada em JavaScript, Codificada em Perl, codificada ou não em URL, para saída na página de resultados. O valor padrão de "encoding" é "html". Normalmente, não é necessário especificar o atributo de codificação.

5

<search-total>

A contagem total de resultados desta pesquisa.

6

<search-count>

A contagem de resultados relatados para esta página.

7

<search-lower>

O número do primeiro resultado relatado para esta página.

8

<search-upper>

O número do último resultado relatado para esta página.

9

<search-prev-count>

O número de resultados relatados para a página anterior.

10º

<search-next-count>

O número de resultados relatados para a próxima página.

11º

<search-time>

O tempo em segundos para esta pesquisa.

12º

<search-logo>

O HTML do logotipo de Pesquisa configurado para sua conta, se houver. Este logotipo é a imagem que dá crédito à pesquisa/comercialização do site

A maioria das contas não tem um logotipo de pesquisa associado no momento.

13º

<search-collection all="name">

A coleção dos resultados desta pesquisa. O atributo opcional "all" é usado para fornecer o nome da coleção que representa o site inteiro.

14.

<search-form> ...</search-form>

Insere tags de formulário de início e fim. Insere o método e os atributos de ação na tag de início de formulário. Aceita atributos adicionais incluindo o atributo dir="RTL" para linguagem, bem como os atributos "name" e "onSubmit" relacionados ao JavaScript.

15.

<search-input-account>

Insere uma tag de entrada de formulário que especifica o número da conta.

16º

<search-input-gallery>

Insere uma tag de entrada de formulário que especifica o número da galeria.

17º

<search-input-query query-number="XX">

Insere uma tag de entrada de formulário que especifica a string de consulta. O atributo avançado e opcional "número de consulta" controla qual consulta numerada é usada para a tag de entrada do formulário. Por exemplo, <search-input-query query-number=1> gera uma tag de entrada de formulário para a consulta sp_q_1 . Se "query-number" não for especificado, ou se "query-number" for "0", uma tag de entrada para a consulta principal sp_q será inserida.

18º

<search-input-collections all="name">

Insere uma tag de seleção de formulário e o HTML associado que exibe o menu de seleção de coleções. O atributo opcional "all" é usado para fornecer o nome da coleção que representa o site inteiro.

19º

<search-lt>

Insere a saída de uma das tags de modelo de Pesquisa em outras tags HTML ou modelo na página de resultados. <search-lt> insere um caractere menor que. O uso de <search-lt> e <search-gt> fornece uma maneira de escapar da definição de uma tag para que você possa usar as tags do modelo de Pesquisa como valores de atributo. Quando o modelo é renderizado em resposta a uma pesquisa, um sinal de menos que (<) substitui a tag <search-lt> . Por exemplo, <search-link> é equivalente a <search-lt>a href="<search-url>"<search-gt> .

20º

<search-gt>

Insere a saída de uma das tags de modelo de Pesquisa em outras tags HTML ou modelo na página de resultados. <search-gt> insere um caractere maior que. O uso de <search-lt> e <search-gt> fornece uma maneira de escapar da definição de uma tag para que você possa usar outras tags de modelo como valores de atributo. Quando o modelo é renderizado em resposta a uma pesquisa, um sinal de maior que (>) substitui a tag <search-gt> . Por exemplo, <search-link> é equivalente a <search-lt>a href="<search-url>"<search-gt> .

21º

<search-param name="param-name" length="XX" encoding="html/javascript/json/perl/url/none">

Retorna o valor do parâmetro cgi chamado "param-name" da solicitação de pesquisa atual. O atributo opcional "encoding" controla se a saída é codificada em HTML, codificada em JavaScript, Codificada em Perl, codificada ou não em URL, para saída na página de resultados. O valor padrão de "encoding" é "html". Normalmente, não é necessário especificar o atributo de codificação.

22º

<search-trace encoding="html/javascript/ json/perl/url/none">

O atributo de codificação é opcional; o valor padrão é json .

Observação: Esta tag só tem saída se sp_trace=1 for especificado com os parâmetros de consulta de pesquisa principais.

Consulte a linha 48 na tabela localizada em Backend search CGI parameters.

Tags de link de âncora do modelo

Veja a seguir as tags que fazem com que um link de âncora rode o HTML entre elas. Quando clicado, o link de âncora solicita outra página de resultados para exibição. O atributo opcional "count" solicita muitos resultados na página para exibição. Se não especificado, a contagem solicitada na página atual é usada. O atributo avançado e opcional "URL" controla o domínio para o qual o link associado é direcionado. Por padrão, o domínio é https://search.atomz.com/search/, mas você pode alterá-lo usando o atributo de URL.

Adicionar tag

Descrição

3

<search-next URL="https://search.yourdomain.com/search/"> ... </search-next>

<search-prev URL="https://search.yourdomain.com/search/"> ... </search-prev>

Exibe a página seguinte ou anterior dos resultados.

2

<search-sort-by-date URL="https://search.yourdomain.com/search/"> ... </search-sort-by-date>

<search-sort-by-score URL="https://search.yourdomain.com/search/"> ... </search-sort-by-score>

Classifica os resultados por data ou relevância.

3

<search-show-summaries URL="https://search.yourdomain.com/search/"> ... </search-show-summaries>

<search-hide-summaries URL="https://search.yourdomain.com/search/"> ... </search-hide-summaries>

Mostra ou oculta os resumos.

Tags condicionais do modelo

Tags que permitem incluir HTML condicionalmente entre elas.

Adicionar tag

Descrição

3

<search-if-results> ... </search-if-results>

<search-if-not-results> ...</search-if-not-results>

Essas tags incluem HTML se a página atual contiver quaisquer resultados de pesquisa (ou não).

2

<search-if-prev-count> ... </search-if-prev-count>

<search-if-not-prev-count> ... </search-if-not-prev-count>

<search-if-next-count> ... </search-if-next-count>

<search-if-not-next-count> ... </search-if-not-next-count>

Essas tags incluem HTML se a página anterior ou a página seguinte tiver resultados associados.

3

<search-if-sort-by-score> ... </search-if-sort-by-score>

<search-if-not-sort-by-score> ... </search-if-not-sort-by-score>

<search-if-sort-by-date> ... </search-if-sort-by-date>

<search-if-not-sort-by-date> ... </search-if-not-sort-by-date>

Essas tags incluem HTML se a página atual for ou não classificada por relevância ou data.

4

<search-if-show-summaries> ... </search-if-show-summaries>

<search-if-hide-summaries> ... </search-if-hide-summaries>

Essas tags incluem HTML se a página atual estiver mostrando ou ocultando resumos. Você pode usar essas tags para incluir ou excluir qualquer parte do resultado da pesquisa.

5

<search-if-input-collections> ... </search-if-input-collections>

<search-if-not-input-collections> ... </search-if-not-input-collections>

Essas tags incluem HTML se uma coleção foi especificada na geração de resultados de pesquisa para a página atual.

6

<search-if-advanced> ... </search-if-advanced>

<search-if-not-advanced> ... </search-if-not-advanced>

Essas tags incluem HTML se o parâmetro CGI sp_advanced=1 foi especificado para a consulta de pesquisa.

7

<search-if-bad-param name="parameter-name"> ... </search-if-bad-param>

<search-if-not-bad-param name="parameter-name"> ... </search-if-not-bad-param>

Essas tags incluem ou excluem o HTML entre elas se o parâmetro especificado for ou não inválido.

Atualmente, somente o parâmetro sp_q_location[_#] é compatível.

8

<search-if-param name="param-name" value="param-value"> ... </search-if-param>

<search-if-not-param name="param-name" value="param-value"> ... </search-if-not-param>

Essas tags avançadas incluem o HTML entre elas com base no fato de o parâmetro CGI especificado no atributo "name" ter o valor especificado no atributo "value".

9

<search-if-sort-by-field name="field-name"> ... </search-if-sort-by-field>

<search-if-not-sort-by-field name="field-name"> ... </search-if-not-sort-by-field>

Essas tags avançadas incluem o HTML entre elas se a página atual for ou não classificada pelo nome de campo fornecido.

Tags de controle de formulário de modelo

Tags que permitem controlar o estado de seleção padrão de caixas de seleção, botões de opção e caixas de listagem em um <form> no modelo de pesquisa.

Adicionar tag

Descrição

3

<search-input>

Usado em um modelo no lugar de uma tag <input> . Quando a tag é gravada no navegador, a palavra input substitui search-input e todas as outras informações na tag são geradas como estão. Além disso, se o nome especificado na tag for listado como um parâmetro CGI e se o valor especificado na tag for o valor desse parâmetro CGI, a palavra marcado será adicionada ao final da tag. Dessa forma, você pode tornar automaticamente o botão de opção padrão ou o estado da caixa de seleção em seu resultado de pesquisa igual ao da consulta atual.

Por exemplo, o código HTML de uma caixa de seleção pode ser semelhante ao seguinte:

<input type="checkbox" name="sp_w" value="exact">Sem correspondência de som

O código de modelo correspondente para essa caixa de seleção é o seguinte:

<search-input type="checkbox" name="sp_w" value="exact">Sem correspondência de som

Se a string do parâmetro CGI para a consulta contiver sp_w=exato , a tag gravada no navegador com os resultados da pesquisa se parecerá com a seguinte (a palavra marcada é inserida no final da tag):

<input type="checkbox" name="sp_w" value="exact" checked="">Sem correspondência de som

Se a string do parâmetro CGI para a consulta não contiver sp_w=exato , a tag gravada no navegador com os resultados da pesquisa se parecerá com a seguinte (a palavra marcada não está listada na tag ):

<input type="checkbox" name="sp_w" value="exact">Sem correspondência de som

A tag <search-input> é útil para colocar caixas de seleção e botões de opção em seu modelo de pesquisa. Se você tiver caixas de seleção ou botões de opção que deseja adicionar ao <form> no modelo de pesquisa, use <search-input...> no lugar de <input..> .

2

<search-select> ... </search-select>

<search-option> ... </search-option>

As caixas de listagem suspensas em uma tag <form> são iniciadas com uma tag <select> e terminadas com uma tag </select> . O nome do parâmetro CGI associado é listado dentro da tag <select> . Após a tag <select> , há uma lista de tags <option> que especificam os valores a serem exibidos na caixa de listagem.

As tags <search-select> , </search-select> , <search-option> e </search-option> fornecem funcionalidade semelhante à tag <search-input> . Ou seja, a palavra selecionada é adicionada automaticamente no final da tag <option> enviada para o navegador se o nome na tag <search-select> for listado como um parâmetro CGI e se o valor desse parâmetro CGI for listado como o valor em uma tag <search-option> específica. Dessa forma, você pode automaticamente fazer a opção da caixa de listagem padrão em seu resultado de pesquisa igual à query atual.

Por exemplo, uma caixa de listagem típica tem a seguinte aparência:

<select name="sp_x" size=1> <option value="any" selected>Anywhere</option> <option value="title">Title</option> <option value="desc">Description</option> <option value="keys">Keywords</option> <option value="body">Body</option> <option value="alt">Alternate text</option> <option value="url">URL</option> <option value="target">Target</option> </select>

O código de modelo correspondente para essa caixa de listagem é o seguinte:

<search-select name="sp_x" size=1> <search-option value="any">Anywhere</search-option> <search-option value="title">Title</search-option> <search-option value="desc">Description</search-option> <search-option value="keys">Keywords</search-option> <search-option value="body">Body</search-option> <search-option value="alt">Alternate text</search-option> <search-option value="url">URL</search-option> <search-option value="target">Target</search-option> </search-select>

Se você tiver caixas de listagem que deseja adicionar ao <form> em seu modelo de pesquisa, use <search-select...> no lugar de <select..> , </search-select> no lugar de </select> , <search-option...> no lugar de <option..> e </search-option> no lugar de </option> .

3

<search-sort-by-field name="field-name" count="XX"> ... </search-sort-by-field>

Essas tags avançadas criam um link de âncora ao redor do HTML entre elas. Quando essa âncora é clicada, uma página de resultados classificados no campo especificado é exibida. O atributo count opcional especifica o número de resultados a serem exibidos na página de resultados. Se count for omitido, a contagem usada na página atual será usada.

Sequências de caracteres de formato de data

Você pode usar as seguintes especificações de conversão nas sequências de caracteres do formato de data:

Sequência de caracteres do formato de data

Descrição

%Um

Corresponde à representação nacional do nome completo do dia da semana, por exemplo, "Segunda-feira". A configuração em Linguística > Palavras e idiomas > Idioma determina a representação nacional.

Consulte Sobre palavras e idioma.

%a

Corresponde à representação nacional do nome abreviado do dia da semana, em que a abreviação é os três primeiros caracteres, por exemplo "Mon". A configuração em Linguística > Palavras e idiomas > Idioma determina a representação nacional.

Consulte Sobre palavras e idioma.

%B

Corresponde à representação nacional do nome completo do mês, por exemplo "junho". A configuração em Linguística > Palavras e idiomas > Idioma determina a representação nacional.

Consulte Sobre palavras e idioma.

%b

Corresponde à representação nacional do nome abreviado do mês, em que a abreviação é os três primeiros caracteres, por exemplo "Jun". A configuração em Linguística > Palavras e idiomas > Idioma determina a representação nacional.

Consulte Sobre palavras e idioma.

%D

Equivalente a "%m/%d/%y", por exemplo "07/25/13".

%d

Corresponde ao dia do mês como um número decimal (01-31).

%e

Corresponde ao dia do mês como um número decimal (1-31). Um branco precede um único dígito.

%H

Corresponde ao relógio de 24 horas como um número decimal (00-23).

%h

Corresponde à representação nacional do nome abreviado do mês, em que a abreviação corresponde aos três primeiros caracteres, por exemplo "Jun" (o mesmo que %b).

%I

Corresponde ao relógio de 12 horas como um número decimal (01-12).

%j

Corresponde ao dia do ano como um número decimal (001-366).

%k

Corresponde ao (relógio de 24 horas como um número decimal (0-23). Um branco precede um único dígito.

%l

Corresponde ao relógio de 12 horas da hora como um número decimal (1-12). Um branco precede um único dígito.

%M

Corresponde ao minuto como um número decimal (00-59).

%m

Corresponde ao mês como um número decimal (01-12).

%p

Corresponde à representação nacional de "ante meridiem" ou "post meridiem", conforme apropriado, por exemplo "PM". A configuração em Linguística > Palavras e idiomas > Idioma determina a representação nacional.

Consulte Sobre palavras e idioma.

%R

Equivalente a "%H:%M", por exemplo, "13:23".

%r

Equivalente a "%I:%M:%S %p", por exemplo, "01:23:45 PM".

%S

Corresponde o segundo como um número decimal (00-60).

%T

Equivalente a "%H:%M:%S", por exemplo, "13:26:47".

%U

Corresponde ao número da semana do ano (domingo como primeiro dia da semana) como um número decimal (00-53).

%v

Equivalente a "%e-%b-%Y", por exemplo, "25-jul-2013".

%S

Corresponde ao ano com século como um número decimal, por exemplo, "2013".

%y

Corresponde ao ano sem século como um número decimal (00-99).

%Z

Corresponde ao nome do fuso horário.

%%

Corresponde "%".

Identificadores de idioma

A tabela a seguir contém os identificadores de idioma para cada idioma suportado. Você pode usar esses identificadores como valores para o atributo opcional "idioma" nas seguintes tags de modelo:

Idioma

Identificador de idioma

Búlgaro (Bulgária)

bg_BG

Chinês (China)

zh_CN

Chinês (Hong Kong)

zh_HK

Chinês (Singapura)

zh_SG

Chinês (Taiwan)

zh_TW

Tcheco (República Tcheca)

cs_CZ

Dinamarquês (Dinamarca)

da_DK

Holandês (Bélgica)

nl_BE

Holandês (Países Baixos)

nl_NL

Inglês (Austrália)

en_AU

Inglês (Canadá)

en_CA

Inglês (Grã-Bretanha)

en_GB

Inglês (Estados Unidos)

en_US

Francês (Bélgica)

fr_BE

Francês (Canadá)

fr_CA

Finlandês (Finlândia)

fi_FI

Francês (França)

fr_FR

Francês (Suíça)

fr_CH

Alemão (Áustria)

de_AT

Alemão (Alemanha)

de_DE

Alemão (Suíça)

de_CH

Grego (Grécia)

el_GR

Gaélico Irlandês (Irlanda)

ga_IE

Italiano (Itália)

it_IT

Japonês (Japão)

ja_JP

Coreano (Coreia)

ko_KR

Norueguês (Noruega)

no_NO

Polonês (Polônia)

pl_PL

Português (Brasil)

pt_BR

Português (Portugal)

pt_PT

Russo (Antiga União Soviética)

ru_SU

Eslovaco (Eslováquia)

sk_SK

Eslovaco (Eslovênia)

sl_SI

Espanhol (México)

es_MX

Espanhol (Espanha)

es_ES

Sueco (Suécia)

sv_SE

Especificação do cabeçalho HTTP do tipo de conteúdo

Você pode especificar o cabeçalho de resposta HTTP Tipo de conteúdo usando a seguinte tag:

<search-content-type-header [content="MIME-type"] [charset="charset-name"]>

Os atributos content e charset são opcionais. Essa tag deve aparecer o mais cedo possível no template. Também é recomendável que ele seja exibido antes de <search-html-meta-charset> ou <search-xml-decl>, pois afeta o comportamento dessas tags.

Se você não especificar o atributo content, o valor de MIME-type assumirá como padrão o valor definido em Settings > Crawling > Content Types. Se você especificar um atributo content, ele será usado como o atributo content padrão para a tag <search-html-meta-charset>.

Se você não especificar o atributo charset, nenhum valor charset será gravado no cabeçalho content-type.

Se você especificar charset="1", o valor real para charset-name é o valor do parâmetro CGI sp_f. Se nenhum parâmetro CGI sp_f for enviado com a pesquisa, o valor real de charset-name será lido das configurações da sua conta. Você pode exibir ou alterar o conjunto de caracteres associado à sua conta em Settings > My Profile > Personal Information > Character Encoding.

Consulte Configurar as informações pessoais do usuário.

Você pode escolher um nome de conjunto de caracteres específico listando-o como o valor charset, como charset="iso-8859-1" ou charset="Shift-JIS".

Se você especificar um atributo charset, ele será usado como o atributo charset padrão para as tags <search-html-meta-charset> e <search-xml-decl> , além de ser enviado para o cabeçalho content-type.

Especificação de um conjunto de caracteres em um modelo HTML

Os modelos de resultado de pesquisa HTML padrão especificam o conjunto de caracteres associado à conta atual por meio da seguinte tag:

<search-html-meta-charset [content="MIME-type"] [charset="charset-name"]>

Os atributos de conteúdo e charset são opcionais. Essa tag deve aparecer na seção HTML <head> do template. Essa tag resulta na seguinte tag na página HTML gerada do modelo:

<meta http-equiv="content-type" content="MIME-type; charset=charset-name">

Se você não especificar o atributo de conteúdo, o valor real de MIME-type assumirá um dos dois valores como padrão. Se a tag <search-content-type-header> especificou um atributo content, esse valor será usado. Caso contrário, o valor usado é o definido na guia Templates > Settings > Content Type.

Se você não especificar o atributo charset, o valor real de charset-name assumirá um dos dois valores como padrão. Se a tag <search-content-type-header> especificou um atributo charset, esse valor será usado. Caso contrário, o valor real de charset-name será lido das configurações da sua conta. Você pode exibir ou alterar o conjunto de caracteres associado à sua conta em Settings > My Profile > Personal Information > Character Encoding.

Consulte Configurar as informações pessoais do usuário.

Se você especificar charset="1", o valor real para charset-name é o valor do parâmetro CGI sp_f. Se nenhum parâmetro CGI sp_f for enviado com a pesquisa, o valor real de charset-name será o valor definido na tag <search-content-type-header>, se tiver sido especificado, ou o valor definido nas configurações da sua conta.

Você pode especificar um nome de conjunto de caracteres específico, como em charset="charset-name". Por exemplo, charset="iso-8859-1" ou charset="Shift-JIS".

A tag <search-html-meta-charset> é opcional. Se você removê-lo, o navegador assume os valores padrão para content-type, que são os seguintes: content="text/html; charset=ISO-8859-1". Você também pode optar por substituir a tag <search-html-meta-charset> por sua própria tag http-equiv.

Especificação de um conjunto de caracteres em um modelo XML

O modelo de resultado da pesquisa XML padrão especifica o conjunto de caracteres associado à conta atual por meio da seguinte tag:

<search-xml-decl [charset="charset-name"]>

O atributo charset é opcional. Essa tag deve aparecer na parte superior do modelo, mas após qualquer tag <search-content-type-header> . Essa tag resulta na seguinte tag no documento XML gerado a partir do modelo:

<?xml version="1.0" encoding="charset-name" standalone="yes" ?>

Se você não especificar o charset, o valor real de charset-name assumirá um dos dois valores como padrão. Se <search-content-type-header> especificou um atributo charset, então esse valor é usado. Caso contrário, o valor real de charset-name será lido das configurações da sua conta. Você pode exibir ou alterar o conjunto de caracteres associado à sua conta em Settings > My Profile > Personal Information > Character Encoding.

Consulte Configurar as informações pessoais do usuário.

Se você especificar charset="1", o valor real para charset-name é o valor do parâmetro CGI sp_f. Se nenhum parâmetro CGI sp_f for enviado com a pesquisa, o valor real de charset-name será o valor definido na tag <search-content-type-header>, se for especificado, ou o valor definido nas configurações da conta.

Você pode especificar um nome de conjunto de caracteres específico, como em charset="charset-name", se desejar. Por exemplo, charset="iso-8859-1" or charset="Shift-JIS".

Você pode optar por substituir a tag <search-xml-decl> por sua própria tag ?xml.

Inclusão de um modelo de pesquisa em outro

Para incluir um modelo de pesquisa em outro, use a tag <search-include> , definindo o atributo de arquivo para o nome do arquivo de modelo que deseja incluir, como no exemplo a seguir:

<search-include file="seo/seo_search_title.tpl" />

Os segmentos do modelo de pesquisa SEO estão na subpasta seo/ e os modelos de pesquisa normais estão na subpasta templates/. Somente arquivos .tpl são significativos para incluir neste contexto.

Gerenciamento de vários modelos de transporte para seu site

Você pode controlar a aparência dos resultados de pesquisa em seu site usando modelos de transporte de pesquisa diferentes para cada área.

Para realizar esse tipo de funcionalidade de pesquisa, você pode gerenciar seus modelos de transporte em pesquisa/merchandising do site. Ou você pode gerenciar os modelos de transporte em Publicar. Como pesquisa/merchandising no site, a opção Publicar permite editar, visualizar e publicar vários modelos de transporte de pesquisa.

Para configurar seus formulários de pesquisa para usar um modelo de transporte específico (diferente do padrão), use o parâmetro de consulta sp_t . Por exemplo, suponha que você tenha um modelo de pesquisa chamado "clearance" para a área de vendas marcada do site. Use o formulário de pesquisa HTML padrão com o seguinte código de formulário adicional:

<input type=hidden name="sp_t" value="clearance">

Quando um cliente clica em um formulário padrão que contém essa linha de código, o modelo de transporte de pesquisa "clearance" é exibido junto com seus resultados de pesquisa.

Consulte Uso de coleções em formulários de pesquisa.

Consulte Uso de quadros com formulários.

Consulte Amostra de formulário de pesquisa avançada.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
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