설명서Experience Cloud KCS

ACS Commons 기능은 Adobe Experience Manager에서 사용할 수 없음

마지막 업데이트: 2026년 8월 8일

Adobe Experience Manager에서 ACS AEM Commons 모듈이 누락되거나, 지원되지 않는 API 결과가 BPA 보고서에 나타나거나, 버전 호환성 문제로 인해 기능이 제대로 작동하지 않을 수 있습니다. 이러한 문제는 ACS Commons가 배포되지 않았거나, 지원되지 않는 API를 사용하거나, 호환되지 않는 버전에서 실행될 때 발생합니다. 이 문제를 해결하려면 문제 유형을 식별하고 올바른 ACS Commons 패키지를 배포하고 지원되지 않는 API를 업데이트하며 호환성 요구 사항을 확인합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS)

문제/증상

  • 보고서, 콘텐츠 동기화 또는 MCP 콘솔과 같은 ACS Commons 모듈이 AEM UI에서 누락되었습니다.
  • /var/acs-commons/reports 또는 관련 폴더를 AEMaaCS에 배포하지 못했습니다.
  • BPA 출력은 {“type”:“unsupported.asset.api”,“told”:“com.day.cq.dam.api.AssetManager.createAsset”}​과(와) 같이 지원되지 않는 API 검색 결과를 표시합니다.
  • BPA 보고서 플래그는 com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor과(와) 같이 지원되지 않는 ACS Commons 클래스입니다.
  • 패키지 관리자 검색 창에 ACS Commons 패키지가 표시되지 않습니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. BPA 출력 또는 모듈 동작을 검토하고 문제를 누락된 모듈, 버전 비호환성, 지원되지 않는 API 또는 배포 필터 문제로 분류합니다.
  2. 범주가 UI 요소 누락, BPA 오류 또는 배포 실패와 같이 관찰된 증상과 일치하는지 확인합니다.
  3. /system/console/bundles(으)로 이동하여 acs을(를) 검색합니다.
  4. 번들이 활성 상태인지 확인합니다.
  5. Maven 프로젝트에 ACS Commons 종속성 추가 및 Cloud Service에 필요한 클라우드 분류자 사용
  6. Adobe의 API 제거 지침에 필요한 대로 cloud 분류자가 AEMaaCS에 사용되는지 확인하십시오
  7. Cloud Manager을 통해 업데이트된 ACS Commons 버전을 배포합니다.
  8. 배포 후 /system/console/bundles을(를) 다시 방문하여 ACS Commons 번들이 활성 상태인지 확인하십시오.
  9. 배포가 실패하면 ACS 폴더가 Git 저장소에 있는지 확인하십시오.
  10. ACS Commons 릴리스에서 ACS Commons 패키지를 다운로드하여 /crx/packmgr에 업로드합니다.
  11. 패키지가 성공적으로 설치되었는지 확인합니다.
  12. 번들이 활성 상태인지 확인합니다.
  13. 설치에 실패한 경우 ACS Commons 호환성 매트릭스 를 검토하십시오.
  14. 배포된 코드에 필요한 ACS Commons 모듈이 있는지 확인합니다.
  15. AEMaaCS에서 ui.content/src/main/content/jcr_root 아래의 Git 저장소를 검토합니다.
  16. /var/acs-commons/reports이(가) filter.xml에 포함되어 있는지 확인하십시오.
  17. CRX/DE에서 경로 가시성을 확인합니다.
  18. 모듈을 계속 사용할 수 없는 경우 Git 분기에 필요한 폴더가 있는지 확인합니다.
  19. com.day.cq.dam.api.AssetManager.createAsset 또는 com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor과(와) 같이 더 이상 사용되지 않는 API 사용을 식별합니다.
  20. unsupported.asset.api 결과가 더 이상 나타나지 않는지 확인하십시오.
  21. 결과가 지속되면 GitHub를 통해 ACS Commons 유지 관리자와 문제를 기록하십시오.
  22. AEMaaCS 배포의 경우 /apps 또는 /libs은(는) Cloud Service에서 지원되지 않으므로 해당 모듈에서 런타임 쓰기를 시도하지 않도록 하십시오.
  23. Cloud Manager 파이프라인을 통해 모든 ACS Commons 코드가 성공적으로 배포되었는지 확인합니다.
  24. 파이프라인 로그를 검토하고 배포가 성공적으로 완료되었는지 확인합니다.
  25. 배포 문제가 발생하면 filter.xml을(를) 검토하고 금지된 경로를 제거하십시오.

관련 읽기

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