À propos des modèles

Vous pouvez utiliser Templates pour gérer vos modèles de présentation et de transport.

À propos des modèles

Vous pouvez ajouter, modifier, copier, renommer ou supprimer des modèles de présentation et des modèles de transport. Lorsque vous cliquez sur un nom de modèle existant dans le tableau Modèles, il s’ouvre dans une fenêtre d’éditeur (ou de visionneuse) où vous pouvez apporter vos modifications.

Vous pouvez annuler les modifications apportées aux modèles à l’aide de la fonction Historique à partir de la liste déroulante du nom du modèle dans le tableau Modèles.

Vous pouvez réduire le poids de page d’un modèle de présentation en cochant la case Minimize correspondante du modèle dans le tableau du modèle. En réduisant le poids de page du modèle, vous réduisez dynamiquement le code JavaScript et CSS intégré. Vous supprimez également les espaces blancs redondants dans le code HTML. La réduction du poids de page du modèle de présentation peut aider à obtenir plus rapidement les résultats de recherche.

Vous pouvez prévisualisation l’aspect du modèle réduit en cliquant sur la liste déroulante en regard du nom de fichier, puis en cliquant sur Preview minimized. Si vous réduisez le modèle de présentation principal, veillez à activer la réduction pour les modèles inclus (avec une balise guided-include) car cette option n’est pas héritable.

Même si vous réduisez au minimum un modèle de présentation, vous pouvez toujours modifier la version "non minimisée" du même modèle.

Vous pouvez utiliser les règles de pré-recherche, les règles de post-recherche et les règles de fonctionnement pour déterminer quand utiliser l’un de vos autres modèles de présentation. Il est courant de disposer d’une règle telle que "Pour chaque recherche, définissez le modèle ciblé sur xxxx". Une telle règle étant en place, lorsque vous modifiez le modèle "Par défaut" dans le tableau Modèles, il semble n’avoir aucun effet.

Voir A propos des règles préalables à la recherche.

Voir A propos des règles de post-recherche.

Voir A propos des règles de fonctionnement.

À propos des modèles de présentation

Les modèles de présentation sont des modèles HTML qu’un client voit lorsqu’il consulte les résultats de sa recherche sur votre site Web.

Dans la couche de présentation, vous pouvez disposer d’un modèle de présentation unique qui présente les résultats de plusieurs recherches provenant de différentes sources. Vous pouvez définir autant de modèles de présentation que vous le souhaitez et même définir des modèles de présentation que les autres modèles partagent à l'aide des commandes include. Le modèle de présentation permet à tous les composants Design, tels que les facettes, les menus et les chemins de navigation, de se regrouper. Pour afficher les différents composants de conception, vous devez utiliser des balises de modèle de présentation.

Voir Balises de modèle de présentation

Lorsque vous disposez de plusieurs modèles de présentation, vous définissez dans quelles conditions les différents modèles de présentation sont utilisés. Vous pouvez sélectionner le modèle de présentation à utiliser en fonction des paramètres CGI entrants et des cookies. Vous pouvez également changer le modèle de présentation que vous utilisez en fonction du résultat d’une recherche précédente.

Lorsque vous utilisez plusieurs modèles de présentation, veillez à indiquer quel modèle vous souhaitez que les résultats de la recherche s'affichent initialement. Pour ce faire, utilisez la colonne Default du tableau Modèles.

À propos des modèles de transport

Les modèles de transport peuvent être des modèles XML ou JSON qui transmettent des données de la recherche principale à la couche de présentation Recherche guidée.

Par défaut, votre compte est configuré pour utiliser des modèles de transport XML. Cependant, si vous préférez utiliser JSON pour transmettre vos données à la recherche guidée, contactez le service de conseil en Adobe qui peut vous aider.

Dans la couche de présentation, vous pouvez disposer d’un modèle de présentation unique qui présente les résultats de plusieurs recherches. Chaque recherche peut utiliser le même modèle de transport ou un modèle de transport personnalisé pour transmettre les données à la couche de présentation. Le modèle de transport n'étant utilisé que pour transmettre des données à la couche de présentation, il ne doit pas comporter de code HTML permettant d'afficher les résultats de la recherche. Le modèle utilise des balises de modèle de transport pour transmettre les résultats de la recherche et les résultats de remplissage des facettes. Dans ces balises, les balises de modèle de recherche standard sont utilisées pour afficher les valeurs réelles.

Voir Rechercher des balises de modèle.

Balises spécifiques au modèle de transport XML

