Esistono diversi servizi avanzati correlati 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.
Se non è necessario disporre dei servizi avanzati descritti di seguito, puoi ignorare questa configurazione.
Quando si estendono o si utilizzano i componenti forniti, non è consigliabile modificare la configurazione.
È 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.
I servizi che richiedono la registrazione di un componente sono:
Se avete bisogno di una o più di queste funzioni, è più semplice utilizzare la funzionalità out-of-the-box, anziché svilupparla da zero.
La configurazione deve essere associata al servizio OSGi Configurazione componente frammento di contenuto:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Per ulteriori informazioni, vedere Configurazione di OSGi.
Esempio:
La configurazione OSGi è:
Etichetta | Configurazione OSGi |
Descrizione |
Tipo risorsa | dam.cfm.component.resourceType |
Il tipo di risorsa da registrare; ad esempio
|
Proprietà Reference | dam.cfm.component.fileReferenceProp |
Nome della proprietà contenente il riferimento al frammento; ad esempio fragmentPath oppure fileReference |
Proprietà Element(s) | dam.cfm.component.elementsProp |
Il nome della proprietà che contiene i nomi degli elementi di cui eseguire il rendering; ad esempioelementName |
Proprietà variante |
dam.cfm.component.variationProp |
Il nome della proprietà che contiene il nome della variante da rappresentare; ad esempiovariationName |
Per alcune funzionalità (ad es. per eseguire il rendering solo di un intervallo di paragrafi), dovrete aderire ad alcune convenzioni:
Nome proprietà | Descrizione |
paragraphRange |
Una proprietà stringa che definisce l'intervallo di paragrafi da restituire se in modalità di rendering elemento singolo. Formato:
|
paragraphScope |
Una proprietà stringa che definisce la modalità di output dei paragrafi in modalità di rendering a elemento singolo. Valori:
|
paragraphHeadings |
Una proprietà booleana che definisce se le intestazioni (ad esempio, h1 , h2 , h3 ) sono conteggiate come paragrafi (true ) o meno (false ) |
Questo può cambiare in 6,5 tappe successive.
Ad esempio, vedete quanto segue (in 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"