Show Menu
TÓPICOS×

Sobre Modelos

Você pode usar Templates para gerenciar seus modelos de apresentação e de transporte.

Sobre Modelos

Você pode adicionar, editar, copiar, renomear ou excluir modelos de apresentação e modelos de transporte. Quando você clica em um nome de modelo existente na tabela Modelos, ele é aberto em uma janela do editor (ou visualizador) onde você pode fazer suas alterações.
É possível reverter quaisquer alterações feitas nos modelos usando o recurso Histórico na lista suspensa do nome do modelo na tabela Modelos.
Você pode reduzir o peso da página de um modelo de apresentação marcando a caixa de Minimize seleção correspondente do modelo na tabela do modelo. Ao reduzir o peso da página do modelo, você minimiza dinamicamente o JavaScript e o CSS em linha. Você também remove o espaço em branco redundante no HTML. Minimizar o peso da página do modelo de apresentação pode ajudar a fornecer os resultados da pesquisa mais rapidamente.
Você pode visualizar a aparência do modelo minimizado clicando na lista suspensa ao lado do nome do arquivo e, em seguida, clicando em Preview minimized . Se você minimizar o modelo de apresentação principal, lembre-se de ativar a minimização para modelos incluídos (com guided-include tag), pois essa opção não é herdada.
Mesmo se você minimizar um modelo de apresentação, ainda poderá editar a versão "não minimizada" do mesmo modelo.
Você pode usar as regras de pré-pesquisa, pós-pesquisa e de negócios para determinar quando usar um de seus outros modelos de apresentação. É comum ter uma regra como "Para cada pesquisa, defina o modelo direcionado como xxxx". Com tal regra em vigor, quando você altera o modelo "Padrão" na tabela Modelos, ele parece não ter efeito.

Sobre modelos de apresentação

Os modelos de apresentação são modelos HTML que um cliente vê quando está visualizando os resultados de sua pesquisa em seu site.
Na camada de apresentação, você pode ter um único modelo de apresentação que apresenta os resultados de várias pesquisas de várias fontes. Você pode definir quantos modelos de apresentação desejar e até mesmo definir modelos de apresentação que outros modelos compartilham usando include comandos. O modelo de apresentação é onde todos os componentes do Design, como facetas, menus e navegações estruturais, se juntam. Para exibir os vários componentes de design, você deve usar tags de modelo de apresentação.
Consulte Tags de modelo de apresentação
Quando você tem mais de um modelo de apresentação, define em que condições os vários modelos de apresentação são usados. Você pode selecionar qual modelo de apresentação usar com base nos parâmetros CGI e cookies recebidos. Ou você pode alternar qual modelo de apresentação está usando com base no resultado de uma pesquisa anterior.
Ao usar vários modelos de apresentação, certifique-se de indicar qual modelo deseja que os resultados da pesquisa apareçam inicialmente. É possível fazer isso usando a Default coluna da tabela Modelos.

Sobre modelos de transporte

Os modelos de transporte podem ser modelos XML ou JSON que transmitem dados da pesquisa de back-end para a camada de apresentação da Pesquisa guiada.
Por padrão, sua conta está configurada para usar modelos de transporte XML. No entanto, se você preferir usar JSON para passar seus dados para a Pesquisa guiada, entre em contato com a Adobe Consulting que pode ajudá-lo.
Na camada de apresentação, você pode ter um único modelo de apresentação que apresenta 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 passar dados para a camada de apresentação, ele não deve ter nenhum HTML usado para exibir os resultados da pesquisa. O modelo usa tags de modelo de transporte para passar os resultados da pesquisa e os resultados para preencher os aspectos. Dentro dessas tags, as tags padrão do modelo de pesquisa são usadas para exibir os valores reais.
Consulte Pesquisar marcas de modelo.
Tags específicas do modelo de transporte XML
Tag do modelo de transporte XML
Descrição
<guided-xml></guided-xml>
Essas são as tags raiz XML que a camada de apresentação usa para detectar o que ela deve analisar fora do modelo de transporte.
<general></general>
Esse conjunto de tags delimita tags de 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, o resultado mais baixo e o resultado mais alto. Você pode definir qualquer número de campos globais adicionais que desejar com a tag de campo geral .
Exemplo
    <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>
