DocumentaciónKCS de Experience Cloud

Las consultas persistentes no están disponibles en el editor GraphQL de AEM para configuraciones que no sean de nivel raíz

Última actualización: 29 de julio de 2026

En este artículo se explica por qué la opción para guardar consultas persistentes no está disponible en el editor de GraphQL de Adobe Experience Manager (AEM) al utilizar una configuración que no es de nivel raíz y se proporcionan los pasos para resolver el problema.

Descripción description

Al trabajar con el editor de GraphQL de AEM, falta la opción para guardar consultas persistentes si los modelos de fragmentos de contenido y la configuración relacionada se almacenan en una carpeta de configuración que no está en el nivel raíz bajo /conf. Por ejemplo, si los modelos de fragmentos de contenido se encuentran en una ruta como /conf/dam/shared, esta configuración no aparecerá en el menú desplegable Usar esquema de GraphQL proporcionado por al crear un nuevo extremo de GraphQL. Solo las configuraciones de nivel raíz que contienen tanto los modelos de fragmentos de contenido como la configuración de Sites/WCM se reconocen y enumeran como puntos de conexión válidos. Esto evita guardar consultas persistentes para configuraciones que no cumplen estos criterios.

Entorno

  • Adobe Experience Manager (todas las versiones compatibles)

Síntomas

  • La opción Guardar para consultas persistentes no está disponible en el editor de GraphQL.
  • La carpeta de configuración esperada no aparece en el menú desplegable Usar esquema de GraphQL proporcionado por al crear un nuevo extremo de GraphQL.
  • No se muestran mensajes de error específicos.

Causa

Admin Console de AEM Sites GraphQL solo enumera las configuraciones de nivel raíz en /conf que contienen los modelos de fragmentos de contenido (settings/dam/cfm) y la configuración de Sites/WCM (settings/wcm). Las subconfiguraciones o carpetas que carecen de esta configuración no se reconocen como puntos de conexión válidos, lo que impide que se guarden consultas persistentes.

Resolución resolution

Siga los pasos a continuación para resolver el problema:

  1. Revise la estructura de configuración actual:

    • En el Explorador de configuración de AEM, vaya a /libs/granite/configurations/content/view.html/conf.

    • Identifique la carpeta de configuración que está utilizando (por ejemplo: /conf//shared).

  2. Compruebe los requisitos de configuración:

    • Asegúrese de que la configuración esté en el nivel raíz bajo /conf (por ejemplo: /conf/), no como una subcarpeta (como /conf//shared).

    • Confirme que la configuración contiene:

    • Modelos de fragmento de contenido: settings/dam/cfm

    • Configuración de Sites/WCM: settings/wcm (incluidas plantillas, directivas o tipos de plantillas)

  3. Vuelva a crear la configuración como una carpeta de nivel raíz:

    • Cree una nueva configuración de nivel raíz en /conf (por ejemplo: /conf/).

    • Mueva o vuelva a crear los modelos de fragmentos de contenido y la configuración de Sites/WCM en esta nueva configuración. Esto puede implicar copiar los nodos y la configuración relevantes de la subcarpeta a la nueva carpeta de nivel raíz mediante CRXDE Lite o el Explorador de configuración.

  4. Actualizar selección de extremo de GraphQL:

    • Acceda a Admin Console de Sites GraphQL en /libs/cq/graphql/sites/admin/content/console.html.

    • Compruebe que la nueva configuración de nivel raíz aparezca en el menú desplegable Usar esquema de GraphQL proporcionado por.

    • Continúe creando y guardando las consultas persistentes, según sea necesario.

  5. Después de completar los pasos anteriores, confirme que la opción Guardar ya está disponible al crear consultas persistentes en el editor de GraphQL.

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