Strukturvorlage scaffolding

Manchmal muss eine große Anzahl von Seiten erstellt werden, die zwar die gleiche Struktur, aber unterschiedliche Inhalte haben. Über die standardmäßige Adobe Experience Manager(AEM)-Benutzeroberfläche müssen Sie dann jede Seite erstellen, die entsprechenden Komponenten auf die Seite ziehen und sie einzeln auffüllen.

Eine Strukturvorlage dient zur Erstellung eines Formulars (einer Struktur), dessen Felder die gewünschte Seitenstruktur widerspiegeln. Anhand dieses Formulars können Sie ganz einfach auf dieser Struktur basierende Seiten erstellen.

NOTE
Bei Strukturvorlagen (auf der klassischen Benutzeroberfläche) wird die MSM-Vererbung berücksichtigt.

Funktionsweise von Strukturvorlagen how-scaffolding-works

Strukturvorlagen sind über die Tools-Konsole des SiteAdmin-Bereichs verfügbar.

  • Öffnen Sie die Tools-Konsole und klicken Sie auf Strukturvorlage der Standardseite.
  • Klicken Sie darunter auf Geometrixx.
  • Unter Geometrixx finden Sie eine Strukturvorlagen-Seite namens News. Doppelklicken Sie auf die Seite, um sie zu öffnen.

howscaffolds_work

Die Strukturvorlage besteht aus einem Formular mit einem Feld für jedes Inhaltselement, mit dem die zu erstellende Seite gefüllt werden soll. Außerdem wird das Aussehen der Seite durch vier wichtige Parameter bestimmt, die in den Seiteneigenschaften der Strukturvorlagenseite festgelegt werden.

pageprops

Die Eigenschaften der Strukturvorlagen-Seite sind:

  • Titeltext: Dies ist der Name dieser Strukturvorlagen-Seite selbst. In diesem Beispiel heißt sie „News“.
  • Beschreibung: Dies wird unter dem Titel auf der Strukturvorlagen-Seite angezeigt.
  • Zielvorlage: Dies ist die Vorlage, die diese Strukturvorlage beim Erstellen einer neuen Seite verwendet. In diesem Beispiel handelt es sich um eine Vorlage für eine Geometrixx-Inhaltsseite.
  • Zielpfad: Dies ist der Pfad der übergeordneten Seite, unter der diese Strukturvorlage Seiten erstellt. In diesem Beispiel lautet der Pfad /content/geometrixx/en/news.

Der Textkörper der Strukturvorlage ist das Formular. Wenn ein Benutzer eine Seite mithilfe der Strukturvorlage erstellen möchte, füllt er das Formular aus und klickt unten auf Erstellen. Im Beispiel Nachrichten oben weist das Formular die folgenden Felder auf:

  • Titel: Dies ist der Name der zu erstellenden Seite. Dieses Feld ist immer auf jeder Struktur vorhanden.
  • Text: Dieses Feld korrespondiert zu einer Textkomponente auf der resultierenden Seite.
  • Bild: Dieses Feld stellt eine Bildkomponente für die zu erstellende Seite dar.
  • Bild/Erweitert: Titel: Der Titel des Bildes.
  • Bild/Erweitert: Alternativtext: Der Alternativtext für das Bild.
  • Bild/Erweitert: Beschreibung: Die Beschreibung des Bildes.
  • Bild/Erweitert: Größe: Die Größe des Bildes.
  • Tags/Keywords: Metadaten, die dieser Seite zugewiesen werden sollen. Dieses Feld ist immer auf jeder Struktur vorhanden.

Erstellen einer Strukturvorlage creating-a-scaffold

Um eine Strukturvorlage zu erstellen, navigieren Sie zu der Tools-Konsole und dann zur Option Standardseiten-Strukturvorlage und erstellen Sie eine Seite. Eine Strukturvorlagen-Vorlage ist als einseitige Vorlage verfügbar.

Legen Sie in den Seiteneigenschaften der neuen Seite die Optionen Titeltext, Beschreibung, Zielvorlage und Zielpfad fest, wie oben beschrieben.

