설명서Experience Cloud KCS

AEM이 EDS 콘텐츠 소스일 때의 유니버설 편집기 액세스 및 구성 문제 해결

마지막 업데이트: 2026년 6월 21일

Edge Delivery Services(EDS)가 AEM을 컨텐츠 소스로 사용하는 경우 작성자는 유니버설 편집기 내에서 예상 메타데이터 필드, 블록 구성 값, 템플릿 변형 또는 JSON 데이터를 볼 수 없습니다. EDS 프로젝트는 하나의 기본 콘텐츠 소스만 지원하며, BYOM(Bring Your Own Model) 모델은 유니버설 편집기에 메타데이터를 명시적으로 노출해야 하고, 동적 필드 채우기에는 사용자 지정 유니버설 편집기 확장이 필요하며, JSON 또는 구성 데이터는 EDS 저장소, 구조화된 콘텐츠 또는 DAM 매핑을 통해 의도적으로 노출해야 하는 경우 거의 항상 아키텍처 또는 구성이 일치하지 않기 때문입니다. 작성 모드를 확인하고, 단일 소스 규칙을 적용하고, 필요한 메타데이터 및 데이터를 노출하면 누락된 편집기 필드가 복원됩니다.

설명 description

문제: AEM이 EDS 콘텐츠 소스일 때 유니버설 편집기는 메타데이터, 블록 필드 또는 JSON 데이터를 표시하지 않습니다

설명

Edge Delivery Services(EDS) 및 유니버설 편집기(UE)를 사용하여 작업할 때 작성자가 편집기 내에서 예상 메타데이터 필드, 블록 구성 값, 템플릿 변형 또는 JSON 데이터를 볼 수 없습니다. 페이지가 UE에서 올바르게 로드되지 않거나 작성자가 페이지 수준 메타데이터, 동적 필드 또는 블록 옵션을 구성할 수 없습니다. 다른 경우 고객은 단일 EDS 프로젝트 내에서 범용 편집기 및 문서 기반 작성을 혼합하거나 동일한 fstab.yaml 내에서 여러 콘텐츠 소스를 구성하는 것과 같이 지원되지 않는 아키텍처 패턴을 시도합니다. 이러한 구성 오류로 인해 일관되지 않은 렌더링, 메타데이터 누락, 특정 작성 인터페이스 사용 불가 또는 AEM의 필수 입력을 소비하지 못하는 블록이 발생합니다.

환경:

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services
  • AEM as a Cloud Service - 사이트
  • Edge Delivery Services (EDS)
  • 유니버설 편집기

문제/증상:

  • 범용 편집기가 로드되지만 메타데이터 필드 또는 블록 구성 필드가 표시되지 않고 오류가 표시되지 않습니다.
  • BYOM에서 페이지 수준 또는 블록 수준 메타데이터가 누락되어 블록을 렌더링하지 못했습니다.
  • 작성자는 하나의 EDS 프로젝트에서 문서 기반 작성과 UE 작성을 모두 수행해야 하지만 하나의 소스만 인식됩니다.
  • 파일이 DAM 또는 GitHub에 있어도 사용자 지정 JSON 또는 구성 데이터는 유니버설 편집기 내에서 사용할 수 없습니다.
  • 블록에 대한 동적 대화 상자/드롭다운 옵션이 UE에 채워지지 않습니다.

근본 원인:

EDS와 Universal Editor는 엄격한 아키텍처 모델을 따릅니다. 단일 EDS 프로젝트에는 기본 콘텐츠 소스가 하나만 있으며, BYOM 모델은 메타데이터를 유니버설 편집기에 명시적으로 노출해야 하고, 동적 필드 채우기에는 사용자 지정 유니버설 편집기 확장이 필요하며, JSON 또는 기타 구성 데이터를 EDS 저장소, 구조화된 콘텐츠 또는 DAM 매핑을 통해 의도적으로 노출해야 합니다. 이러한 영역을 잘못 구성하면 메타데이터가 누락되거나 구성 데이터에 액세스할 수 없거나 하이브리드 설정이 지원되지 않습니다.

