Erfahren Sie, wie Sie Ihre Inhalte modellieren

In diesem Teil der AEM Headless-Entwickler-Tour erfahren Sie, wie Sie Ihre Inhaltsstruktur modellieren. Setzen Sie dann diese Struktur für Adobe Experience Manager (AEM) mithilfe von Inhaltsfragmentmodellen und Inhaltsfragmenten um, um sie kanalübergreifend wiederzuverwenden.

Die bisherige Entwicklung

Zu Beginn wurde in Erfahren Sie mehr über CMS-Headless-Bereitstellung die Headless-Bereitstellung von Inhalten behandelt und erläutert, warum diese eingesetzt werden sollte. Dann wurde in Erste Schritte mit AEM Headless as a Cloud Service AEM Headless im Kontext Ihres eigenen Projekts beschrieben…

Im vorherigen Dokument der AEM Headless-Tour, Der Weg zu Ihrem ersten Erlebnis mit AEM Headless haben Sie dann die Schritte kennengelernt, die zur Implementierung Ihres ersten Projekts erforderlich sind. Nach dem Lesen sollten Sie:

  • wichtige Planungsüberlegungen für die Gestaltung Ihrer Inhalte verstehen,
  • die Schritte zur Implementierung von Headless in Abhängigkeit von Ihren Anforderungen an die Integrationsebene verstehen,
  • die erforderlichen Tools und AEM-Konfigurationen einrichten können,
  • die Best Practices kennen, um Ihre Headless-Tour reibungslos zu gestalten, die Inhaltserstellung effizient zu halten und sicherzustellen, dass die Inhalte schnell bereitgestellt werden.

Dieser Artikel baut auf diesen Grundlagen auf, sodass Sie verstehen, wie Sie Ihr eigenes AEM Headless-Projekt vorbereiten.

Ziel

  • Zielgruppe: Anfänger
  • Ziele: Sie erfahren, wie Sie Ihre Inhaltsstruktur modellieren und diese Struktur dann mithilfe von AEM-Inhaltsfragmentmodellen und Inhaltsfragmenten umsetzen:
    • Einführung von Konzepten und Terminologie für die Daten-/Inhaltsmodellierung.
    • Erfahren Sie, warum eine Inhaltsmodellierung für die Headless-Bereitstellung von Inhalten erforderlich ist.
    • Erfahren Sie, wie Sie diese Struktur mit AEM-Inhaltsfragmentmodellen (und Autoreninhalten mit Inhaltsfragmenten) umsetzen können.
    • Erfahren Sie, wie Sie Ihre Inhalte modellieren können. Grundprinzipien mit einfachen Beispielen.
HINWEIS

Die Datenmodellierung ist ein sehr großes Feld, da sie bei der Entwicklung von relationalen Datenbanken verwendet wird. Es gibt viele Bücher und Online-Informationsquellen dazu.

Wir werden nur die Aspekte berücksichtigen, die bei der Modellierung von Daten für die Verwendung mit AEM Headless von Interesse sind.

Inhaltsmodellierung

Die Welt da draußen ist groß und schlecht.

Vielleicht, vielleicht auch nicht, aber es ist sicherlich eine große komplizierte Welt da draußen und die Datenmodellierung wird verwendet, um eine vereinfachte Darstellung eines sehr (sehr) kleinen Unterabschnitts zu definieren, wobei die spezifischen Informationen verwendet werden, die für einen bestimmten Zweck benötigt werden.

HINWEIS

Da sich AEM mit Inhalten beschäftigt, bezeichnen wir die Datenmodellierung als Inhaltsmodellierung.

Beispiel:

Es gibt viele Schulen, aber alle haben verschiedene Gemeinsamkeiten:

  • Ein Standort
  • Ein(e) Schulleiter(in)
  • Viele Lehrkräfte
  • Viele Mitarbeiter, die nicht zum Lehrpersonal gehören
  • Viele Schüler/innen
  • Viele Ex-Lehrkräfte
  • Viele Ex-Schüler/innen
  • Viele Klassenzimmer
  • Viele (viele) Bücher
  • Viele (viele) Ausrüstungsgegenstände
  • Viele Aktivitäten außerhalb des Lehrplans
  • und so weiter…

