Componenti di configurazione dei frammenti di contenuto per il rendering content-fragments-configuring-components-for-rendering
Ce ne sono diversi servizi avanzati relative al rendering dei frammenti di contenuto. Per utilizzare questi servizi, i tipi di risorse di tali componenti devono farsi conoscere nel framework dei frammenti di contenuto.
Questa operazione viene eseguita configurando Servizio OSGi - Configurazione del componente Frammento di contenuto.
Queste informazioni sono necessarie quando:
- È necessario implementare un componente basato su frammenti di contenuto personalizzato,
- E devono utilizzare i servizi avanzati.
L’Adobe consiglia di utilizzare i Componenti core.
-
Se non è necessario servizi avanzati come descritto di seguito, puoi ignorare questa configurazione.
-
Quando estendi o utilizzi i componenti predefiniti, si sconsiglia di modificare la configurazione OSGi.
-
Puoi scrivere da zero un componente che utilizza solo l’API Frammenti di contenuto, senza servizi avanzati. Tuttavia, in questo caso, dovrai sviluppare il componente in modo che gestisca l’elaborazione appropriata.
Definizione dei servizi avanzati che richiedono la configurazione definition-of-advanced-services-that-need-configuration
I servizi che richiedono la registrazione di un componente sono:
- Determinare correttamente le dipendenze durante la pubblicazione (ovvero, assicurarsi che frammenti e modelli possano essere pubblicati automaticamente con una pagina se sono stati modificati dopo l’ultima pubblicazione).
- Supporto per frammenti di contenuto nella ricerca full-text.
- La gestione/gestione di contenuto intermedio.
- La gestione/gestione di risorse multimediali diverse.
- Svuotamento del Dispatcher per i frammenti di riferimento (se viene ripubblicata una pagina contenente un frammento).
- Utilizzo del rendering basato su paragrafi.
Se hai bisogno di una o più di queste funzioni, in genere è più facile utilizzare i servizi avanzati preconfigurati, anziché svilupparli da zero.
Servizio OSGi - Configurazione del componente Frammento di contenuto osgi-service-content-fragment-component-configuration
La configurazione deve essere associata al servizio OSGi Configurazione del componente Frammento di contenuto:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Ad esempio:
La configurazione OSGi è:
dam.cfm.component.resourceType
Tipo di risorsa da registrare, ad esempio
core/wcm/components/contentfragment/v1/contentfragment
dam.cfm.component.fileReferenceProp
fragmentPath
o fileReference
dam.cfm.component.elementsProp
elementName
dam.cfm.component.variationProp
variationName
Per alcune funzionalità il componente dovrà rispettare convenzioni predefinite. La tabella seguente descrive le proprietà che devono essere definite dal componente per ciascun paragrafo (ovvero jcr:paragraph
per ogni istanza di componente) in modo che i servizi possano rilevarli ed elaborarli correttamente.
paragraphScope
Una proprietà stringa che definisce come devono essere generati i paragrafi se in modalità di rendering di un singolo elemento.
Valori:
all
: per eseguire il rendering di tutti i paragrafirange
: per riprodurre l’intervallo di paragrafi fornito daparagraphRange
paragraphRange
Una proprietà stringa che definisce l’intervallo di paragrafi da restituire se in modalità di rendering di un singolo elemento.
Formato:
-
1
o1-3
o1-3;6;7-8
o*-3;5-*
-
indicatore di intervallo;
separatore di elenco*
carattere jolly
-
valutato solo se
paragraphScope
è impostato surange
paragraphHeadings
h1
, h2
, h3
) vengono conteggiati come paragrafi (true
) o meno (false
)Esempio example
Ad esempio, consulta quanto segue (su un’istanza di AEM preconfigurata):
/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"