Als nächstes müssen Sie die Struktur der Seite festlegen, die mithilfe der Strukturvorlage erstellt wird. Wechseln Sie hierzu auf der Strukturvorlagenseite in den Design-Modus. Es wird ein Link angezeigt, mit dessen Hilfe Sie die Strukturvorlage im Dialogfeldeditor bearbeiten können.

cq5_dialog_editor

Im Dialogfeldeditor legen Sie die Eigenschaften fest, die für alle mit der Strukturvorlage erstellten Seiten gelten.

Die Dialogdefinition für eine Strukturvorlage funktioniert ähnlich wie bei einer Komponente (siehe Komponenten). Es gibt jedoch einige wichtige Unterschiede:

  • Komponenten-Dialogfelddefinitionen werden als normale Dialogfelder gerendert (wie z. B. im mittleren Bereich des Dialogfeldeditors angezeigt), während Dialogfelddefinitionen von Strukturvorlagen zwar als normale Dialogfelder im Dialogfeldeditor angezeigt werden, aber auf der Strukturvorlagen-Seite als Strukturvorlagenformular wiedergegeben werden (wie in der Nachrichten-Strukturvorlage oben).
  • Komponentendialogfelder enthalten nur Felder für die Werte, die zum Definieren des Inhalts einer einzelnen bestimmten Komponente erforderlich sind. Ein Dialogfeld einer Strukturvorlage muss Felder für jede Eigenschaft in jedem Absatz der zu erstellenden Seite enthalten.
  • Bei Dialogfeldern für Komponenten ist die Komponente, die für das Rendern des angegebenen Inhalts verwendet wird, implizit. Daher wird die Eigenschaft sling:resourceType des Absatzes automatisch bei dessen Erstellung eingefügt. Bei einer Strukturvorlage müssen alle Informationen, die sowohl den Inhalt als auch die zugewiesene Komponente für einen bestimmten Absatz definieren, vom Dialogfeld selbst bereitgestellt werden. In Dialogfeldern von Strukturvorlagen müssen diese Informationen bereitgestellt werden, indem Sie ausgeblendete Felder verwenden, um diese Informationen bei der Seitenerstellung zu übermitteln.

Ein Blick auf die Beispiel-Strukturvorlage Nachrichten im Dialog-Editor hilft zu erklären, wie dies funktioniert. Wechseln Sie in den Designmodus auf der Strukturvorlagen-Seite und klicken Sie auf den Link des Dialogfeldeditors.

Klicken Sie nun im Dialogfeld auf Dialog > Registerfeld > Text > Text, wie in der folgenden Abbildung zu sehen:

textedit

Daraufhin wird die Eigenschaftenliste für dieses Feld auf der rechten Seite des Dialogfeldeditors wie folgt angezeigt:

list_of_properties

Beachten Sie die Eigenschaft „Name“ für dieses Feld. Sie hat den Wert

./jcr:content/par/text/text

Dies ist der Name der Eigenschaft, in die der Inhalt dieses Feldes geschrieben wird, wenn die Grundlage für die Erstellung einer neuen Seite verwendet wird. Die Eigenschaft wird als relativer Pfad zu dem Knoten angegeben, der die zu erstellende Seite repräsentiert. Sie gibt den Eigenschaftstext unter dem Knotentext an, der sich unter dem par-Knoten befindet, der wiederum ein untergeordnetes Element des Knotens jcr:content unter dem Seitenknoten ist.

Dies definiert den Speicherort des Inhaltsspeichers für den Text, der in dieses Feld eingegeben wird. Für diesen Inhalt müssen jedoch zwei weitere Eigenschaften angegeben werden:

  • Die Tatsache, dass die hier gespeicherte Zeichenfolge als Rich-Text interpretiert werden muss, und
  • welche Komponente zum Rendern dieses Inhalts auf der resultierenden Seite verwendet werden soll.

In einem normalen Komponentendialogfeld müssen Sie diese Informationen nicht angeben, weil sie durch die Tatsache, dass das Dialogfeld an eine bestimmte Komponente gebunden ist, bereits vorgegeben sind.