Esse conjunto de tags está envolvido nos resultados da pesquisa, de modo que a Pesquisa guiada saiba onde procurá-las.
<resultado></resultado>
Esse conjunto de tags é vinculado 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.
Exemplo
    <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">
Essa tag permite executar um loop por cada item em uma lista de vários valores para um único resultado. Use a tag somente em um resultado. Seu objetivo principal é permitir que você itere sobre atributos pertencentes a um campo de resultado.
Exemplo
      <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>
<facetas></facetas>
Esse conjunto de tags transmite os resultados que preenchem as facetas.
<facet name="name"></facet>
Cada faceta deve ter suas próprias marcas de aspecto, onde o parâmetro name corresponde ao nome da faceta. As tags de pesquisa são usadas dentro das tags de aspecto para os valores de aspecto.
Exemplo
    <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>
<sugestões></sugestões>
Esse conjunto de tags vincula suas sugestões de Você quis dizer para que a Pesquisa guiada reconheça quais nós XML contêm sugestões.
<sugestão></sugestão>
Esse conjunto de tags vincula cada sugestão Você quis dizer.
Exemplo
    <search-if-suggestions>       <suggestions>         <search-suggestions>           <suggestion>             <value><search-suggestion-text /></value>             <count><search-suggestion-result-count /></count>           </suggestion>         </search-suggestions>       </suggestions>     </search-if-suggestions>
Tags específicas do modelo de transporte JSON
Sabe-se que passar JSON versus XML do mecanismo de pesquisa é mais rápido porque é uma carga menor e um analisador mais rápido. No entanto, tenha cuidado ao usar JSON para garantir que a saída seja JSON estrita, pois o analisador não está perdoando.
Se você for novo no JSON, poderá usar os seguintes links e exemplos para ajudá-lo a começar:
Exemplo de modelo JSON
{ 
 "general": 
 { 
  "total" : "<search-total />", 
  "lower" : "<search-lower />", 
  "upper" : "<search-upper />", 
  "rbt-trigger-list" : "<search-rbta-trigger-id-list>", 
  "fields" :  
  [ 
   { 
    "name" : "seo_search_title", 
    "value" : "<search-include file="seo/seo_search_title.tpl" />" 
   }, 
   { 
    "name" : "seo_search_keywords", 
    "value" : "<search-include file="seo/seo_search_keywords.tpl" />" 
   } 
  ] 
 }, 
 
 <search-if-suggestions> 
 "suggestions": 
  [ 
  <search-suggestions> 
  { 
   "suggestion":"<search-suggestion-text />", 
   "count": "<search-suggestion-result-count>" 
  }<search-if-not-last-suggestion>,</search-if-not-last-suggestion> 
  </search-suggestions> 
 ], 
 </search-if-suggestions> 
 
 "facets" : 
 [ 
  { 
   "name" : "leveli", 
   "values" : [ <search-field-value-list name="leveli" quotes="yes" sortby="values" data="values" encoding="json"/>], 
   "counts" : [<search-field-value-list name="leveli" quotes="no" sortby="values" data="results" />] 
  }, 
  { 
   "name" :"levelii", 
   "values" : [<search-field-value-list name="levelii" quotes="yes" sortby="values" data="values" encoding="json"/>], 
   "counts" : [<search-field-value-list name="levelii" quotes="no" sortby="values" data="results" />] 
  }, 
  { 
   "name" : "brand", 
   "values" : [<search-field-value-list name="brand" quotes="yes" sortby="values" data="values" encoding="json"/>], 
   "counts" : [<search-field-value-list name="brand" quotes="no" sortby="values" data="results" />] 
  }, 
 ], 
 "results" : 
 [ 
  <search-results> 
  { 
   "fields" : 
   [ 
    { 
     "name" : "index", 
     "value" : "<search-index />" 
    }, 
    { 
     "name" : "loc", 
     "value" : "<search-display-field name="url" length="500" encoding="json"/>" 
    }, 
    { 
     "name" : "title", 
     "value" : "<search-display-field name="title" encoding="json"/>" 
    }, 
    { 
     "name" : "img_url_thumbnail", 
     "value" : "<search-display-field name="img_url_thumbnail" encoding="json"/>" 
    }, 
    { 
     "name" : "description", 
     "value" : "<search-display-field name="description" encoding="json"/>" 
    }, 
    { 
     "name" : "mdi", 
     "value" : "<SEARCH-RBTA-DISPLAY-MDI-FIELD>" 
    } 
   ] 
  }<search-if-not-last>,</search-if-not-last>  
  </search-results> 
 ] 
}

