Inhaltsfragmentmodelle in AEM definieren die Inhaltsstruktur für Ihre Inhaltsfragmente, die als Grundlage für Ihren Headless-Content dienen.
So verwenden Sie Inhaltsfragmentmodelle:
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zu dem Ordner, der Ihrer Konfiguration oder Unterkonfiguration entspricht.
Öffnen Sie den Assistenten über Erstellen.
Wenn die Verwendung von Inhaltsfragmentmodellen nicht aktiviert wurde, ist die Option Erstellen nicht verfügbar.
Geben Sie den Modell-Titel an. Sie können auch Tags und eine Beschreibung hinzufügen sowie Modell aktivieren auswählen, um das Modell bei Bedarf zu aktivieren.
Speichern Sie das leere Modell über Erstellen. Eine Benachrichtigung zeigt an, dass der Vorgang erfolgreich abgeschlossen wurde. Daraufhin können Sie das Modell über die Option Öffnen direkt bearbeiten oder über Fertig zur Konsole zurückkehren.
Das Inhaltsfragmentmodell definiert effektiv die Struktur der resultierenden Inhaltsfragmente unter Verwendung unterschiedlicher Datentypen. Mithilfe des Modell-Editors können Sie Instanzen der Datentypen hinzufügen und diese dann so konfigurieren, dass die erforderlichen Felder erstellt werden:
Die Bearbeitung eines vorhandenen Inhaltsfragmentmodells kann sich auf abhängige Fragmente auswirken.
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zu dem Ordner, der Ihr Inhaltsfragmentmodell enthält.
Öffnen Sie das zu bearbeitende Modell; nutzen Sie dazu entweder die entsprechende Schnellaktion oder wählen Sie das Modell und anschließend die Aktion aus der Symbolleiste aus.
Wenn das Modell geöffnet ist, finden Sie Folgendes im Editor:
Wenn ein Feld ein Pflichtfeld ist, wird die Bezeichnung im linken Bereich mit einem Stern markiert (*).
So fügen Sie ein Feld hinzu
Ziehen Sie einen erforderlichen Datentyp an die entsprechende Stelle für ein Feld:
Wenn ein Feld zum Modell hinzugefügt wurde, werden im rechten Fenster die Eigenschaften angezeigt, die für diesen speziellen Datentyp definiert werden können. Hier können Sie festlegen, was für dieses Feld erforderlich ist.
Viele Eigenschaften sind selbsterklärend. Weitere Informationen finden Sie unter Eigenschaften.
Wenn Sie eine Feldbeschriftung eingeben, wird Eigenschaftsname automatisch gefüllt, wenn das Feld leer ist, und kann anschließend manuell aktualisiert werden.
Wenn Sie die Eigenschaft Eigenschaftsname für einen Datentyp manuell aktualisieren, beachten Sie, dass Namen nur A–Z, a–z, 0–9 und den Unterstrich „_“ als Sonderzeichen enthalten dürfen.
Wenn in früheren Versionen von AEM erstellte Modelle unzulässige Zeichen enthalten, entfernen oder ändern Sie diese Zeichen.
Beispiel:
So entfernen Sie ein Feld
Wählen Sie das entsprechende Feld aus und klicken/tippen Sie auf das Papierkorb-Symbol. Sie werden aufgefordert, den Vorgang zu bestätigen.
Fügen Sie alle erforderlichen Felder hinzu und legen Sie bei Bedarf die zugehörigen Eigenschaften fest. Beispiel:
Wählen Sie Speichern, um die Definition beizubehalten.
Zum Definieren Ihres Modells stehen unterschiedliche Datentypen zur Verfügung:
Ermöglicht die Einführung von Registerkarten zur Bearbeitung des Inhalts von Inhaltsfragmenten.
Dies wird als Trennzeichen im Modell-Editor angezeigt, der Abschnitte der Liste der Inhaltsdatentypen trennt. Jede Instanz stellt den Beginn einer neuen Registerkarte dar.
Im Fragment-Editor wird jede Instanz als Registerkarte angezeigt.
Dieser Datentyp dient ausschließlich zur Formatierung und wird vom GraphQL-Schema von AEM ignoriert.
Viele Eigenschaften sind selbsterklärend. Im Folgenden finden Sie weitere Informationen zu bestimmten Eigenschaften:
Eigenschaftsname
Wenn Sie diese Eigenschaft für einen Datentyp manuell aktualisieren, beachten Sie, dass Namen nur A–Z, a–z, 0–9 und den Unterstrich „_“ als Sonderzeichen enthalten dürfen.
Wenn in früheren Versionen von AEM erstellte Modelle unzulässige Zeichen enthalten, entfernen oder ändern Sie diese Zeichen.
Rendern als
Die verschiedenen Möglichkeiten, das Feld in einem Fragment zu erstellen/zu rendern. Oft können Sie damit festlegen, ob dem Autor nur eine einzige Instanz des Feldes angezeigt wird oder ob er mehrere Instanzen erstellen darf.
Feldbezeichnung
Durch die Eingabe einer
Feldbezeichnungen wird automatisch ein Eigenschaftsnamen generiert, der bei Bedarf manuell aktualisiert werden kann.
Validierung
Die grundlegende Basic ist mittels Mechanismen wie etwa die Eigenschaft Erforderlich verfügbar. Einige Datentypen verfügen über zusätzliche Validierungsfelder. Weitere Informationen finden Sie unter Validierung.
Beim Datentyp Mehrzeilentext können Sie den Standardtyp folgendermaßen definieren:
Wenn Sie keinen Typ angeben, wird der Standardwert Rich-Text in diesem Feld verwendet.
Änderungen am Standardtyp in einem Fragmentmodell werden erst dann auf vorhandene, zugehörige Inhaltsfragmente angewendet, wenn das Fragment im Editor geöffnet und gespeichert wurde.
Eindeutiger
Content (für das spezifische Feld) muss für alle Inhaltsfragmente, die anhand des aktuellen Modells erstellt werden, eindeutig sein.
Dadurch wird sichergestellt, dass Inhaltsersteller Content, der bereits einem anderen Fragment desselben Modells hinzugefügt wurde, nicht wiederholen können.
Beispielsweise kann ein einzeiliges Textfeld mit dem Namen Country
im Inhaltsfragmentmodell nicht den Wert Japan
in zwei abhängigen Inhaltsfragmenten haben. Eine Warnung wird ausgegeben, wenn versucht wird, eine zweite Instanz zu erstellen.
Die Eindeutigkeit wird pro Sprachstamm gewährleistet.
Varianten können denselben eindeutigen Wert haben wie Varianten desselben Fragments, jedoch nicht denselben Wert wie Varianten anderer Fragmente.
Weitere Informationen zu diesem bestimmten Datentyp und seinen Eigenschaften finden Sie unter Inhaltsreferenz.
Weitere Informationen zu diesem bestimmten Datentyp und seinen Eigenschaften finden Sie unter Fragmentreferenz (verschachtelte Fragmente).
Übersetzbar
Durch Aktivieren des Kontrollkästchens Übersetzbar für ein Feld im Editor für Inhaltsfragmentmodelle geschieht Folgendes:
/content/dam/<sites-configuration>
hinzugefügt wird, falls er noch nicht vorhanden ist.<translatable>
auf yes
festgelegt, um den GraphQL-Abfragefilter für die JSON-Ausgabe nur mit übersetzbarem Inhalt zuzulassen.Verschiedene Datentypen bieten jetzt die Möglichkeit, Validierungsanforderungen für den Zeitpunkt zu definieren, an dem Inhalt in das resultierende Fragment eingefügt wird:
Inhaltsfragmente können mit einem der folgenden Datentypen verschachtelte Inhalte bilden:
Fragmentreferenz (verschachtelte Fragmente)
Verweist auf andere Fragmente, abhängig von den angegebenen Modellen.
Ermöglicht das Einschließen/Abrufen strukturierter Daten.
Diese Methode ist in Verbindung mit der Headless-Bereitstellung mithilfe von Inhaltsfragmenten mit GraphQL besonders interessant.
AEM bietet einen Wiederholungsschutz für:
Inhaltsreferenzen
Verhindert, dass der Benutzer dem aktuellen Fragment einen Verweis hinzufügt. Dies kann zu einem leeren Dialogfeld für die Auswahl von Fragmentreferenzen führen.
Fragmentverweise in GraphQL
Wenn Sie eine Deep-Abfrage erstellen, die mehrere Inhaltsfragmente zurückgibt, die gegenseitig aufeinander verweisen, gibt sie beim ersten Auftreten NULL zurück.
Mit der Inhaltsreferenz können Sie Content aus einer anderen Quelle rendern, zum Beispiel ein Bild oder Inhaltsfragment.
Zusätzlich zu den Standardeigenschaften können Sie Folgendes angeben:
Die Fragmentreferenz verweist auf mindestens ein Inhaltsfragment. Diese Funktion ist besonders beim Abrufen von Content für die Verwendung in Ihrem Programm interessant, da sie es Ihnen ermöglicht, strukturierte Daten mit mehreren Ebenen abzurufen.
Beispiel:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Dies ist besonders in Verbindung mit der Headless-Bereitstellung mithilfe von Inhaltsfragmenten mit GraphQL von Interesse.
Zusätzlich zu den Standardeigenschaften können Sie Folgendes definieren:
Rendern als:
multifield: Der Fragmentautor kann mehrere einzelne Verweise erstellen.
fragmentreference: Der Fragmentautor kann einen einzelnen Verweis auf ein Fragment auswählen.
Modelltyp
Es können mehrere Modelle ausgewählt werden. Beim Erstellen des Inhaltsfragments müssen alle referenzierten Fragmente mit diesen Modellen erstellt worden sein.
Stammpfad
Gibt einen Stammpfad für referenzierte Fragmente an.
Fragmenterstellung zulassen
Auf diese Weise kann der Fragmentautor ein neues Fragment erstellen, das auf dem entsprechenden Modell basiert.
Es gibt einen Mechanismus zum Wiederholungsschutz. Dieser verhindert, dass Benutzer in der Fragmentreferenz das aktuelle Inhaltsfragment auswählen. Dies kann zu einem leeren Dialogfeld für die Auswahl von Fragmentreferenzen führen.
Es gibt auch einen Wiederholungsschutz für Fragmentreferenzen in GraphQL. Wenn Sie eine Deep-Abfrage über zwei Inhaltsfragmente erstellen, die gegenseitig aufeinander verweisen, wird NULL zurückgegeben.
Sie können die Eigenschaften eines Inhaltsfragmentmodells bearbeiten:
Zur vollständigen Kontrolle über die Verwendung Ihrer Inhaltsfragmentmodelle können Sie deren Status festlegen.
Nachdem ein Modell erstellt wurde, muss es aus folgenden Gründen aktiviert werden:
So aktivieren Sie ein Modell, das folgendermaßen gekennzeichnet ist:
Sie verwenden die Option Aktivieren aus einem der folgenden Bereiche:
Ein Modell lässt sich auch aus folgenden Gründen deaktivieren:
Um ein Modell zu deaktivieren, das als Aktiviert gekennzeichnet ist, verwenden Sie die Option Deaktivieren aus einem der folgenden Bereiche:
Zur Implementierung der Inhaltsverwaltung können Sie Richtlinien im Asset-Ordner konfigurieren, um zu steuern, welche Inhaltsfragmentmodelle für die Fragmenterstellung in diesem Ordner zulässig sind.
Der Mechanismus ähnelt dem Zulassen von Seitenvorlagen für eine Seite und deren untergeordnete Elemente in den erweiterten Eigenschaften einer Seite.
So konfigurieren Sie die Richtlinien für Zulässige Inhaltsfragmentmodelle:
Navigieren Sie zum gewünschten Asset-Ordner und öffnen Sie Eigenschaften.
Öffnen Sie die Registerkarte Richtlinien, in der Sie Folgendes konfigurieren können:
Vererbt von<folder>
Richtlinien werden beim Erstellen neuer untergeordneter Ordner automatisch übernommen. Die Richtlinie kann neu konfiguriert (und die Vererbung aufgehoben) werden, wenn Unterordner Modelle zulassen müssen, die vom übergeordneten Ordner abweichen.
Zugelassene Inhaltsfragmentmodelle nach Pfad
Es können mehrere Modelle zugelassen werden.
Zugelassene Inhaltsfragmentmodelle nach Tag
Es können mehrere Modelle zugelassen werden.
Speichern Sie die Änderungen.
Die für einen Ordner zulässigen Inhaltsfragmentmodelle werden wie folgt aufgelöst:
Das Löschen eines Inhaltsfragmentmodells wirkt sich unter Umständen auf abhängige Fragmente aus.
So löschen Sie ein Inhaltsfragmentmodell:
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zu dem Ordner, der Ihr Inhaltsfragmentmodell enthält.
Wählen Sie Ihr Modell und anschließend die Option Löschen aus der Symbolleiste aus.
Wenn es Verweise auf das Modell gibt, wird Ihnen ein Warnhinweis angezeigt. Ergreifen Sie die entsprechenden Maßnahmen.
Inhaltsfragmentmodelle müssen zeitgleich mit oder im Vorfeld der Veröffentlichung abhängiger Inhaltsfragmente veröffentlicht werden.
So veröffentlichen Sie ein Inhaltsfragmentmodell:
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zu dem Ordner, der Ihr Inhaltsfragmentmodell enthält.
Wählen Sie Ihr Modell und anschließen die Option Veröffentlichen aus der Symbolleiste aus.
Der Status „Veröffentlicht“ wird in der Konsole angezeigt.
Wenn Sie Inhaltsfragmente veröffentlichen, deren Modell noch nicht veröffentlicht wurde, wird dies in der Auswahlliste angezeigt und das Modell wird mit dem Fragment veröffentlicht.
Die Veröffentlichung von Inhaltsfragmentmodellen kann rückgängig gemacht werden, wenn sie nicht von Fragmenten referenziert werden.
So machen Sie die Veröffentlichung eines Inhaltsfragmentmodells rückgängig:
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zu dem Ordner, der Ihr Inhaltsfragmentmodell enthält.
Wählen Sie Ihr Modell und anschließen die Option Veröffentlichung aufheben aus der Symbolleiste aus.
Der Status „Veröffentlicht“ wird in der Konsole angezeigt.
Wenn Sie versuchen, die Veröffentlichung eines Modells aufzuheben, das aktuell von einem oder mehreren Fragmenten verwendet wird, werden Sie über eine Fehlermeldung über Folgendes informiert:
In der Meldung wird vorgeschlagen, dass Sie das Bedienfeld Verweise überprüfen, um weitere Nachforschungen anzustellen:
Diese Funktion bietet Governance für Inhaltsfragmentmodelle, die veröffentlicht wurden.
Inhaltsfragmentmodelle bestimmen das Schema für GraphQL-Abfragen in AEM.
AEM GraphQL-Schemas werden erstellt, sobald ein Inhaltsfragmentmodell erstellt wird, und sie können in der Autoren- und Veröffentlichungsumgebung vorhanden sein.
Schemas in der Veröffentlichungsinstanz sind die wichtigsten, da sie die Grundlage für die Live-Bereitstellung von Inhaltsfragmentinhalten im JSON-Format bieten.
Probleme können auftreten, wenn Inhaltsfragmentmodelle geändert oder bearbeitet werden. Das bedeutet, dass sich das Schema ändert, was wiederum vorhandene GraphQL-Abfragen beeinflussen kann.
Das Hinzufügen neuer Felder zu einem Inhaltsfragmentmodell sollte (in der Regel) keine schädlichen Auswirkungen haben. Wenn Sie jedoch vorhandene Datenfelder (z. B. deren Namen) ändern oder Felddefinitionen löschen, werden vorhandene GraphQL-Abfragen bei der Anforderung dieser Felder beschädigt.
Anwender wurden auf die Risiken aufmerksam gemacht, die bei der Bearbeitung von Modellen auftreten, die bereits für die Bereitstellung von Live-Inhalten verwendet werden (d. h. von Modellen, die veröffentlicht wurden).
Außerdem die Vermeidung von unbeabsichtigten Änderungen.
In beiden Fällen können Abfragen beschädigt werden, wenn die geänderten Modelle erneut veröffentlicht werden.
Um diese Probleme zu lösen, werden die Inhaltsfragmentmodelle in der Autorenumgebung durch einen SCHREIBGESCHÜTZTEN Modus gesperrt, sobald sie veröffentlicht wurden. Dies wird durch Gesperrt angezeigt:
Wenn das Modell Gesperrt ist (im schreibgeschützten Modus), können Sie die Inhalte und die Struktur der Modelle anzeigen, sie jedoch nicht bearbeiten.
Sie können Gesperrte Modelle entweder aus der Konsole heraus oder im Modell-Editor verwalten:
Konsole
In der Konsole können Sie den SCHREIBGESCHÜTZTEN Modus mit den Aktionen Entsperren und Sperren in der Symbolleiste verwalten:
Sie können ein Modell zum Aktivieren von Bearbeitungen Entsperren.
Wenn Sie Entsperren wählen, wird eine Warnung angezeigt, und Sie müssen die Aktion Entsperren bestätigen:
Anschließend können Sie das Modell zum Bearbeiten öffnen.
Sie können das Modell anschließend auch wieder Sperren.
Wenn Sie das Modell erneut veröffentlichen, wird es sofort wieder in den Modus Gesperrt (SCHREIBGESCHÜTZT) versetzt.
Modell-Editor
Wenn Sie ein gesperrtes Modell öffnen, werden Sie gewarnt und es werden Ihnen drei Aktionen angezeigt: Abbrechen, Schreibgeschützt anzeigen, Bearbeiten:
Wenn Sie Schreibgeschützt anzeigen auswählen, können Sie den Inhalt und die Struktur des Modells sehen:
Wenn Sie Bearbeiten auswählen, können Sie Ihre Änderungen bearbeiten und speichern:
Oben kann noch eine Warnung angezeigt werden. In diesem Fall wird das Modell jedoch bereits von vorhandenen Inhaltsfragmenten verwendet.
Über Abbrechen kehren Sie zur Konsole zurück.