Show Menu
ARGOMENTI×

Componenti di configurazione dei frammenti di contenuto per il rendering

Esistono diversi servizi Definizione di servizi avanzati che richiedono la configurazione avanzati relativi al rendering dei frammenti di contenuto. Per utilizzare questi servizi, i tipi di risorse di tali componenti devono essere resi noti al framework dei frammenti di contenuto.
Questa operazione viene eseguita configurando il servizio OSGi - Configurazione componente frammento di contenuto.
Queste informazioni sono necessarie quando:
  • È necessario implementare un proprio componente basato su frammenti di contenuto,
  • E devono utilizzare i servizi avanzati.
Si consiglia di utilizzare i componenti core.
  • Se non sono necessari i servizi Definizione di servizi avanzati che richiedono la configurazione ​avanzati descritti di seguito, puoi ignorare questa configurazione.
  • Quando si estendono o si utilizzano i componenti forniti , non è consigliabile modificare la configurazione OSGi.
  • È possibile scrivere un componente da zero che utilizza solo l'API dei frammenti di contenuto, senza servizi avanzati. Tuttavia, in tal caso, sarà necessario sviluppare il componente in modo che gestisca l’elaborazione appropriata.
Si consiglia pertanto di utilizzare i componenti core.

Definizione di servizi avanzati che richiedono la configurazione

I servizi che richiedono la registrazione di un componente sono:
  • Determinazione corretta delle dipendenze durante la pubblicazione (ad esempio, verificare che frammenti e modelli possano essere pubblicati automaticamente con una pagina se sono stati modificati dall’ultima pubblicazione).
  • Supporto per i frammenti di contenuto nella ricerca full-text.
  • Gestione/gestione del contenuto intermedio.
  • Gestione/gestione di risorse multimediali diverse.
  • Dispatcher flush per i frammenti di riferimento (se una pagina contenente un frammento viene pubblicata nuovamente).
  • Utilizzo del rendering basato su paragrafo.
Se hai bisogno di una o più di queste funzionalità, in genere è più semplice utilizzare i servizi avanzati out-of-the-box, invece di svilupparli da zero.

Servizio OSGi - Configurazione componente frammento di contenuto

La configurazione deve essere associata alla configurazione del componente frammento di contenuto del servizio OSGi:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Per ulteriori informazioni, consultate Configurazione Configurazione OSGI OSGi.
Ad esempio:
La configurazione OSGi è:
Etichetta Configurazione OSGi Descrizione
Tipo risorsa dam.cfm.component.resourceType Il tipo di risorsa da registrare; ad esempio
core/wcm/components/contentfragment/v1/contentfragment
Proprietà Reference dam.cfm.component.fileReferenceProp Nome della proprietà contenente il riferimento al frammento; ad esempio fragmentPath o fileReference
Proprietà Element(s) dam.cfm.component.elementsProp Il nome della proprietà che contiene i nomi degli elementi di cui eseguire il rendering; ad esempio elementName
Proprietà variante dam.cfm.component.variationProp Il nome della proprietà che contiene il nome della variante da rappresentare; ad esempio variationName
Per alcune funzionalità, il componente dovrà rispettare convenzioni predefinite. Nella tabella seguente sono illustrate le proprietà che devono essere definite dal componente per ogni paragrafo (ovvero jcr:paragraph per ogni istanza di componente) in modo che i servizi possano rilevarle ed elaborarle correttamente.
Nome proprietà Descrizione
paragraphScope
Una proprietà stringa che definisce la modalità di output dei paragrafi in modalità di rendering di un singolo elemento .
Valori:
  • all : per eseguire il rendering di tutti i paragrafi
  • range : per eseguire il rendering dell'intervallo di paragrafi fornito da paragraphRange
paragraphRange
Una proprietà stringa che definisce l'intervallo di paragrafi da restituire se in modalità di rendering a elemento singolo.
Formato:
  • 1 o 1-3 o 1-3;6;7-8 *-3;5-*
    • - indicatore di gamma
    • ; separatore elenco
    • * carattere jolly
  • valutato solo se paragraphScope impostato su range
paragraphHeadings Una proprietà booleana che definisce se le intestazioni (ad esempio, h1 , h2 , h3 ) sono conteggiate come paragrafi ( true ) o meno ( false )

Esempio

Per un esempio, consultate quanto segue (su un’istanza AEM out-of-the-box):
/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"