Headless-Bereitstellung von Inhalten mithilfe von Inhaltsfragmenten mit GraphQL

Mit Adobe Experience Manager (AEM) as a Cloud Service können Sie Inhaltsfragmente zusammen mit der AEM-GraphQL-API (eine auf GraphQL basierende benutzerdefinierte Implementierung) verwenden, um strukturierte Inhalte für Ihre Programme „headless“ bereitzustellen. Durch die Möglichkeit, eine einzelne API-Abfrage anzupassen, können Sie den spezifischen Inhalt, den Sie rendern möchten/benötigen (als Antwort auf die einzelne API-Abfrage), abrufen und bereitstellen.

HINWEIS

Eine Einführung in die Headless-Entwicklung für AEM Sites as a Cloud Service finden Sie unter Headless und AEM.

Headless-CMS

Ein Headless-Content-Management-System (CMS) ist:

  • Ein Headless-Content-Management-System oder Headless-CMS ist ein Backend-Content-Management-System (CMS), das von Grund auf als Content-Repository erstellt wurde und Inhalte über eine API für die Anzeige auf jedem Gerät zugänglich macht.

    Weitere Informationen finden Sie in Wikipedia.

In Bezug auf das Erstellen von Inhaltsfragmenten in AEM bedeutet dies Folgendes:

  • Sie können Inhaltsfragmente verwenden, um Inhalte zu erstellen, die nicht primär für die direkte Veröffentlichung (1:1) auf formatierten Seiten vorgesehen sind.

  • Der Inhalt Ihrer Inhaltsfragmente wird in einer vorgegebenen Art und Weise strukturiert – entsprechend den Inhaltsfragmentmodellen. Dies vereinfacht den Zugriff für Ihre Programme, die Ihre Inhalte weiterverarbeiten werden.

Ein Überblick über GraphQL

GraphQL ist:

  • … eine Abfragesprache für APIs und eine Laufzeitumgebung zur Erfüllung dieser Abfragen mit Ihren vorhandenen Daten.

    Weitere Informationen finden Sie unter GraphQL.org

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.

AEM-GraphQL-API

Für Adobe Experience as a Cloud Service wurde eine benutzerdefinierte Implementierung der Standard-GraphQL-API entwickelt. Weitere Informationen finden Sie unter AEM GraphQL-API zur Verwendung mit Inhaltsfragmenten.

Die Implementierung der AEM-GraphQL-API basiert auf den GraphQL-Java-Bibliotheken.

Inhaltsfragmente zur Verwendung mit der AEM-GraphQL-API

Inhaltsfragmente können als Grundlage für GraphQL-Abfragen für AEM verwendet werden:

  • Sie ermöglichen Ihnen das Entwerfen, Erstellen, Kuratieren und Veröffentlichen seitenunabhängiger Inhalte.
  • Die Inhaltsfragmentmodelle stellen mithilfe definierter Datentypen die erforderliche Struktur bereit.
  • Die Fragmentreferenz, die beim Definieren eines Modells verfügbar ist, kann zum Definieren zusätzlicher Strukturebenen verwendet werden.

Inhaltsfragmente zur Verwendung mit GraphQL

Inhaltsfragmente

Inhaltsfragmente:

  • enthalten strukturierten Inhalt,

  • basieren auf einem Inhaltsfragmentmodell, das die Struktur für das daraus entstehende Fragment vordefiniert.

Inhaltsfragmentmodelle

Diese Inhaltsfragmentmodelle:

  • werden verwendet, um die Schemas zu erzeugen, sobald sie aktiviert sind.

  • stellen die für GraphQL erforderlichen Datentypen und Felder bereit. Sie stellen sicher, dass Ihr Programm nur das anfordert, was möglich ist, und das erhält, was erwartet wird.

  • Der Datentyp Fragmentreferenzen kann in Ihrem Modell verwendet werden, um auf ein anderes Inhaltsfragment zu verweisen und so zusätzliche Strukturebenen einzuführen.

Fragmentreferenzen

Die Fragmentreferenz:

  • ist vor allem in Verbindung mit GraphQL von Interesse,

  • ist ein spezifischer Datentyp, der bei der Definition eines Inhaltsfragmentmodells verwendet werden kann,

  • verweist auf ein anderes Fragment, abhängig von einem bestimmten Inhaltsfragmentmodell,

  • ermöglicht Ihnen das Abrufen strukturierter Daten.

    • Wenn als multifeed definiert, können mehrere Unterfragmente vom primären Fragment referenziert (abgerufen) werden.

JSON-Vorschau

Als Hilfe beim Entwerfen und Entwickeln Ihrer Inhaltsfragmentmodelle können Sie eine Vorschau der JSON-Ausgabe anzeigen.

Verwendung von GraphQL mit AEM – Beispielinhalt und Abfragen

Eine Einführung in die Verwendung der AEM GraphQL-API finden Sie unter Verwendung von GraphQL mit AEM – Beispielinhalt und Abfragen.

Tutorial – Erste Schritte mit AEM Headless und GraphQL

Suchen Sie nach einem praktischen Tutorial? Lesen Sie das umfassende Tutorial Erste Schritte mit AEM Headless und GraphQL, in dem veranschaulicht wird, wie Inhalte mithilfe der GraphQL-APIs von AEM erstellt und verfügbar gemacht und von einem externen Programm in einem Headless CMS-Szenario verwendet werden.

Auf dieser Seite