文件Experience Cloud KCS

遺失必要的使用者端資料庫時，AEM PDF Viewer會呈現空白

最後更新： 2026年6月30日

當網站使用者端程式庫設定中未包含所需的使用者端程式庫時，AEM PDF Viewer元件可呈現為空白容器。 在AEM as a Cloud Service中，如果PDF檢視器CA-config使用不符合頁面網域的使用者端ID，演算也會失敗。 因此，即使元件出現在頁面上，檢視器仍無法在「作者」或「發佈」中正確載入。 內嵌必要的PDF Viewer使用者端程式庫，驗證CA-config使用者端ID，並在兩個環境中重新測試頁面。

說明 description

環境

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • 內部部署的Adobe Experience Manager 6.5

問題/症狀

  • PDF Viewer元件會在頁面上顯示空白或空白區域。
  • 檢視器無法在「作者」或「發佈」中正確載入。
  • 必要的PDF檢視器JavaScript或CSS檔案不會在瀏覽器中載入。
  • 在AEM as a Cloud Service中，即便在頁面上設定元件後，檢視器也會失敗。

原因

頁面缺少必要的PDF Viewer使用者端資料庫，因為core.wcm.components.pdfviewer.v1未內嵌在網站clientlib-base中。 在AEM as a Cloud Service中，當PdfViewerCaConfig使用者端識別碼有效但對應到與用來開啟頁面的網域不同的網域時，轉譯也會失敗。

解決方法 resolution

若要解決遺失使用者端程式庫所導致的空白AEM PDF Viewer轉譯，請遵循下列步驟：

  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. 重新載入頁面，並在「作者」和「發佈」中測試PDF Viewer 。
  6. 檢查瀏覽器網路標籤，並確認必要的PDF Viewer JavaScript和CSS檔案現在已成功載入。
  7. 如果使用者端程式庫內嵌正確且檢視器仍呈現空白，請聯絡Adobe支援並共用頁面URL、瀏覽器主控台記錄及網路追蹤。

相關閱讀

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