Exemplo de seção de resultado JSON com uma tabela de atributos de resultados
{ 
 "results" : 
 [ 
  <search-results> 
  { 
   "fields" : 
   [ 
    { 
     "name" : "index", 
     "value" : "<search-index />" 
    }, 
    { 
     "name" : "loc", 
     "value" : "<search-display-field name="url" length="500" encoding="json"/>" 
    } 
   ], 
   "tables" : 
   [ 
    { 
     "name" : "downloads", 
     "fields" : 
     [ 
      { 
       "name" : "download_title", 
       "value" : <search-display-field name="download_title" encoding="json"/> 
      }, 
      { 
       "name" : "download_link", 
       "value" : <search-display-field name="download_link" encoding="json"/> 
      } 
     ] 
    } 
   ] 
  }<search-if-not-last>,</search-if-not-last>  
  </search-results> 
 ] 
}

Exemplo de seção JSON Facet para uma faceta com campos associados
{ 
 facets" : 
 [ 
  { 
   "name" : "t1", 
   "values" : [<search-field-value-list name="t1" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />], 
   "counts" : [<search-field-value-list name="t1" quotes="yes" commas="yes" data="results" sortby="values" />], 
   "custom-fields" : 
   [ 
    { 
     "name" : "taxonmyId", 
     "value" : [<search-field-value-list name="tax1" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />] 
    } 
   ] 
  } 
 ] 
}

Exemplo de seção JSON Facet para aspectos com slot
{ 
  "facets" : 
  [  
   { 
    "name" : "fvalue0", 
                  "dynamic" : 1, 
                  "display-names" : [<search-field-value-list name="fname0" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />], 
    "values" : [<search-field-value-list name="fvalue0" quotes="yes" commas="yes" data="values" sortby="values" encoding="json" />], 
    "counts" : [<search-field-value-list name="fvalue0" quotes="no" commas="yes" data="results" sortby="values" />] 
   } 
  ] 
} 

Adicionar uma nova apresentação ou um novo arquivo de modelo de transporte

Você pode usar Add Template para adicionar modelos de apresentação (.tmpl) ou modelos de transporte (.tpl) à Templates página.
Para adicionar uma nova apresentação ou um novo arquivo de modelo de transporte
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, clique em Add New Template .
  3. Na caixa de Add Template diálogo, defina as opções desejadas.
    Opção
    Descrição
    Novo nome de arquivo
    Especifica o nome do modelo que você deseja adicionar. A extensão de arquivo adequada é adicionada automaticamente ao nome do arquivo, com base no tipo de modelo selecionado. Os modelos de apresentação têm uma extensão de arquivo .tmpl; Os modelos de transporte têm uma extensão de arquivo .tpl.
    Novo tipo de modelo
    Permite que você escolha uma apresentação ou um modelo de transporte que deseja adicionar. Consulte Sobre Modelos .
    Consulte também Edição de uma apresentação ou de um modelo de transporte.
  4. Clique em Add .
  5. (Opcional) Na Templates página, execute um dos procedimentos a seguir:

Editar uma apresentação ou um modelo de transporte

