DocumentaçãoKCS da Experience Cloud

Consultas persistentes indisponíveis no editor do AEM GraphQL para configurações sem nível raiz

Última atualização: 29 de julho de 2026

Este artigo explica por que a opção para salvar consultas persistentes não está disponível no editor do GraphQL do Adobe Experience Manager (AEM) ao usar uma configuração de nível não raiz e fornece etapas para resolver o problema.

Descrição description

Ao trabalhar com o editor do AEM GraphQL, a opção para salvar consultas persistentes estará ausente se os Modelos de fragmento de conteúdo e as configurações relacionadas forem armazenados em uma pasta de configuração que não esteja no nível raiz em /conf. Por exemplo, se os Modelos de fragmento de conteúdo estiverem localizados em um caminho como /conf/dam/shared, essa configuração não aparecerá no menu suspenso Usar esquema do GraphQL fornecido por ao criar um novo ponto de extremidade do GraphQL. Somente as configurações de nível raiz que contêm os modelos de fragmento de conteúdo e as configurações de Sites/WCM são reconhecidas e listadas como endpoints válidos. Isso evita salvar consultas persistentes para configurações que não atendem a esses critérios.

Ambiente

  • Adobe Experience Manager (todas as versões compatíveis)

Sintomas

  • A opção Salvar para consultas persistentes não está disponível no editor do GraphQL.
  • A pasta de configuração esperada não aparece na lista suspensa Usar esquema do GraphQL fornecido por ao criar um novo ponto de extremidade do GraphQL.
  • Nenhuma mensagem de erro específica é exibida.

Causa

O Admin Console do AEM Sites GraphQL lista apenas as configurações de nível raiz em /conf que contêm os Modelos de fragmento de conteúdo (settings/dam/cfm) e as configurações de Sites/WCM (settings/wcm). Subconfigurações ou pastas que não têm essas configurações não são reconhecidas como endpoints válidos, o que impede que consultas persistentes sejam salvas.

Resolução resolution

Siga as etapas abaixo para resolver o problema:

  1. Revise sua estrutura de configuração atual:

    • No Navegador de Configuração do AEM, navegue até /libs/granite/configurations/content/view.html/conf.

    • Identifique a pasta de configuração que você está usando (Por exemplo: /conf//shared).

  2. Verifique os requisitos de configuração:

    • Verifique se a configuração está no nível raiz em /conf (Por exemplo: /conf/), não como uma subpasta (como /conf//shared).

    • Confirme se a configuração contém ambos:

    • Modelos de fragmentos do conteúdo: settings/dam/cfm

    • Configurações de Sites/WCM: settings/wcm (incluindo modelos, políticas ou tipos de modelo)

  3. Recrie a configuração como uma pasta de nível raiz:

    • Criar uma nova configuração de nível raiz em /conf (Por exemplo: /conf/).

    • Mova ou recrie os modelos de fragmento de conteúdo e as configurações de Sites/WCM nesta nova configuração. Isso pode envolver copiar os nós e as configurações relevantes da subpasta para a nova pasta de nível raiz usando o CRXDE Lite ou o Navegador de configuração.

  4. Atualizar seleção de ponto de extremidade do GraphQL:

    • Acesse o Admin Console do Sites GraphQL em /libs/cq/graphql/sites/admin/content/console.html.

    • Verifique se a nova configuração de nível raiz aparece na lista suspensa Usar esquema GraphQL fornecido por.

    • Continue criando e salvando consultas persistentes, conforme necessário.

  5. Após concluir as etapas acima, confirme se a opção Salvar está disponível ao criar consultas persistentes no editor do GraphQL.

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