DokumentationAEMBenutzerhandbuch

[AEM Sites]{class="badge positive" title="Gilt für AEM Sites)."}

Definieren von Inhaltsfragmentmodellen defining-content-fragment-models

Letzte Aktualisierung: 2. November 2026
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • Benutzerin bzw. Benutzer
  • Entwicklerin/Entwickler

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 nach dem Erstellen Ihrer Ihre Fragmente verfügbar sind, einschließlich Aktionen, die in der Inhaltsfragmentkonsole verfügbar sind, dem Zulassen des Modells für Ihren Ordner und dem Veröffentlichen Ihres Modells.

NOTE
Beachten Sie die Best Practices beim Arbeiten mit Ihren Inhaltsfragmentmodellen und Inhaltsfragmenten.
CAUTION
Wenn Sie Abfragen nach mehreren Fragmenten durchführen, auf die verwiesen wird, wird nicht empfohlen, dass Ihre verschiedenen Fragmentmodelle Feldnamen mit demselben Namen, aber unterschiedlichen Typen aufweisen.
Weitere Informationen finden Sie unter AEM GraphQL-API zur Verwendung mit Inhaltsfragmenten – Einschränkungen.
NOTE
Wenn Sie ein Modell mit diesem neuen Editor erstellen, sollten Sie immer diesen Editor für dieses Modell verwenden.
Wenn Sie dann das Modell mit dem ursprünglichen Modell-Editor öffnen, wird die Meldung angezeigt:
  • „Für dieses Modell ist ein benutzerdefiniertes Benutzeroberflächenschema konfiguriert. Die Reihenfolge der in dieser Benutzeroberfläche angezeigten Felder stimmt möglicherweise nicht mit dem Benutzeroberflächenschema überein. Um die Felder anzuzeigen, die mit dem Benutzeroberflächenschema abgestimmt sind, müssen Sie zum neuen Inhaltsfragment-Editor wechseln.“

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:

