Falhas de ativos ACS Commons e relatórios MCP em ambientes AEM
A geração de relatórios do Adobe Experience Manager (AEM) ACS Commons falha quando relatórios de ativos, relatórios MCP ou painéis do Report Builder retornam erros, downloads em branco ou resultados vazios. Esse problema ocorre devido a versões desatualizadas do ACS Commons, pacotes ausentes ou definições de relatório configuradas incorretamente que afetam a execução do relatório. Para resolver o problema, atualize a versão, valide os pacotes e corrija as configurações.
Descrição description
Ambiente
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Problema/Sintomas
- Exibe o erro: java.lang.NoSoMethodError: org.apache.poi.xssf.usermodel.XSSFColor.
<init>(Ljava/awt/Color;)V durante a geração do relatório. - Mostra TooManyCallsException durante a execução do relatório ou retorna resultados vazios do relatório.
- Falha ao carregar o painel ACS Commons Report Builder em
/apps/acs-commons/content/reports.html. - Falha ao baixar arquivos de relatório gerados por MCP ou retornar arquivos em branco do Excel/CSV.
- Redirecionar para páginas de erro ao acessar painéis de relatório ou endpoints de execução.
Causa raiz
O problema ocorre quando uma versão desatualizada do ACS Commons usa APIs de POI do Apache incompatíveis ou quando pacotes Report Builder necessários estão ausentes ou inativos. Definições de relatório mal configuradas, dependências incompletas ou consultas complexas que excedem os limites do sistema também levam a falhas, como NosuchMethodError, resultados vazios ou exceções de execução.
Resolução resolution
Siga estas etapas para identificar o tipo de falha e resolver o problema de relatório ACS Commons:
- Identifique o tipo de falha revisando os logs do AEM e localizando erros como NoSoMethodError, XSSFColor ou TooManyCallsException.
- Categorize o problema mapeando o erro detectado para cenários como incompatibilidade de versão, pacotes ausentes, resultados vazios ou limites de execução.
- Resolva os erros relacionados à versão atualizando o ACS Commons para a versão 6.0.14 ou posterior e implantando a atualização por meio do pipeline do Cloud Manager.
- Valide a implantação do pacote verificando o pacote ACS Commons Report Builder em
/system/console/bundlese garantindo que ele esteja ativo sem problemas de dependência. - Corrija os resultados vazios do relatório, verificando se há ativos no ambiente e se os caminhos e as configurações de relatório selecionados estão corretos.
- Aborde os limites de execução aumentando o limite sling.max.calls onde aplicável, para lidar com consultas de relatórios complexas.
- Valide a resolução executando novamente o relatório, confirmando o download bem-sucedido, garantindo que o painel seja carregado corretamente e verificando se os dados do relatório aparecem conforme esperado.
Quando escalonar
- O problema persiste após a atualização do ACS Commons e a validação da ativação do pacote.
- A geração de relatórios continua a falhar, apesar da configuração correta e da disponibilidade de dados.
- Os relatórios de ativos prontos para uso do AEM não são gerados ou baixados.
- O erro indica um problema de nível de sistema além da configuração ACS Commons.