설명서Experience Cloud KCS

지속 쿼리는 AEM GraphQL 편집기에서 루트 수준이 아닌 구성으로 사용할 수 없습니다.

마지막 업데이트: 2026년 7월 29일

이 문서에서는 루트 수준이 아닌 구성을 사용할 때 Adobe Experience Manager(AEM) GraphQL 편집기에서 지속 쿼리 저장 옵션을 사용할 수 없는 이유를 설명하고 문제 해결 단계를 제공합니다.

설명 description

AEM GraphQL 편집기로 작업할 때 콘텐츠 조각 모델 및 관련 설정이 /conf 아래의 루트 수준이 아닌 구성 폴더에 저장되어 있는 경우 지속 쿼리를 저장하는 옵션이 없습니다. 예를 들어 콘텐츠 조각 모델이 /conf/dam/shared과(와) 같은 경로에 있는 경우 새 GraphQL 끝점을 만들 때 이 구성은 다음에서 제공하는 GraphQL 스키마 사용 드롭다운에 표시되지 않습니다. 콘텐츠 조각 모델 및 Sites/WCM 설정이 모두 포함된 루트 수준 구성만 인식되며 유효한 끝점으로 나열됩니다. 이렇게 하면 이러한 기준을 충족하지 않는 구성에 대한 지속 쿼리가 저장되지 않습니다.

환경

  • Adobe Experience Manager (지원되는 모든 버전)

증상

  • GraphQL 편집기에서 지속 쿼리에 대한 저장 옵션을 사용할 수 없습니다.
  • 새 GraphQL 끝점을 만들 때 다음에서 제공하는 GraphQL 스키마 사용 드롭다운에 필요한 구성 폴더가 표시되지 않습니다.
  • 특정 오류 메시지가 표시되지 않습니다.

원인

AEM Sites GraphQL 관리 콘솔에는 콘텐츠 조각 모델(settings/dam/cfm)과 Sites/WCM 설정(settings/wcm)을 모두 포함하는 /conf의 루트 수준 구성만 나열됩니다. 이러한 설정이 없는 하위 구성 또는 폴더는 유효한 끝점으로 인식되지 않으므로 지속 쿼리가 저장되지 않습니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. 현재 구성 구조를 검토합니다.

    • AEM 구성 브라우저에서 /libs/granite/configurations/content/view.html/conf(으)로 이동합니다.

    • 사용 중인 구성 폴더를 식별합니다(예: /conf//shared).

  2. 구성 요구 사항 확인:

    • 구성이 하위 폴더(예: /conf//shared)가 아닌 /conf 아래의 루트 수준(예: /conf/)에 있는지 확인하십시오.

    • 구성에 다음 두 항목이 모두 포함되어 있는지 확인합니다.

    • 콘텐츠 조각 모델: settings/dam/cfm

    • Sites/WCM 설정: settings/wcm(템플릿, 정책 또는 템플릿 유형 포함)

  3. 구성을 루트 수준 폴더로 다시 만듭니다.

    • /conf 아래에 새 루트 수준 구성을 만듭니다(예: /conf/).

    • 이 새 구성에서 콘텐츠 조각 모델 및 Sites/WCM 설정을 이동하거나 다시 만듭니다. 여기에는 CRXDE Lite 또는 구성 브라우저를 사용하여 하위 폴더에서 새 루트 수준 폴더로 관련 노드 및 설정을 복사하는 작업이 포함될 수 있습니다.

  4. GraphQL 엔드포인트 선택 업데이트:

    • /libs/cq/graphql/sites/admin/content/console.html에서 Sites GraphQL 관리 콘솔에 액세스합니다.

    • 다음에서 제공하는 GraphQL 스키마 사용 드롭다운에 새 루트 수준 구성이 표시되는지 확인하십시오.

    • 필요에 따라 지속 쿼리를 만들고 저장하십시오.

  5. 위의 단계를 완료한 후 GraphQL 편집기에서 지속 쿼리를 만들 때 이제 저장 옵션을 사용할 수 있는지 확인하십시오.

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