Sobre Modelos

Você pode usar Templates para gerenciar os 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. Ao clicar em um nome de modelo existente na tabela Modelos, ele é aberto em uma janela do editor (ou visualizador), onde você pode fazer as alterações.

Você pode reverter qualquer alteração feita 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 seleção Minimize correspondente do modelo na tabela do modelo. Ao reduzir o peso da página do modelo, minimize 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 entregar mais rapidamente os resultados da pesquisa.

Você pode visualizar a aparência do modelo minimizado clicando na lista suspensa ao lado do nome do arquivo e clicando em Preview minimized. Se você minimizar o modelo de apresentação principal, lembre-se de ativar a minimização de modelos incluídos (com guided-include tag) porque essa opção não é herdada.

Mesmo que minimize um modelo de apresentação, ainda é possível 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 essa regra em vigor, quando você altera o modelo "Padrão" na tabela Modelos, ele parece não ter efeito.

Consulte Sobre as regras de pré-pesquisa.

Consulte Sobre as regras pós-pesquisa.

Consulte Sobre as Regras de Negócios.

Sobre os modelos de apresentação

Os modelos de apresentação são modelos HTML que um cliente vê ao visualizar os resultados de sua pesquisa no site.

Na camada de apresentação, você pode ter um único modelo de apresentação que apresente os resultados de várias pesquisas de várias fontes. Você pode definir quantos modelos de apresentação quiser e até mesmo definir modelos de apresentação que outros modelos compartilham usando comandos include. O modelo de apresentação é onde todos os componentes de Design, como facetas, menus e navegações estruturais, se reúnem. 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 template de apresentação, define em quais condições os vários templates de apresentação são usados. Você pode selecionar qual modelo de apresentação usar com base nos parâmetros CGI e cookies de entrada. 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, indique qual modelo deseja que os resultados da pesquisa sejam exibidos inicialmente. Você pode fazer isso usando a coluna Default da tabela Modelos.

Sobre templates 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 templates de transporte XML. No entanto, se preferir usar o JSON para enviar 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 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 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. Nessas tags, as tags de modelo de pesquisa padrão 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 XML raiz 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 envolve 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 é delimitado em torno dos resultados da pesquisa, de modo que a Pesquisa guiada saiba onde procurá-las.

<result></result>

Esse conjunto de tags é colocado em torno de 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 a iteração 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>

<facets></facets>

Esse conjunto de tags passa pelos resultados que preenchem as facetas.

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

Cada faceta deve ter 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.

Consulte Sobre as facetas .

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>

<suggestions></suggestions>

Esse conjunto de tags vincula suas sugestões do Você quis dizer para que a Pesquisa guiada reconheça quais nós XML contêm sugestões.

<suggestion></suggestion>

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

O envio de JSON versus XML do mecanismo de pesquisa é conhecido por ser mais rápido porque é uma carga menor e um analisador mais rápido. No entanto, tenha cuidado ao usar JSON para garantir que o que é saída seja JSON rigoroso, pois o analisador não está perdoando.

Se você nunca usou o JSON, use os links e exemplos a seguir para ajudar você 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 de Aspecto JSON 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) à página Templates.

Para adicionar uma nova apresentação ou um arquivo de modelo de transporte

  1. No menu do produto, clique em Design > Templates.

  2. Na página Templates, clique em Add New Template.

  3. Na caixa de diálogo Add Template, defina as opções desejadas.

    Opção Descrição
    Novo nome de arquivo Especifica o nome do modelo que 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 escolher uma apresentação ou um modelo de transporte que você 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 página Templates , execute um dos seguintes procedimentos:

Editar uma apresentação ou um modelo de transporte

Você pode usar o Editor de modelo para exibir e editar o conteúdo de sua apresentação e os arquivos de modelo de transporte.

Você pode editar e testar sua apresentação preparada e modelos de transporte, enquanto os visitantes do site continuam a usar as versões ativas dos modelos. Você testa seu modelo preparado usando a versão preparada do URL do domínio de pesquisa. Por exemplo, você pode testar seu modelo de transporte preparado executando uma consulta preparada ( sp_staged=1) com sp_t que está definida como o nome do modelo de transporte. Quando estiver satisfeito com a exibição do layout, você poderá usar Push Live no editor de modelo para colocar o modelo online. 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 seu modelo de apresentação aos componentes de Pesquisa guiada, como facetas, navegação estrutural 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 página Templates, clique em uma apresentação ou em um nome de arquivo de modelo de transporte.

  3. Na página Template Editor , faça as alterações desejadas nas tags e na codificação.

    Tenha cuidado com as alterações feitas no Template Editor; não há recurso Desfazer . Se fizer uma alteração indesejada e quiser voltar à versão anterior do arquivo, clique em Cancel para retornar à tabela de modelos (supondo que não tenha salvo nenhuma das alterações até esse ponto). Se você já tiver salvo suas alterações, poderá usar History no editor para reverter essas alterações.

  4. (Opcional) Clique em Insert Symbol para inserir caracteres especiais e símbolos que não tenham teclas correspondentes em teclados em inglês americano.

  5. Clique em Save Changes.

  6. (Opcional) Siga um destes procedimentos:

  7. Feche a página Editor de modelos quando terminar; você é retornado à 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 Modelo de Transporte (.tpl) e adicioná-lo à página Modelos.