CAUTION
Das Bearbeiten eines Modells, das bereits von vorhandenen Inhaltsfragmenten verwendet wird, kann sich auf diese abhängigen Fragmente auswirken.

  1. Wählen Sie in der Inhaltsfragmentkonsole das Panel für Inhaltsfragmentmodelle aus und navigieren Sie zu dem Ordner mit Ihrem Inhaltsfragmentmodell.

    note
    NOTE
    Sie können ein Modell auch direkt nach dem Erstellen öffnen.

  2. Öffnen Sie das gewünschte Modell für Bearbeiten verwenden Sie einen der Schnellzugriff-Links oder wählen Sie das Modell und dann die Aktion in der Symbolleiste aus.

    Eigenschaften

    Nach dem Öffnen zeigt der Modell-Editor Folgendes an:

    • Oben:

      • Symbol Startseite
      • Option zum Umschalten zwischen dem Original und neuen Editor
      • Abbrechen
      • Speichern

    • Links: Datentypen zum Erstellen von Feldern verfügbar

    • Middle: Felder, die bereits zusammen mit der Option Hinzufügen definiert wurden

    • Rechts: Mithilfe der Symbole ganz rechts können Sie zwischen folgenden Optionen wählen:

      • Eigenschaften: Definieren und Anzeigen von Eigenschaften für das ausgewählte Feld
      • Modelldetails: Anzeigen des Aktiviert-Status, Modelltitel, Tags, Beschreibung und Vorschau-URL

  3. So fügen Sie ein Feld hinzu

    • Sie haben folgende Möglichkeiten:

      • Ziehen Sie einen Datentyp aus dem linken Bereich an die erforderliche Position für ein Feld im mittleren Bereich.
      • Wählen Sie das Symbol + nach einem Datentyp aus, um es am unteren Rand der Feldliste hinzuzufügen.
      • Wählen Sie mittleren Bereich Hinzufügen“ und dann den erforderlichen Datentyp aus der resultierenden Dropdown-Liste aus, um ein Feld zum Ende der Liste hinzuzufügen.
      note
      NOTE
      Registerkarten-Platzhalter Felder müssen immer über den vorhandenen Feldern angezeigt werden.

    • Sie können ein Feld mithilfe der Punktbildung links im Feld neu positionieren:

      Feld verschieben

    • Nachdem ein Feld zum Modell hinzugefügt wurde (und ausgewählt ist), werden im rechten Bereich die Eigenschaften angezeigt, die für diesen bestimmten Datentyp definiert werden können. Hier können Sie festlegen, was für die jeweiligen
      Feld.

      • Viele Eigenschaften sind selbsterklärend. Weitere Informationen finden Sie unter Eigenschaften (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:

      Feldeigenschaften

      note
      NOTE
      Wenn ein Feld als "" definiert, wird Beschriftung im mittleren Bereich mit einem Stern markiert (*).

  4. So entfernen Sie ein Feld

    Wählen Sie das Papierkorbsymbol für das entsprechende Feld im mittleren Bereich aus.

    Entfernen

  5. Fügen Sie alle erforderlichen Felder hinzu und legen Sie bei Bedarf die zugehörigen Eigenschaften fest.

  6. Wählen Sie Speichern, um die Definition beizubehalten.

Datentypen data-types

Zum Definieren Ihres Modells stehen unterschiedliche Datentypen zur Verfügung:

  • Einzeilentext

    • Ein Feld für eine einzelne Textzeile hinzufügen; 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
    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

    • Ein numerisches Feld hinzufügen.
    • 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.

  • 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:

      • Bearbeiten Sie das referenzierte Fragment direkt.
      • Erstellen Sie ein neues Inhaltsfragment 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.

  • 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.

  • zusammengesetzt

    • Der Composite-Datentyp kann verwendet werden, um verschachtelten Inhalt zu erstellen

    • Der Composite-Datentyp ermöglicht Inhaltsfragmenten das Speichern hierarchischer, strukturierter Daten

      • Dies wird dadurch erreicht, dass Felder verschachtelte Unterfelder enthalten können
      • Die Unterfelder sind strukturiert
      • Die Unterfelder sind nach Inhaltsfragmentmodellen strukturiert
      • Die Unterfelder sind auf die Inhaltsfragmentmodelle beschränkt, die Sie beim Definieren des Unterfelds angeben

    • Diese Funktion bietet eine Möglichkeit, komplexe Datenstrukturen innerhalb eines einzelnen Fragments zu modellieren, ähnlich wie verschachtelte Objekte in JSON oder eingebettete Dokumente in NoSQL-Datenbanken

    note warning
    WARNING
    Der zusammengesetzte Datentyp kann verwendet werden:
    • in der Touch-optimierten Benutzeroberfläche (Original) Inhaltsfragmentmodell-Editor
    • im neuen Inhaltsfragment-Editor
    Der neue Inhaltsfragmentmodell-Editor und der Inhaltsfragment-Editor in der Touch-optimierten Benutzeroberfläche (original) blockieren den Zugriff auf den zusammengesetzten Datentyp und alle abhängigen Felder.
    Für zusammengesetzte Felder im neuen Inhaltsfragmentmodell-Editor wird die Meldung angezeigt: Bitte registrieren Sie den Renderer für den Typ „zusammengesetzt“.

  • 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
      Dieser Datentyp dient ausschließlich zur Formatierung und wird vom GraphQL-Schema von AEM ignoriert.
      Registerkarten-Platzhalter Felder müssen immer über den vorhandenen Feldern angezeigt werden.

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 darzustellen/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
    Durch Eingabe einer Feldbezeichnung wird automatisch ein Eigenschaftsname generiert, der bei Bedarf manuell aktualisiert werden kann.

  • Validierung
    Die einfache Validierung ist über Mechanismen wie 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
    Inhalte (für das spezifische Feld) müssen in allen aus dem aktuellen Modell erstellten Inhaltsfragmenten 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.

    note
    NOTE
    Die Eindeutigkeit wird pro Sprachstamm gewährleistet.
    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 zu diesem bestimmten Datentyp und Eigenschaften finden Sie unter „Fragmentreferenz“.

  • Ü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> auf yes festgelegt, um den GraphQL-Abfragefilter für die JSON-Ausgabe nur mit übersetzbarem Inhalt zuzulassen.

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

    • Test auf ein bestimmtes Inhaltsfragmentmodell.

  • 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.

Verschachtelter Inhalt nested-content

Inhaltsfragmente können verschachtelte Inhalte bilden, indem sie einen der folgenden Datentypen verwenden:

  • Inhaltsreferenz

    • Bietet einen einfachen Verweis auf andere Inhalte eines beliebigen Typs.
    • Wird vom Datentyp Inhaltsreferenz bereitgestellt
    • Kann für eine oder mehrere Referenzen konfiguriert werden (im resultierenden Fragment).

  • Fragmentreferenz

    • verweist auf andere Fragmente, abhängig von den angegebenen Modellen.

    • Die Fragmente, auf die verwiesen wird, unterscheiden sich und sind vom referenzierenden Fragment getrennt.

    • Wird vom Datentyp Fragmentreferenz bereitgestellt.

    • Ermöglicht das Einschließen/Abrufen strukturierter Daten.

      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).

    • Geeignet, wenn modulare, wiederverwendbare Inhalte benötigt werden.

  • Composite Datentyp:

    • verweist auf andere Fragmente, abhängig von den angegebenen Modellen.
    • Die Fragmente, auf die verwiesen wird, sind vollständig in das referenzierende Fragment eingebettet und integraler Bestandteil des Fragments. Sie haben eine echte Eltern-Kind-Beziehung.
      • Mit dem zusammengesetzten Datentyp können Sie eine Gruppe von Feldern als inline wiederholbare Struktur innerhalb eines übergeordneten Fragments definieren, anstatt auf einen separaten Fragmentverweis zu verweisen.
    • Die zusammengesetzten Felder werden in derselben Editor-Sitzung wie das übergeordnete Fragment bearbeitet.
    • Ermöglicht das Einschließen/Abrufen strukturierter Daten.
    • Geeignet für mehrwertige zusammengesetzte Felder, bei denen die modulare Wiederverwendung nicht das primäre Ziel ist.
    • Ermöglicht die Verwendung flacherer, leichter zu verwaltender Inhaltsstrukturen und kann auch zur Verbesserung der System- und API-Leistung beitragen.