Você pode usar o Editor de modelos para exibir e editar o conteúdo de sua apresentação e os arquivos de modelo de transporte.
Você pode editar e testar a apresentação em etapas e os modelos de transporte, enquanto os visitantes do seu site continuam a usar as versões ao vivo dos seus modelos. Você testa seu modelo preparado usando a versão preparada do URL do domínio de pesquisa. Por exemplo, você pode testar o modelo de transporte preparado executando uma consulta preparada ( sp_staged=1 ) com sp_t o nome definido para o modelo de transporte. Quando estiver satisfeito com a forma como o layout é exibido, você pode usar Push Live de dentro do editor de modelo para colocar o modelo ao vivo. Depois que o modelo é exibido, os visitantes do site começam a usá-lo.
Use a referência de tag do modelo de apresentação para saber como conectar o modelo de apresentação aos componentes de Pesquisa guiada, como facetas, navegações estruturais e menus.
Consulte Tags de modelo de apresentação
Use a referência de tag do modelo de transporte para saber mais sobre as tags a serem usadas nos modelos de transporte.
Consulte Tags de modelo de transporte
To edit a presentation or a transport template
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, clique em uma apresentação ou no nome de um arquivo de modelo de transporte.
  3. Na Template Editor página, faça as alterações desejadas nas tags e na codificação.
    Tenha cuidado com as mudanças que você faz no Template Editor; não há nenhum recurso Desfazer. Se você fizer uma alteração indesejada e quiser voltar à versão anterior do arquivo, clique em Cancel para retornar à tabela de modelos (assumindo que não salvou nenhuma de suas alterações até esse ponto). Se você já salvou as alterações, poderá usá-las History no editor para revertê-las.
  4. (Opcional) Clique em Insert Symbol para inserir caracteres e símbolos especiais que não tenham teclas correspondentes em teclados em inglês dos EUA.
  5. Clique em Save Changes .
  6. (Opcional) Execute um dos procedimentos a seguir:
  7. Feche a página Editor de modelos quando terminar; você retornará à página Modelos.

Copiando uma apresentação ou um arquivo de modelo de transporte

Você pode usar Copy Template para economizar tempo duplicando um modelo de Apresentação existente (.tmpl) ou um modelo de Transporte (.tpl) e adicioná-lo à página Modelos.
É necessário alterar o nome do modelo, o tipo de modelo ou ambos. Se você não fizer alterações, o modelo não será copiado.
Você deve ter um modelo já adicionado para poder copiar um modelo.
Consulte Adicionar uma nova apresentação ou arquivo de modelo de transporte.
Para copiar uma apresentação ou um arquivo de modelo de transporte
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, na lista suspensa ao lado do nome do modelo que você deseja copiar, clique em Copy .
  3. Na caixa de Copy Template diálogo, defina uma ou mais das opções desejadas.
  4. Clique em Copy .
  5. (Opcional) Execute um dos procedimentos a seguir:

Renomear uma apresentação ou um arquivo de modelo de transporte

Você pode usar Rename Template para alterar o nome de um modelo de apresentação existente (.tmpl) ou de um modelo de transporte (.tpl).
Você também pode alterar o tipo de modelo, se desejado.
Você já deve ter um modelo adicionado para renomear um modelo.
Consulte Adicionar uma nova apresentação ou arquivo de modelo de transporte.
Para renomear uma apresentação ou um arquivo de modelo de transporte
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, na lista suspensa ao lado do nome de um modelo que você deseja renomear, clique em Rename .
  3. Na caixa de Rename Template diálogo, defina uma ou mais das opções desejadas.
  4. Clique em Rename .
  5. (Opcional) Execute um dos procedimentos a seguir:

Excluindo uma apresentação ou um arquivo de modelo de transporte

