Show Menu
TOPICS×

Componente de fragmento de experiencia

El componente de fragmento de experiencia de componente principal permite al autor del contenido colocar una variación de fragmento de experiencia en una página mientras admite una estructura de sitio localizada.

Uso

El componente de fragmento de experiencia de componente principal permite al autor del contenido seleccionar entre las variables de fragmento de experiencia existentes y colocar una en la página de contenido. El componente Fragmento de experiencia también admite una estructura de sitio localizada.
  • Las propiedades de los componentes se pueden definir en el cuadro de diálogo Configurar cuadro de diálogo Configurar.
  • Los valores predeterminados del componente al agregarlo a una página se pueden definir en el cuadro de diálogo de diseño.

Compatibilidad con la estructura del sitio localizada

El componente Fragmento de experiencia se adapta a las estructuras del sitio localizado y representa el fragmento de experiencia correcto en función de la localización de la página. Para ello, el fragmento de experiencia debe cumplir las siguientes condiciones.
  • El componente Fragmento de experiencia se agrega a una plantilla.
  • Esa plantilla se utiliza para crear una nueva página de contenido que forma parte de una estructura localizada a continuación
    /content/<site>
    .
  • El fragmento de experiencia al que se hace referencia en una página de contenido forma parte de una estructura de fragmentos de experiencia localizada a continuación
    /content/experience-fragments
    que sigue los mismos patrones que el sitio a continuación,
    /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 procesará como parte de la plantilla.
Este comportamiento se limita a los componentes de fragmento de experiencia añadidos a las plantillas. Los componentes de fragmento de experiencia añadidos a páginas de contenido individuales representarán las representaciones exactas de fragmentos de experiencia configuradas dentro del componente.
  • Para ver un ejemplo de cómo funcionan las funciones de localización del componente Fragmento de experiencia, consulte la sección siguiente .
  • Para ver un ejemplo de cómo funcionan conjuntamente las funciones de localización de los componentes principales, consulte la página Características de localización de la páginaComponentes principales.

Ejemplo

Supongamos que su contenido tiene este aspecto:
/content +-- experience-fragments \-- we-retail +-- language-masters +-- us +-- en +-- footerTextXf \-- headerTextXf \-- es +-- footerTextXf \-- headerTextXf \-- ch +-- de +-- footerTextXf \-- headerTextXf +-- fr +-- footerTextXf \-- headerTextXf \-- it +-- footerTextXf \-- headerTextXf +-- we-retail +-- language-masters +-- us +-- en \-- es +-- ch +-- de +-- fr \-- it +-- wknd-events \-- wknd-shop
Observe que la estructura siguiente
/content/experience-fragments/we-retail
refleja la estructura de
/content/we-retail
.
En este caso, si el componente Fragmento de experiencia
/content/experience-fragments/we-retail/us/en/footerTextXf
se coloca en una plantilla, las páginas localizadas creadas a partir de esa plantilla representarán automáticamente el fragmento de experiencia localizado que corresponde a la página de contenido localizado.
Por lo tanto, si se desplaza a una página de contenido debajo de
/content/we-retail/ch/de
la que se utiliza la misma plantilla,
/content/experience-fragments/we-retail/ch/de/footerTextXf
se procesará en lugar de
/content/experience-fragments/we-retail/us/en/footerTextXf
.

Visitas en el orden previsto

El componente Fragmento de experiencia intentará encontrar un componente localizado correspondiente en el orden siguiente.
  1. Primero trata de encontrar una raíz de idioma.
  2. Si no se encuentra, intenta encontrar un modelo.
  3. Si no se encuentra, intenta encontrar una Live Copy.
  4. Si no se encuentra, el valor predeterminado es el fragmento de experiencia configurado en el componente.

Versión y compatibilidad

La versión actual del componente Fragmento de experiencia es v1, que se introdujo con la versión 2.6.0 de los componentes principales en septiembre de 2019 y se describe en este documento.
En la tabla siguiente se detallan todas las versiones compatibles del componente, las versiones de AEM con las que las versiones del componente son compatibles y los vínculos a la documentación de versiones anteriores.
Versión del componente
AEM 6.3
AEM 6.4
AEM 6.5
v1
Compatible
Compatible
Compatible
Para obtener más información sobre las versiones y versiones de los componentes principales, consulte el documento Versiones de componentes principales.

Ejemplo de salida de componente

Para experimentar el componente Fragmento de experiencia y ver ejemplos de sus opciones de configuración, así como los resultados HTML y JSON, visite la biblioteca de componentes.

Detalles técnicos

La documentación técnica más reciente sobre el componente Fragmento de experiencias puede encontrarse en GitHub .
Encontrará más detalles sobre el desarrollo de los componentes principales en la documentación para desarrolladores de los componentes principales.

Configurar cuadro de diálogo

El cuadro de diálogo de configuración permite al autor del contenido seleccionar la variación de fragmento de experiencia que se debe representar en la página.
Utilice el botón
Abrir cuadro de diálogo
de selección para abrir el selector de componentes y elegir la variación de componente de fragmento de experiencia que desea agregar a la página de contenido.
Si agrega el componente Fragmento de experiencia a una plantilla, tenga en cuenta que se localizará automáticamente siempre que los fragmentos de experiencia estén localizados, por lo que lo que se procese en la página puede variar del componente que seleccione explícitamente. Consulte el ejemplo anterior para obtener más información.

Cuadro de diálogo Diseño

El cuadro de diálogo de diseño permite al autor de la plantilla definir las opciones disponibles para el autor del contenido que utiliza el componente Fragmento de experiencia y los valores predeterminados establecidos al colocar el componente Fragmento de experiencia.
El componente Fragmento de experiencia admite el sistema de estilo AEM.