Inhaltsfragmentmodelle in Adobe Experience Manager (AEM) as a Cloud Service definieren die Inhaltsstruktur Ihrer Inhaltsfragmente. Diese Fragmente können dann für die Seitenbearbeitung oder als Grundlage für Ihren Headless Content verwendet werden.
So verwenden Sie Inhaltsfragmentmodelle:
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zu dem Ordner, der Ihrer Konfiguration oder Unterkonfiguration.
Verwenden Sie Erstellen, um den Assistenten zu öffnen.
Wenn die Variable Verwendung von Inhaltsfragmentmodellen wurde nicht aktiviert, die Erstellen nicht verfügbar.
Geben Sie den Modelltitel an.
Sie können auch verschiedene Eigenschaften definieren, beispielsweise Tags, a Beschreibung auswählen Modell aktivieren nach das Modell aktivieren bei Bedarf und definieren Sie die
Standardmäßige Echtzeitansicht für URL-Muster.
Siehe Inhaltsfragmentmodell - Eigenschaften für ausführliche Informationen.
Verwenden Sie Erstellen, um das leere Modell zu speichern. Eine Meldung weist auf den Erfolg der Aktion hin. Sie können Öffnen das Modell sofort bearbeiten oder Fertig , um zur Konsole zurückzukehren.
Diese Eigenschaften werden beim Erstellen eines Modells definiert und können später mit der Eigenschaften -Option für das Inhaltsfragmentmodell:
Modell-Titel
Tags
Beschreibung
Modell aktivieren
Standard-URL-Vorschaumuster
Der Inhaltsfragment-Editor ermöglicht es Autoren, Vorschau ihren Inhalt in einer externen Frontend-Anwendung. Einmal die Vorschaufunktion konfiguriert ist, fügen Sie die URL für die Frontend-Anwendung hinzu.
Die Vorschau-URL sollte diesem Muster entsprechen:
https://<preview_url>?param=${expression}
Verfügbare Ausdrücke sind:
${contentFragment.path}
${contentFragment.model.path}
${contentFragment.model.name}
${contentFragment.variation}
${contentFragment.id}
Bild hochladen
Das Inhaltsfragmentmodell definiert die Struktur der resultierenden Inhaltsfragmente mithilfe einer Auswahl von Datentypen. Mithilfe des Modell-Editors können Sie Instanzen der Datentypen hinzufügen und diese dann so konfigurieren, dass die erforderlichen Felder erstellt werden:
Das Bearbeiten eines Modells, das bereits von vorhandenen Inhaltsfragmenten verwendet wird, kann sich auf diese abhängigen Fragmente auswirken.
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zum Ordner mit Ihrem Inhaltsfragmentmodell.
Ö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:
Wenn ein Feld als Erforderlich, die Titel im linken Bereich mit einem Sternchen (*).
So fügen Sie ein Feld hinzu
Ziehen Sie einen erforderlichen Datentyp an die entsprechende Stelle für ein Feld:
Nachdem dem Modell ein Feld hinzugefügt wurde, zeigt das rechte Bedienfeld die Eigenschaften , die für diesen 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.
Typisierung Feldbezeichnung schließt automatisch die Eigenschaftsname - wenn leer, und kann danach manuell aktualisiert werden.
Beim manuellen Aktualisieren der Eigenschaft Eigenschaftsname für einen Datentyp müssen Namen only A-Z, a-z, 0-9 und Unterstrich "_"als Sonderzeichen.
Wenn Modelle, die in früheren Versionen von AEM erstellt wurden, unzulässige Zeichen enthalten, entfernen oder ändern Sie diese Zeichen.
Beispiel:
So entfernen Sie ein Feld
Wählen Sie das gewünschte Feld aus und wählen Sie dann das Papierkorbsymbol 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. Beispiel:
Wählen Sie Speichern, um die Definition beizubehalten.
Zum Definieren Ihres Modells stehen unterschiedliche Datentypen zur Verfügung:
Einzeilentext
Mehrzeilentext
Ob der Textbereich Rich Text, Nur Text oder Markdown ist, wird im Modell durch die Eigenschaft definiert Standardtyp.
Dieses Format kann nicht über die Inhaltsfragmente-Editor, aber nur vom Modell.
Zahl
Boolesch
Datum und Uhrzeit
Aufzählung
Tags
Inhaltsreferenz
Fragmentreferenz
JSON-Objekt
Registerkarten-Platzhalter
Ermöglicht die Einführung von Registerkarten zur Bearbeitung des Inhalts von Inhaltsfragmenten.
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
Beim manuellen Aktualisieren dieser Eigenschaft für einen Datentyp werden Namen must contain only A-Z, a-z, 0-9 und Unterstrich "_"als Sonderzeichen.
Wenn Modelle, die in früheren Versionen von AEM erstellt wurden, unzulässige Zeichen enthalten, entfernen oder ändern Sie diese Zeichen.
Rendern als
Die verschiedenen Optionen zum Realisieren/Rendern des Felds in einem Fragment. Oft können Sie damit festlegen, ob dem Autor nur eine einzige Instanz des Feldes angezeigt wird oder ob er mehrere Instanzen erstellen darf. Wann Mehrere Felder verwendet wird, können Sie die Mindest- und Höchstanzahl der Elemente definieren - siehe Validierung für weitere Informationen.
Feldbezeichnung
Eingabe einer Feldbezeichnung automatisch generiert eine Eigenschaftsname, die 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:
Wenn Sie keinen Typ angeben, wird der Standardwert Rich-Text in diesem Feld verwendet.
Ändern der Standardtyp in einem Inhaltsfragmentmodell wird nur auf ein vorhandenes, zugehöriges Inhaltsfragment wirksam, nachdem dieses Fragment im Editor geöffnet und gespeichert wurde.
Eindeutig
Der Inhalt (für das spezifische Feld) muss für alle Inhaltsfragmente eindeutig sein, die vom aktuellen Modell erstellt werden.
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:
Einzeilentext
Zahl
Inhaltsreferenz
Fragmentreferenz
Mindestanzahl von Elementen / Maximale Elementanzahl
Felder, die als Mehrere Felder (festgelegt mit Rendern als) haben die Optionen:
Diese werden im Inhaltsfragment-Editor.
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 bei der Verwendung von Headless-Content-Bereitstellung mit Inhaltsfragmenten mit GraphQL.
AEM bietet Wiederholungsschutz für:
Inhaltsreferenzen
Dies verhindert, dass der Benutzer einen Verweis zum aktuellen Fragment hinzufügt, und kann zu einem leeren Dialogfeld für die Auswahl der Fragmentverweise führen.
Fragmentverweise in GraphQL
Wenn Sie eine Deep-Abfrage erstellen, die mehrere Inhaltsfragmente zurückgibt, auf die sich gegenseitig verweisen, wird beim ersten Auftreten null zurückgegeben.
Mit der 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:
Die Stammverzeichnis, der angibt, wo referenzierte Inhalte gespeichert werden sollen
Dies ist erforderlich, wenn Sie Bilder in diesem Feld bei Verwendung des Inhaltsfragment-Editors direkt hochladen und referenzieren möchten.
Siehe Referenzbilder für weitere Informationen.
Die Inhaltstypen, auf die verwiesen werden kann
Diese müssen Bild , wenn Sie Bilder in diesem Feld bei Verwendung des Inhaltsfragment-Editors direkt hochladen und referenzieren möchten.
Siehe Referenzbilder für weitere Informationen.
Einschränkungen bezüglich der Dateigrößen
Wenn ein Bild referenziert wird:
Die Fragmentreferenz verweist auf ein oder mehrere Inhaltsfragmente. Diese Funktion ist besonders beim Abrufen von Inhalten für die Verwendung in Ihrer App interessant, da Sie damit strukturierte Daten mit mehreren Ebenen abrufen können.
Beispiel:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Fragmentverweise sind für Headless-Content-Bereitstellung mit Inhaltsfragmenten mit GraphQL.
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 Verweisen 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
Dadurch kann der Fragmentautor ein Fragment basierend auf dem entsprechenden Modell erstellen.
Es gibt einen Mechanismus zum Wiederholungsschutz. Es untersagt dem Benutzer, das aktuelle Inhaltsfragment in der Fragmentreferenz auszuwählen, und kann zu einem leeren Dialogfeld für die Auswahl von Fragmentverweisen führen.
Es gibt auch Wiederholungsschutz für Fragmentverweise in GraphQL. Wenn Sie eine tiefe Abfrage über zwei Inhaltsfragmente erstellen, die sich gegenseitig referenzieren, wird null zurückgegeben.
Sie können Aktivieren oder Deaktivieren Ihre Inhaltsfragmentmodelle, um deren Verwendung vollständig zu kontrollieren.
Nachdem ein Modell erstellt wurde, muss es aktiviert werden, damit es:
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:
So deaktivieren Sie ein Modell, das als Aktiviert, verwenden Sie die Deaktivieren -Option entweder:
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 vererbt. Die Richtlinie kann neu konfiguriert werden (und die Vererbung ist unterbrochen), wenn Unterordner Modelle zulassen müssen, die sich vom übergeordneten Ordner unterscheiden.
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 kann sich auf abhängige Fragmente auswirken.
So löschen Sie ein Inhaltsfragmentmodell:
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zum Ordner mit Ihrem Inhaltsfragmentmodell.
Wählen Sie Ihr Modell und anschließend die Option Löschen aus der Symbolleiste aus.
Wenn auf das Modell verwiesen wird, wird eine Warnung angezeigt, damit Sie entsprechende Maßnahmen treffen können.
Inhaltsfragmentmodelle müssen veröffentlicht werden, wenn/bevor abhängige Inhaltsfragmente veröffentlicht werden.
So veröffentlichen Sie ein Inhaltsfragmentmodell:
Navigieren Sie zu Tools > Allgemein und öffnen Sie dann Inhaltsfragmentmodelle.
Navigieren Sie zum Ordner mit Ihrem Inhaltsfragmentmodell.
Wählen Sie Ihr Modell und anschließen die Option Veröffentlichen aus der Symbolleiste aus.
Der veröffentlichte Status wird in der Konsole angezeigt.
Wenn Sie ein Inhaltsfragment veröffentlichen, für das das Modell noch nicht veröffentlicht wurde, wird dies in einer Auswahlliste angezeigt und das Modell wird mit dem Fragment veröffentlicht.
Die Veröffentlichung von Inhaltsfragmentmodellen kann aufgehoben 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 zum Ordner mit Ihrem Inhaltsfragmentmodell.
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 derzeit von einem oder mehreren Fragmenten verwendet wird, wird eine Fehlerwarnung angezeigt. Beispiel:
Die Nachricht weist darauf hin, dass Sie die Verweise -Gremium weiter zu untersuchen:
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.
Jedes dieser Kriterien kann Abfragen unterbrechen, 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. Dieser Status wird durch Gesperrt:
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 ein Warnhinweis angezeigt wird, und Sie müssen die Entsperren Aktion:
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 an Gesperrt (SCHREIBGESCHÜTZT).
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, können Sie den Inhalt und die Struktur des Modells sehen:
Wenn Sie Bearbeiten können Sie Ihre Aktualisierungen bearbeiten und speichern:
Oben kann noch eine Warnung angezeigt werden. In diesem Fall wird das Modell jedoch bereits von vorhandenen Inhaltsfragmenten verwendet.
Abbrechen kehrt Sie zur Konsole zurück.