Fragmentos de contenido Configurar componentes para procesamiento

Existen varios servicios avanzados relacionados con la representación de fragmentos de contenido. Para utilizar estos servicios, los tipos de recursos de dichos componentes deben darse a conocer al marco de fragmentos de contenido.

Esto se lleva a cabo configurando la Configuración del componente de fragmento de contenido del servicio OSGi.

PRECAUCIÓN

Si no necesita los servicios avanzados que se describen a continuación, puede ignorar esta configuración.

PRECAUCIÓN

Al ampliar o utilizar los componentes integrados, no se recomienda cambiar la configuración.

PRECAUCIÓN

Puede escribir un componente desde cero que utilice únicamente la API de fragmentos de contenido, sin servicios avanzados. Sin embargo, en este caso, tendrá que desarrollar el componente para que gestione el procesamiento adecuado.

Por lo tanto, se recomienda utilizar los componentes principales.

Definición de los servicios avanzados que necesitan configuración

Los servicios que requieren el registro de un componente son:

  • Determinar las dependencias correctamente durante la publicación (es decir, asegurarse de que los fragmentos y modelos se pueden 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.
  • Administración/administración de contenido intermedio.
  • Administración/administración de recursos de medios mixtos.
  • Despegue del despachante para fragmentos a los que se hace referencia (si se vuelve a publicar una página que contiene un fragmento).
  • Mediante el procesamiento basado en párrafos.

Si necesita una o más de estas funciones, entonces (normalmente) es más fácil utilizar la funcionalidad lista para usar, en lugar de desarrollarla desde cero.

Servicio OSGi - Configuración del componente de fragmento de contenido

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

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

NOTA

Consulte Configuración de OSGi para obtener más detalles.

Por ejemplo:

cfm-01

La configuración 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; p. ej.

core/wcm/components/contentfragment/v1/contentfragment

Propiedad Reference dam.cfm.component.fileReferenceProp El nombre de la propiedad que contiene la referencia al fragmento; p. ej. fragmentPath o fileReference
Propiedad Element(s) dam.cfm.component.elementsProp El nombre de la propiedad que contiene los nombres de los elementos que se van a procesar; p. ej.elementName
Propiedad de variación
dam.cfm.component.variationProp El nombre de la propiedad que contiene el nombre de la variación que se va a procesar; p. ej.variationName

Para algunas funciones (por ejemplo, para representar solo un rango de párrafos), deberá cumplir algunas convenciones:

Nombre de propiedad Descripción
paragraphRange

Una propiedad de cadena que define el rango de párrafos que se van a generar si se encuentra en modo de procesamiento de un solo elemento.

Formato:

  • 1 o 1-3 o 1-3;6;7-8 o *-3;5-*
  • solo se evalúa si paragraphScope está establecido en range
paragraphScope

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

Valores:

  • all :: para procesar todos los párrafos
  • range :: para representar el rango 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)
PRECAUCIÓN

Esto puede cambiar en 6,5 hitos posteriores.

Ejemplo

Como ejemplo, consulte lo siguiente (en una instancia de AEM lista para usar):

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

Contiene:

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"

En esta página