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:
Si 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.
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ù facile utilizzare i servizi avanzati preconfigurati, anziché svilupparli da zero.
La configurazione deve essere associata al servizio OSGi Configurazione del componente Frammento di contenuto:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Consulta Configurazione OSGi per ulteriori dettagli.
Ad esempio:
La configurazione OSGi è:
Etichetta | Configurazione OSGi |
Descrizione |
Tipo risorsa | dam.cfm.component.resourceType |
Tipo di risorsa da registrare, ad esempio
|
Proprietà di riferimento | dam.cfm.component.fileReferenceProp |
Nome della proprietà che contiene il riferimento al frammento; ad esempio, fragmentPath o fileReference |
Proprietà elemento/i | dam.cfm.component.elementsProp |
Il nome della proprietà che contiene i nomi degli elementi da riprodurre; ad esempio,elementName |
Proprietà variante |
dam.cfm.component.variationProp |
Il nome della proprietà che contiene il nome della variante da riprodurre; ad esempio,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 (ad esempio jcr:paragraph
per ogni istanza di componente) in modo che i servizi possano rilevarli ed elaborarli correttamente.
Nome proprietà | Descrizione |
paragraphScope |
Una proprietà stringa che definisce come devono essere generati i paragrafi se in modalità di rendering di un singolo elemento. Valori:
|
paragraphRange |
Una proprietà stringa che definisce l’intervallo di paragrafi da restituire se in modalità di rendering di un singolo elemento. Formato:
|
paragraphHeadings |
Una proprietà booleana che definisce se le intestazioni (ad esempio, h1 , h2 , h3 ) vengono conteggiati come paragrafi (true ) o meno (false ) |
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"