Você pode usar Delete Template para remover um modelo de apresentação existente (.tmpl) ou um modelo de transporte (.tpl).
Você já pode ter uma versão correspondente do modelo preparado que é enviado ao vivo. Em caso positivo, certifique-se de colocar o modelo excluído ao vivo usando Staging para que ele também seja excluído do ambiente ativo. Ou você pode usar Push Live na página Modelos.
Você já deve ter um modelo adicionado para poder excluir um modelo.
Para excluir uma apresentação ou um arquivo de modelo de transporte
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, na lista suspensa ao lado do nome do modelo que você deseja excluir, clique em Delete .
  3. Na caixa de Delete Template diálogo, clique em Delete.
  4. (Opcional) Execute um dos procedimentos a seguir:

A visualização do modelo de apresentação foi minimizada

Você pode usar Preview minimized para ver como seria a espessura reduzida de uma página de um modelo de apresentação se optar por minimizá-lo.
Se você minimizar o modelo de apresentação principal, lembre-se de ativar a minimização para modelos incluídos (com tag de inclusão guiada), pois essa opção não é herdada.
Você já deve ter um modelo adicionado para visualizar o modelo minimizado.
Você pode visualizar o código XML de um arquivo de modelo de transporte.
Para visualizar o modelo de apresentação minimizado
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, na lista suspensa ao lado do nome do modelo de apresentação, clique em Preview minimized .
    Use a Type coluna na tabela Modelos para classificar os modelos por Apresentação e Transporte.
  3. (Opcional) Na Preview Minimized Template página, marque Wrap lines para ler as tags na janela definida.
  4. Clique em Close .
  5. (Opcional) Execute um dos procedimentos a seguir:

Redução do peso da página de um modelo de apresentação em seu site

Você pode reduzir a espessura da página de um modelo de apresentação usando a Minimize opção na tabela de modelo.
Ao reduzir o peso da página do modelo, você minimiza dinamicamente o JavaScript e o CSS em linha. Você também remove o espaço em branco redundante no HTML. Minimizar o peso da página do modelo de apresentação pode ajudar a fornecer os resultados da pesquisa mais rapidamente.
Você também pode visualizar a aparência do modelo de apresentação minimizado usando Preview minimized .
To reduce the page weight of a presentation template on your website
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, na Minimize coluna, marque a caixa de seleção de um ou mais arquivos de modelo de apresentação que você deseja enviar como mínimo em seu site.
    Use a Type coluna na Templates tabela para classificar os modelos por Apresentação e Transporte.
  3. (Opcional) Execute um dos procedimentos a seguir:

Configurar o arquivo de modelo de apresentação padrão para usar em seu site

Quando você tem vários modelos de apresentação, pode indicar qual modelo será usado inicialmente para exibir os resultados da pesquisa.
Você pode usar as regras de pré-pesquisa, pós-pesquisa e de negócios para determinar quando um de seus outros modelos de apresentação deve ser usado.
É comum ter uma regra como "Para cada pesquisa, defina o modelo de apresentação direcionada como xxxx." Com tal regra em vigor, a alteração do modelo "padrão" na página Modelos parece não ter efeito.
To set the default presentation template file to use on your website
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, na Default coluna, clique no botão de opção para o arquivo de modelo de apresentação correspondente que você deseja servir como padrão.
    Use a Type coluna na Templates tabela para classificar os modelos por Apresentação e Transporte.
  3. (Opcional) Execute um dos procedimentos a seguir:

Visualização do XML de um arquivo de modelo de transporte

Você pode usar Preview para revisar o XML de um modelo de transporte que você adicionou.
Você deve ter um modelo de transporte já adicionado para visualizar o XML do modelo.
Consulte Adicionar uma nova apresentação ou arquivo de modelo de transporte.
É possível visualizar arquivos de modelo de apresentação minimizados para exibir a espessura reduzida da página.
Para visualizar o XML de um arquivo de modelo de transporte
  1. No menu do produto, clique em Design > Templates .
  2. Na Templates página, na lista suspensa ao lado do nome de um modelo de transporte, clique em Preview .
    Use a Type coluna na Templates tabela para classificar os modelos por Apresentação e Transporte.
  3. Feche a janela de visualização e volte para site search/merchandising.
  4. (Opcional) Execute um dos procedimentos a seguir: