Erstellen einer API-Anfrage – Headless-Einrichtung

Erfahren Sie, wie Sie die GraphQL-API für die Headless-Bereitstellung von Inhaltsfragmentinhalten und die Assets-REST-API von AEM zur Verwaltung von Inhaltsfragmenten verwenden.

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.

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

Aktivieren eines GraphQL-Endpunkts

Bevor die GraphQL-APIs verwendet werden können, muss ein GraphQL-Endpunkt erstellt werden.

  1. Navigieren Sie zu Instrumente, Allgemein, wählen Sie GraphQL.

  2. Wählen Sie Erstellen.

  3. Das Dialogfeld Neuen GraphQL-Endpunkt erstellen wird geöffnet. Hier können Sie Folgendes angeben:

    • Name: Name des Endpunkts; Sie können einen beliebigen Text eingeben.
    • GraphQL-Schema verwenden, das bereitgestellt wurde von: Verwenden Sie das Dropdown-Menü, um die gewünschte Konfiguration auszuwählen.
  4. Bestätigen Sie mit Erstellen.

  5. In der Konsole wird nun ein Pfad basierend auf der zuvor erstellten Konfiguration angezeigt. Dies ist der Pfad zum Ausführen von GraphQL-Abfragen.

    /content/cq:graphql/<configuration-name>/endpoint
    

Weitere Informationen zur Aktivierung von GraphQL-Endpunkten finden Sie hier.

Abfragen von Inhalten unter Verwendung von GraphQL mit GraphiQL

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.

GraphiQL ist eine IDE, die in Ihrer AEM-Umgebung enthalten ist. nach dem Öffnen Endpunkte konfigurieren.

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

    Sie können auf den Abfrageeditor wie folgt zugreifen:

    • Instrumente -> Allgemein -> GraphQL-Abfrage-Editor
    • direkt; Beispiel: http://localhost:4502/aem/graphiql.html
  2. Die GraphiQL-IDE ist ein In-Browser-Abfrage-Editor für GraphQL. Sie können sie verwenden, um Abfragen zum Abrufen von Inhaltsfragmenten zu erstellen, um sie Headless als JSON bereitzustellen.

    • In der Dropdown-Liste oben rechts können Sie den Endpunkt auswählen.
    • In einem Bereich ganz links werden die beibehaltenen Abfragen aufgelistet (sofern verfügbar)
    • Im mittleren linken Bereich können Sie Ihre Abfrage erstellen.
    • Die Ergebnisse werden im rechten mittleren Bereich 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 Mobile 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.

Auf dieser Seite