DocumentationExperience Cloud KCS

Fonctionnalités ACS Commons non disponibles dans Adobe Experience Manager

Dernière mise à jour : 8 août 2026

Dans Adobe Experience Manager, les modules ACS AEM Commons peuvent être manquants, des résultats d’API non pris en charge peuvent apparaître dans les rapports BPA ou des problèmes de compatibilité de version peuvent empêcher les fonctionnalités de fonctionner correctement. Ces problèmes se produisent lorsque ACS Commons n’est pas déployé, utilise des API non prises en charge ou s’exécute sur des versions incompatibles. Pour résoudre ce problème, identifiez le type de problème, déployez le package ACS Commons approprié, mettez à jour les API non prises en charge et validez les exigences de compatibilité.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problème/Symptômes

  • Les modules ACS Commons sont absents de l’interface utilisateur d’AEM, tels que les rapports, la synchronisation de contenu ou la console MCP.
  • Le déploiement des dossiers /var/acs-commons/reports ou connexes échoue sur AEMaaCS.
  • La sortie BPA affiche les résultats d’API non pris en charge, tels que {« type »:« unsupported.asset.api »,« told »:« com.day.cq.dam.api.AssetManager.createAsset »}.
  • Les rapports BPA signalent les classes ACS Commons non prises en charge, telles que com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
  • La barre de recherche du gestionnaire de packages n’affiche pas le package ACS Commons .

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

  1. Passez en revue la sortie BPA ou le comportement du module et classifiez le problème comme un module manquant, une incompatibilité de version, une API non prise en charge ou un problème de filtre de déploiement.
  2. Vérifiez que la catégorie correspond aux symptômes observés, tels que des éléments d’interface utilisateur manquants, des erreurs BPA ou des échecs de déploiement.
  3. Accédez à /system/console/bundles et recherchez des acs.
  4. Vérifiez que les lots sont à l’état Actif .
  5. Ajoutez des dépendances ACS Commons à votre projet Maven et utilisez le classificateur cloud requis par Cloud Service
  6. Assurez-vous que le classificateur cloud est utilisé pour AEMaaCS, comme l’exige le guide de suppression de l’API ​ d’Adobe
  7. Déployez la version mise à jour d’ACS Commons via Cloud Manager.
  8. Revenez /system/console/bundles après le déploiement et confirmez que les lots ACS Commons sont actifs.
  9. Si le déploiement échoue, vérifiez que les dossiers ACS existent dans le référentiel Git.
  10. Téléchargez le package ACS Commons à partir de versions d’ACS Commons et chargez-le vers /crx/packmgr.
  11. Vérifiez que le package s’installe correctement.
  12. Vérifiez que les lots sont à l’état Actif .
  13. Si l’installation échoue, consultez la matrice de compatibilité d’ACS Commons .
  14. Vérifiez que les modules ACS Commons requis existent dans le code déployé.
  15. Dans AEMaaCS, passez en revue le référentiel Git sous ui.content/src/main/content/jcr_root.
  16. Vérifiez que /var/acs-commons/reports est inclus dans filter.xml.
  17. Vérifiez CRX/DE pour la visibilité du chemin d’accès.
  18. Si les modules ne sont toujours pas disponibles, vérifiez que la branche Git contient les dossiers requis.
  19. Identifier l’utilisation obsolète de l’API comme com.day.cq.dam.api.AssetManager.createAsset ou com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
  20. Vérifiez que unsupported.asset.api résultats n’apparaissent plus.
  21. Si les résultats persistent, consignez un problème avec les responsables de la maintenance d’ACS Commons via GitHub.
  22. Pour les déploiements AEMaaCS, assurez-vous qu’aucun module ne tente d’effectuer des écritures d’exécution sur /apps ou /libs, car ces chemins d’accès ne sont pas pris en charge dans Cloud Service.
  23. Vérifiez que tout le code ACS Commons est déployé avec succès via les pipelines Cloud Manager.
  24. Vérifiez les journaux du pipeline et confirmez que le déploiement s’est terminé avec succès.
  25. Si des problèmes de déploiement se produisent, passez en revue les filter.xml et supprimez tous les chemins interdits.

Lecture connexe

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