설명서Experience Cloud KCS

AEM Forms 이전 버전과의 호환성 및 SDK 업데이트가 적응형 Forms 프록시 구성 요소에 미치는 영향

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

Adobe Experience Manager(AEM) Forms에서 조직은 프로젝트 소유 프록시 구성 요소를 사용하여 적응형 Forms을 사용자 정의하는 경우가 많습니다. SDK 업데이트가 이러한 사용자 정의에 어떤 영향을 미치는지, Adobe의 이전 버전과의 호환성 정책이 적응형 Forms 구성 요소 버전에 어떻게 적용되는지 묻는 문제가 발생할 수 있습니다. 이 문제를 해결하려면 프로덕션에 업데이트를 승격하기 전에 지원되는 사용자 지정 사례를 따르고 모든 프록시 구성 요소의 유효성을 검사하십시오.

설명 description

환경

Adobe Experience Manager(AEM) as a Cloud Service(모든 버전)

문제/증상

  • 사용자 지정 프록시 구성 요소 또는 클라이언트 라이브러리에 영향을 주는 사소한 SDK 업데이트에 대한 우려.
  • 사용자 지정 코드에 영향을 주는 SDK 업데이트 후 관찰되는 문제입니다.
  • 적응형 Forms 구성 요소 버전에 대한 Adobe의 호환성 보장에 대해 명확성이 필요합니다.

원인

적응형 Forms 구성 요소 버전에 대한 일부 또는 이전 버전과 호환되는 변경 사항은 이러한 맞춤화가 내부 또는 문서화되지 않은 구현 세부 정보에 의존하는 경우 사용자 지정 프록시 구성 요소에 영향을 줄 수 있습니다. Adobe의 호환성 보장은 문서화된 확장 지점에만 적용되며 내부 구조나 오버레이 리소스에 적용되지 않고 기본 동작만 지원됩니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. 프로젝트 소유 프록시 구성 요소 구성: 필요한 Adobe 적응형 Forms 구성 요소 버전을 참조하는 sling:resourceSuperType과(와) 함께 프로젝트 소유 프록시 구성 요소를 사용합니다.
  2. 사용자 지정 구성 요소 변경 제한: 사용자 지정 HTL 및 대화 상자 변경 내용을 최소화합니다. 문서화된 API, 이벤트, 선택기 및 확장 지점만 사용하십시오.
  3. 프로젝트 소유 클라이언트 라이브러리 만들기: 고유한 범주 이름을 가진 별도의 프로젝트 소유 클라이언트 라이브러리를 만듭니다.
  4. Adobe 소유 클라이언트 라이브러리 보호: Adobe 소유 공유 런타임 기본 또는 종속 클라이언트 라이브러리를 오버레이하거나 수정하지 마십시오.
  5. 사용자 지정의 유효성을 검사합니다. 프로덕션에 업데이트를 승격하기 전에 낮은 환경에서 모든 사용자 지정의 유효성을 검사합니다. 각 SDK 또는 Forms 구성 요소가 업데이트된 후 렌더링, 작성, 유효성 검사, 규칙, 미리 채우기, 제출, 접근성, 클라이언트 라이브러리 로드 및 사용자 지정 JavaScript 동작에 대한 모든 프록시 구성 요소와 사용자 지정 사항을 회귀 테스트하십시오.
  6. SDK 업데이트 확인 및 승격: 프로젝트가 적응형 Forms 핵심 구성 요소 버전을 종속성으로 관리하는 경우 먼저 업데이트하고 더 낮은 환경에 배포하십시오. 모든 사용자 지정 프록시 구성 요소와 클라이언트 라이브러리가 예상대로 작동하는지 확인한 다음 표준 배포 프로세스를 통해 업데이트를 더 높은 환경으로 승격하십시오.

참고

  • 이전 버전과의 호환성은 적응형 Forms 구성 요소에 대해 지원되는 기본 제공 동작, 문서화된 API 및 문서화된 확장 포인트에 적용됩니다.
  • 지원되는 계약이 유지되는 한 버그 수정 및 이전 버전과 호환되는 개선 사항이 기존 구성 요소 버전 내에서 제공될 수 있습니다.
  • 지원되는 비헤이비어 또는 문서화된 확장 포인트에 대한 이전 버전과 호환 불가능한 변경 사항에 대해서만 새 구성 요소 버전이 도입됩니다.
  • 지원되는 계약이 유지되는 경우 HTL 렌더링, HTML 및 DOM 구조, CSS 클래스, JavaScript 동작, 클라이언트측 API, 유효성 검사, 규칙 실행, 대화 상자 및 구성 구조, 클라이언트 라이브러리 등 구현 세부 사항이 동일한 구성 요소 버전 내에서 변경될 수 있습니다.
  • 복사된 HTL, 개인 DOM 구조, 문서화되지 않은 선택기 또는 오버레이된 Adobe 클라이언트 라이브러리와 같이 내부 구현 세부 정보에 따라 달라지는 사용자 지정은 작은 업데이트의 영향을 받지 않을 수 있습니다.
  • Adobe 관리 환경에서는 별도의 개발 전용 자동 업그레이드 스위치를 제공하지 않습니다.

관련 읽기

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