NOTE
AEM bietet Schutz vor Rekursionen für:

  • Inhaltsverweise
    Dies verhindert, dass Benutzende einen Verweis zum aktuellen Fragment hinzufügen, und kann zu einem leeren Auswahldialogfeld der Fragmentreferenzen führen.

  • Fragmentreferenzen in GraphQL
    Wenn Sie eine tiefe Abfrage erstellen, die mehrere Inhaltsfragmente zurückgibt, die gegenseitig aufeinander verweisen, gibt sie beim ersten Vorkommen null zurück.

CAUTION
Wenn Sie mehrere referenzierte Fragmente abfragen, wird nicht empfohlen, dass die verschiedenen Fragmentmodelle Feldnamen mit demselben Namen, sondern unterschiedlichen Typen aufweisen.
Weitere Informationen finden Sie unter AEM GraphQL-API zur Verwendung mit Inhaltsfragmenten – Einschränkungen.

Inhaltsreferenz content-reference

Mit Datentyp „Inhaltsreferenz können Sie Inhalte aus einer anderen Quelle rendern, z. B. Bild, Seite oder Experience Fragment.

Zusätzlich zu den Standardeigenschaften können Sie Folgendes angeben:

  • Das Stammverzeichnis, das angibt, wo referenzierte Inhalte gespeichert werden sollen

    note
    NOTE
    Dies ist erforderlich, wenn Sie mit dem Inhaltsfragment-Editor 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
    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