Selbst in einem so kleinen Beispiel kann die Liste endlos erscheinen. Wenn Ihr Programm jedoch nur eine einfache Aufgabe ausführen soll, müssen Sie die Informationen auf das Wichtigste beschränken.

Beispielsweise Werbung für Sonderveranstaltungen für alle Schulen in der Region:

  • Schulname
  • Schulort
  • Schulleiter(in)
  • Veranstaltungstyp
  • Veranstaltungsdatum
  • Lehrkraft, die die Veranstaltung organisiert

Konzepte

Was Sie beschreiben möchten, wird als Entitäten bezeichnet – im Grunde die „Dinge“, über die wir Informationen speichern möchten.

Die Informationen, die wir über sie speichern wollen, sind die Attribute (Eigenschaften), wie z. B. Name und Qualifikationen für die Lehrer.

Dann gibt es verschiedene Beziehungen zwischen den Entitäten. Beispielsweise hat eine Schule in der Regel nur eine(n) Schulleiter(in) und viele Lehrkräfte (und normalerweise ist der Schulleiter auch Lehrer).

Der Prozess der Analyse und Definition dieser Informationen zusammen mit den Beziehungen zwischen ihnen wird als Inhaltsmodellierung bezeichnet.

Grundlagen

Häufig müssen Sie zunächst ein Konzeptschema erstellen, in dem die Entitäten und ihre Beziehungen beschrieben werden. Normalerweise handelt es sich hierbei um einen allgemeinen (konzeptionellen) Ansatz.

Sobald dies stabil ist, können Sie die Modelle in ein logisches Schema übersetzen, das die Entitäten zusammen mit den Attributen und den Beziehungen beschreibt. Auf dieser Ebene sollten Sie die Definitionen genau prüfen, um Duplikate zu vermeiden und Ihren Entwurf zu optimieren.

HINWEIS

Manchmal werden diese beiden Schritte zusammengeführt, was häufig von der Komplexität Ihres Szenarios abhängt.

Benötigen Sie beispielsweise separate Entitäten für Head Teacher und Teacher oder einfach ein zusätzliches Attribut im Teacher-Modell?

Gewährleistung der Datenintegrität

Datenintegrität ist erforderlich, um die Genauigkeit und Konsistenz Ihrer Inhalte über den gesamten Lebenszyklus hinweg zu gewährleisten. Dazu gehört auch, sicherzustellen, dass Autoren von Inhalten leicht verstehen können, was wo gespeichert werden soll. Daher ist Folgendes wichtig:

  • eine klare Struktur
  • eine möglichst knappe Struktur (ohne Genauigkeit zu opfern)
  • Validierung einzelner Felder
  • beschränken Sie gegebenenfalls den Inhalt bestimmter Felder auf das, was aussagekräftig ist

Beseitigen von Datenredundanz

Datenredundanz tritt auf, wenn dieselben Informationen zweimal in der Inhaltsstruktur gespeichert werden. Dies sollte vermieden werden, da es zu Verwirrung bei der Erstellung des Inhalts und zu Fehlern bei Abfragen führen kann, ganz zu schweigen von der schlechten Nutzung des Speicherplatzes.

Optimierung und Leistung

Durch die Optimierung Ihrer Struktur können Sie die Leistung sowohl bei der Inhaltserstellung als auch bei Abfragen verbessern.

Alles ist ein Balanceakt, aber das Erstellen einer Struktur, die zu komplex ist oder zu viele Ebenen hat, kann:

  • für Autoren, die den Inhalt generieren, verwirrend sein,

  • die Leistung stark beeinträchtigen, wenn die Abfrage auf mehrere verschachtelte (referenzierte) Inhaltsfragmente zugreifen muss, um die gewünschten Inhalte abzurufen.

