설명서

잘못된 핵심 구성 요소 데이터 레이어 구성으로 인해 배포가 실패합니다.

Last update: Wed May 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

/conf의 핵심 구성 요소 데이터 레이어 구성을 잘못된 노드 유형으로 만든 경우 변경 가능한 콘텐츠 설치 단계 동안 Adobe Experience Manager as a Cloud Service용 Cloud Manager 배포가 실패합니다. 구성 노드가 필수 enabled 속성을 지원하지 않는 cq:Page(으)로 만들어져 OakConstraint0004 제약 조건 위반 및 패키지 설치 오류가 발생합니다.

이 문제를 해결하려면 올바른 기본 유형을 사용하도록 구성 노드를 업데이트하고 필요한 속성을 설정한 다음 수정된 구성 패키지를 다시 배포합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service - 사이트

문제/증상

  • 배포 도중 Cloud Manager 파이프라인이 "변경 가능한 콘텐츠 설치 - 실패" 오류와 함께 실패합니다.
  • 변경 가능한 콘텐츠 작업은 cp2fm 변환 구성 패키지를 설치하는 동안 실패합니다. 예를 들면 다음과 같습니다.
    • /etc/packages/<group>/<site>-base-config-content-<version>-cp2fm-converted.zip
  • 파이프라인 로그에 다음 오류가 표시됩니다.
    • OakConstraint0004: /conf/<site>/sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig[ [ cq:Page] ] : No matching property definition found for enabled = true.
  • DataLayerConfig 노드가 cq:Page(으)로 만들어졌지만 cq:Page에서 enabled 속성을 정의하지 않아 제약 조건 위반 및 패키지 설치 오류가 발생합니다.

해결 방법 resolution

다음 단계에 따라 문제를 해결하십시오.

  1. jcr:primaryType=nt:unstructured을(를) 사용하도록 /conf/<site>/sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig의 노드를 업데이트하십시오. 자세한 내용은 핵심 구성 요소와 함께 Adobe 클라이언트 데이터 레이어 사용을 참조하세요.
  2. enabled=true을(를) nt:unstructured 노드에서 부울 속성으로 설정합니다.
  3. 구성 노드가 cq:Page(으)로 만들어지지 않고 페이지 템플릿 또는 페이지 구조를 사용하지 않는지 확인하십시오.
  4. 구성이 올바르게 참조되도록 /content/<site>/jcr:content에 sling:configRef=/conf/<site>이(가) 포함되어 있는지 확인하십시오.
  5. 이러한 수정 사항을 사용하여 기본 구성 콘텐츠 패키지를 다시 빌드합니다.
  6. 패키지를 다시 배포하고 변경 가능한 콘텐츠 설치 단계와 전체 배포가 완료되었는지 확인하십시오.

참고:

핵심 구성 요소 버전 2.9.0 이상에서는 Adobe 클라이언트 데이터 레이어가 핵심 구성 요소 클라이언트 라이브러리의 일부로 포함됩니다. 활성화하려면 /conf/<site>/sling:configs의 컨텍스트 인식 구성만 필요합니다. 별도의 데이터 레이어 구성 요소 설치 패키지는 필요하지 않습니다.

관련 읽기

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f