Inhaltsreferenz

Fragmentreferenz fragment-reference

Der Fragmentverweis Datentyp kann 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
}
NOTE
Fragmentreferenzen sind für die Headless-Bereitstellung von Inhalten mithilfe von Inhaltsfragmenten mit GraphQL besonders interessant.

Zusätzlich zu den Standardeigenschaften können Sie Folgendes definieren:

  • Rendern als:

    • Mehrere Felder - Der Fragmentautor kann mehrere, einzelne Verweise erstellen

    • Fragmentverweis - ermöglicht es dem Fragmentautor, einen einzelnen Verweis auf ein Fragment auszuwä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.

  • Stammverzeichnis
    Dies gibt einen Stammpfad für alle Fragmente an, auf die verwiesen wird, oder stellt diesen dar.

  • Fragmenterstellung zulassen

    Auf diese Weise kann die Autorin oder der Autor des Fragments ein Fragment auf der Grundlage des entsprechenden Modells erstellen.

    Fragmentreferenz

NOTE
Es gibt einen Mechanismus zum Schutz vor rekursiven Verweisen. Er hindert Benutzende daran, das aktuelle Inhaltsfragment in der Fragmentreferenz auszuwählen, und kann zu einem leeren Auswahldialogfeld der Fragmentreferenzen führen.
Es gibt auch einen Schutz vor rekursiven Verweisen für Fragmentreferenzen in GraphQL. Wenn Sie eine tiefe Abfrage über zwei Inhaltsfragmente hinweg erstellen, die gegenseitig aufeinander verweisen, wird null zurückgegeben.

Zusammengesetzte Daten composite-data

Der Composite-Datentyp ermöglicht es Inhaltsfragmenten, hierarchische, strukturierte Daten zu speichern, indem er ermöglicht, dass Felder verschachtelte Unterfelder enthalten. Die untergeordneten (Unterfelder) sind selbst strukturierte Inhalte, die durch benutzerdefinierte Inhaltsfragmentmodelle definiert und vollständig in das übergeordnete“ eingebettet werden.

Der zusammengesetzte Datentyp bietet eine Möglichkeit, komplexe Datenstrukturen innerhalb eines einzelnen Fragments zu modellieren, ähnlich wie verschachtelte Objekte in JSON oder eingebettete Dokumente in NoSQL-Datenbanken.

Ein zusammengesetztes Feld weist die folgenden Eigenschaften und Merkmale auf:

  • Angeben eines oder mehrerer Inhaltsfragmentmodelle

    • Beim Definieren eines zusammengesetzten Felds in einem Inhaltsfragmentmodell müssen Sie festlegen, welche Modelle für die zusammengesetzten Elemente verwendet werden können.
    • Es können mehrere Modelle ausgewählt werden, sodass der Autor bzw. die Autorin auswählen kann, welches Modell beim Hinzufügen eines Elements verwendet werden soll.

  • Authoring

    • Zusammengesetzte Elemente werden ​ derselben EditorSitzung wie ihr übergeordnetes Fragment bearbeitet, ohne ein separates Inhaltsfragment zu öffnen.

  • Schritt-und-Wiederholung als Mehrfachfeld

    • Ein mehrwertiger Verbund unterstützt das Hinzufügen, Entfernen und Neuanordnen von Elementen.

  • Multi-Modell Composite

    • Ein einzelnes zusammengesetztes Feld kann Elemente aus mehreren zulässigen Modellen akzeptieren.
    • Der Autor wählt das Modell aus, das beim Hinzufügen eines neuen Elements verwendet werden soll.

  • Varianten

    • Varianten der obersten Ebene gelten für zusammengesetzte Baumstrukturen: Eine Variante kann eine andere Anzahl zusammengesetzter Elemente oder einen anderen Inhalt pro Element aufweisen als das primäre Element.
    • Die Auswahl erfolgt nur auf der obersten Ebene. Verschachtelte Inhalte spiegeln die ausgewählte Variante wider.

  • Suchen

    • Text in zusammengesetzten Elementen kann durchsucht werden. Übereinstimmende Inhalte geben das übergeordnete Inhaltsfragment in den Suchergebnissen zurück.

  • Nativer Versand

    • GraphQL und OpenAPI geben zusammengesetzte Inhalte als verschachtelte Daten in der übergeordneten Payload zurück, ohne ein separates Inhaltsfragment-Asset aufzulösen.

  • Referenzsemantik bereinigen

    • Sie können Inhalte modellieren, die zu ihrem übergeordneten Element gehören und nicht wiederverwendet werden.

      note
      NOTE
      Reservieren Sie Fragmentverweise für Inhalte, die wirklich wiederverwendbar sind. Beides ist komplementär, kein Ersatz.

