Errori nei rapporti sulle risorse e MCP di ACS Commons negli ambienti AEM
La generazione di rapporti Adobe Experience Manager (AEM) ACS Commons non riesce se i rapporti su risorse, i rapporti MCP o le dashboard di Report Builder restituiscono errori, download vuoti o risultati vuoti. Questo problema si verifica a causa di versioni ACS Commons obsolete, bundle mancanti o definizioni di report non configurate correttamente che influiscono sull’esecuzione dei report. Per risolvere il problema, aggiorna la versione, convalida i bundle e correggi le configurazioni.
Descrizione description
Ambiente
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Problema/Sintomi
- Visualizza l’errore: java.lang.NoThatMethodError: org.apache.poi.xssf.usermodel.XSSFColor.
<init>(Ljava/awt/Color;)V durante la generazione del report. - Mostra TooManyCallsException durante l’esecuzione del report o restituisce risultati del report vuoti.
- Impossibile caricare il dashboard Report Builder di ACS Commons in
/apps/acs-commons/content/reports.html. - Impossibile scaricare i file di rapporto generati da MCP o restituire i file Excel/CSV vuoti.
- Reindirizza alle pagine di errore durante l’accesso alle dashboard dei rapporti o agli endpoint di esecuzione.
Causa principale
Il problema si verifica quando una versione di ACS Commons obsoleta utilizza API Apache POI incompatibili o quando i bundle Report Builder richiesti sono mancanti o inattivi. Definizioni di report non configurate correttamente, dipendenze incomplete o query complesse che superano i limiti di sistema causano anche errori quali NoThatMethodError, risultati vuoti o eccezioni di esecuzione.
Risoluzione resolution
Per identificare il tipo di errore e risolvere il problema del rapporto ACS Commons, effettua le seguenti operazioni:
- Identificare il tipo di errore esaminando i registri di AEM e individuando errori quali NoThatMethodError, XSSFColor o TooManyCallsException.
- Categorizza il problema mappando l’errore rilevato a scenari quali incompatibilità di versione, bundle mancanti, risultati vuoti o limiti di esecuzione.
- Risolvi gli errori relativi alla versione aggiornando ACS Commons alla versione 6.0.14 o successiva e distribuendo l’aggiornamento tramite la pipeline di Cloud Manager.
- Convalidare la distribuzione del bundle controllando il bundle ACS Commons Report Builder in
/system/console/bundlese verificando che sia attivo senza problemi di dipendenza. - Correggi i risultati dei rapporti vuoti verificando che le risorse siano presenti nell’ambiente e confermando che i percorsi e le configurazioni dei rapporti selezionati sono corretti.
- Affronta i limiti di esecuzione aumentando la soglia sling.max.calls, se applicabile, per gestire query di report complesse.
- Convalida la risoluzione eseguendo nuovamente il rapporto, confermando il download corretto, assicurando che il dashboard venga caricato correttamente e verificando che i dati del rapporto vengano visualizzati come previsto.
Quando inoltrare la richiesta
- Il problema persiste dopo l’aggiornamento di ACS Commons e la convalida dell’attivazione del bundle.
- La generazione dei rapporti continua a non riuscire nonostante la configurazione e la disponibilità dei dati corrette.
- I rapporti predefiniti sulle risorse di AEM non vengono generati o scaricati.
- L’errore indica un problema a livello di sistema che va oltre la configurazione ACS Commons.