설명서Experience Cloud KCS

AEM as a Cloud Service: 사용자 지정 컨텐츠 조각 속성을 새 Assets UI에서 검색할 수 있도록 설정

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

이 문서에서는 사용자 지정 콘텐츠 조각 속성을 Adobe Experience Manager as a Cloud Service의 새 Assets UI에서 검색할 수 있도록 만드는 데 필요한 단계에 대해 설명합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS) (모든 버전)

증상

  • 일부 필드는 클래식 DAM Assets 관리 UI에서 검색할 수 있지만, 콘텐츠 조각에 추가된 사용자 지정 속성은 새 Assets UI(Assets 보기)에서 검색할 수 없습니다.
  • 사용자 지정 콘텐츠 조각 필드는 사용자 지정 Lucene 인덱스로 인덱싱되며, 클래식 Assets 관리 UI를 통해 검색할 수 있습니다.
  • 동일한 필드가 새 Assets UI에서 사용 가능한 검색 필드 또는 필터로 표시되지 않습니다.
  • 필드 추가, 속성 유형 변경, 증폭 또는 색인 재지정과 같은 인덱스 구성을 조정하려고 해도 새 Assets UI에 대한 문제가 해결되지 않습니다.
  • 특정 오류 메시지는 표시되지 않지만 사용자 지정 콘텐츠 조각 속성에 대한 예상 검색/필터 기능이 없습니다.

원인

새 Assets UI는 Lucene 인덱스에 포함할 뿐만 아니라 검색 가능한 속성 인덱스를 통해 사용자 지정 속성을 노출해야 하는 다른 검색 메커니즘을 사용합니다. 이 구성이 없으면 사용자 지정 콘텐츠 조각 속성을 새 Assets UI에서 검색할 수 없습니다.

해결 방법 resolution

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

  1. 검색 아키텍처 검토: 클래식 Assets 관리 UI는 Oak/Lucene 인덱스에 대해 직접 QueryBuilder를 사용하는 반면, 새 Assets UI는 AEM 저장소 API(R-API) 및 검색 가능한 속성 색인에 의존합니다. search:indexed: true(으)로 노출된 속성만 검색 및 필터링에 사용할 수 있습니다.
  2. Lucene 인덱스 구성 확인: 사용자 지정 콘텐츠 조각 속성이 사용자 지정 Lucene 인덱스 오버레이에 포함되어 있는지 확인합니다. 속성이 Long 유형인 경우 해당 속성을 String 유형으로 변경하거나 사용자 지정 인덱스 오버레이에 Long 속성을 명시적으로 포함하십시오.
  3. 검색 가능한 속성 인덱스의 속성 표시: 필요한 사용자 지정 속성을 검색 가능한 속성 인덱스 구성에 추가하여 새 Assets UI에서 검색 필드 및 필터로 표시되도록 합니다. Assets 보기 필터에서 사용할 수 있는 속성은 jcr:content/metadata/... 아래에 있어야 합니다. jcr:content/data/...의 속성은 이 용도로 지원되지 않습니다.
  4. 구성 변경 후 다시 인덱싱: 인덱스 구성 및 검색 가능한 속성 인덱스를 업데이트한 후 다시 인덱스를 트리거하여 변경 사항이 적용되도록 합니다.
  5. 새 Assets UI에서 유효성 검사: 이제 사용자 지정 속성이 새 Assets UI에서 사용 가능한 검색 필드 및 필터로 표시되는지 확인합니다. 검색 기능을 테스트하여 예상대로 속성을 검색할 수 있도록 합니다.
recommendation-more-help
experience-cloud-kcs-help-kbarticles