Schnellstartanleitung für Headless: Abrufen und Bereitstellen von Inhaltsfragmenten

Die Assets-REST-API ermöglicht die Verwaltung von Inhaltsfragmenten und die GraphQL-API ermöglicht die einfache Headless-Bereitstellung von Inhaltsfragmentinhalten.

Was sind GraphQL- und Assets-REST-APIs?

Nachdem Sie einige Inhaltsfragmente erstellt haben, können Sie die APIs von AEM verwenden, um sie headless bereitzustellen.

  • Mit der GraphQL-API können Sie Anfragen für den Zugriff auf und die Bereitstellung von Inhaltsfragmenten erstellen.
  • Mit der Assets-REST-API können Sie Inhaltsfragmente (und andere Assets) erstellen und ändern.

Der Rest dieses Handbuchs konzentriert sich auf den GraphQL-Zugriff und die Bereitstellung von Inhaltsfragmenten.

Bereitstellen eines Inhaltsfragments mit GraphQL

Informationsarchitekten müssen Abfragen für ihre Kanalendpunkte entwerfen, um Inhalte bereitzustellen. Diese Abfragen müssen in der Regel nur einmal pro Endpunkt und Modell berücksichtigt werden. Für die Zwecke dieser ersten Schritte müssen wir nur eine erstellen.

  1. Melden Sie sich bei AEM als Cloud Service an und greifen Sie auf die GraphiQL-Oberfläche zu:

    • Beispiel: https://<host>:<port>/content/graphiql.html.
  2. GraphiQL ist ein In-Browser-Abfrage-Editor für GraphQL. Sie können damit Abfragen zum Abrufen von Inhaltsfragmenten erstellen, um diese als JSON-Datei direkt bereitzustellen.

    • Im linken Bedienfeld können Sie Ihre Abfrage erstellen.

    • Im rechten Bedienfeld werden die Ergebnisse angezeigt.

    • Der Abfrage-Editor bietet Code-Vervollständigung und Hotkeys, um die Abfrage einfach auszuführen.

      GraphiQL-Editor

  3. Angenommen, das von uns erstellte Modell person wurde mit Feldern firstName, lastName und position aufgerufen. Wir können dann eine einfache Abfrage erstellen, um den Inhalt unseres Inhaltsfragments abzurufen.

    query 
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. Geben Sie die Abfrage in das linke Bedienfeld ein.
    GraphiQL-Abfrage

  5. Klicken Sie auf die Schaltfläche Abfrage ausführen oder verwenden Sie den Ctrl-Enter-Hotkey. Die Ergebnisse werden als JSON im rechten Bedienfeld angezeigt.
    GraphiQL-Ergebnisse

  6. Klicken Sie oben rechts auf der Seite auf den Link Dokumente, um eine kontextbezogene Dokumentation anzuzeigen, die Sie bei der Erstellung Ihrer Abfragen unterstützt und sich an Ihre eigenen Modelle anpasst.
    GraphiQL-Dokumentation

GraphQL ermöglicht strukturierte Abfragen, die nicht nur auf bestimmte Datensätze oder einzelne Datenobjekte abzielen, sondern auch bestimmte Elemente der Objekte und verschachtelte Ergebnisse bereitstellen, Unterstützung für Abfragevariablen bieten und vieles mehr.

GraphQL kann sowohl iterative API-Anfragen als auch Überbereitstellungen vermeiden und ermöglicht stattdessen eine Massenbereitstellung von genau dem, was zum Rendern als Antwort auf eine einzelne API-Abfrage benötigt wird. Das resultierende JSON kann verwendet werden, um Daten in anderen Sites oder Apps bereitzustellen.

Nächste Schritte

Das war´s! Sie haben nun ein grundlegendes Verständnis für das Headless-Content-Management in AEM. Natürlich gibt es viele weitere Ressourcen, mit deren Hilfe Sie sich ein umfassendes Verständnis der verfügbaren Funktionen aneignen können.

  • Konfigurations-Browser – Weitere Informationen zum AEM-Konfigurations-Browser
  • Inhaltsfragmente – Weitere Informationen zum Erstellen und Verwalten von Inhaltsfragmenten
  • Unterstützung von Inhaltsfragmenten in der AEM Assets-HTTP-API – Weitere Informationen zum direkten Zugriff auf AEM-Inhalte über die HTTP-API über CRUD-Vorgänge (Erstellen, Lesen, Aktualisieren, Löschen)
  • GraphQL-API – Weitere Informationen zum Headless-Bereitstellen von Inhaltsfragmenten

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free