Variables de sustitución para entrar HTML en el Management Center

En la herramienta Marketing, puede utilizar las variables de sustitución en el HTML de contenido de marketing para mejorar el manejo de enlaces para almacenar páginas y archivos del contenido de marketing. Mediante el uso de estas variables de sustitución, puede utilizar el mismo HTML en la vista previa de tienda y el escaparate de producción sin cambiar la raíz de contexto. El motor de marketing sustituye dinámicamente estas variables por la información de raíz de contexto correcta.

Anteriormente si entraba HTML en el campo de texto al crear o cambiar el contenido de marketing, tenía que codificar la raíz de contexto específica para las vías de acceso de imagen y los URL. Si el escaparate y la vista previa de tienda del Management Center utilizaban raíces de contexto diferentes para las imágenes y los URL, no podía utilizar el mismo HTML en la vista previa de tienda y el escaparate. Para conmutar entre ver las imágenes y los URL en el escaparate y la vista previa de la tienda, ha tenido que cambiar la raíz de contexto. Puede incluir variables de sustitución para la vía de acceso de imagen y los URL para poder ver las imágenes y los URL en la vista previa de la tienda y el escaparate sin cambiar la raíz de contexto. Puede establecer las variables de sustitución para la raíz de contexto al crear o cambiar el contenido de marketing en el Management Center.

Fragmento HTML estático de ejemplo

Los archivos JSP de zona de e-Marketing de tienda de inicio se han ampliado para pasar variables de sustitución para el contenido de imagen. Estas variables se sustituyen en el texto de contenido y el HTML de imagen. Si desea utilizar las variables [contextPath] y [imagePath] al crear o cambiar el HTML para el contenido de imagen, estas vías de acceso las debe pasar el archivo JSP de e-Marketing Spot. Incluya el siguiente código en los archivos JSP de zonas de e-Marketing correspondientes a la tienda para habilitar el uso de estas variables para las zonas de e-Marketing de la tienda.

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