Inhaltsmodellierung für AEM Headless

Die Datenmodellierung ist eine Reihe etablierter Techniken, die häufig bei der Entwicklung von relationalen Datenbanken verwendet werden. Was bedeutet die Inhaltsmodellierung also für AEM Headless?

Vorteile

Um sicherzustellen, dass Ihr Programm die erforderlichen Inhalte konsistent und effizient von AEM anfragen und empfangen kann, müssen diese Inhalte strukturiert sein.

Das bedeutet, dass Ihr Programm die Form der Antwort im Voraus kennt und daher weiß, wie sie verarbeitet wird. Dies ist viel einfacher als das Empfangen von Freiforminhalten, die geparst werden müssen, um festzustellen, was sie enthalten und wie sie daraus folgend verwendet werden können.

Einführung in das Wie?

AEM verwendet Inhaltsfragmente, um die Strukturen bereitzustellen, die für die Headless-Bereitstellung Ihrer Inhalte an Ihre Programme erforderlich sind.

Die Struktur Ihres Inhaltsmodells wird:

  • durch die Definition Ihres Inhaltsfragmentmodells umgesetzt,
  • als Grundlage der Inhaltsfragmente verwendet, die für die Inhaltserstellung verwendet werden.
HINWEIS

Die Inhaltsfragmentmodelle werden auch als Grundlage für die AEM-GraphQL-Schemata verwendet, die zum Abrufen Ihres Inhalts verwendet werden – mehr dazu in einer späteren Sitzung.

Anfragen für Ihre Inhalte werden mit der AEM-GraphQL-API gestellt, einer angepassten Implementierung der standardmäßigen GraphQL-API. Mit der AEM-GraphQL-API können Sie (komplexe) Abfragen für Ihre Inhaltsfragmente durchführen, wobei jede Abfrage einem bestimmten Modelltyp entspricht.

Die zurückgegebenen Inhalte können dann von Ihren Programmen verwendet werden.

Erstellen der Struktur mit Inhaltsfragmentmodellen

Inhaltsfragmentmodelle bieten verschiedene Mechanismen, mit denen Sie die Struktur Ihrer Inhalte definieren können.

Ein Inhaltsfragmentmodell beschreibt eine Entität.

HINWEIS

Um neue Modelle erstellen zu können, müssen Sie die Funktion für Inhaltsfragmente im Konfigurations-Browser aktivieren.

TIPP

Das Modell sollte so benannt werden, dass der Inhaltsautor weiß, welches Modell er beim Erstellen eines Inhaltsfragments auswählen soll.

Innerhalb eines Modells:

  1. Mit Datentypen können Sie die einzelnen Attribute definieren.
    Definieren Sie beispielsweise das Feld mit dem Namen eines Lehrers als Text und dessen Dienstjahre als Zahl.
  2. Mit den Datentypen Inhaltsreferenz und Fragmentreferenz können Sie Beziehungen zu anderen Inhalten in AEM erstellen.
  3. Mit dem Datentyp Fragmentreferenz können Sie mehrere Ebenen der Struktur umsetzen, indem Sie Ihre Inhaltsfragmente verschachteln (je nach Modelltyp). Dies ist für Ihre Inhaltsmodellierung von entscheidender Bedeutung.

Beispiel:
Inhaltsmodellierung mit Inhaltsfragmenten

Datentypen

AEM stellt die folgenden Datentypen bereit, mit denen Sie Ihren Inhalt modellieren können:

  • Einzeilentext
  • Mehrzeilentext
  • Zahl
  • Boolesch
  • Datum und Uhrzeit
  • Aufzählung
  • Tags
  • Inhaltsreferenz
  • Fragmentreferenz
  • JSON-Objekt

Verweise und verschachtelte Inhalte

