Componente Fragmento de experiencia de correo electrónico email-experience-fragment-component
El componente Fragmento de experiencia de correo electrónico permite al autor del contenido colocar una variación de fragmento de experiencia en su contenido y admitir al mismo tiempo una estructura de contenido localizada.
Uso usage
El componente Fragmento de experiencia de correo electrónico permite al autor del contenido seleccionar entre las variaciones de fragmento de experiencia existentes y colocar una en el contenido. Un Fragmento de experiencia es un grupo de contenido que incluye contenido y diseño y que se puede reutilizar en todos los canales.
- Las propiedades del componente se pueden definir en el cuadro de diálogo de configuración.
- Los valores predeterminados del componente se pueden definir en el cuadro de diálogo de diseño al agregarlo a un contenido.
El componente Fragmento de experiencia de correo electrónico también admite una estructura de sitio localizada.
Versión y compatibilidad version-and-compatibility
La versión actual del componente Fragmento de experiencia de correo electrónico es la versión 1, que se introdujo con la versión X de los componentes principales de correo electrónico en octubre de 2022 y se describe en este documento.
La siguiente tabla detalla todas las versiones compatibles del componente, las versiones de AEM con las que son compatibles las versiones del componente y los vínculos a la documentación de versiones anteriores.
Para obtener más información acerca de las versiones y publicaciones de los componentes principales de correo electrónico, consulte el documento Versiones de los componentes principales de correo electrónico.
Compatibilidad con la estructura del sitio localizada localized-site-structure
El componente Fragmento de experiencia de correo electrónico se adapta a las estructuras de contenido localizadas y representa el fragmento de experiencia adecuado en función de la localización del contenido. Para ello, el fragmento de experiencia debe cumplir las siguientes condiciones.
- El componente Fragmento de experiencia de correo electrónico se agrega a una plantilla de página.
- Esa plantilla se utiliza para crear una nueva página de contenido que forma parte de una estructura localizada debajo de
/content/<site>. - El fragmento de experiencia al que se hace referencia en una página de contenido forma parte de una estructura de fragmento de experiencia localizada debajo de
/content/experience-fragmentsque sigue los mismos patrones que el sitio debajo de/content/<site>, incluido el uso de los mismos nombres de componentes.
En este caso, el fragmento con la misma localización (idioma, modelo o Live Copy) que la página actual se procesa como parte de la plantilla.
Este comportamiento se limita a los componentes de fragmento de experiencia de correo electrónico añadidos a las plantillas. Los componentes Fragmento de experiencia añadidos a páginas de contenido individuales procesarán las representaciones exactas de fragmentos de experiencia configuradas en el componente.
- Para ver un ejemplo de cómo trabajan las funciones de localización del componente Fragmento de experiencia, consulte la sección siguiente.
- Para ver un ejemplo de cómo funcionan juntas las funciones de localización de los componentes principales, consulte la página Funciones de localización de los componentes principales.
Ejemplo example
Digamos que el contenido tiene este aspecto:
/content
+-- experience-fragments
\-- wknd
+-- language-masters
+-- us
+-- en
+-- footerTextXf
\-- headerTextXf
\-- es
+-- footerTextXf
\-- headerTextXf
\-- ch
+-- de
+-- footerTextXf
\-- headerTextXf
+-- fr
+-- footerTextXf
\-- headerTextXf
\-- it
+-- footerTextXf
\-- headerTextXf
+-- wknd
+-- language-masters
+-- us
+-- en
\-- es
+-- ch
+-- de
+-- fr
\-- it
+-- wknd-events
\-- wknd-shop
Verá que la estructura siguiente /content/experience-fragments/wknd refleja la estructura de /content/wknd.
En este caso, si el componente Fragmento de experiencia de correo electrónico /content/experience-fragments/wknd/us/en/footerTextXf se coloca en una plantilla, las páginas localizadas creadas en función de esa plantilla procesarán automáticamente el fragmento de experiencia localizado que corresponda a la página de contenido localizada.
Por lo tanto, si se desplaza a una página de contenido en /content/wknd/ch/de que utiliza la misma plantilla, se procesará /content/experience-fragments/wknd/ch/de/footerTextXf en lugar de /content/experience-fragments/wknd/us/en/footerTextXf.
Abandono fallback
El componente Fragmento de experiencia de correo electrónico intentará encontrar un componente localizado correspondiente en el siguiente orden.
- Primero intenta encontrar una raíz de idioma.
- Si no se encuentra, intenta encontrar un modelo.
- Si no se encuentra, intenta encontrar una versión activa.
- Si no se encuentra, el valor predeterminado será el fragmento de experiencia configurado en el componente.
Detalles técnicos technical-details
Lea la última versión de documentación técnica sobre el componente Fragmento de experiencia.
Puede encontrar más información acerca del desarrollo de componentes principales en la documentación para desarrolladores de componentes principales.
Cuadro de diálogo de configuración configure-dialog
El cuadro de diálogo de configuración permite al autor del contenido seleccionar la variación del fragmento de experiencia que se debe procesar en la página.
Utilice el botón Abrir cuadro de diálogo de selección para abrir el selector de componentes y elegir qué variación del componente Fragmento de experiencia se agregará a la página de contenido.
Si agrega el componente Fragmento de experiencia de correo electrónico a una plantilla, se localizará automáticamente siempre que los fragmentos de experiencias estén localizados, de modo que lo que se procesa en la página puede variar del componente que seleccione explícitamente. Consulte el ejemplo anterior para obtener más información.
También puede definir un ID. Esta opción permite controlar el identificador único del componente en el HTM.
- Si se deja en blanco, se generará automáticamente un ID único que se puede encontrar inspeccionando el contenido resultante.
- Si se especifica un ID, es responsabilidad del autor asegurarse de que sea único.
- Cambiar el ID puede afectar al CSS.
Pestaña Estilos styles-tab-edit
El componente Fragmento de experiencia de correo electrónico es compatible con el sistema de estilos de AEM.
Utilice la lista desplegable para seleccionar los estilos que desea aplicar al componente. Las selecciones realizadas en el cuadro de diálogo de edición tienen el mismo efecto que las seleccionadas en la barra de herramientas de componentes.
Los estilos deben configurarse para este componente en el cuadro de diálogo de diseño para que la pestaña esté disponible.
Cuadro de diálogo de diseño design-dialog
El cuadro de diálogo de diseño permite al autor de la plantilla definir las opciones disponibles para el autor de contenido que utiliza el componente Fragmento de experiencia de correo electrónico y los valores predeterminados establecidos al colocarlo.
Pestaña Estilos styles-tab
El componente Fragmento de experiencia de correo electrónico es compatible con el sistema de estilos de AEM.