A propos des modèles

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

A 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 de l’éditeur (ou du lecteur) où vous pouvez apporter vos modifications.

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

Vous pouvez réduire le poids de page d’un modèle de présentation en cochant la Minimize case 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 intégré et le code CSS. Vous supprimez également les espaces blancs redondants dans le code HTML. La réduction du poids de la page du modèle de présentation peut vous aider à obtenir plus rapidement les résultats de votre recherche.

Vous pouvez prévisualiser l’aspect du modèle réduit en cliquant dans 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, n’oubliez pas d’activer la réduction pour les modèles inclus (avec guided-include balise) car cette option n’est pas héritable.

Même si vous réduisez 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 d’avoir 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.

See About Pre-Search Rules.

See About Post-Search Rules.

See About Business Rules.

A propos des modèles de présentation

Les modèles de présentation sont des modèles HTML visibles par un client 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 partagés par d’autres modèles à l’aide de include commandes. Le modèle de présentation permet à tous les composants de conception, tels que les facettes, les menus et les chemins de navigation, de se réunir. Pour afficher les différents composants de conception, vous devez utiliser les 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, assurez-vous d’indiquer le modèle que vous souhaitez que les résultats de la recherche apparaissent au départ. Pour ce faire, utilisez la Default colonne du tableau Modèles.

A 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 de la recherche guidée.

Par défaut, votre compte est configuré pour utiliser des modèles de transport XML. Toutefois, si vous préférez utiliser JSON pour transmettre vos données à la recherche guidée, contactez le service de conseil d’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 étant uniquement utilisé pour transmettre des données à la couche de présentation, il ne doit pas comporter de code HTML utilisé pour 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 pour remplir les facettes. Dans ces balises, les balises de modèle de recherche standard sont utilisées pour afficher les valeurs réelles.

Voir Rechercher des balisesde 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 utilisées par la couche de présentation pour détecter ce qu’elle doit analyser à partir du modèle de transport.

<general></general>

Ce jeu de balises entoure les balises de modèle de recherche qui fournissent des données de résumé 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 un nombre illimité de champs globaux supplémentaires à l’aide de 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 entouré des 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 l’endroit où le contenu d’un seul résultat de recherche commence et se termine.

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

Cette balise vous permet de parcourir en boucle chaque élément d’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>

<facettes></facettes>

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

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

Chaque facette doit disposer de ses propres balises de facette pour lesquelles 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 du message 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 au code XML à partir du moteur de recherche est connue pour être plus rapide car la 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 fichier JSON strict, car l’analyseur n’est pas pardonnant.

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

Ajout d’une nouvelle présentation ou d’un fichier 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 Templates page.

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

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

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

  3. Dans la Add Template boîte de dialogue, 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 A propos des modèles.

    Voir aussi Modification d’une présentation ou d’un modèlede transport.

  4. Cliquez sur Add.

  5. (Facultatif) Sur la Templates page, 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 afficher 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 les modèles de transport, tandis que les visiteurs de votre site Web continuent d’utiliser les versions en direct de vos modèles. Vous testez votre modèle d’évaluation à 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 qui est 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 mettre le modèle en service. Une fois le modèle 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 du modèle de transport pour en savoir plus sur les balises à utiliser dans les modèles de transport.

Voir Transport des balises de modèle

To edit a presentation or a transport template

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

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

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

    Soyez attentif aux changements que vous apportez dans le Template Editor; il n’existe pas de fonction Annuler. Si vous effectuez une modification indésirable et souhaitez revenir à la version précédente du fichier, vous pouvez cliquer 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 les annuler History dans l’éditeur.

  4. (Facultatif) Cliquez sur Insert Symbol pour saisir des caractères spéciaux et des symboles qui ne comportent pas de touches correspondantes sur les claviers en anglais américain.

  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 Ajout d’un nouveau fichierde modèle de présentation ou de transport.

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

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

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

  3. Dans la Copy Template boîte de dialogue, définissez une ou plusieurs des 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, le cas échéant.

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

Voir Ajout d’un nouveau fichierde modèle de présentation ou de transport.

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

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

  2. Sur la Templates page, dans la liste déroulante en regard du nom du modèle à renommer, cliquez sur Rename.

  3. Dans la Rename Template boîte de dialogue, définissez une ou plusieurs des 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 c’est le cas, veillez à mettre en ligne le modèle supprimé Staging afin qu’il soit également supprimé de l’environnement de production. Vous pouvez également utiliser Push Live la page Modèles.

Voir A propos de l’évaluation

Voir Pousser les paramètres de l’étape en direct

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

Voir Ajout d’une nouvelle présentation ou d’un fichier de modèle de transport

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

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

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

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

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

Aperçu du modèle de présentation réduit

Vous pouvez Preview minimized voir à quoi ressemblerait le poids réduit d’une page 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, n’oubliez pas d’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 d’une page d’un modèle de présentation sur votre…

Vous devez déjà ajouter un modèle pour prévisualiser le modèle réduit.

Voir Ajout d’une nouvelle présentation ou d’un fichier de modèle de transport

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

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

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

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

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

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

  3. (Facultatif) Sur la Preview Minimized Template page, cochez Wrap lines la case 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 d’une page d’un modèle de présentation en utilisant l’ Minimize option du tableau du modèle.

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

Vous pouvez également prévisualiser l’aspect du modèle de présentation réduit à l’aide de Preview minimized.

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

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

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

  2. Sur la Templates page, sous la Minimize colonne, 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 Type colonne du Templates tableau 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é.

See About Pre-Search Rules.

See About Post-Search Rules.

See About Business Rules.

Il est courant d’avoir une règle du type "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 ne semble pas avoir d’effet.

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

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

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

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

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

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

Vous pouvez utiliser Preview pour vérifier le code XML d’un modèle de transport que vous avez ajouté.

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

Voir Ajout d’un nouveau fichierde modèle de présentation ou de transport.

Vous pouvez prévisualiser les fichiers de modèle de présentation minimisés afin d’afficher leur poids réduit.

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

Pour prévisualiser le code XML d’un fichier de modèle de transport

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

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

    Utilisez la Type colonne du Templates tableau 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