Errores de informes de ACS Commons y MCP en entornos AEM
La generación de informes de Adobe Experience Manager (AEM) ACS Commons falla cuando los informes de recursos, los informes MCP o los paneles de Report Builder devuelven errores, descargas en blanco o resultados vacíos. Este problema se produce debido a versiones obsoletas de ACS Commons, la falta de paquetes o definiciones de informe mal configuradas que afectan a la ejecución del informe. Para resolver el problema, actualice la versión, valide los paquetes y corrija las configuraciones.
Descripción description
Entorno
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Problema/Síntomas
- Muestra el error: java.lang.NoSuchMethodError: org.apache.poi.xssf.usermodel.XSSFColor.
<init>(Ljava/awt/Color;)V durante la generación del informe. - Muestra TooManyCallsException durante la ejecución del informe o devuelve resultados de informe vacíos.
- No se pudo cargar el panel Report Builder de ACS Commons en
/apps/acs-commons/content/reports.html. - Error al descargar los archivos de informe generados por MCP o al devolver archivos de Excel/CSV en blanco.
- Redirija a páginas de error al acceder a paneles de informes o extremos de ejecución.
Causa principal
El problema se produce cuando una versión obsoleta de ACS Commons utiliza API de Apache POI incompatibles o cuando los paquetes de Report Builder necesarios faltan o están inactivos. Definiciones de informes mal configuradas, dependencias incompletas o consultas complejas que exceden los límites del sistema también producen errores como NoSuchMethodError, resultados vacíos o excepciones de ejecución.
Resolución resolution
Siga estos pasos para identificar el tipo de error y resolver el problema del informe de ACS Commons:
- Identifique el tipo de error revisando los registros de AEM y localizando errores como NoSuchMethodError, XSSFColor o TooManyCallsException.
- Categorice el problema asignando el error detectado a escenarios como incompatibilidad de versiones, paquetes que faltan, resultados vacíos o límites de ejecución.
- Resuelva los errores relacionados con la versión actualizando ACS Commons a la versión 6.0.14 o posterior e implementando la actualización a través de la canalización de Cloud Manager.
- Valide la implementación del paquete comprobando el paquete Report Builder de ACS Commons en
/system/console/bundlesy asegurándose de que esté activo sin problemas de dependencia. - Para corregir los resultados de los informes vacíos, compruebe que los recursos existen en el entorno y confirme que las rutas y configuraciones del informe seleccionado son correctas.
- Aborde los límites de ejecución aumentando el umbral sling.max.calls cuando corresponda para administrar consultas de informes complejas.
- Valide la resolución volviendo a ejecutar el informe, confirmando la descarga correcta, asegurándose de que el tablero se cargue correctamente y verificando que los datos del informe aparezcan según lo esperado.
Cuándo escalar
- El problema persiste después de actualizar ACS Commons y validar la activación del paquete.
- La generación de informes sigue fallando a pesar de la configuración y disponibilidad de datos correctas.
- Los informes de recursos de AEM predeterminados no se pueden generar ni descargar.
- El error indica un problema a nivel de sistema más allá de la configuración de ACS Commons.