Schnellstartanleitung für Headless: Abrufen und Bereitstellen von Inhaltsfragmenten accessing-delivering-content-fragments

Erfahren Sie, wie Sie mit der AEM Assets REST-API Inhaltsfragmente verwalten und mit der GraphQL-API die Headless-Bereitstellung von Inhaltsfragmentinhalten durchführen können.

Was sind GraphQL- und Assets-REST-APIs? what-are-the-apis

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

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

Bereitstellen eines Inhaltsfragments mit GraphQL how-to-deliver-a-content-fragment

Informationsarchitektinnen und -architekten müssen Abfragen für ihre Kanalendpunkte entwerfen, um Inhalte bereitzustellen. Berücksichtigen Sie diese Abfragen nur einmal pro Endpunkt und Modell. Erstellen Sie für dieses Erste-Schritte-Handbuch nur eine.

  1. Melden Sie sich bei AEM an und rufen Sie die GraphiQL-Oberfläche auf:

    • Beispiel: http://<host>:<port>/aem/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 „headless“ 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 den Feldern firstName, lastName und position aufgerufen. Wir können dann eine einfache Abfrage erstellen, um den Inhalt unseres Inhaltsfragments abzurufen.

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

  5. Klicken Sie auf das Symbol Abfrage ausführen (Pfeil nach rechts) oder verwenden Sie das Tastaturkürzel Ctrl-Enter. Die Ergebnisse werden als JSON im rechten Bedienfeld angezeigt.
    GraphiQL-Ergebnisse

  6. Klicken Sie auf:

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

    • Verlauf in der oberen Symbolleiste, um frühere Abfragen anzuzeigen.

    • Wählen Sie Speichern unter und Speichern, um Ihre Abfragen zu speichern. Danach können Sie sie im Bedienfeld Persistierte Abfragen auflisten, abrufen und veröffentlichen.

      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 iterative API-Anfragen und zu häufige Bereitstellungen vermeiden. Stattdessen ermöglicht es Massenbereitstellung von genau dem, was zum Rendern als Antwort auf eine einzelne API-Anfrage benötigt wird. Das resultierende JSON kann verwendet werden, um Daten in anderen Sites oder Mobile Apps bereitzustellen.

Nächste Schritte next-steps

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2