DocumentaçãoKCS da Experience Cloud

Recursos ACS Commons indisponíveis no Adobe Experience Manager

Última atualização: 8 de agosto de 2026

No Adobe Experience Manager, os módulos ACS AEM Commons podem estar ausentes, descobertas de API não suportadas podem aparecer em relatórios BPA ou problemas de compatibilidade de versão podem impedir que os recursos funcionem corretamente. Esses problemas ocorrem quando o ACS Commons não é implantado, usa APIs não compatíveis ou é executado em versões incompatíveis. Para corrigir esse problema, identifique o tipo de problema, implante o pacote ACS Commons correto, atualize APIs não compatíveis e valide os requisitos de compatibilidade.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Sintomas

  • Os módulos ACS Commons estão ausentes na interface do usuário do AEM, como Relatórios, Sincronização de conteúdo ou Console MCP.
  • /var/acs-commons/reports ou pastas relacionadas falham ao implantar no AEMaaCS.
  • A saída do BPA mostra descobertas de API sem suporte, como {“type”:“unsupported.asset.api”,“told”:“com.day.cq.dam.api.AssetManager.createAsset”}.
  • Os relatórios BPA sinalizam classes ACS Commons não suportadas, como com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
  • A barra de pesquisa do Gerenciador de pacotes não mostra o pacote ACS Commons.

Resolução resolution

Para corrigir esse problema, siga estas etapas:

  1. Revise a saída do BPA ou o comportamento do módulo e classifique o problema como um módulo ausente, incompatibilidade de versão, API não compatível ou problema de filtro de implantação.
  2. Confirme se a categoria corresponde aos sintomas observados, como elementos de interface do usuário ausentes, erros de BPA ou falhas de implantação.
  3. Navegue até /system/console/bundles e procure por acs.
  4. Verifique se os pacotes estão no estado Ativo.
  5. Adicione dependências ACS Commons ao seu projeto Maven e use o classificador de nuvem exigido pela Cloud Service
  6. Verifique se o classificador cloud é usado para o AEMaaCS, conforme exigido pela orientação de remoção de API da Adobe
  7. Implante a versão atualizada do ACS Commons por meio do Cloud Manager.
  8. Revise /system/console/bundles após a implantação e confirme se os pacotes ACS Commons estão ativos.
  9. Se a implantação falhar, verifique se as pastas do ACS existem no repositório Git.
  10. Baixe o pacote ACS Commons de ACS Commons Releases e carregue-o para /crx/packmgr.
  11. Verifique se o pacote foi instalado com êxito.
  12. Verifique se os pacotes estão no estado Ativo.
  13. Se a instalação falhar, reveja a matriz de compatibilidade ACS Commons.
  14. Verifique se os módulos ACS Commons necessários existem no código implantado.
  15. No AEMaaCS, revise o repositório Git em ui.content/src/main/content/jcr_root.
  16. Confirme se /var/acs-commons/reports está incluído em filter.xml.
  17. Verifique CRX/DE quanto à visibilidade do caminho.
  18. Se os módulos permanecerem indisponíveis, confirme se a ramificação Git contém as pastas necessárias.
  19. Identifique o uso de API obsoleta, como com.day.cq.dam.api.AssetManager.createAsset ou com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
  20. Verifique se unsupported.asset.api descobertas não aparecem mais.
  21. Se as descobertas persistirem, registre um problema com os administradores do ACS Commons pelo GitHub.
  22. Para implantações do AEMaaCS, verifique se nenhum módulo tenta gravar em tempo de execução /apps ou /libs, pois esses caminhos não são compatíveis com o Cloud Service.
  23. Verifique se todo o código ACS Commons foi implantado com êxito por meio de pipelines Cloud Manager.
  24. Revise os logs de pipeline e confirme se a implantação foi concluída com sucesso.
  25. Se ocorrerem problemas de implantação, revise filter.xml e remova os caminhos proibidos.

Leitura relacionada

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