설명서Experience Cloud KCS

AEM: DEV/STAGE/PROD에서 DITA 업그레이드 후 DAM Asset 미리보기 및 편집 실패

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

이 문서에서는 Adobe Experience Manager 환경의 DAM 에셋 미리보기 및 편집 기능 관련 문제를 해결합니다.

설명 description

환경


Adobe Experience Manager(AEM) (모든 버전)

문제/증상


AEM Assets 관리 UI에서 일부 이미지 미리 보기(예: 에셋 클릭)에 에셋이 잠시 표시될 수 있으며, 이후 미리 보기가 비어 있습니다. 이 문제는 일반적으로 특정 에셋으로 제한되지만 동일한 환경의 다른 에셋은 정상적으로 미리 보기를 계속할 수 있습니다.

영향을 받는 에셋에 대한 브라우저 네트워크 추적은 다음과 유사한 Dynamic Media 뷰어 요청 실패를 표시합니다.

GET /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse

요청은 다음을 반환합니다.

HTTP 404
No preview server defined for root ID referenced in net path

관련 AEM 로그에는 다음이 포함될 수 있습니다.

Unable to forward request for root [ content] , no preview servlet defined for [ content]

해결 방법 resolution

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

  1. 영향을 받는 자산의 Dynamic Media 메타데이터를 검사합니다 자산 메타데이터 노드를 열고 아래의 다음 속성을 확인하십시오.

    code language-none 
    /content/dam/<asset-path>/jcr:content/metadata

    다음 필드를 구체적으로 확인하십시오.

    • dam:scene7FileStatus
    • dam:scene7File
    • dam:scene7ID
    • dam:scene7Domain
    • dam:scene7CloudConfigPath
    • dam:scene7APIServer
    • dam:scene7Type

    정상적인 자산은 일반적으로 다음을 포함해야 합니다.

    • dam:scene7FileStatus = PublishComplete
    • dam:scene7File 채워짐
    • dam:scene7ID 채워짐

  2. 작업 에셋과 비교 가능한 경우 실패한 에셋을 미리 보는 동일한 환경의 다른 이미지와 비교합니다. 대부분의 경우 실패한 자산에 하나 이상의 필수 dam:scene7* 속성이 없거나 dam:scene7FileStatus이(가) 다음과 같이 정상이 아닌 값으로 설정됩니다.

    • NeedsReupload
    • PublishIncomplete
    • UploadFailed
    • UploadStart
    • ReprocessStart

  3. 영향을 받는 에셋을 다시 업로드하거나 재처리합니다. 에셋을 다시 업로드하거나 재처리하면 AEM/Dynamic Media가 누락된 Scene7 링크 메타데이터를 다시 생성합니다. 검증된 사례에서 재업로드를 수행하면 에셋이 다음에서 변경되었습니다.

    • dam:scene7FileStatus = NeedsReupload
    • dam:scene7File 누락
    • dam:scene7ID 누락

    건강한 상태로 만들기:

    • dam:scene7FileStatus = PublishComplete
    • 채워진 dam:scene7File
    • 채워진 dam:scene7ID

  4. 에셋이 콘텐츠 복사, 패키지 설치 또는 마이그레이션에 의해 도입된 경우 대상 환경에서 영향을 받는 에셋을 다시 처리합니다 다른 환경에서 복사된 Assets은 오래되거나 불완전한 Dynamic Media 메타데이터를 유지하거나 대상 환경에서 일반적인 Dynamic Media 수집을 건너뛸 수 있습니다. 대상 환경에서 다시 업로드하거나 다시 처리하면 올바른 로컬 dam:scene7* 메타데이터가 다시 생성됩니다.

  5. 다시 업로드 또는 재처리 후 미리 보기 복구 유효성 검사:

    • 자산 세부 정보에서 자산 미리 보기가 작동하는지 확인하십시오.
    • 자산이 다음에 대해 실패한 미리 보기 요청을 더 이상 발행하지 않는지 확인:
    code language-none 
    /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse
    • dam:scene7File에서 유효한 Scene7 핸들을 사용하여 에셋이 확인되는지 확인합니다.

  6. 대량 영향을 받으려면 상태별로 유사한 자산을 식별하십시오 여러 자산이 영향을 받는 경우 비정상 dam:scene7FileStatus 값이 있는 자산을 쿼리하고 전체 DAM 트리가 아닌 해당 하위 집합을 다시 처리합니다.

원인

이 문제는 영향을 받는 자산이 완료되지 않았거나 오래된 Dynamic Media 동기화 상태에 있기 때문에 발생합니다. 이 조건에서는 에셋이 AEM에 존재하지만 에셋 세부 사항 미리 보기 해상도에 필요한 올바른 Scene7 연결 메타데이터가 없습니다. 예: dam:scene7File, dam:scene7ID 또는 정상적인 dam:scene7FileStatus.

따라서 자산 세부 정보에서 올바른 Scene7 자산 핸들 대신 /content/dam/... 아래의 저장소 경로를 사용하여 Dynamic Media 미리 보기를 로드하려고 시도하지만 미리 보기 요청이 실패하여 미리 보기 영역이 비어 있습니다.

이 상태는 일반적으로 다음과 같은 경우에 도입됩니다.

  • Dynamic Media 동기화/업로드가 완전히 완료되지 않았습니다.
  • 자산이 다른 환경에서 복사되거나 마이그레이션되었습니다.
  • 오래된 dam:scene7* 메타데이터가 다른 환경에서 이월되었습니다.
  • 마이그레이션 또는 콘텐츠 복사 후 대상 환경에서 자산이 완전히 재처리되지 않았습니다.
recommendation-more-help
experience-cloud-kcs-help-kbarticles