DocumentazioneExperience Cloud KCS

Query persistenti non disponibili nell’editor di AEM GraphQL per configurazioni non a livello di radice

Ultimo aggiornamento: 29 luglio 2026

Questo articolo spiega perché l’opzione per salvare le query persistenti non è disponibile nell’editor GraphQL di Adobe Experience Manager (AEM) quando si utilizza una configurazione non a livello di radice e fornisce i passaggi per risolvere il problema.

Descrizione description

Quando si utilizza l’editor di AEM GraphQL, l’opzione per il salvataggio delle query persistenti risulta mancante se i modelli per frammenti di contenuto e le impostazioni correlate sono memorizzati in una cartella di configurazione che non si trova al livello principale in /conf. Ad esempio, se i modelli per frammenti di contenuto si trovano in un percorso come /conf/dam/shared, questa configurazione non verrà visualizzata nel menu a discesa Usa schema GraphQL fornito da durante la creazione di un nuovo endpoint GraphQL. Solo le configurazioni a livello di radice che contengono sia Modelli per frammenti di contenuto che Impostazioni di Sites/WCM vengono riconosciute ed elencate come endpoint validi. Questo impedisce il salvataggio di query persistenti per configurazioni che non soddisfano questi criteri.

Ambiente

  • Adobe Experience Manager (tutte le versioni supportate)

Sintomi

  • L’opzione Salva per le query persistenti non è disponibile nell’editor di GraphQL.
  • La cartella di configurazione prevista non viene visualizzata nel menu a discesa Usa schema GraphQL fornito da durante la creazione di un nuovo endpoint GraphQL.
  • Non vengono visualizzati messaggi di errore specifici.

Causa

In AEM Sites GraphQL Admin Console sono elencate solo le configurazioni a livello di radice in /conf che contengono sia modelli di frammenti di contenuto (settings/dam/cfm) che impostazioni Sites/WCM (settings/wcm). Le configurazioni secondarie o le cartelle prive di queste impostazioni non vengono riconosciute come endpoint validi, impedendo in tal modo il salvataggio delle query persistenti.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Esamina la struttura di configurazione corrente:

    • Nel browser configurazioni di AEM, passa a /libs/granite/configurations/content/view.html/conf.

    • Identificare la cartella di configurazione in uso (ad esempio: /conf//shared).

  2. Verifica i requisiti di configurazione:

    • Verificare che la configurazione si trovi al livello principale in /conf (ad esempio: /conf/) e non come sottocartella (ad esempio /conf//shared).

    • Conferma che la configurazione contenga entrambi:

    • Modelli per frammenti di contenuto: settings/dam/cfm

    • Impostazioni Sites/WCM: settings/wcm (inclusi modelli, criteri o tipi di modelli)

  3. Ricrea la configurazione come cartella principale:

    • Creare una nuova configurazione a livello di radice in /conf (ad esempio: /conf/).

    • In questa nuova configurazione, sposta o ricrea i modelli per frammenti di contenuto e le impostazioni Sites/WCM. Questo può richiedere la copia dei nodi e delle impostazioni pertinenti dalla sottocartella alla nuova cartella principale utilizzando CRXDE Lite o il Browser configurazioni.

  4. Aggiorna selezione endpoint GraphQL:

    • Accedere a Sites GraphQL Admin Console all’indirizzo /libs/cq/graphql/sites/admin/content/console.html.

    • Verifica che la nuova configurazione a livello di radice venga visualizzata nel menu a discesa Usa schema GraphQL fornito da.

    • Procedi con la creazione e il salvataggio delle query persistenti in base alle esigenze.

  5. Dopo aver completato i passaggi precedenti, verifica che l’opzione Salva sia ora disponibile durante la creazione di query persistenti nell’editor di GraphQL.

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