Definieren von Inhaltsfragmentmodellen defining-content-fragment-models
In Inhaltsfragmentmodellen in Adobe Experience Manager (AEM) as a Cloud Service wird die Struktur des Inhalts Ihrer Inhaltsfragmente definiert. Diese Fragmente können dann für die Seitenbearbeitung oder als Grundlage für Ihre Headless-Inhalte verwendet werden.
Auf dieser Seite wird beschrieben, wie Sie Ihr Inhaltsfragmentmodell mithilfe des dedizierten Editors definieren. Unter Verwalten Ihrer Inhaltsfragmentmodelle finden Sie weitere Aufgaben und Optionen, die verfügbar sind, sobald Ihre Fragmente erstellt wurden, einschließlich Aktionen, die in der Inhaltsfragmentkonsole verfügbar sind, Zulassen des Modells für Ihren Ordner und Veröffentlichen Ihres Modells.
Definieren des Inhaltsfragmentmodells defining-your-content-fragment-model
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:
-
Wählen Sie in der Inhaltsfragmentkonsole das Bedienfeld für Inhaltsfragmentmodelle und navigieren Sie zum Ordner mit Ihrem Inhaltsfragmentmodell.
note note NOTE Sie können ein Modell auch direkt nach dem öffnen. -
Ö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.
Nach dem Öffnen zeigt der Modell-Editor Folgendes an:
- Links: Felder bereits definiert
- Rechts: verfügbare Datentypen für das Erstellen von Feldern (und Eigenschaften, die für erstellte Felder verwendet werden können)
note note NOTE Wenn ein Feld als Pflichtfeld definiert 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 Bereich 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 (Datentypen).
-
Wenn Sie eine Feldbeschriftung eingeben, wird der Eigenschaftsname automatisch ausgefüllt, falls das Feld leer ist, und kann anschließend manuell aktualisiert werden.
note caution CAUTION Wenn Sie die Eigenschaft Eigenschaftsname für einen Datentyp manuell aktualisieren, dürfen die Namen nur A–Z, a–z, 0–9 und den Unterstrich „_“ als Sonderzeichen enthalten. Wenn in früheren Versionen von AEM erstellte Modelle unzulässige Zeichen enthalten, entfernen oder ändern Sie diese Zeichen.
Zum Beispiel:
-
-
-
So entfernen Sie ein Feld
Wählen Sie das entsprechende Feld aus und wählen Sie das Papierkorb-Symbol aus. Sie werden aufgefordert, die Aktion zu bestätigen.
-
Fügen Sie alle erforderlichen Felder hinzu und legen Sie bei Bedarf die zugehörigen Eigenschaften fest. Zum Beispiel:
-
Wählen Sie Speichern, um die Definition beizubehalten.
Datentypen data-types
Zum Definieren Ihres Modells stehen unterschiedliche Datentypen zur Verfügung:
-
Einzeilentext
- Fügt ein Feld für eine einzelne Textzeile hinzu; die maximale Länge kann definiert werden.
- Das Feld kann so konfiguriert werden, dass Fragmentautorinnen und -autoren neue Instanzen des Felds erstellen können.
-
Mehrzeilentext
- Ein Textbereich, der Rich Text, Nur Text oder Markdown sein kann
- Das Feld kann so konfiguriert werden, dass Fragmentautorinnen und -autoren neue Instanzen des Felds erstellen können.
note note NOTE Ob es sich bei dem Textbereich um Rich Text, Nur Text oder Markdown handelt, wird im Modell durch die Eigenschaft Standardtyp definiert. Dieses Format kann nicht über den Inhaltsfragmenteditor, sondern nur vom Modell aus geändert werden. -
Zahl
- Fügt ein numerisches Feld hinzu.
- Das Feld kann so konfiguriert werden, dass Fragmentautorinnen und -autoren neue Instanzen des Felds erstellen können.
-
Boolesch
- Fügen Sie ein boolesches Kontrollkästchen hinzu.
-
Datum und Uhrzeit
- Fügt ein Datums- und/oder Zeitfeld hinzu.
-
Aufzählung
- Fügt einen Satz Kontrollkästchen, Optionsfelder oder Dropdown-Felder hinzu.
- Sie können die für Fragmentautorinnen und -autoren verfügbaren Optionen festlegen.
- Fügt einen Satz Kontrollkästchen, Optionsfelder oder Dropdown-Felder hinzu.
-
Tags
- Ermöglicht Fragmentautoren den Zugriff auf und die Auswahl von Tag-Bereichen.
-
Fragmentreferenz
-
Verweist auf andere Inhaltsfragmente. Kann zum Erstellen verschachtelter Inhalte verwendet werden.
-
Der Datentyp kann so konfiguriert werden, dass Fragmentautoren folgende Möglichkeiten haben:
- Direktes Bearbeiten des referenzierten Fragments
- Erstellen eines neuen Inhaltsfragments basierend auf dem entsprechenden Modell
- Erstellen neuer Instanzen des Felds
-
Die Referenz gibt den Pfad zur referenzierten Ressource an, z. B.
/content/dam/path/to/resource.
-
-
Fragmentreferenz (UUID)
-
Verweist auf andere Inhaltsfragmente. Kann zum Erstellen verschachtelter Inhalte verwendet werden.
-
Der Datentyp kann so konfiguriert werden, dass Fragmentautoren folgende Möglichkeiten haben:
- Direktes Bearbeiten des referenzierten Fragments
- Erstellen eines neuen Inhaltsfragments basierend auf dem entsprechenden Modell
- Erstellen neuer Instanzen des Felds
-
Im Editor gibt die Referenz den Pfad zur referenzierten Ressource an. Intern wird die Referenz als Universally Unique ID (UUID) gespeichert, die auf die Ressource verweist.
- Sie müssen die UUID nicht kennen. Sie können im Fragmenteditor zum gewünschten Fragment navigieren.
-
-
Inhaltsreferenz
- Verweist auf andere Inhalte jeden Typs. Kann zum Erstellen verschachtelter Inhalte verwendet werden.
- Wenn ein Bild referenziert wird, kann wahlweise eine Miniatur angezeigt werden.
- Das Feld kann so konfiguriert werden, dass Fragmentautorinnen und -autoren neue Instanzen des Felds erstellen können.
- Die Referenz gibt den Pfad zur referenzierten Ressource an, z. B.
/content/dam/path/to/resource.
-
Inhaltsreferenz (UUID)
- Verweist auf andere Inhalte jeden Typs. Kann zum Erstellen verschachtelter Inhalte verwendet werden.
- Wenn ein Bild referenziert wird, kann wahlweise eine Miniatur angezeigt werden.
- Das Feld kann so konfiguriert werden, dass Fragmentautorinnen und -autoren neue Instanzen des Felds erstellen können.
- Im Editor gibt die Referenz den Pfad zur referenzierten Ressource an. Intern wird die Referenz als Universally Unique ID (UUID) gespeichert, die auf die Ressource verweist.
- Sie müssen die UUID nicht kennen. Sie können im Fragmenteditor zur gewünschten Asset-Ressource navigieren.
-
JSON-Objekt
-
Ermöglicht es der Autorin bzw. dem Autor des Inhaltsfragments, JSON-Syntax in die entsprechenden Elemente eines Fragments einzugeben.
- Damit AEM direktes JSON speichern kann, das Sie von einem anderen Service kopiert/eingefügt haben.
- Das JSON wird weitergegeben und als JSON in GraphQL ausgegeben.
- Umfasst JSON-Syntaxhervorhebung, automatische Vervollständigung und Fehlerhervorhebung im Inhaltsfragmenteditor.
-
-
Registerkarten-Platzhalter
-
Ermöglicht die Einführung von Registerkarten zur Bearbeitung des Inhalts von Inhaltsfragmenten.
- Dies wird als Trennzeichen im Modell-Editor angezeigt, das Abschnitte der Liste der Inhaltsdatentypen trennt. Jede Instanz stellt den Beginn einer neuen Registerkarte dar.
- Im Fragment-Editor wird jede Instanz als Registerkarte angezeigt.
note note NOTE Dieser Datentyp dient ausschließlich zur Formatierung und wird vom GraphQL-Schema von AEM ignoriert.
-
Eigenschaften (Datentypen) properties
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, dürfen die Namen nur A–Z, a–z, 0–9 und den Unterstrich „_“ als Sonderzeichen enthalten.
note caution CAUTION 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 oder der Autorin nur eine einzige Instanz des Feldes angezeigt wird oder ob mehrere Instanzen erstellt werden dürfen. Wenn Mehrere Felder verwendet wird, können Sie die Mindest- und Höchstanzahl der Elemente definieren. Siehe Validierung für weitere Informationen.
-
Feldbezeichnung
Das Eingeben einer Feldbezeichnung generiert automatisch einen Eigenschaftsnamen, der dann 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:
- Rich-Text
- Markdown
- Nur Text
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.
-
Eindeutig
Der Inhalt (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
Countryim Inhaltsfragmentmodell nicht den WertJapanin zwei abhängigen Inhaltsfragmenten haben. Eine Warnung wird ausgegeben, wenn versucht wird, eine zweite Instanz zu erstellen.note note NOTE Die Eindeutigkeit wird pro Sprachstamm gewährleistet. note note NOTE 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:
- Es wird sichergestellt, dass der Eigenschaftsname zur Übersetzungskonfiguration im Kontext
/content/dam/<sites-configuration>hinzugefügt wird, falls er noch nicht vorhanden ist. - Für GraphQL: Im Inhaltsfragmentfeld wird die Eigenschaft
<translatable>aufyesfestgelegt, um den GraphQL-Abfragefilter für die JSON-Ausgabe nur mit übersetzbarem Inhalt zuzulassen.
- Es wird sichergestellt, dass der Eigenschaftsname zur Übersetzungskonfiguration im Kontext
Validierung validation
Verschiedene Datentypen bieten jetzt die Möglichkeit, Validierungsanforderungen für den Zeitpunkt zu definieren, an dem Inhalt in das resultierende Fragment eingefügt wird:
-
Einzeilentext
- Führen Sie einen Vergleich mit einem vordefinierten Regex durch.
-
Zahl
- Suchen Sie nach bestimmten Werten.
-
Inhaltsreferenz
- Testen Sie, ob bestimmte Content-Typen vorhanden sind.
- Es können nur Assets bis zur angegebenen maximalen Dateigröße referenziert werden.
- Es können nur Bilder in einem vordefinierten Bereich von Breite und/oder Höhe (in Pixel) referenziert werden.
-
Fragmentreferenz
- Testen Sie, ob ein bestimmtes Inhaltsfragmentmodell vorhanden ist.
-
Mindestanzahl der Elemente/Maximale Anzahl der Elemente
Felder, die als Mehrere Felder festgelegt wurden (mit Rendern als) haben die Optionen:
- Mindestanzahl der Elemente
- Maximale Anzahl der Elemente
Diese werden im Inhaltsfragmenteditor validiert.
Verwenden von Verweisen, um verschachtelten Inhalt zu bilden using-references-to-form-nested-content
Inhaltsfragmente können mit einem der folgenden Datentypen verschachtelte Inhalte bilden:
-
-
Bietet einen einfachen Verweis auf andere Inhalte eines beliebigen Typs.
-
Bereitgestellt von den Datentypen:
- Inhaltsreferenz – pfadbasiert
- Inhaltsreferenz (UUID) – UUID-basiert
-
Kann für eine oder mehrere Referenzen konfiguriert werden (im resultierenden Fragment).
-
-
Fragmentreferenz (verschachtelte Fragmente)
-
Verweist auf andere Fragmente, abhängig von den angegebenen Modellen.
-
Bereitgestellt von den Datentypen:
- Fragmentreferenz – pfadbasiert
- Fragmentreferenz (UUID) – UUID-basiert
-
Ermöglicht das Einschließen/Abrufen strukturierter Daten.
note note NOTE Diese Methode ist vor allem bei der Verwendung in Verbindung mit der Headless-Inhaltsbereitstellung mittels Inhaltsfragmenten mit GraphQL interessant. * Kann für eine oder mehrere Referenzen konfiguriert werden (im resultierenden Fragment).
-
-
Inhaltsverweise
Dies verhindert, dass Benutzende einen Verweis zum aktuellen Fragment hinzufügen, und kann zu einem leeren Auswahldialogfeld „Fragmentreferenz“ führen. -
Fragmentverweise in GraphQL
Wenn Sie eine Deep-Abfrage erstellen, die mehrere, sich gegenseitig referenzierende Inhaltsfragmente zurückgibt, gibt sie beim ersten Auftreten NULL zurück.
Inhaltsreferenz content-reference
Mit den Datentypen Inhaltsreferenz und Inhaltsreferenz (UUID) können Sie Inhalte aus einer anderen Quelle rendern, z. B. ein Bild, eine Seite oder ein Experience Fragment.
Zusätzlich zu den Standardeigenschaften können Sie Folgendes angeben:
-
Das Stammverzeichnis, das angibt, wo referenzierte Inhalte gespeichert werden sollen
note note NOTE Dies ist erforderlich, wenn Sie mit dem Inhaltsfragmenteditor Bilder in diesem Feld direkt hochladen und referenzieren möchten. Siehe Bilder referenzieren für weitere Informationen. -
Die Inhaltstypen, auf die verwiesen werden kann
note note NOTE Dazu gehören Bilder, wenn Sie mit dem Inhaltsfragmenteditor Bilder in diesem Feld direkt hochladen und referenzieren möchten. Siehe Bilder referenzieren für weitere Informationen. -
Einschränkungen bezüglich der Dateigrößen
-
Wenn ein Bild referenziert wird:
- Miniatur anzeigen
- Bildeinschränkungen hinsichtlich Höhe und Breite
Fragmentreferenz (verschachtelte Fragmente) fragment-reference-nested-fragments
Die Datentypen Fragmentreferenz und Fragmentreferenz (UUID) können auf ein oder mehrere Inhaltsfragmente verweisen. Diese Funktion ist besonders beim Abrufen von Inhalten für die Verwendung in Ihrem Programm interessant, da sie es Ihnen ermöglicht, strukturierte Daten mit mehreren Ebenen abzurufen.
Zum Beispiel:
- Ein Modell, das Details für eine Mitarbeiterin oder einen Mitarbeiter definiert, beispielsweise:
- Ein Verweis auf das Modell, das den Arbeitgeber (Firma) definiert
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
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 Hinzufügen von Referenzen zu einem Inhaltsfragment 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 die Autorin oder der Autor des Fragments ein Fragment auf der Grundlage des entsprechenden Modells erstellen.
- fragmentreferencecomposite: Ermöglicht dem Fragmentautor das Erstellen einer Composite-Datei durch Auswahl mehrerer Fragmente.
