Inhaltsfragmentmodelle content-fragment-models
Inhaltsfragmentmodelle in AEM definieren die Inhaltsstruktur für Ihre Inhaltsfragmente, die als Grundlage für Ihren Headless-Content dienen.
Verwenden von Inhaltsfragmentmodellen
- Aktivieren Sie die Funktion für Inhaltsfragmentmodelle für Ihre Instanz.
- Erstellen und konfigurieren Sie Ihre Inhaltsfragmentmodelle.
- Aktivieren Sie Ihre Inhaltsfragmentmodelle zur Verwendung beim Erstellen von Inhaltsfragmenten.
- Lassen Sie Ihre Inhaltsfragmentmodelle in den erforderlichen Asset-Ordnern zu, indem Sie Richtlinien konfigurieren.
Erstellen eines Inhaltsfragmentmodells creating-a-content-fragment-model
-
Navigieren Sie zu Tools > Assets und öffnen Sie dann Inhaltsfragmentmodelle.
-
Navigieren Sie zu dem entsprechenden Ordner für Ihre Konfiguration.
-
Verwenden Sie Erstellen, um den Assistenten zu öffnen.
note caution CAUTION 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 je nach Bedarf das Modell zu aktivieren.
-
Verwenden Sie Erstellen, um das leere Modell zu speichern. Eine Meldung zeigt den Erfolg der Aktion an. Sie können Öffnen auswählen, um das Modell sofort zu bearbeiten, oder Fertig, um zur Konsole zurückzukehren.
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:
-
Navigieren Sie zu Tools > Assets 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.
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 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 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 Eigenschaften.
-
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, 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.
Zum Beispiel:
-
-
-
Entfernen eines Feldes
Wählen Sie das entsprechende Feld aus und klicken Sie auf das Papierkorbsymbol. 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. Beispiel:
-
Wählen Sie Speichern, um die Definition beizubehalten.
Datentypen data-types
Zum Definieren Ihres Modells stehen unterschiedliche Datentypen zur Verfügung:
-
Einzeilentext
- Fügen Sie ein oder mehrere Felder mit einer einzelnen Textzeile hinzu. Die maximale Länge kann festgelegt werden.
-
Mehrzeilentext
- Ein Textbereich, der Rich Text, Plain Text oder Markdown sein kann
-
Zahl
- Fügen Sie ein oder mehrere numerische Felder hinzu.
-
Boolesch
- Fügen Sie ein boolesches Kontrollkästchen hinzu.
-
Datum und Uhrzeit
- Fügen Sie ein Datum und/oder eine Uhrzeit hinzu.
-
Aufzählung
- Hinzufügen einer Reihe von Kontrollkästchen, Optionsfeldern oder Dropdown-Feldern
-
Tags
- Ermöglicht Fragmentautoren den Zugriff auf und die Auswahl von Tag-Bereichen.
-
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.
-
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
-
-
JSON-Objekt
-
Ermöglicht es dem Autor des Inhaltsfragments, JSON-Syntax in die entsprechenden Elemente eines Fragments einzugeben.
- Damit AEM direktes JSON speichern kann, das Sie von einem anderen Dienst kopiert und 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 Fragmenteditor 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 properties
Viele Eigenschaften sind selbsterklärend. Im Folgenden finden Sie weitere Informationen zu bestimmten Eigenschaften:
-
Eigenschaftsname
Bei der manuellen Aktualisierung dieser Eigenschaft für einen Datentyp 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 der Autorin oder dem Autor nur eine einzige Instanz des Feldes angezeigt wird oder ob sie bzw. er mehrere Instanzen erstellen darf. -
Feldbezeichnung
Das Eingeben einer Feldbezeichnung generiert automatisch einen Eigenschaftsnamen, der dann bei Bedarf manuell aktualisiert werden kann. -
Validierung
Die grundlegende Validierung 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.
Eine Änderung des Standardtyps in einem Inhaltsfragment-Modell wird nur bei einem vorhandenen, verwandten Inhaltsfragment wirksam, nachdem dieses 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 WertJapan
in 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).
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.
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 anderen Content jedes Typs.
- Kann für einen oder mehrere Verweise konfiguriert werden (im resultierenden Fragment).
-
Fragmentreferenz (verschachtelte Fragmente)
-
Verweist auf andere Fragmente, abhängig von den angegebenen Modellen.
-
Ermöglicht das Einschließen/Abrufen strukturierter Daten.
note note NOTE Diese Methode ist in Verbindung mit der Headless-Inhaltsbereitstellung mittels Inhaltsfragmenten mit GraphQL besonders interessant. * Kann für einen oder mehrere Verweise konfiguriert werden (im resultierenden Fragment).
-
-
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, sich gegenseitig referenzierende Inhaltsfragmente zurückgibt, gibt sie beim ersten Auftreten NULL zurück.
Inhaltsreferenz content-reference
Mit der Inhaltsreferenz können Sie Inhalt aus einer anderen Quelle rendern, z. B. ein Bild oder Inhaltsfragment.
Zusätzlich zu den Standardeigenschaften können Sie Folgendes angeben:
-
Den Stammpfad für referenzierte Inhalte
-
Die Inhaltstypen, auf die verwiesen werden kann
-
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 Fragmentreferenz verweist auf mindestens ein Inhaltsfragment. Diese Funktion ist besonders beim Abrufen von Inhalt für die Verwendung in Ihrer Anwendung interessant, da sie es Ihnen ermöglicht, strukturierte Daten mit mehreren Ebenen abzurufen.
Zum Beispiel:
- Ein Modell, das Details für einen Mitarbeiter definiert, beispielsweise:
- Ein Verweis auf das Modell, das den Arbeitgeber definiert (Firma)
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 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 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.
Aktivieren oder Deaktivieren von Inhaltsfragmentmodellen enabling-disabling-a-content-fragment-model
Zur vollständigen Kontrolle über die Verwendung Ihrer Inhaltsfragment-Modelle können Sie deren Status festlegen.
Aktivieren eines Inhaltsfragmentmodells enabling-a-content-fragment-model
Wenn ein Modell erstellt wurde, muss es aus folgenden Gründen aktiviert werden:
- Damit es zur Auswahl steht, wenn ein neues Inhaltsfragment erstellt wird.
- Damit es in einem Inhaltsfragment-Modell referenziert werden kann.
- Damit es für GraphQL verfügbar ist, sodass das Schema generiert wird.
So aktivieren Sie ein Modell, das folgendermaßen gekennzeichnet ist:
- Entwurf: neu (noch nie aktiviert).
- Deaktiviert: wurde deaktiviert.
Sie können die Option Aktivieren aus einem der folgenden Bereiche verwenden:
- Die obere Symbolleiste, wenn das erforderliche Modell ausgewählt ist.
- Die entsprechende Schnellaktion (bewegen Sie den Mauszeiger über das entsprechende Modell).
Deaktivieren eines Inhaltsfragmentmodells disabling-a-content-fragment-model
Ein Modell lässt sich auch aus folgenden Gründen deaktivieren:
-
Das Modell ist nicht mehr als Grundlage für die Erstellung neuer Inhaltsfragmente verfügbar.
-
Beachten Sie jedoch Folgendes:
- Das GraphQL-Schema wird weiterhin generiert und kann weiterhin abgefragt werden (um eine Beeinträchtigung der JSON-API zu vermeiden).
- Inhaltsfragmente, die auf dem Modell basieren, können weiterhin abgefragt und vom GraphQL-Endpunkt zurückgegeben werden.
-
Das Modell kann nicht mehr referenziert werden. Vorhandene Referenzen bleiben jedoch unverändert und können weiterhin abgefragt und vom GraphQL-Endpunkt zurückgegeben werden.
Um ein Modell zu deaktivieren, das als Aktiviert gekennzeichnet ist, verwenden Sie die Option Deaktivieren aus einem der folgenden Bereiche:
- Die obere Symbolleiste, wenn das erforderliche Modell ausgewählt ist.
- Die entsprechende Schnellaktion (bewegen Sie den Mauszeiger über das entsprechende Modell).
Zulassen von Inhaltsfragmentmodellen im Asset-Ordner allowing-content-fragment-models-assets-folder
Zur Implementierung der Inhaltsverwaltung können Sie Richtlinien im Asset-Ordner konfigurieren, um zu steuern, welche Inhaltsfragment-Modelle für die Fragmenterstellung in diesem Ordner zulässig sind.
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:
- Die Richtlinien für Zulässige Inhaltsfragmentmodelle.
- Falls leer, versuchen Sie, die Richtlinie mithilfe der Vererbungsregeln zu bestimmen.
- Wenn die Vererbungskette kein Ergebnis liefert, prüfen Sie die Cloud Services-Konfiguration für diesen Ordner (auch zuerst direkt und dann über Vererbung).
- Wenn keines der oben genannten Verfahren Ergebnisse liefert, gibt es keine zulässigen Modelle für diesen Ordner.
Löschen eines Inhaltsfragmentmodells deleting-a-content-fragment-model
Löschen eines Inhaltsfragment-Modells:
-
Navigieren Sie zu Tools > Assets 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.
note note NOTE Wenn auf das Modell verwiesen wird, wird eine Warnung angezeigt. Ergreifen Sie geeignete Maßnahmen.
Veröffentlichen eines Inhaltsfragmentmodells publishing-a-content-fragment-model
Inhaltsfragment-Modelle müssen zeitgleich mit oder im Vorfeld der Veröffentlichung abhängiger Inhaltsfragmente veröffentlicht werden.
So veröffentlichen Sie ein Inhaltsfragment-Modell:
-
Navigieren Sie zu Tools > Assets 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.note note NOTE Wenn Sie ein Inhaltsfragment veröffentlichen, dessen Modell noch nicht veröffentlicht wurde, wird dies in einer Auswahlliste angezeigt und das Modell wird mit dem Fragment veröffentlicht.
Rückgängigmachen der Veröffentlichung eines Inhaltsfragmentmodells unpublishing-a-content-fragment-model
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 > Assets 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.
Inhaltsfragmentmodell – Eigenschaften content-fragment-model-properties
Sie können die Eigenschaften eines Inhaltsfragmentmodells bearbeiten:
-
Allgemein
- Modell-Titel
- Tags
- Beschreibung
- Bild hochladen