DokumentationExperience Cloud KCS

Persistierte Abfragen sind im AEM GraphQL-Editor für Konfigurationen außerhalb der Stammebene nicht verfügbar

Letzte Aktualisierung: 29. Juli 2026

In diesem Artikel wird erläutert, warum die Option zum Speichern persistenter Abfragen bei Verwendung einer Nicht-Root-Ebene-Konfiguration im GraphQL-Editor von Adobe Experience Manager (AEM) nicht verfügbar ist, und es werden Schritte zur Behebung des Problems beschrieben.

Beschreibung description

Bei der Arbeit mit dem AEM GraphQL-Editor fehlt die Option zum Speichern persistierter Abfragen, wenn Inhaltsfragmentmodelle und zugehörige Einstellungen in einem Konfigurationsordner gespeichert sind, der sich nicht auf der Stammebene unter /conf befindet. Wenn sich beispielsweise Inhaltsfragmentmodelle in einem Pfad wie /conf/dam/shared befinden, wird diese Konfiguration beim Erstellen eines neuen GraphQL-Endpunkts nicht in der Dropdown-Liste Verwenden GraphQL-Schemas von “” angezeigt. Nur Konfigurationen auf Stammebene, die sowohl Inhaltsfragmentmodelle als auch Sites-/WCM-Einstellungen enthalten, werden erkannt und als gültige Endpunkte aufgelistet. Dadurch wird verhindert, dass persistierte Abfragen für Konfigurationen gespeichert werden, die diese Kriterien nicht erfüllen.

Umgebung

  • Adobe Experience Manager (alle unterstützten Versionen)

Symptome

  • Die Speichern-Option für persistierte Abfragen ist im GraphQL-Editor nicht verfügbar.
  • Der erwartete Konfigurationsordner wird beim Erstellen eines neuen GraphQLEndpunkts nicht in der Dropdown-Liste Verwenden eines GraphQL-Schemas von“ angezeigt.
  • Es werden keine spezifischen Fehlermeldungen angezeigt.

Ursache

Die Admin Console von AEM Sites GraphQL listet nur Konfigurationen auf Stammebene unter /conf auf, die sowohl Inhaltsfragmentmodelle (settings/dam/cfm) als auch Sites-/WCM-Einstellungen (settings/wcm) enthalten. Unterkonfigurationen oder Ordner, die nicht über diese Einstellungen verfügen, werden nicht als gültige Endpunkte erkannt, was das Speichern persistenter Abfragen verhindert.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Überprüfen Sie Ihre aktuelle Konfigurationsstruktur:

    • Navigieren Sie im AEM-Konfigurationsbrowser zu /libs/granite/configurations/content/view.html/conf.

    • Identifizieren Sie den von Ihnen verwendeten Konfigurationsordner (zum Beispiel: /conf//shared).

  2. Überprüfen Sie die Konfigurationsanforderungen:

    • Stellen Sie sicher, dass sich Ihre Konfiguration auf der Stammebene unter /conf befindet (z. B.: /conf/) und nicht als Unterordner (z. B. /conf//shared).

    • Bestätigen Sie, dass die Konfiguration beides enthält:

    • Inhaltsfragmentmodelle: settings/dam/cfm

    • Sites-/WCM-Einstellungen: settings/wcm (einschließlich Vorlagen, Richtlinien oder Vorlagentypen)

  3. Erstellen Sie die Konfiguration als Stammordner neu:

    • Erstellen Sie unter /conf eine neue Stammkonfiguration (z. B.: /conf/).

    • Verschieben oder erstellen Sie Ihre Inhaltsfragmentmodelle und Sites-/WCM-Einstellungen unter dieser neuen Konfiguration. Dazu kann es erforderlich sein, die entsprechenden Knoten und Einstellungen mithilfe von CRXDE Lite oder dem Konfigurationsbrowser aus dem Unterordner in den neuen Stammordner zu kopieren.

  4. GraphQL-Endpunktauswahl aktualisieren:

    • Rufen Sie die Sites GraphQL Admin Console unter /libs/cq/graphql/sites/admin/content/console.html auf.

    • Stellen Sie sicher, dass Ihre neue Stammkonfiguration im Dropdown-Menü Verwenden eines GraphQL-Schemas von angezeigt wird.

    • Fahren Sie mit dem Erstellen und Speichern persistenter Abfragen fort.

  5. Nachdem Sie die oben genannten Schritte ausgeführt haben, vergewissern Sie sich, dass die Option Speichern jetzt verfügbar ist, wenn Sie im GraphQL-Editor persistierte Abfragen erstellen.

recommendation-more-help
experience-cloud-kcs-help-kbarticles