ドキュメントExperience Cloud KCS

必要なクライアントライブラリが見つからない場合、AEM PDF ビューアは空白でレンダリングされます

最終更新日： 2026年6月30日

必要なクライアントライブラリがサイトクライアントライブラリ設定に含まれていない場合、AEM PDF Viewer コンポーネントは空のコンテナとしてレンダリングできます。 AEM as a Cloud Serviceでは、PDF Viewer 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では、コンポーネントをページに設定した後でも、ビューアが失敗します。

原因

core.wcm.components.pdfviewer.v1がサイト clientlib-baseに埋め込まれていないため、ページに必要なPDF Viewer クライアント ライブラリがありません。 AEM as a Cloud Serviceでは、PdfViewerCaConfig クライアント IDは有効ですが、ページを開くために使用されるドメインとは異なるドメインにマッピングされている場合、レンダリングが失敗する可能性があります。

解決策 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