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.
Esta información es necesaria cuando:
Se recomienda utilizar los componentes principales.
Si no necesita los servicios avanzados descritos a continuación, puede omitir esta configuración.
Al ampliar o utilizar los componentes listos para usar, no se recomienda cambiar la configuración de OSGi.
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.
Los servicios que requieren el registro de un componente son:
Si necesita una o más de estas funciones, entonces (normalmente) es más fácil usar los servicios avanzados predeterminados, en lugar de desarrollarlos desde cero.
La configuración debe enlazarse al servicio OSGi Configuración del componente de fragmento de contenido:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Consulte Configuración de OSGi para obtener más detalles.
Por ejemplo:
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.
|
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, el componente tendrá que cumplir las convenciones predefinidas. En la tabla siguiente se detallan las propiedades que el componente debe definir para cada párrafo (p. ej. jcr:paragraph
para cada instancia de componente) para que los servicios puedan detectarlos y procesarlos correctamente.
Nombre de propiedad | Descripción |
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:
|
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:
|
paragraphHeadings |
Una propiedad booleana que define si los encabezados (por ejemplo, h1 , h2 , h3 ) se cuentan como párrafos (true ) o no (false ) |
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"