Funciones de ACS Commons no disponibles en Adobe Experience Manager

Última actualización: 8 de agosto de 2026

En Adobe Experience Manager, es posible que falten módulos ACS AEM Commons, que aparezcan conclusiones de API no admitidas en los informes de BPA o que los problemas de compatibilidad de versiones puedan impedir que las funciones funcionen correctamente. Estos problemas se producen cuando ACS Commons no está implementado, utiliza API no admitidas o se ejecuta en versiones incompatibles. Para solucionar este problema, identifique el tipo de problema, implemente el paquete correcto de ACS Commons, actualice las API no admitidas y valide los requisitos de compatibilidad.

Descripción description

Entorno

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Síntomas

Faltan módulos ACS Commons en la interfaz de usuario de AEM, como Informes, Sincronización de contenido o Consola MCP.
/var/acs-commons/reports o carpetas relacionadas no se pueden implementar en AEMaaCS.
La salida de BPA muestra resultados de API no compatibles como {“type”:“unsupported.asset.api”,“told”:“com.day.cq.dam.api.AssetManager.createAsset”}.
Los informes de BPA marcan clases de ACS Commons no admitidas, como com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
La barra de búsqueda del Administrador de paquetes no muestra el paquete ACS Commons.

Resolución resolution

Para solucionar este problema, siga estos pasos:

Revise la salida de BPA o el comportamiento del módulo y clasifique el problema como módulo que falta, incompatibilidad de versión, API no admitida o problema de filtro de implementación.
Confirme que la categoría coincide con los síntomas observados, como la falta de elementos de la interfaz de usuario, errores de BPA o errores de implementación.
Vaya a /system/console/bundles y busque acs.
Compruebe que los paquetes están en estado Activo.
Agregue dependencias ACS Commons a su proyecto Maven y utilice el clasificador en la nube requerido por Cloud Service
Asegúrese de que el clasificador cloud se usa para AEMaaCS según lo requerido por las directrices de eliminación de API de Adobe
Implemente la versión actualizada de ACS Commons a través de Cloud Manager.
Vuelva a visitar /system/console/bundles después de la implementación y confirme que los paquetes ACS Commons están activos.
Si la implementación falla, compruebe que haya carpetas ACS en el repositorio Git.
Descargue el paquete ACS Commons desde Versiones ACS Commons y cárguelo en /crx/packmgr.
Compruebe que el paquete se instala correctamente.
Compruebe que los paquetes están en estado Activo.
Si la instalación falla, revise la matriz de compatibilidad de ACS Commons.
Compruebe que los módulos ACS Commons necesarios existan en el código implementado.
En AEMaaCS, revise el repositorio Git en ui.content/src/main/content/jcr_root.
Confirme que /var/acs-commons/reports está incluido en filter.xml.
Compruebe CRX/DE para ver la visibilidad de la ruta.
Si los módulos siguen sin estar disponibles, confirme que la rama Git contiene las carpetas necesarias.
Identificar uso de API obsoleto como com.day.cq.dam.api.AssetManager.createAsset o com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor.
Compruebe que los resultados de unsupported.asset.api ya no aparecen.
Si los resultados persisten, registre un problema con los administradores de ACS Commons a través de GitHub.
Para implementaciones de AEMaaCS, asegúrese de que ningún módulo intente escribir en tiempo de ejecución en /apps o /libs, ya que estas rutas no son compatibles con Cloud Service.
Compruebe que todo el código ACS Commons se implementa correctamente a través de las canalizaciones Cloud Manager.
Revise los registros de canalización y confirme que la implementación se completó correctamente.
Si se producen problemas de implementación, revise filter.xml y quite las rutas de acceso prohibidas.

Lectura relacionada

recommendation-more-help

experience-cloud-kcs-help-kbarticles