ドキュメントExperience Cloud KCS

ACS Commonsの機能はAdobe Experience Managerで利用できません

最終更新日： 2026年8月8日

Adobe Experience Managerでは、ACS AEM Commons モジュールが見つからない場合や、サポートされていないAPIの結果がBPA レポートに表示される場合があります。また、バージョンの互換性の問題により、機能が正しく動作しない場合があります。 これらの問題は、ACS Commonsがデプロイされていないか、サポートされていないAPIを使用しているか、互換性のないバージョンで実行されている場合に発生します。 この問題を修正するには、問題タイプを特定し、正しいACS Commons パッケージをデプロイし、サポートされていないAPIを更新し、互換性の要件を検証します。

説明 description

環境

Adobe Experience Manager as a Cloud Service （AEMaaCS）

問題/症状

  • ACS Commons モジュールが、Reports、Content Sync、MCP Consoleなど、AEM UIにありません。
  • /var/acs-commons/reportsまたは関連するフォルダーをAEMaaCSにデプロイできません。
  • BPA出力に、{“type”:“unsupported.asset.api”,“told”:“com.day.cq.dam.api.AssetManager.createAsset”}​などのサポートされていないAPIの結果が表示されます。
  • BPA レポートは、com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestorなど、サポートされていないACS Commons クラスにフラグを設定します。
  • パッケージマネージャーの検索バーに、ACS Commons パッケージが表示されません。

解決策 resolution

この問題を修正するには、次の手順に従います。

  1. BPA出力またはモジュールの動作を確認し、この問題を不足しているモジュール、バージョンの非互換性、サポートされていないAPI、またはデプロイメントフィルターの問題として分類します。
  2. UI要素の欠落、BPA エラー、デプロイメントエラーなど、カテゴリが観察された症状と一致することを確認します。
  3. /system/console/bundlesに移動し、acsを検索します。
  4. バンドルがアクティブ状態であることを確認します。
  5. ACS Commonsの依存関係をMaven プロジェクトに追加し、Cloud Serviceで必要なクラウド分類子を使用します
  6. AdobeのAPI削除ガイダンス ​で要求されているように、cloud分類子がAEMaaCSに使用されていることを確認してください
  7. 更新されたACS Commons バージョンをCloud Managerからデプロイします。
  8. デプロイメント後に/system/console/bundlesを再訪問し、ACS Commons バンドルがアクティブであることを確認します。
  9. デプロイメントが失敗した場合は、ACS フォルダーがGit リポジトリーに存在することを確認します。
  10. ACS Commons パッケージをACS Commons リリース ​からダウンロードし、/crx/packmgrにアップロードします。
  11. パッケージが正常にインストールされていることを確認します。
  12. バンドルがアクティブ状態であることを確認します。
  13. インストールが失敗した場合は、ACS Commons互換性マトリックスを確認します。
  14. 必要なACS Commons モジュールがデプロイされたコードに存在することを確認します。
  15. AEMaaCSで、ui.content/src/main/content/jcr_rootの下にあるGit リポジトリを確認します。
  16. /var/acs-commons/reportsがfilter.xmlに含まれていることを確認してください。
  17. CRX/DEでパスの可視性を確認します。
  18. モジュールが使用できない場合は、Git ブランチに必要なフォルダーが含まれていることを確認します。
  19. com.day.cq.dam.api.AssetManager.createAssetやcom.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestorなどの非推奨のAPI使用を特定します。
  20. unsupported.asset.api件の調査結果が表示されなくなったことを確認します。
  21. 調査結果が残る場合は、GitHubを通じてACS Commons メンテナに問題を記録します。
  22. AEMaaCS デプロイメントの場合は、Cloud Serviceでサポートされていないため、ランタイムの書き込みを/appsまたは/libsに行うモジュールがないことを確認してください。
  23. すべてのACS Commons コードがCloud Manager パイプラインを通じて正常にデプロイされていることを確認します。
  24. パイプラインログを確認し、デプロイメントが正常に完了したことを確認します。
  25. デプロイメントの問題が発生した場合は、filter.xmlを確認し、禁止されているパスをすべて削除してください。

関連トピックス

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