Variables de substitution pour la saisie du code HTML dans le Management Center

Dans l'outil Marketing, vous pouvez utiliser des variables de substitution dans le code HTML de contenu marketing pour améliorer la gestion des liens pour stocker des pages et des fichiers à partir du contenu marketing. Avec ces variables de substitution, vous pouvez utiliser le même code HTML dans votre prévisualisation de magasin et dans la vitrine de production sans avoir à modifier la racine de contexte. Le moteur marketing remplace dynamiquement ces variables par les informations de racine de contexte correctes.

Précédemment, si vous saisissiez du code HTML dans la zone de texte lors de la création ou la modification de contenu marketing, vous deviez coder la racine de contexte spécifique aux chemins et URL d'image. Si votre prévisualisation de magasin et votre vitrine du Management Center utilisaient différentes racines de contexte pour des images et des URL, vous ne pouviez pas utiliser le même code HTML dans la prévisualisation du magasin et dans votre vitrine. Pour basculer entre l'affichage des images et des URL dans la prévisualisation du magasin et dans votre vitrine, vous deviez modifier la racine de contexte. Vous pouvez inclure des variables de substitution pour le chemin des images et des URL, de sorte que vous pouvez visualiser les images et les URL dans la prévisualisation du magasin et dans votre vitrine sans modifier la racine du contexte. Vous pouvez définir les variables de substitution pour la racine de contexte lorsque vous créez ou modifiez le contenu de marketing dans le Management Center.

Exemple de fragment HTML statique

Vos fichiers JSP d'emplacement e-Marketing de magasin type sont améliorés afin de permettre la transmission de variables de substitution pour le contenu d'image. Ces variables sont remplacées dans le texte de contenu et le fragment HTML d'image. Si vous souhaitez utiliser les variables [contextPath] et [imagePath] lorsque vous créez ou modifiez le fragment HTML pour le contenu d'image, ces chemins doivent être transmis via le fichier JSP d'emplacement e-marketing. Incluez le code suivant dans les fichiers JSP d'emplacement e-Marketing pour votre magasin pour permettre l'utilisation de ces variables pour les emplacements e-Marketing de votre magasin.

<c:if test="${!empty env_contextAndServletPath}">
  <wcf:param name="DM_contextPath" value="${env_contextAndServletPath}" />
</c:if>           
<c:if test="${!empty env_imageContextPath}">    
  <wcf:param name="DM_imagePath" value="${env_imageContextPath}" />
</c:if>

Dans le code HTML du contenu d'image du Management Center, vous pouvez inclure des variables de substitution lorsque vous définissez le chemin d'image ou n'importe quelle URL. Par exemple, le fragment HTML suivant inclut les variables de substitution [imagePath], [contextPath], [storeId] et [catalogId] :

<div class="espot" style="position:relative;">
  1<img alt="Dresses Image" src="[imagePath]/Aurora/content/custom/images/en_US/dresses_espot.png"/>
  2<a href="[contextPath]/SearchDisplay?searchTerm=dresses&amp;storeId=[storeId]&amp;catalogId=[catalogId]">
    <div class="imagelink" style="position: absolute;  top: 220px; right: 0px; ">Dresses</div>
  </a>
</div>

La ligne portant le libellé 1 illustre la façon dont vous pouvez inclure des images dans votre fragment HTML statique. Vous pouvez définir une liaison vers des fichiers image que vous téléchargez à l'aide de l'outil Actifs du Management Center. Notez que le chemin vers le fichier image doit commencer par [imagePath].
La ligne portant le libellé 2 illustre la façon dont vous pouvez définir une liaison vers d'autres pages de magasin depuis votre fragment HTML statique. Cet exemple utilise la commande SearchDisplay pour établir une liaison avec la page contenant les résultats de la recherche portant sur le terme dresses.

Variables de substitution à utiliser dans du code HTML statique

HCL Commerce fournit un ensemble de variables de substitution que vous pouvez utiliser dans le code HTML statique pour le contenu marketing. Vous pouvez utiliser ces variables de substitution pour le code HTML d'image cliquable de texte de marketing. Les variables de substitution vous permettent d'afficher l'aperçu de vos pages de contenu personnalisé telles qu'elles apparaîtront sur votre magasin. Lorsque vous insérez une variable de substitution, le serveur remplace automatiquement la variable par les données appropriées de l'environnement de magasin en cours.

Le tableau suivant répertorie les variables de substitution qui sont prises en charge par défaut.