Balise de modèle de transport XML

Description

<guided-xml></guided-xml>

Il s’agit des balises XML racine que la couche de présentation utilise pour détecter ce qu’elle doit analyser en dehors du modèle de transport.

<general></general>

Ce jeu de balises entoure les balises de modèle de recherche qui fournissent des données récapitulatives basées sur le jeu de résultats. En règle générale, ces balises contiennent des balises de recherche pour le nombre total de résultats, le résultat le plus faible et le résultat le plus élevé. Vous pouvez définir le nombre de champs globaux supplémentaires que vous souhaitez avec la balise general-field .

Exemple

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

Cet ensemble de balises est enveloppé dans les résultats de la recherche, de sorte que la recherche guidée sache où les rechercher.

<result></result>

Ce jeu de balises est enveloppé autour de chaque résultat de recherche, de sorte que la recherche guidée identifie où se trouve le contenu d’un seul résultat de recherche, début et fin.

Exemple

    <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">

Cette balise vous permet de parcourir en boucle chaque élément dans une liste à plusieurs valeurs pour un seul résultat. N’utilisez la balise que dans un résultat. Son Principal objectif est de vous permettre d’effectuer une itération sur les attributs appartenant à un champ de résultat.

Exemple

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

Cet ensemble de balises transmet les résultats qui remplissent les facettes.

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

Chaque facette doit comporter ses propres balises de facette où le paramètre name correspond au nom de la facette. Les balises de recherche sont utilisées dans les balises de facette pour les valeurs de facette.

Voir A propos des facettes .

Exemple

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

Cet ensemble de balises encapsule vos suggestions Voulez-vous dire afin que la recherche guidée identifie les noeuds XML qui contiennent des suggestions.

<suggestion></suggestion>

Cet ensemble de balises encapsule chaque suggestion Voulez-vous dire.

Exemple

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

Balises spécifiques au modèle de transport JSON

La transmission de JSON par rapport à XML à partir du moteur de recherche est connue pour être plus rapide car sa charge utile est plus faible et l’analyseur plus rapide. Soyez toutefois prudent lorsque vous utilisez JSON pour vous assurer que la sortie est un JSON strict, car l’analyseur n’est pas indulgent.

Si vous découvrez JSON, vous pouvez utiliser les liens et exemples suivants pour vous aider à démarrer :

Exemple de modèle 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> 
 ] 
}

Exemple de section de résultat JSON avec une table d’attributs de résultats

{ 
 "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> 
 ] 
}

Exemple de section Facette JSON pour une facette avec des champs associés

{ 
 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" />] 
    } 
   ] 
  } 
 ] 
}

Exemple de section de facette JSON pour les facettes avec graphique à secteurs

{ 
  "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" />] 
   } 
  ] 
} 

Ajouter un nouveau fichier de présentation ou de modèle de transport

Vous pouvez utiliser Add Template pour ajouter des modèles de présentation (.tmpl) ou des modèles de transport (.tpl) à la page Templates.

Pour ajouter une nouvelle présentation ou un fichier de modèle de transport

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, cliquez sur Add New Template.

  3. Dans la boîte de dialogue Add Template, définissez les options de votre choix.

    Option Description
    Nouveau nom de fichier Indique le nom du modèle à ajouter. L’extension de fichier appropriée est automatiquement ajoutée au nom du fichier, en fonction du type de modèle sélectionné. Les modèles de présentation ont une extension de fichier .tmpl ; Les modèles de transport ont une extension de fichier .tpl.
    Nouveau type de modèle Vous permet de choisir une présentation ou un modèle de transport à ajouter. Voir À propos des modèles.

    Voir aussi Modification d'une présentation ou d'un modèle de transport.

  4. Cliquez sur Add.

  5. (Facultatif) Sur la page Templates, effectuez l’une des opérations suivantes :

Modification d'une présentation ou d'un modèle de transport

Vous pouvez utiliser l’éditeur de modèles pour vue et modifier le contenu de votre présentation et transporter les fichiers de modèles.

Vous pouvez modifier et tester votre présentation par étapes et vos modèles de transport, pendant que les visiteurs de votre site Web continuent à utiliser les versions en direct de vos modèles. Vous testez votre modèle intermédiaire à l’aide de la version intermédiaire de l’URL de votre domaine de recherche. Par exemple, vous pouvez tester votre modèle de transport par étapes en exécutant une requête par étapes ( sp_staged=1) avec sp_t définie sur le nom de votre modèle de transport. Lorsque vous êtes satisfait de l’apparence de la mise en page, vous pouvez utiliser Push Live depuis l’éditeur de modèles pour diffuser le modèle. Une fois que le modèle est actif, les visiteurs du site commencent à l’utiliser.

