ドキュメントExperience Cloud KCS

ACS Commons アセットおよびMCP レポートのAEM環境でのエラー

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

Adobe Experience Manager（AEM） ACS Commons レポートの生成は、アセットレポート、MCP レポート、またはReport Builder ダッシュボードでエラー、空のダウンロード、または空の結果が返された場合に失敗します。 この問題は、古いACS Commonsのバージョン、バンドルの欠落、または誤って設定されたレポート定義がレポート実行に影響を与えたことが原因で発生します。 この問題を解決するには、バージョンをアップグレードし、バンドルを検証して、設定を修正します。

説明 description

環境

Adobe Experience Manager as a Cloud Service （AEMaaCS）

問題/症状

  • エラーを表示します：java.lang.NoSuchMethodError: org.apache.poi.xssf.usermodel.XSSFColor.< レポート生成中にinit> （Ljava/awt/Color;） V。
  • レポートの実行中に​ TooManyCallsException ​を表示するか、空のレポート結果を返します。
  • ACS Commons Report Builder ダッシュボードを/apps/acs-commons/content/reports.htmlに読み込めませんでした。
  • MCPで生成されたレポートファイルをダウンロードできないか、空白のExcel/CSV ファイルを返します。
  • レポートダッシュボードまたは実行エンドポイントにアクセスする際のエラーページにリダイレクトします。

根本原因

この問題は、古いACS Commons バージョンで互換性のないApache POI APIが使用されている場合、または必要なReport Builder バンドルが見つからないか非アクティブな場合に発生します。 誤って設定されたレポート定義、不完全な依存関係、またはシステム制限を超える複雑なクエリも、NoSuchMethodError、空の結果、実行例外などのエラーにつながります。

解決策 resolution

次の手順に従って、障害タイプを特定し、ACS Commons レポートの問題を解決します。

  1. AEM ログを確認し、NoSuchMethodError、XSSFColor、TooManyCallsException​などのエラーを見つけることで、エラーの種類を特定します。
  2. 検出されたエラーを、バージョンの非互換性、バンドルの欠落、空の結果、実行制限などのシナリオにマッピングして、問題を分類します。
  3. ACS Commonsをバージョン 6.0.14以降にアップグレードし、Cloud Manager パイプラインを通じてアップデートをデプロイすることで、バージョン関連のエラーを解決します。
  4. /system/console/bundlesのACS Commons Report Builder バンドルを確認し、依存関係の問題なくアクティブであることを確認して、バンドルのデプロイメントを検証します。
  5. 環境内にアセットが存在することを確認し、選択したレポートパスと設定が正しいことを確認して、空のレポート結果を修正します。
  6. 複雑なレポートクエリを処理するために、該当する場合はsling.max.callsしきい値を増やして、実行の制限に対処します。
  7. レポートを再実行し、正常にダウンロードされたことを確認し、ダッシュボードが正しく読み込まれることを確認し、レポートデータが期待どおりに表示されることを確認して、解決を検証します。

エスカレーションするタイミング

  • ACS Commonsをアップグレードし、バンドルのアクティベーションを検証した後も、この問題は解決しません。
  • 正しい設定とデータの可用性にもかかわらず、レポートの生成は失敗し続けます。
  • すぐに使用できるAEM アセットレポートは、生成またはダウンロードに失敗します。
  • このエラーは、ACS Commons設定を超えるシステム レベルの問題を示します。

関連トピックス

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