Balise	Variable de magasin type	Description
`[contextPath]`	`${env_contextAndServletPath}`	Pour les liens d'URL : Utilisées conjointement, ces deux variables insèrent une partie de l'URL sur une page de magasin. Exemple 1 : Liaison vers une autre page de magasin appelée `terms-of-use` : `<a href="[contextPath]/aurora/content/terms-of-use">...</a>` Exemple 2 : Liaison vers une page contenant les résultats de la recherche portant sur `dresses` : `<a href="[contextPath]/SearchDisplay?searchTerm=dresses&storeId=[storeId]&catalogId=[catalogId]">...</a>`
`[imagePath]`	`${env_imageContextPath}`	Pour les liens d'image : Cette variable insère la partie du chemin d'image située avant /`storedirectory` dans l'outil Actifs. Par exemple, si le fichier image se trouve dans le chemin suivant de l'outil Actifs : `/Aurora/content/custom/images/en_US/dresses_espot.png` Le lien utilise la variable de substitution `[imagePath]` pour générer le chemin suivant : `src=[imagePath]/Aurora/content/custom/images/en_US/dresses_espot.png`
`[storeId]`		Pour les liens d'URL : Cette variable insère l'ID magasin dans l'URL. Voir l'exemple 2 pour la variable `[contextPath]`.
`[catalogId]`		Pour les liens d'URL : Cette variable insère l'ID catalogue dans l'URL. Voir l'exemple 2 pour la variable `[contextPath]`.
`[ProductDisplay?productId=NNN]`		Pour le remplacement de l'URL SEO relative aux informations produit. Par exemple, si la page de produit se trouve sur l'URL suivante : `en/aurora/electronics/widescreen-lcd-monitor` Le lien utilise la variable de substitution `[ProductDisplay?productId=NNN]` pour générer l'URL suivante : `en/aurora/electronics/widescreen-lcd-monitor`
`[CategoryDisplay?categoryId=NNN]`		Pour le remplacement de l'URL SEO relative aux informations de catégorie. Par exemple, si la page de catégorie se trouve sur l'URL suivante : `en/aurora/electronics` Le lien utilise la variable de substitution `[CategoryDisplay?categoryId=NNN]` pour générer l'URL suivante : `en/aurora/electronics`

Remarque : En tant que meilleure pratique, faites précéder par [contextPath]/ les URL href que vous incluez dans votre code source HTML. Où [contextPath]/ est le chemin de contexte ou de servlet vers l'URL. Par exemple,

<area shape="rect" coords="62,228,195,251" href="[webapp/wcs/preview/servlet]/[CategoryDisplay?categoryId=10003]"

Où [webapp/wcs/preview/servlet]/ est la valeur pour [contextPath]/.

Utilisation de variables de substitution avec des appels REST

Les développeurs de magasin doivent transmettre le nom et la valeur que les variables de substitution doivent remplacer.

Il existe deux types de variables de substitution : 1 les variables prédéfinies et 2 les variables dynamiques.

1 Pour les variables de substitution prédéfinies, le moteur de marketing définit deux variables utiles pour le contenu HTML statique, [contextPath] et [imagePath].

Par exemple, dans le fichier widgetdir/com.ibm.commerce.store.widgets.ContentRecommendation/ContentRecommendation_Data.jspf, les variables DM_contextPath (qui remplacera [contextPath]) et DM_imagePath (qui remplacera [imagePath]) sont transmises en tant que paramètres dans l'appel d'API REST /espot.

Les variables env_contextAndServletPath et jspStoreImgDir sont définies dans le fichier storedir/Common/EnvironmentSetup.jspf :


<%-- Call the REST service to get the data to display in the e-Marketing Spot --%>
<wcf:rest var="eSpotDatasRoot" url="/store/{storeId}/espot/{name}" format="json" >
            <%-- the name of the e-Marketing Spot --%>
            <wcf:param name="DM_EmsName" value="${emsName}" />

            <wcf:param name="DM_contextPath" value="${env_contextAndServletPath}" />
            <wcf:param name="DM_imagePath" value="${requestScope.jspStoreImgDir}" />

Par conséquent, les développeurs de magasin doivent identifier les valeurs applicables pour leur environnement et transmettre les paramètres DM_contextPath et DM_imagePath dans l'appel REST.

2 Pour les variables de substitution dynamiques, les développeurs de magasin peuvent transmettre une ou plusieurs variables, comme DM_SubstitutionNameX et DM_SubstitutionValueX, où X est une valeur à partir de 1.

Le magasin type Aurora passe dans 6 de ces variables : [storeName], [fullPathHomeURL], [langlocale], [productTotalCount], [contentTotalCount] et [widgetSuffix].

Par exemple, dans le fichier widgetdir/com.ibm.commerce.store.widgets.ContentRecommendation/ContentRecommendation_Data.jspf, le code suivant apparaît :


<c:if test="${empty param.substitutionName1}">
<wcf:param name="DM_SubstitutionName1" value="[storeName]" />
<wcf:param name="DM_SubstitutionValue1" value="${storeName}" />
</c:if>
<c:if test="${empty param.substitutionName2}">
<wcf:param name="DM_SubstitutionName2" value="[fullPathHomeURL]" />
<wcf:param name="DM_SubstitutionValue2" value="${homePageURL}" />
</c:if>
<c:if test="${empty param.substitutionName3}">
<wcf:param name="DM_SubstitutionName3" value="[langlocale]" />
<wcf:param name="DM_SubstitutionValue3" value="${locale}" />
</c:if>
<c:if test="${empty param.substitutionName4}">
<wcf:param name="DM_SubstitutionName4" value="[productTotalCount]" />
<wcf:param name="DM_SubstitutionValue4" value="${searchTabSubText1}" />
</c:if>

<c:if test="${empty param.substitutionName5}">
<wcf:param name="DM_SubstitutionName5" value="[contentTotalCount]" />
<wcf:param name="DM_SubstitutionValue5" value="${searchTabSubText2}" />
</c:if>

<wcf:param name="DM_SubstitutionName6" value="[widgetSuffix]" />
<wcf:param name="DM_SubstitutionValue6" value="${widgetSuffix}" />

Dans ce scénario, le développeur de magasin doit identifier les valeurs applicables à son environnement et transmettre les paramètres DM_SubstitutionNameX et DM_SubstitutionValueX dans l'appel REST.