Ce ne sono diversi servizi avanzati relativo al rendering di frammenti di contenuto. Per utilizzare questi servizi, i tipi di risorse di tali componenti devono diventare noti al framework dei frammenti di contenuto.
Questa operazione viene eseguita configurando il Servizio OSGi - Configurazione del componente Frammento di contenuto.
Se non hai bisogno del servizi avanzati come descritto di seguito, puoi ignorare questa configurazione.
Quando estendi o utilizzi i componenti predefiniti, si sconsiglia di modificare la configurazione.
È possibile scrivere un componente da zero che utilizza solo l’API Frammenti di contenuto, senza servizi avanzati. Tuttavia, in questo caso, sarà necessario sviluppare il componente in modo che gestisca l’elaborazione appropriata.
Pertanto, si consiglia di utilizzare i componenti core .
I servizi che richiedono la registrazione di un componente sono:
Se hai bisogno di una o più di queste funzioni, in genere è più semplice utilizzare la funzionalità preconfigurata, anziché svilupparla da zero.
La configurazione deve essere associata al servizio OSGi Configurazione del componente Frammento di contenuto:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Vedi Configurazione di OSGi per ulteriori dettagli.
Esempio:
La configurazione OSGi è:
Etichetta | Configurazione OSGi |
Descrizione |
Tipo risorsa | dam.cfm.component.resourceType |
Il tipo di risorsa da registrare; ad esempio
|
Proprietà di riferimento | dam.cfm.component.fileReferenceProp |
Nome della proprietà contenente il riferimento al frammento; ad esempio fragmentPath o fileReference |
Proprietà elemento/i | dam.cfm.component.elementsProp |
Nome della proprietà che contiene i nomi degli elementi da riprodurre; ad esempioelementName |
Proprietà variante |
dam.cfm.component.variationProp |
Il nome della proprietà che contiene il nome della variante di cui eseguire il rendering; ad esempiovariationName |
Per alcune funzionalità (ad esempio, per eseguire il rendering solo di un intervallo di paragrafi) dovrai rispettare alcune convenzioni:
Nome proprietà | Descrizione |
paragraphRange |
Proprietà stringa che definisce l'intervallo di paragrafi da visualizzare se in modalità di rendering di un singolo elemento. Formato:
|
paragraphScope |
Proprietà stringa che definisce la modalità di output dei paragrafi in modalità di rendering di un singolo elemento. Valori:
|
paragraphHeadings |
Una proprietà booleana che definisce se le intestazioni (ad esempio, h1 , h2 , h3 ) sono conteggiati come paragrafi (true ) o no (false ) |
Questo potrebbe cambiare in 6.5 tappe successive.
Ad esempio, consulta quanto segue (in 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"