En el HTML de contenido de imagen en Management Center, puede incluir variables de sustitución al definir la vía de acceso de imagen o cualquier URL. Por ejemplo, el siguiente fragmento de código HTML incluye las variables de sustitución [imagePath], [contextPath], [storeId] y [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 línea marcada 1 muestra cómo se pueden incluir imágenes en el HTML estático. Puede enlazar a archivos de imagen que sube utilizando la herramienta Elementos en el Management Center. Tome en cuenta que la vía de acceso al archivo de imagen debe empezar con [imagePath].
La línea marcada 2 muestra cómo puede enlazar a otras páginas de tienda desde el HTML estático. Este ejemplo utiliza el mandato SearchDisplay para conectarse a la página de resultados de búsqueda que contiene los resultados para el término de búsqueda dresses.

Variables de sustitución para su uso en HTML estático

HCL Commerce proporciona un conjunto de variables de sustitución que puede utilizar en el HTML estático para el contenido de marketing. Puede utilizar estas variables de sustitución para HTML de correlación de imágenes de texto de marketing. Mediante el uso de las variables de sustitución, puede ver previamente las páginas de contenido personalizadas a medida que se visualizan en la tienda en directo. Al insertar una variable de sustitución, el servidor sustituye automáticamente la variable por los datos correctos del entorno de tienda actual.

La siguiente tabla detalla las variables de sustitución que están soportadas de forma predeterminada.


Etiqueta	Variable de tienda de inicio	Descripción:
`[contextPath]`	`${env_contextAndServletPath}`	Para enlaces de URL: Utilizadas juntas, estas dos variables insertan una parte del URL en una página de tienda. Ejemplo 1: para conectarse a otra página de tienda denominada `terms-of-use`: `<a href="[contextPath]/aurora/content/terms-of-use">...</a>` Ejemplo 2: Para conectarse a una página de resultados para la búsqueda del término `dresses`: `<a href="[contextPath]/SearchDisplay?searchTerm=dresses&storeId=[storeId]&catalogId=[catalogId]">...</a>`
`[imagePath]`	`${env_imageContextPath}`	Para enlaces de imagen: Esta variable inserta la parte de la vía de acceso de imagen que viene antes de /`storedirectory` en la herramienta Elementos. Por ejemplo, si el archivo de imagen está en la vía de acceso siguiente en la herramienta Elementos: `/Aurora/content/custom/images/en_US/dresses_espot.png` El enlace utiliza la variable de sustitución `[imagePath]` para generar la vía de acceso siguiente: `src=[imagePath]/Aurora/content/custom/images/en_US/dresses_espot.png`
`[storeId]`		Para enlaces de URL: Esta variable inserta el ID de tienda en el URL. Consulte Ejemplo 2: para la variable `[contextPath]`.
`[catalogId]`		Para enlaces de URL: Esta variable inserta el ID de catálogo en el URL. Consulte Ejemplo 2: para la variable `[contextPath]`.
`[ProductDisplay?productId=NNN]`		Para sustituir el URL SEO para información de producto. Por ejemplo, si la página de producto está en el URL siguiente: `en/aurora/electronics/widescreen-lcd-monitor` El enlace utiliza la variable de sustitución `[ProductDisplay?productId=NNN]` para generar la vía de acceso siguiente: `en/aurora/electronics/widescreen-lcd-monitor`
`[CategoryDisplay?categoryId=NNN]`		Para sustituir el URL SEO para información de categoría. Por ejemplo, si la página de categoría está en el URL siguiente: `en/aurora/electronics` El enlace utiliza la variable de sustitución `[CategoryDisplay?categoryId=NNN]` para generar la vía de acceso siguiente: `en/aurora/electronics`

Nota: Como método recomendado, indique el prefijo [contextPath]/ en los URL href que se incluyen en el código fuente HTML. Donde [contextPath]/ es la vía de acceso del contexto o servlet al URL. Por ejemplo,

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

Donde [webapp/wcs/preview/servlet]/ es el valor de [contextPath]/.

Utilización de variables de sustitución con llamadas REST

Los desarrolladores de tiendas son los responsables de pasar el nombre y el valor que debe sustituirse con variables de sustitución.

Hay dos tipos de variables de sustitución: 1 predefinido y 2 dinámicos.

1 Para las variables de sustitución predefinidas, el motor de marketing define dos variables útiles para el contenido HTML estático, [contextPath] y [imagePath].

Por ejemplo, en el archivo widgetdir/com.ibm.commerce.store.widgets.ContentRecommendation/ContentRecommendation_Data.jspf, las variables DM_contextPath (que sustituirán a [contextPath] ) y DM_imagePath (que sustituirán [imagePath] ) se pasan como parámetros en la llamada de API de REST /espot.

Las variables env_contextAndServletPath y jspStoreImgDir se definen en el archivo 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}" />

Por lo tanto, los desarrolladores de tiendas tendrán que averiguar los valores aplicables para su entorno y pasar los parámetros DM_contextPath y DM_imagePath en la llamada REST.

2 Para las variables de sustitución dinámicas, los desarrolladores de tiendas pueden pasar en una o más variables, como DM_SubstitutionNameX y DM_SubstitutionValueX, donde X es un valor que comienza en 1.

La tienda de inicio Aurora pasa 6 de estas variables: [storeName], [fullPathHomeURL], [langlocale], [productTotalCount], [contentTotalCount], y [widgetSuffix].

Por ejemplo, en el archivo widgetdir/com.ibm.commerce.store.widgets.ContentRecommendation/ContentRecommendation_Data.jspf, aparece el código siguiente:


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

En este escenario, el desarrollador de tiendas tendrán que averiguar los valores aplicables para su entorno y pasar los parámetros DM_SubstitutionNameX y DM_SubstitutionValueX en la llamada REST.