Inhaltsfragmente, die Komponenten für die Wiedergabe konfigurieren
- Themen:
- Inhaltsfragmente
Erstellt für:
- Entwickler
Es gibt mehrere erweiterte Services zum Rendern von Inhaltsfragmenten. Um diese Services zu verwenden, müssen sich die Ressourcentypen dieser Komponenten dem Inhaltsfragmente-Framework bekannt machen.
Dies erfolgt durch die Konfiguration von OSGi-Service – Konfiguration der Inhaltsfragment-Komponente.
Definition erweiterter Services, die konfiguriert werden müssen
Die Services, die die Registrierung einer Komponente erfordern:
- das korrekte Bestimmen von Abhängigkeiten während der Veröffentlichung (d. h. sicherstellen, dass Fragmente und Modelle automatisch mit einer Seite veröffentlicht werden können, wenn sie sich seit der letzten Veröffentlichung geändert haben)
- unterstützen Inhaltsfragmente in der Volltextsuche,
- verwalten/bearbeiten Zwischeninhalte,
- verwalten/bearbeiten gemischte Medien-Assets,
- Dispatcher-Flush für referenzierte Fragmente (wenn eine Seite, die ein Fragment enthält, erneut veröffentlicht wird),
- verwenden absatzbasiertes Rendering.
Wenn Sie eine oder mehrere dieser Funktionen benötigen, ist es (in der Regel) einfacher, die vordefinierte Funktionalität zu verwenden, anstatt sie von Grund auf neu zu entwickeln.
OSGi-Service – Konfiguration der Inhaltsfragment-Komponente
Die Konfiguration muss an den OSGi-Service Konfiguration der Inhaltsfragment-Komponente gebunden sein:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Beispiel:
Die OSGi-Konfiguration lautet:
Bezeichnung | OSGi-Konfiguration | Beschreibung |
Ressourcentyp | dam.cfm.component.resourceType |
Der zu registrierende Ressourcentyp; z. B.
|
Verweiseigenschaft | dam.cfm.component.fileReferenceProp | Der Name der Eigenschaft, die den Verweis auf das Fragment enthält; z. B. fragmentPath oder fileReference |
Elementeigenschaft | dam.cfm.component.elementsProp | Der Name der Eigenschaft, die die Namen der zu rendernden Elemente enthält; z. B.elementName |
Varianteneigenschaft | dam.cfm.component.variationProp | Der Name der Eigenschaft, die den Namen der zu rendernden Variante enthält; z. B.variationName |
Für einige Funktionen (z. B. um nur einen Absatzbereich zu rendern) müssen Sie einige Konventionen einhalten:
Eigenschaftsname | Beschreibung |
paragraphRange |
Eine Zeichenfolgeneigenschaft, die den Bereich der Absätze definiert, die ausgegeben werden sollen, wenn sie sich im Rendermodus für einzelne Elemente befinden. Format:
|
paragraphScope |
Eine Zeichenfolgeneigenschaft, die definiert, wie Absätze ausgegeben werden sollen, wenn sie sich im Rendermodus für einzelne Elemente befinden. Werte:
|
paragraphHeadings | Eine boolesche Eigenschaft, die definiert, ob Überschriften (z. B. h1 , h2 , h3 ) als Absätze (true ) oder nicht als Absätze (false ) gezählt werden sollen |
Beispiel
Sehen Sie sich folgendes Beispiel (in einer vordefinierten AEM-Instanz) an:
/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config
Es umfasst:
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"