Utilisez la référence de balise du modèle de présentation pour savoir comment associer votre modèle de présentation aux composants de recherche guidée tels que les facettes, les chemins de navigation et les menus.

Voir Balises de modèle de présentation

Utilisez la référence de balise de modèle de transport pour en savoir plus sur les balises à utiliser dans les modèles de transport.

Voir Balises de modèle de transport

To edit a presentation or a transport template

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, cliquez sur une présentation ou un nom de fichier de modèle de transport.

  3. Sur la page Template Editor, effectuez les modifications que vous souhaitez apporter aux balises et au codage.

    Soyez prudent quant aux modifications que vous apportez dans le fichier Template Editor; il n'existe pas de fonction Annuler. Si vous effectuez une modification non souhaitée et souhaitez revenir à la version précédente du fichier, vous pouvez cliquer sur Cancel pour revenir à la table des modèles (en supposant que vous n'ayez enregistré aucune de vos modifications jusqu'à ce moment). Si vous avez déjà enregistré vos modifications, vous pouvez utiliser History dans l’éditeur pour annuler ces modifications.

  4. (Facultatif) Cliquez sur Insert Symbol pour entrer des caractères spéciaux et des symboles qui ne comportent pas de clés correspondantes sur les claviers anglais des États-Unis.

  5. Cliquez sur Save Changes.

  6. (Facultatif) Effectuez l’une des opérations suivantes :

  7. Fermez la page Editeur de modèle lorsque vous avez terminé ; vous revenez à la page Modèles.

Copie d'une présentation ou d'un fichier de modèle de transport

Vous pouvez utiliser Copy Template pour gagner du temps en dupliquant un modèle de présentation existant (.tmpl) ou un modèle de transport (.tpl) et l'ajouter à la page Modèles.

Vous devez modifier le nom du modèle, son type ou les deux. Si vous n’apportez aucune modification, le modèle n’est pas copié.

Un modèle doit déjà être ajouté pour pouvoir copier un modèle.

Voir Ajouter un nouveau fichier de présentation ou de modèle de transport.

Pour copier une présentation ou un fichier de modèle de transport

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, dans la liste déroulante en regard d’un nom de modèle à copier, cliquez sur Copy.

  3. Dans la boîte de dialogue Copy Template, définissez une ou plusieurs options de votre choix.

  4. Cliquez sur Copy.

  5. (Facultatif) Effectuez l’une des opérations suivantes :

Attribution d’un nouveau nom à une présentation ou à un fichier de modèle de transport

Vous pouvez utiliser Rename Template pour modifier le nom d'un modèle de présentation existant (.tmpl) ou d'un modèle de transport (.tpl).

Vous pouvez également modifier le type de modèle, si vous le souhaitez.

Un modèle doit déjà être ajouté pour renommer un modèle.

Voir Ajouter un nouveau fichier de présentation ou de modèle de transport.

Pour renommer une présentation ou un fichier de modèle de transport

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, dans la liste déroulante en regard d’un nom de modèle que vous souhaitez renommer, cliquez sur Rename.

  3. Dans la boîte de dialogue Rename Template, définissez une ou plusieurs options de votre choix.

  4. Cliquez sur Rename.

  5. (Facultatif) Effectuez l’une des opérations suivantes :

Suppression d'une présentation ou d'un fichier de modèle de transport

Vous pouvez utiliser Delete Template pour supprimer un modèle de présentation existant (.tmpl) ou un modèle de transport (.tpl).

Vous disposez peut-être déjà d’une version correspondante du modèle mis en scène qui est publiée. Si tel est le cas, veillez à publier le modèle supprimé en utilisant Staging afin qu’il soit également supprimé de l’environnement en direct. Vous pouvez également utiliser Push Live sur la page Modèles.

Voir A propos de l’évaluation

Voir Activation des paramètres d’étape

Un modèle doit déjà être ajouté pour pouvoir supprimer un modèle.

Voir Ajouter une nouvelle présentation ou un nouveau fichier de modèle de transport

Pour supprimer une présentation ou un fichier de modèle de transport

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, dans la liste déroulante en regard d'un nom de modèle à supprimer, cliquez sur Delete.

  3. Dans la boîte de dialogue Delete Template, cliquez sur Delete.

  4. (Facultatif) Effectuez l’une des opérations suivantes :

Aperçu du modèle de présentation minimisé

Vous pouvez utiliser Preview minimized pour voir à quoi ressemblerait le poids de page réduit d'un modèle de présentation si vous choisissez de le réduire.

Si vous réduisez le modèle de présentation principal, veillez à activer la réduction pour les modèles inclus (avec balise d’inclusion guidée) car cette option n’est pas héritable.

Voir Réduction du poids de page d'un modèle de présentation sur votre…

Un modèle doit déjà être ajouté à la prévisualisation du modèle réduit.

Voir Ajouter une nouvelle présentation ou un nouveau fichier de modèle de transport

Vous pouvez prévisualisation le code XML d’un fichier de modèle de transport.

Voir Prévisualisation du XML d'un fichier de modèle de transport

Pour prévisualisation le modèle de présentation réduit

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, dans la liste déroulante en regard du nom d’un modèle de présentation, cliquez sur Preview minimized.

    Utilisez la colonne Type du tableau Modèles pour trier les modèles par présentation et par transport.

  3. (Facultatif) Sur la page Preview Minimized Template, cochez Wrap lines pour lire les balises dans la fenêtre définie.

  4. Cliquez sur Close.

  5. (Facultatif) Effectuez l’une des opérations suivantes :

Réduction du poids de page d’un modèle de présentation sur votre site Web

Vous pouvez réduire le poids de page d’un modèle de présentation en utilisant l’option Minimize du tableau de modèle.

En réduisant le poids de page du modèle, vous réduisez dynamiquement le code JavaScript et CSS intégré. Vous supprimez également les espaces blancs redondants dans le code HTML. La réduction du poids de page du modèle de présentation peut aider à obtenir plus rapidement les résultats de recherche.

Vous pouvez également prévisualisation l’aspect du modèle de présentation minimisé à l’aide de Preview minimized.

Voir Prévisualisation du modèle de présentation minimisé.

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

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, sous la colonne Minimize, cochez la case correspondant à un ou plusieurs fichiers de modèle de présentation que vous souhaitez réduire au minimum sur votre site Web.

    Utilisez la colonne Type du tableau Templates pour trier les modèles par présentation et par transport.

  3. (Facultatif) Effectuez l’une des opérations suivantes :

Définition du fichier de modèle de présentation par défaut à utiliser sur votre site Web

Lorsque vous disposez de plusieurs modèles de présentation, vous pouvez indiquer le modèle qui est initialement utilisé pour afficher les résultats de la recherche.

Vous pouvez utiliser les règles de pré-recherche, les règles de post-recherche et les règles de fonctionnement pour déterminer à quel moment l’un des autres modèles de présentation doit être utilisé.

Voir A propos des règles préalables à la recherche.

Voir A propos des règles de post-recherche.

Voir A propos des règles de fonctionnement.

Il est courant de disposer d’une règle telle que "Pour chaque recherche, définissez le modèle de présentation ciblé sur xxxx". Une telle règle étant en place, la modification du modèle "par défaut" sur la page Modèles semble n’avoir aucun effet.

To set the default presentation template file to use on your website

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, sous la colonne Default, cliquez sur le bouton radio du fichier de modèle de présentation correspondant que vous souhaitez utiliser par défaut.

    Utilisez la colonne Type du tableau Templates pour trier les modèles par présentation et par transport.

  3. (Facultatif) Effectuez l’une des opérations suivantes :

Prévisualisation du XML d'un fichier de modèle de transport

Vous pouvez utiliser Preview pour examiner le XML d'un modèle de transport que vous avez ajouté.

Un modèle de transport doit déjà être ajouté à la prévisualisation du code XML du modèle.

Voir Ajouter un nouveau fichier de présentation ou de modèle de transport.

Vous pouvez prévisualisation des fichiers de modèle de présentation minimisés pour vue de leur poids de page réduit.

Voir Prévisualisation du modèle de présentation minimisé.

Pour prévisualisation du XML d’un fichier de modèle de transport

  1. Dans le menu produit, cliquez sur Design > Templates.

  2. Sur la page Templates, dans la liste déroulante en regard d'un nom de modèle de transport, cliquez sur Preview.

    Utilisez la colonne Type du tableau Templates pour trier les modèles par présentation et par transport.

  3. Fermez la fenêtre d’affichage et revenez à site search/merchandising.

  4. (Facultatif) Effectuez l’une des opérations suivantes :

Sur cette page