Você deve alterar o nome do modelo, o tipo de modelo ou ambos. Se você não fizer alterações, o modelo não será copiado.

É necessário ter um modelo já adicionado para poder copiar um modelo.

Consulte Adicionar uma nova apresentação ou um 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 página Templates , na lista suspensa ao lado de um nome de modelo que você deseja copiar, clique em Copy.

  3. Na caixa de diálogo Copy Template, defina uma ou mais das opções desejadas.

  4. Clique em Copy.

  5. (Opcional) Siga um destes procedimentos:

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

Se desejar, também é possível alterar o tipo de modelo.

É necessário que um modelo já tenha sido adicionado para renomear um modelo.

Consulte Adicionar uma nova apresentação ou um 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 página Templates , na lista suspensa ao lado de um nome de modelo que você deseja renomear, clique em Rename.

  3. Na caixa de diálogo Rename Template, defina uma ou mais das opções desejadas.

  4. Clique em Rename.

  5. (Opcional) Siga um destes procedimentos:

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 é ativada. Em caso positivo, certifique-se de enviar 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.

Consulte Sobre preparo

Consulte Envio das configurações do estágio ao vivo

É necessário ter um modelo já adicionado para excluir um modelo.

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

Para excluir uma apresentação ou um arquivo de modelo de transporte

  1. No menu do produto, clique em Design > Templates.

  2. Na página Templates , na lista suspensa ao lado de um nome de modelo que você deseja excluir, clique em Delete.

  3. Na caixa de diálogo Delete Template, clique em Delete.

  4. (Opcional) Siga um destes procedimentos:

Visualizar o modelo de apresentação minimizado

Você pode usar Preview minimized para ver como seria o peso de página reduzido 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 de modelos incluídos (com tag de inclusão guiada), pois essa opção não é herdada.

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

É necessário ter um modelo já adicionado para visualizar o modelo minimizado.

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

Você pode visualizar o código XML de um arquivo de modelo de transporte.

Consulte Pré-visualização do 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 página Templates , na lista suspensa ao lado do nome de um modelo de apresentação, clique em Preview minimized.

    Use a coluna Type na tabela Modelos para classificar os modelos por Apresentação e Transporte.

  3. (Opcional) Na página Preview Minimized Template , marque Wrap lines para ler as tags na janela definida.

  4. Clique em Close.

  5. (Opcional) Siga um destes procedimentos:

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

Você pode reduzir o peso da página de um modelo de apresentação usando a opção Minimize na tabela de modelo.

Ao reduzir o peso da página do modelo, minimize 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 entregar mais rapidamente os resultados da pesquisa.

Você também pode visualizar a aparência do modelo de apresentação minimizado usando Preview minimized.

Consulte Visualizar o modelo de apresentação minimizado.

To reduce the page weight of a presentation template on your website

  1. No menu do produto, clique em Design > Templates.

  2. Na página Templates, na coluna Minimize, marque a caixa de seleção de um ou mais arquivos de modelo de apresentação que você deseja mover como minimizar no seu site.

    Use a coluna Type na tabela Templates para classificar os modelos por Apresentação e Transporte.

  3. (Opcional) Siga um destes procedimentos:

Configurar o arquivo de modelo de apresentação padrão a ser usado em seu site

Quando você tem vários modelos de apresentação, pode indicar qual modelo deve 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.

Consulte Sobre as regras de pré-pesquisa.

Consulte Sobre as regras pós-pesquisa.

Consulte Sobre as Regras de Negócios.

É comum ter uma regra como "Para cada pesquisa, defina o modelo de apresentação direcionado como xxxx". Com essa regra em vigor, a alteração do modelo "padrão" na página Modelos 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 página Templates, na coluna Default, 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 coluna Type na tabela Templates para classificar os modelos por Apresentação e Transporte.

  3. (Opcional) Siga um destes procedimentos:

Pré-visualização do XML de um arquivo de modelo de transporte

Você pode usar Preview para revisar o XML de um modelo de transporte adicionado.

É necessário ter um modelo de transporte já adicionado para visualizar o XML do modelo.

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

Você pode visualizar arquivos minimizados de modelo de apresentação para exibir seu peso reduzido da página.

Consulte Visualizar o modelo de apresentação minimizado.

Para visualizar o XML de um arquivo de modelo de transporte

  1. No menu do produto, clique em Design > Templates.

  2. Na página Templates , na lista suspensa ao lado de um nome de modelo de transporte, clique em Preview.

    Use a coluna Type na tabela Templates para classificar os modelos por Apresentação e Transporte.

  3. Feche a janela de visualização e retorne para site search/merchandising.

  4. (Opcional) Siga um destes procedimentos:

Nesta página