Lernen Sie die Grundlagen der Inhaltsmodellierung für Headless mit AEM kennen.

Die bisherige Entwicklung

Am Anfang der AEM Headless-Inhaltsarchitekten-Tour wurden in der Einführung die grundlegenden Konzepte und die Terminologie behandelt, die für die Modellierung von Inhalten für Headless relevant sind.

Dieser Artikel baut auf diesen auf, damit Sie verstehen, wie Sie Ihre Inhalte für Ihr AEM Headless-Projekt modellieren können.

Ziel

  • Zielgruppe: Anfänger
  • Ziel: Einführung in die Konzepte der Inhaltsmodellierung für Headless-CMS.

Inhaltsmodellierung mit Inhaltsfragmentmodellen

Die Inhalts-(Daten) modellierung 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 Ihrer Inhalte verwendet werden – mehr dazu in der Entwickler-Tour.

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 Anwendungen (komplexe) Abfragen für 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 Ihres Inhalts definieren können.

Ein Inhaltsfragmentmodell beschreibt eine Entität.

HINWEIS

Die Funktion für Inhaltsfragmente muss im Konfigurations-Browser aktiviert sein, damit Sie neue Modelle erstellen können.

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. 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. Die Datentypen Inhaltsreferenz und Fragmentverweis können Sie Beziehungen zu anderen Inhalten in AEM erstellen.
  3. Die Fragmentverweis -Datentyp können Sie mehrere Ebenen der Struktur realisieren, 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
HINWEIS

Weitere Informationen finden Sie unter „Inhaltsfragmentmodelle – Datentypen“.

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
HINWEIS

Sie können Ad-hoc-Verweise auch über Links in Textblöcken erstellen.

Strukturebenen (verschachtelte Fragmente)

Für die Inhaltsmodellierung Fragmentverweis Datentyp können Sie mehrere Ebenen von Struktur und Beziehungen erstellen.

Mit diesem Verweis können Sie verschiedene Inhaltsfragmentmodelle verbinden, um Zusammenhänge darzustellen. Dadurch kann die Headless-Anwendung den Verbindungen folgen und bei Bedarf auf die Inhalte zugreifen.

HINWEIS

Dies sollte mit Vorsicht angewendet werden und als Best Practice kann definiert werden, so viel wie nötig, aber so wenig wie möglich zu verschachteln.

Fragmentverweise tun genau das - sie ermöglichen Ihnen, auf ein anderes Fragment zu verweisen.

Bei Ihnen sind möglicherweise die folgenden Inhaltsfragmentmodelle definiert:

  • Stadt
  • Unternehmen
  • Person
  • Auszeichnungen

Es scheint ziemlich einfach, aber natürlich hat eine Firma sowohl einen CEO als auch Mitarbeiter…und dies sind alles Leute, die jeweils als Person definiert sind.

Und eine Person kann eine Auszeichnung bekommen (oder vielleicht zwei).

  • Meine Firma – Firma
    • CEO – Person
    • Mitarbeiter – Person
      • Persönliche Auszeichnungen – Auszeichnung

Und das ist nur für den Einstieg. Je nach Komplexität kann eine Auszeichnung firmenspezifisch sein oder eine Firma könnte ihre Hauptverwaltung in einer bestimmten Stadt haben.

Die Repräsentation dieser Beziehungen kann mit Fragmentverweisen erreicht werden, so wie sie von Ihnen (dem Architekten), Ihrem Inhaltsautor und den Headless-Anwendungen verstanden werden.

Wie geht es weiter

Nachdem Sie nun die Grundlagen gelernt haben, lautet der nächste Schritt Erfahren Sie mehr über das Erstellen von Inhaltsfragmentmodellen in AEM. In diesem Abschnitt werden die verschiedenen verfügbaren Verweise vorgestellt und diskutiert und wie mit den Fragmentverweisen Strukturebenen erstellt werden – ein zentraler Bestandteil der Modellierung für Headless.

Zusätzliche Ressourcen

Auf dieser Seite