설명서Experience Cloud KCS

필요한 클라이언트 라이브러리가 누락된 경우 AEM PDF 뷰어가 비어 있습니다

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

필요한 클라이언트 라이브러리가 사이트 클라이언트 라이브러리 구성에 포함되지 않은 경우 AEM PDF 뷰어 구성 요소는 빈 컨테이너로 렌더링할 수 있습니다. AEM as a Cloud Service에서 PDF Viewer CA-config가 페이지 도메인과 일치하지 않는 클라이언트 ID를 사용하는 경우 렌더링이 실패할 수도 있습니다. 그 결과 구성 요소가 페이지에 있어도 뷰어가 작성자 또는 게시에서 올바르게 로드되지 않습니다. 필요한 PDF 뷰어 클라이언트 라이브러리를 임베드하고 CA-config 클라이언트 ID를 확인한 다음 두 환경에서 페이지를 다시 테스트합니다.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe Experience Manager 6.5 On-Premise

문제/증상

  • PDF 뷰어 구성 요소는 페이지에서 비어 있거나 빈 영역을 표시합니다.
  • 작성자 또는 게시에서 뷰어가 올바르게 로드되지 않습니다.
  • 필요한 PDF 뷰어 JavaScript 또는 CSS 파일이 브라우저에 로드되지 않습니다.
  • AEM as a Cloud Service에서는 구성 요소가 페이지에 구성된 후에도 뷰어가 실패합니다.

원인

core.wcm.components.pdfviewer.v1이(가) 사이트 clientlib-base에 포함되어 있지 않으므로 페이지에 필요한 PDF 뷰어 클라이언트 라이브러리가 없습니다. AEM as a Cloud Service에서 PdfViewerCaConfig 클라이언트 ID가 유효하지만 페이지를 여는 데 사용된 것과 다른 도메인에 매핑된 경우에도 렌더링이 실패할 수 있습니다.

해결 방법 resolution

클라이언트 라이브러리 누락으로 인해 빈 AEM PDF 뷰어 렌더링을 해결하려면 다음 단계를 수행합니다.

  1. /apps/<project>/clientlibs/clientlib-base에서 사이트 클라이언트 라이브러리를 엽니다.
  2. embed 속성을 확인하고 누락된 경우 core.wcm.components.pdfviewer.v1을(를) 추가합니다.
  3. 업데이트된 클라이언트 라이브러리 구성을 배포합니다. AEM as a Cloud Service의 경우 Cloud Manager을 통해 변경 사항을 배포합니다.
  4. AEMaaCS의 경우 /conf/<project>/sling:configs을(를) 열고 PdfViewerCaConfig에 페이지 액세스에 사용되는 정확한 도메인에 대한 올바른 clientId이(가) 있는지 확인하십시오.
  5. 페이지를 다시 로드하고 Author와 Publish 모두에서 PDF 뷰어를 테스트합니다.
  6. 브라우저 네트워크 탭을 확인하고 필요한 PDF 뷰어 JavaScript 및 CSS 파일이 로드되었는지 확인합니다.
  7. 클라이언트 라이브러리 임베드가 올바르고 뷰어가 계속 비어 있는 경우 Adobe 지원에 문의하여 페이지 URL, 브라우저 콘솔 로그 및 네트워크 추적을 공유하십시오.

관련 읽기

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