Zur Angabe dieser beiden Informationen verwenden Sie ausgeblendete Felder. Klicken Sie für das erste ausgeblendete Feld auf Dialog > Registerfeld > Text > Ausgeblendet, wie in der folgenden Abbildung zu sehen:

hidden

Dieses ausgeblendete Feld weist folgende Eigenschaften auf:

hidden_list_props

Die Namenseigenschaft dieses ausgeblendeten Felds lautet:

./jcr:content/par/text/textIsRich

Hierbei handelt es sich um eine boolesche Eigenschaft für die Auswertung der Textzeichenfolge, die unter ./jcr:content/par/text/text gespeichert ist.

Da wir wissen, dass der Text als Rich-Text ausgewertet werden soll, legen wir für die Eigenschaft value dieses Felds den Wert true fest.

CAUTION
Der Dialog-Editor ermöglicht die Änderung der Werte bestehender Eigenschaften in der Dialogdefinition. Um eine neue Eigenschaft hinzuzufügen, muss die Benutzerin oder der Benutzer CRXDE Lite verwenden. Wenn beispielsweise mit dem Dialogfeldeditor ein neues ausgeblendetes Feld zu einer Dialogfelddefinition hinzugefügt wird, verfügt es über keine value-Eigenschaft (d. h. eine Eigenschaft mit dem Namen „value“ (Wert)). Wenn für das betreffende ausgeblendete Feld die Standardeigenschaft „value“ erforderlich ist, muss diese Eigenschaft manuell mit einem der CRX-Tools hinzugefügt werden. Der Wert kann nicht mit dem Dialogfeldeditor selbst hinzugefügt werden. Sobald die Eigenschaft jedoch vorhanden ist, kann ihr Wert mit dem Dialogfeldeditor bearbeitet werden.

Das zweite ausgeblendete Feld kann angezeigt werden, indem Sie wie folgt darauf klicken:

hidden2

Dieses ausgeblendete Feld weist folgende Eigenschaften auf:

hidden_list_props2

Die Namenseigenschaft dieses ausgeblendeten Felds lautet:

./jcr:content/par/text/sling:resourceType

Der feste Wert für diese Eigenschaft lautet:

foundation/components/textimage

Dadurch wird festgelegt, dass die für das Rendern des Textinhalts verwendete Komponente vom Typ Textbild ist. Zusammen mit dem booleschen Wert isRichText in dem anderen ausgeblendeten Feld kann die Komponente die eigentliche unter ./jcr:content/par/text/text gespeicherte Textzeichenfolgen wie gewünscht rendern.

Strukturvorlagen mit MSM-Vererbung scaffolding-with-msm-inheritance

Auf der klassischen Benutzeroberfläche sind Strukturvorlagen vollständig in die MSM-Vererbung integriert (sofern verfügbar).

Wenn Sie eine Seite im Strukturvorlagenmodus öffnen (über das Symbol im unteren Sidekick-Bereich), werden alle Komponenten, für die Vererbung gilt, folgendermaßen gekennzeichnet:

  • ein Vorhängeschloss-Symbol (für die meisten Komponenten, z. B. Text und Titel)
  • eine Maske mit dem Text Klicken Sie, um die Vererbung abzubrechen (für Bildkomponenten)

Diese zeigen an, dass die Komponente erst bearbeitet werden kann, wenn die Vererbung abgebrochen wird.

chlimage_1

Durch Klicken auf das Vorhängeschloss-Symbol oder auf das Bildsymbol können Sie die Vererbung aufheben:

  • Das Symbol ändert sich in ein geöffnetes Vorhängeschloss.
  • Nach erfolgter Entsperrung können Sie den Inhalt bearbeiten.

chlimage_1-1

Nach dem Entsperren können Sie die Vererbung wiederherstellen, indem Sie auf das Symbol des geöffneten Vorhängeschlosses klicken. Dabei gehen jedoch alle vorgenommenen Änderungen verloren.

NOTE
Wenn die Vererbung auf Seitenebene (über die Registerkarte „Live Copy“ der Seiteneigenschaften) abgebrochen wird, können alle Komponenten im Modus Strukturvorlagen bearbeitet werden (sie werden im entsperrten Status angezeigt).
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2