확인하는 방법

  1. 프로젝트에서 범용 편집기, 문서 기반 또는 둘 다 중 어떤 작성 모드를 사용하여 범용 편집기가 활성화되어 있고 해당 페이지에 대해 작동할 것으로 예상되는지 확인합니다. 명확하지 않은 경우 UE에서 열고 있는 정확한 URL을 캡처합니다.
  2. fstab.yaml 또는 프로젝트 요구 사항을 검토하여 EDS 프로젝트가 하나의 기본 콘텐츠 소스만 사용하는지, 그리고 설치 프로그램이 하나의 프로젝트에서 AEM 및 문서 기반 소스를 혼합하려고 하는지 확인하십시오.
  3. 기본 page-metadata 모델 및 템플릿별 모델을 포함하여 UE 작성에 필요한 페이지 수준 메타데이터가 BYOM을 통해 표시되는지 확인합니다. 템플릿이 필요한 경우 template = page-type​이(가) 페이지 메타데이터에 저장되어 있는지 확인하십시오.

해결 방법 resolution

  1. 단일 콘텐츠 소스 규칙을 적용합니다. EDS는 프로젝트당 하나의 주요 콘텐츠 소스를 지원합니다. 프로젝트에서 AEM 및 문서 기반 작성과 같은 소스를 혼합하는 경우 두 개의 별도 EDS 사이트를 만들고 CDN 라우팅을 사용하여 소스 간에 트래픽을 보냅니다. 단일 리포지토리에서 기본 하이브리드 UE와 문서 기반 작성은 지원되지 않습니다.

  2. BYOM을 통해 UE 작성에 필요한 메타데이터를 노출합니다. 기본 page-metadata 모델이 있는지 확인하고 필요한 경우 템플릿별 메타데이터 모델을 정의합니다. AEM 페이지 속성이 블록에 필요한 template 메타데이터 값을 표시하는지 확인하십시오.

  3. 작성자 편집 가능 또는 정적 여부에 따라 사용자 지정 JSON 또는 구성 데이터 표시:

    • 데이터를 작성자가 편집할 수 있는 경우 EDS 구조화된 콘텐츠를 사용하고 스키마를 정의합니다.
    • 데이터가 정적인 경우 JSON을 EDS 저장소 또는 명시적 매핑으로 AEM DAM에 저장합니다.

UE와 블록이 데이터를 가져올 수 있도록 결과 엔드포인트 URL이 접근 가능한지 확인하십시오.
​4. 동적 드롭다운 또는 필드 모집단을 올바르게 처리합니다. EDS는 Granite UI 데이터 소스를 지원하지 않으므로 동적 드롭다운 옵션을 이러한 방식으로 로드할 수 없습니다. 대신, 사용자 지정 필드 및 클라이언트측 API 호출과 함께 범용 편집기 확장성을 사용하십시오. 이 경우 UE 확장을 구현해야 합니다.
​5. 여러 페이지 템플릿이 필요한 사이트의 템플릿 및 블록 동작을 확인합니다. 관련 AEM 페이지를 템플릿으로 사용(으)로 표시하고 스타일을 지정할 템플릿 메타데이터(CSS 클래스)를 설정하십시오. 템플릿에서 페이지를 만들고 올바른 초기 컨텐츠 및 메타데이터를 전달하는지 확인합니다.

유효성 검사

  1. 유니버설 편집기에서 페이지를 열고 필요한 모든 메타데이터 필드와 블록 구성 필드가 표시되는지 확인합니다.
  2. .page 도메인에서 페이지를 로드하고 동적 메타데이터 또는 JSON 데이터가 페이지 헤드로 렌더링되는지 확인합니다.
  3. JSON 끝점에 대한 fetch() 호출이 예상 콘텐츠를 반환하는지 확인합니다.
  4. 다시 게시한 후 다이내믹 구성 렌더링을 사용하여 블록을 확인합니다.

관련 읽기

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