Zwei Datentypen bieten Verweise auf Inhalte außerhalb eines bestimmten Fragments:

  • Inhaltsreferenz
    Dies bietet einen einfachen Verweis auf andere Inhalte beliebigen Typs.
    Sie können beispielsweise auf ein Bild an einer bestimmten Stelle verweisen.

  • Fragmentreferenz
    Dies bietet Verweise auf andere Inhaltsfragmente.
    Dieser Referenztyp wird verwendet, um verschachtelte Inhalte zu erstellen und die Beziehungen einzuführen, die zum Modellieren Ihres Inhalts erforderlich sind.
    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 von Inhaltsfragmentmodellen

Ganz am Anfang müssen Sie Inhaltsfragmentmodelle für Ihre Website aktivieren. Dies erfolgt im Konfigurations-Browser unter „Tools“ > „Allgemein“ > „Konfigurations-Browser“. Sie können entweder den globalen Eintrag konfigurieren oder eine neue Konfiguration erstellen. Beispiel:

Konfiguration definieren

HINWEIS

Siehe „Zusätzliche Ressourcen – Inhaltsfragmente im Konfigurations-Browser“

Anschließend können die Inhaltsfragmentmodelle erstellt und die Struktur definiert werden. Dies kann unter Tools -> Allgemein -> Inhaltsfragmentmodelle erfolgen. Beispiel:

Inhaltsfragmentmodell

HINWEIS

Siehe „Zusätzliche Ressourcen – Inhaltsfragmentmodelle“.

Verwenden des Modells zum Erstellen von Inhalten mit Inhaltsfragmenten

Inhaltsfragmente basieren immer auf einem Inhaltsfragmentmodell. Das Modell stellt die Struktur bereit, das Fragment enthält den Inhalt.

Auswählen des entsprechenden Modells

Der erste Schritt zur tatsächlichen Erstellung Ihrer Inhalte besteht darin, ein Inhaltsfragment zu erstellen. Dazu verwenden Sie „Erstellen“ > „Inhaltsfragment“ unter „Assets“ > „Dateien“ im erforderlichen Ordner. Der Assistent führt Sie durch die Schritte.

Ein Inhaltsfragment basiert auf einem bestimmten Inhaltsfragmentmodell, das Sie als ersten Schritt des Erstellungsprozesses auswählen.

Erstellen und Bearbeiten von strukturierten Inhalten

Nachdem das Fragment erstellt wurde, können Sie es im Inhaltsfragment-Editor öffnen. Folgende Informationen/Optionen sind verfügbar:

  • Bearbeiten Ihrer Inhalte im normalen oder im Vollbildmodus.
  • Formatieren Ihrer Inhalte entweder als Volltext, Nur-Text oder Markdown.
  • Erstellen und Verwalten von Varianten Ihrer Inhalte.
  • Verknüpfen von Inhalten.
  • Bearbeiten von Metadaten.
  • Anzeigen der Baumstruktur.
  • Vorschau der JSON-Darstellung.

Erstellen von Inhaltsfragmenten

Nach Auswahl des entsprechenden Modells wird ein Inhaltsfragment zur Bearbeitung im Inhaltsfragment-Editor geöffnet:

Inhaltsfragmente-Editor

HINWEIS

Siehe „Zusätzliche Ressourcen – Arbeiten mit Inhaltsfragmenten“.

Erste Schritte mit einigen Beispielen

Eine einfache Struktur als Beispiel finden Sie unter „Beispielstruktur für Inhaltsfragmente“.

Wie geht es weiter

Nachdem Sie nun gelernt haben, wie Sie Ihre Struktur modellieren und abhängig davon Inhalte erstellen, besteht der nächste Schritt hierin: Erfahren Sie, wie Sie mit GraphQL-Abfragen auf Ihre Inhaltsfragmente zugreifen und diese abrufen können. Dort wird GraphQL eingeführt und besprochen und dann werden einige Beispielabfragen angezeigt, um zu zeigen, wie die Dinge in der Praxis funktionieren.

Zusätzliche Ressourcen

Auf dieser Seite