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.
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.
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.
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.
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:
Daraufhin wird die Eigenschaftenliste für dieses Feld auf der rechten Seite des Dialogfeldeditors wie folgt angezeigt:
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:
Dieses ausgeblendete Feld weist folgende Eigenschaften auf:
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.
Das zweite ausgeblendete Feld kann angezeigt werden, indem Sie wie folgt darauf klicken:
Dieses ausgeblendete Feld weist folgende Eigenschaften auf:
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.
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.
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.