DokumentationExperience Cloud KCS

In Adobe Experience Manager nicht verfügbare ACS Commons-Funktionen

Letzte Aktualisierung: 8. August 2026

In Adobe Experience Manager fehlen möglicherweise ACS AEM Commons-Module, nicht unterstützte API-Ergebnisse werden möglicherweise in BPA-Berichten angezeigt oder Versionskompatibilitätsprobleme können Funktionen daran hindern, ordnungsgemäß zu funktionieren. Diese Probleme treten auf, wenn ACS Commons nicht bereitgestellt wird, nicht unterstützte APIs verwendet oder auf inkompatiblen Versionen ausgeführt wird. Um dieses Problem zu beheben, identifizieren Sie den Problemtyp, stellen Sie das richtige ACS Commons-Paket bereit, aktualisieren Sie nicht unterstützte APIs und validieren Sie die Kompatibilitätsanforderungen.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problem/Symptome

  • In der AEM-Benutzeroberfläche fehlen ACS Commons-Module wie Reports, Content Sync oder MCP Console.
  • /var/acs-commons/reports oder verwandte Ordner können nicht für AEMaaCS bereitgestellt werden.
  • Die BPA-Ausgabe zeigt nicht unterstützte API-Ergebnisse wie {„type“:„unsupported.asset.api“,„told“:“com.day.cq.dam.api.AssetManager.createAsset“}.
  • BPA-Berichte kennzeichnen nicht unterstützte ACS Commons-Klassen wie com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
  • In der Package Manager-Suchleiste wird das ACS Commons-Paket nicht angezeigt.

Lösung resolution

Gehen Sie wie folgt vor, um dieses Problem zu beheben:

  1. Überprüfen Sie das Verhalten der BPA-Ausgabe oder des Moduls und klassifizieren Sie das Problem als fehlendes Modul, Versionsinkompatibilität, nicht unterstützte API oder Bereitstellungsfilterproblem.
  2. Vergewissern Sie sich, dass die Kategorie den beobachteten Symptomen entspricht, z. B. fehlende UI-Elemente, BPA-Fehler oder Bereitstellungsfehler.
  3. Navigieren Sie zu /system/console/bundles und suchen Sie nach acs.
  4. Stellen Sie sicher, dass sich die Pakete im Status Aktiv befinden.
  5. Fügen Sie Ihrem Maven-Projekt ACS Commons-Abhängigkeiten hinzu und verwenden Sie den für Cloud Service erforderlichen Cloud-Klassifikator
  6. Stellen Sie sicher, dass der cloud-Klassifikator für AEMaaCS verwendet wird, wie in der (APIEntfernungsanleitung von Adobe erforderlich
  7. Stellen Sie die aktualisierte ACS Commons-Version über Cloud Manager bereit.
  8. Gehen Sie nach der Bereitstellung erneut zu /system/console/bundles und überprüfen Sie, ob ACS Commons-Bundles aktiv sind.
  9. Wenn die Bereitstellung fehlschlägt, stellen Sie sicher, dass im Git-Repository ACS-Ordner vorhanden sind.
  10. Laden Sie das ACS Commons-Paket von ACS Commons-Versionen herunter und laden Sie es in /crx/packmgr hoch.
  11. Vergewissern Sie sich, dass das Paket erfolgreich installiert wurde.
  12. Stellen Sie sicher, dass sich die Pakete im Status Aktiv befinden.
  13. Schlägt die Installation fehl, überprüfen Sie die Kompatibilitätsmatrix von ACS Commons.
  14. Überprüfen Sie, ob die erforderlichen ACS Commons-Module im bereitgestellten Code vorhanden sind.
  15. Überprüfen Sie in AEMaaCS das Git-Repository unter ui.content/src/main/content/jcr_root.
  16. Vergewissern Sie sich, dass /var/acs-commons/reports in filter.xml enthalten ist.
  17. Prüfen Sie die Sichtbarkeit des Pfads in CRX/DE.
  18. Wenn Module nicht verfügbar sind, überprüfen Sie, ob die Git-Verzweigung die erforderlichen Ordner enthält.
  19. Identifizieren Sie veraltete API-Verwendungen wie com.day.cq.dam.api.AssetManager.createAsset oder com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
  20. Stellen Sie sicher, dass unsupported.asset.api Ergebnisse nicht mehr angezeigt werden.
  21. Wenn die Ergebnisse weiterhin bestehen, melden Sie ein Problem mit den ACS Commons-Betreuern über GitHub.
  22. Stellen Sie bei AEMaaCS-Bereitstellungen sicher, dass keine Module versuchen, zur Laufzeit in /apps oder /libs zu schreiben, da diese Pfade in Cloud Service nicht unterstützt werden.
  23. Überprüfen Sie, ob der gesamte ACS Commons-Code erfolgreich über Cloud Manager-Pipelines bereitgestellt wird.
  24. Überprüfen Sie die Pipeline-Protokolle und bestätigen Sie, dass die Bereitstellung erfolgreich abgeschlossen wurde.
  25. Wenn Bereitstellungsprobleme auftreten, überprüfen Sie filter.xml und entfernen Sie alle verbotenen Pfade.

Verwandtes Lesen

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