Zusätzlich zu den Standardeigenschaften können Sie Folgendes definieren:

  • Rendern als

    Geben Sie Folgendes an:

    • Mehrere Felder Unterstützt das Hinzufügen/Entfernen/Neuanordnen mit Min-/Max-Beschränkungen
    • Zusammengesetztes Feld enthält höchstens ein Element

  • Min./Max. Anzahl der Elemente

    Legen Sie für mehrwertige zusammengesetzte Elemente die Mindest- und Höchstgrenzen für die Anzahl der Elemente fest

  • Typ

    Geben Sie ein oder mehrere Inhaltsfragmentmodelle an. Felder aus diesen Modellen werden als zusammengesetzte Elemente angezeigt. Es können mehrere Modelle ausgewählt werden. Der Autor wählt dann aus, welches Modell beim Hinzufügen eines Elements verwendet werden soll.

NOTE
Obwohl die Inhalte eines zusammengesetzten Felds nach einem Inhaltsfragmentmodell strukturiert sind, bilden sie aufgrund des Fehlens bestimmter Metadaten kein Inhaltsfragment im eigentlichen Sinne.
WARNING
Der zusammengesetzte Datentyp kann verwendet werden:
Der neue Inhaltsfragmentmodell-Editor und der Inhaltsfragment-Editor in der Touch-optimierten Benutzeroberfläche (original) blockieren den Zugriff auf den zusammengesetzten Datentyp und alle abhängigen Felder.
Für zusammengesetzte Felder im neuen Inhaltsfragmentmodell-Editor wird die Meldung angezeigt: Bitte registrieren Sie den Renderer für den Typ „zusammengesetzt“.

Vorteile von Composite benefits-of-composite

Der zusammengesetzte Datentyp bietet beim Modellieren von Daten mehrere Vorteile:

  • Einfacheres Management von Inhaltsstrukturen.

    • Da zusammengesetzte Datentypen direkt in ein Inhaltsfragment eingebettet sind, müssen keine separaten Ordner oder Speicherstrukturen für zusammengesetzte Inhalte verwaltet werden, wie es bei referenzierten Fragmenten erforderlich ist.
    • Dies führt zu flacheren, weniger übersichtlichen Inhaltsstrukturen, die die Governance vereinfachen und die Erkennung von zusammengesetzten Inhalten erleichtern.

  • Vereinfachte Bearbeitung mit nativer Unterstützung für zusammengesetzte Felder mit mehreren Werten.

    • Elemente in mehrwertigen zusammengesetzten Elementen können innerhalb derselben Editor-Sitzung wie das übergeordnete Fragment erstellt und bearbeitet werden.
    • Zusammensetzungen können den Mehraufwand für Referenz- und Fragmentmetadaten reduzieren.

  • Verbessertes Content-Management und verbesserte Bereitstellungsleistung.

    • Einfachere Inhaltsstrukturen mit weniger Fragmentverweisen reduzieren den Mehraufwand für die Referenzauflösung bei Authoring-, Publishing- und Versandvorgängen.
    • Einfachere Inhaltsstrukturen reduzieren auch die Größe und Komplexität von JSON-Payloads und verbessern so die API-Effizienz und die allgemeine Client-seitige Leistung.

