DocumentazioneExperience Cloud KCS

Funzioni di ACS Commons non disponibili in Adobe Experience Manager

Ultimo aggiornamento: 8 agosto 2026

In Adobe Experience Manager, i moduli ACS AEM Commons potrebbero essere mancanti, i risultati delle API non supportati potrebbero essere visualizzati nei rapporti BPA, oppure problemi di compatibilità delle versioni potrebbero impedire il corretto funzionamento delle funzioni. Questi problemi si verificano quando ACS Commons non è distribuito, utilizza API non supportate o viene eseguito su versioni non compatibili. Per risolvere questo problema, identifica il tipo di problema, distribuisci il pacchetto ACS Commons corretto, aggiorna le API non supportate e convalida i requisiti di compatibilità.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Sintomi

  • I moduli ACS Commons non sono presenti nell’interfaccia utente di AEM, ad esempio Reports, Content Sync o MCP Console.
  • /var/acs-commons/reports o cartelle correlate non possono essere implementate in AEMaaCS.
  • L’output BPA mostra risultati API non supportati come {“type”:“unsupported.asset.api”,“told”:“com.day.cq.dam.api.AssetManager.createAsset”}.
  • I report BPA contrassegnano le classi ACS Commons non supportate, ad esempio com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
  • La barra di ricerca di Gestione pacchetti non mostra il pacchetto ACS Commons.

Risoluzione resolution

Per risolvere il problema, effettua le seguenti operazioni:

  1. Esamina l’output BPA o il comportamento del modulo e classifica il problema come modulo mancante, incompatibilità di versione, API non supportata o problema del filtro di distribuzione.
  2. Verifica che la categoria corrisponda ai sintomi osservati, ad esempio elementi dell’interfaccia utente mancanti, errori BPA o errori di distribuzione.
  3. Passare a /system/console/bundles e cercare acs.
  4. Verifica che i bundle siano nello stato Attivo.
  5. Aggiungi le dipendenze ACS Commons al tuo progetto Maven e utilizza il classificatore cloud richiesto da Cloud Service
  6. Assicurati che il classificatore cloud sia utilizzato per AEMaaCS come richiesto dalle linee guida per la rimozione delle API di Adobe
  7. Distribuisci la versione aggiornata di ACS Commons tramite Cloud Manager.
  8. Rivedi /system/console/bundles dopo la distribuzione e verifica che i bundle ACS Commons siano attivi.
  9. Se la distribuzione non riesce, verifica che nell’archivio Git siano presenti cartelle ACS.
  10. Scarica il pacchetto ACS Commons da Versioni di ACS Commons e caricalo in /crx/packmgr.
  11. Verifica che il pacchetto sia installato correttamente.
  12. Verifica che i bundle siano nello stato Attivo.
  13. Se l’installazione non riesce, controlla la matrice di compatibilità ACS Commons.
  14. Verifica che nel codice distribuito siano presenti i moduli ACS Commons richiesti.
  15. In AEMaaCS, controlla l’archivio Git in ui.content/src/main/content/jcr_root.
  16. Verificare che /var/acs-commons/reports sia incluso in filter.xml.
  17. Controllare CRX/DE per la visibilità dei percorsi.
  18. Se i moduli non sono disponibili, verifica che il ramo Git contenga le cartelle richieste.
  19. Identificare l’utilizzo di API obsolete, ad esempio com.day.cq.dam.api.AssetManager.createAsset o com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
  20. Verificare che unsupported.asset.api risultati non vengano più visualizzati.
  21. Se i risultati persistono, segnala un problema con i maintainer ACS Commons tramite GitHub.
  22. Per le distribuzioni di AEMaaCS, assicurati che nessun modulo tenti di eseguire scritture in fase di runtime su /apps o /libs, in quanto questi percorsi non sono supportati in Cloud Service.
  23. Verifica che tutto il codice ACS Commons venga distribuito correttamente tramite le pipeline di Cloud Manager.
  24. Esamina i registri della pipeline e verifica che la distribuzione sia stata completata correttamente.
  25. Se si verificano problemi di distribuzione, esaminare filter.xml e rimuovere eventuali percorsi non consentiti.

Lettura correlata

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