Fragmentos de contenido Configurar componentes para procesamiento content-fragments-configuring-components-for-rendering

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Experience Fragments

Creado para:

Developer

Hay varios servicios avanzados relacionado con la renderización de fragmentos de contenido. Para utilizar estos servicios, los tipos de recurso de dichos componentes deben darse a conocer al marco de trabajo de fragmentos de contenido.

Esto se hace configurando la variable Servicio OSGi: configuración del componente Fragmento de contenido.

CAUTION

Si no necesita el servicios avanzados Como se describe a continuación, puede ignorar esta configuración.

CAUTION

Cuando se amplía o se utilizan los componentes predeterminados, no se recomienda cambiar la configuración.

CAUTION

Puede escribir un componente desde cero que utilice solo la API de fragmentos de contenido, sin servicios avanzados. Sin embargo, en tal caso, deberá desarrollar el componente para que se ocupe del procesamiento adecuado.

Por lo tanto, se recomienda utilizar los componentes principales.

Definición de servicios avanzados que necesitan configuración definition-of-advanced-services-that-need-configuration

Los servicios que requieren el registro de un componente son:

Determinar correctamente las dependencias durante la publicación (es decir, asegurarse de que los fragmentos y modelos se puedan publicar automáticamente con una página si han cambiado desde la última publicación).
Compatibilidad con fragmentos de contenido en la búsqueda de texto completo.
La gestión/gestión de contenido intermedio.
La gestión/gestión de recursos de medios mixtos.
Vaciar Dispatcher para fragmentos a los que se hace referencia (si se vuelve a publicar una página que contiene un fragmento).
Uso de la renderización basada en párrafos.

Si necesita una o más de estas funciones, (por lo general) es más fácil utilizar la funcionalidad predeterminada, en lugar de desarrollarla desde cero.

Servicio OSGi: configuración del componente Fragmento de contenido osgi-service-content-fragment-component-configuration

La configuración debe enlazarse al servicio OSGi Configuración del componente Fragmento de contenido:

com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl

NOTE

Consulte Configurar OSGi para obtener más información.

Por ejemplo:

cfm-01

La configuración de OSGi es:

Etiqueta

Configuración de OSGi

Descripción

Tipo de medio

dam.cfm.component.resourceType

El tipo de recurso que se va a registrar; por ejemplo,

core/wcm/components/contentfragment/v1/contentfragment

Propiedad de referencia

dam.cfm.component.fileReferenceProp

Nombre de la propiedad que contiene la referencia al fragmento; por ejemplo, fragmentPath o fileReference

Propiedad de elemento(s)

dam.cfm.component.elementsProp

Nombre de la propiedad que contiene los nombres de los elementos que se van a representar; por ejemplo,elementName

Propiedad de variación

dam.cfm.component.variationProp

Nombre de la propiedad que contiene el nombre de la variación que se va a procesar; por ejemplo,variationName

Para algunas funciones (por ejemplo, para procesar solo un intervalo de párrafo) tendrá que adherirse a algunas convenciones:

Nombre de la propiedad

Descripción

paragraphRange

Una propiedad de cadena que define el intervalo de párrafos de salida si en modo de procesamiento de elemento único.

Formato:

1 o 1-3 o 1-3;6;7-8 o *-3;5-*
solo se evalúa si paragraphScope se establece en range

paragraphScope

Una propiedad de cadena que define cómo se van a generar los párrafos si en modo de procesamiento de elemento único.

Valores:

all : para procesar todos los párrafos
range : para representar el intervalo de párrafos proporcionado por paragraphRange

paragraphHeadings

Una propiedad booleana que define si los encabezados (por ejemplo, h1, h2, h3) se cuentan como párrafos (true) o no (false)

CAUTION

Esto puede cambiar en los hitos 6.5 posteriores.

Ejemplos example

AEM Por ejemplo, consulte lo siguiente (en una instancia de aplicación predeterminada de la interfaz de usuario de la interfaz de usuario de la aplicación de configuración de la aplicación de configuración de la aplicación de configuración de la aplicación):

/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config

Contiene lo siguiente:

dam.cfm.component.resourceType="core/wcm/components/contentfragment/v1/contentfragment"
dam.cfm.component.fileReferenceProp="fragmentPath"
dam.cfm.component.elementsProp="elementName"
dam.cfm.component.variationProp="variationName"

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2