Verwendung von Composite when-to-use-composite

Die Verwendung des zusammengesetzten Datentyps sollte sorgfältig überlegt werden, da Ihr Anwendungsfall bestimmen kann, welche Art von verschachtelten Inhalten die beste Lösung für Sie ist.

  • Empfohlen, wenn:

    • Erstellen (seitenähnlichen oder kartenlistenähnlichen), bei denen die untergeordneten Elemente nicht an anderer Stelle wiederverwendet werden.
    • Bei Versand oder Veröffentlichung treten Leistungsprobleme mit Referenzdiagrammen auf.
    • Autoren beschweren sich über Registerkarten-Wechsel-Workflows für verschachtelte Inhalte.
    • Es werden Schritt-und-Wiederholungs-Gruppen mit mehreren Feldern benötigt, für die derzeit benutzerdefinierte Datentypen oder externe Tools erforderlich sind.

  • Seien Sie vorsichtig, wenn:

    • Ihre Inhalte sind wirklich fragmentübergreifend wiederverwendbar. Fragmentverweise bleiben die richtige Antwort für freigegebene Inhalte. Zusammengesetzte Fragmente sind für Inline-Inhalte.
    • Sie verwenden nur den Editor der (ursprünglichen) Touch-optimierten Benutzeroberfläche. Zusammengesetzte Felder werden im neuen Inhaltsfragment-Editor unterstützt, aber der ursprüngliche Editor für die Touch-optimierte Benutzeroberfläche blockiert die Bearbeitung zusammengesetzter Felder.

Einschränkungen von Composite limitations-of-composite

In der folgenden Liste sind die aktuellen Einschränkungen des zusammengesetzten Datentyps zusammengefasst:

  • Authoring-Oberfläche

    • Fragment-Editor für Touch-optimierte Benutzeroberfläche (Original-Editor)
      • Zusammengesetzte Felder werden nicht unterstützt.
    • Neuer (Headless) Editor für Inhaltsfragmentmodelle
      • Der Composite-Typ wird noch nicht unterstützt. Beim Erstellen von Modellen wird der Modell-Editor der ursprünglichen Touch-optimierten Benutzeroberfläche verwendet.
        Bei zusammengesetzten Feldern wird die Meldung angezeigt: Bitte registrieren Sie den Renderer für den Typ „zusammengesetzt“.

  • Funktionsübergreifende Unterstützung

    • MSM (Multi Site Manager)

      • Die Vererbung kann nur für Felder der obersten Ebene unterbrochen werden.

        • Die Vererbung für ein ganzes zusammengesetztes Feld kann unterbrochen werden.
        • Das Unterbrechen der Vererbung für einzelne Felder in zusammengesetzten Elementen wird nicht unterstützt.

    • Launches

      • Inhaltsfragmente, die zusammengesetzte Felder enthalten, werden in Launches nicht unterstützt, unabhängig davon, ob sie direkt ausgewählt oder über Fragmentverweise aufgenommen wurden. Solche Maßnahmen werden nicht akzeptiert und werden scheitern.

    • Kernkomponenten und der Sling-Modell-Exporter

      • Das Seiten-Rendering über Kernkomponenten und den Sling Model Exporter (.model.json) unterstützt noch keine zusammengesetzten Felder.

    • Visuelle Inhaltsfragmente (Inhaltsfragmente mit HTML-Vorlagen)

      • Visuelle Inhaltsfragmente (Inhaltsfragmente mit HTML-Vorlagen) unterstützen derzeit keine zusammengesetzten Felder.
recommendation-more-help
experience-manager-cloud-service-help-main-toc