DocumentazioneAEM as a Cloud ServiceGuida utente

Componenti di configurazione dei frammenti di contenuto per il rendering content-fragments-configuring-components-for-rendering

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
  • Sviluppatore

Esistono diversi servizi avanzati relativi 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 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.

CAUTION

  • Se non hai bisogno dei servizi avanzati descritti di seguito, puoi ignorare questa configurazione.

  • Quando si estendono o si utilizzano i componenti predefiniti, non è consigliabile modificare la configurazione OSGi.

  • È possibile scrivere un componente da zero 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.

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.
  • Gestione/gestione di contenuto intermedio.
  • Gestione di risorse multimediali miste.
  • 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

NOTE
Per ulteriori dettagli, consulta Configurazione OSGi.

Ad esempio:

Configurazione del componente per frammenti di contenuto della configurazione OSGi

La configurazione OSGi è:

Etichetta
Configurazione OSGi
Descrizione
Tipo risorsa
dam.cfm.component.resourceType

Tipo di risorsa da registrare, ad esempio

core/wcm/components/contentfragment/v1/contentfragment

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 ogni paragrafo (ovvero jcr:paragraph per ogni istanza del componente) in modo che i servizi possano rilevarle ed elaborarle correttamente.

Nome proprietà
Descrizione
paragraphScope

Proprietà stringa che definisce il modo in cui devono essere generati i paragrafi se in modalità rendering elemento singolo.

Valori:

  • all : per eseguire il rendering di tutti i paragrafi
  • range : per riprodurre l’intervallo di paragrafi fornito da paragraphRange
paragraphRange

Proprietà stringa che definisce l'intervallo di paragrafi da restituire se in modalità rendering elemento singolo.

Formato:

  • 1 o 1-3 o 1-3;6;7-8 o *-3;5-*

    • - indicatore di intervallo
    • ; separatore di elenco
    • * carattere jolly

  • valutato solo se paragraphScope è impostato su range

paragraphHeadings
Proprietà booleana che definisce se le intestazioni (ad esempio, h1, h2, h3) vengono conteggiate 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"
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab