적응형 양식의 비동기 제출 asynchronous-submission-of-adaptive-forms

새 적응형 양식 만들기또는 AEM Sites 페이지에 적응형 양식 추가작업을 할 때 현대적이고 확장 가능한 데이터 캡처 핵심 구성 요소를 사용하는 것이 좋습니다. 이러한 구성 요소는 적응형 양식 만들기 작업이 대폭 개선되어 우수한 사용자 경험을 보장할 수 있게 되었음을 나타냅니다. 이 문서에서는 기초 구성 요소를 사용하여 적응형 양식을 작성하는 이전 접근법에 대해 설명합니다.

일반적으로 웹 양식은 동기식으로 제출하도록 구성됩니다. 동기 제출의 경우, 사용자가 양식을 제출할 때 확인 페이지, 감사 페이지로 리디렉션되거나 제출 실패 시 오류 페이지로 리디렉션됩니다. 하지만 백그라운드에서 클라이언트-서버 상호 작용이 발생하는 동안 웹 페이지가 정적인 단일 페이지 애플리케이션과 같은 최신 웹 경험은 인기를 얻고 있습니다. 이제 비동기 제출을 구성하여 적응형 양식을 이 환경에 제공할 수 있습니다.

비동기 제출의 경우, 사용자가 양식을 제출할 때 양식 개발자는 다른 양식 또는 웹 사이트의 별도 섹션으로 리디렉션하는 것과 같은 별도의 경험을 플러그인합니다. 작성자는 또한 데이터를 다른 데이터 저장소에 보내거나 사용자 지정 분석 엔진을 추가하는 것과 같은 별도의 서비스를 플러그인할 수 있습니다. 비동기 제출이 있는 경우, 제출된 양식 데이터가 서버에서 유효성이 검사될 때 양식이 다시 로드되지 않거나 해당 URL이 변경되지 않으므로 적응형 양식은 단일 페이지 애플리케이션처럼 동작합니다.

적응형 양식의 비동기 제출에 대한 자세한 내용은 을 참조하십시오.

비동기 제출 구성 configure

적응형 양식에 대한 비동기 제출을 구성하려면 다음 작업을 수행하십시오.

비동기 제출 작동 방식 how-asynchronous-submission-works

AEM Forms에서는 양식 제출에 필요한 기본 성공 사례와 오류 핸들러를 제공합니다. 핸들러는 서버 응답을 기반으로 실행되는 클라이언트측 함수입니다. 양식을 제출하면 유효성 검사를 위해 데이터가 서버로 전송되며, 이 서버는 제출에 대한 성공 또는 오류 이벤트에 대한 정보와 함께 응답을 클라이언트에 반환합니다. 정보는 관련 핸들러에 매개 변수로 전달되어 함수를 실행합니다.

또한 양식 작성자와 개발자는 양식 수준에서 규칙을 작성하여 기본 핸들러를 재정의할 수 있습니다. 자세한 내용은 규칙을 사용하여 기본 처리기 재정의를 참조하십시오.

먼저 성공 및 오류 이벤트에 대한 서버 응답을 검토하겠습니다.

제출 성공 이벤트에 대한 서버 응답 server-response-for-submission-success-event

제출 성공 이벤트에 대한 서버 응답 구조는 다음과 같습니다.

{
  contentType : "<xmlschema or jsonschema>",
  data : "<dataXML or dataJson>" ,
  thankYouOption : <page/message>,
  thankYouContent : "<thank you page url/thank you message>"
}

양식 제출이 성공적으로 수행된 경우 서버 응답은 다음을 포함합니다.

성공 핸들러가 서버 응답을 읽고 이에 따라 구성된 페이지 URL로 리디렉션되거나 메시지가 표시됩니다.

제출 오류 이벤트에 대한 서버 응답 server-response-for-submission-error-event

제출 오류 이벤트에 대한 서버 응답 구조는 다음과 같습니다.

{
   errorCausedBy : "<CAPTCHA_VALIDATION or SERVER_SIDE_VALIDATION>",

   errors : [
               { "somExpression" : "<SOM Expression>",
                 "errorMessage"  : "<Error Message>"
               },
               ...
             ]
 }

양식 제출에 오류가 있는 경우 서버 응답은 다음과 같습니다.

오류 처리기는 서버 응답을 읽고 이에 따라 양식에 오류 메시지를 표시합니다.

규칙을 사용하여 기본 처리기 재정의 custom

양식 개발자와 작성자는 코드 편집기에서 양식 수준에서 규칙을 작성하여 기본 처리기를 재정의할 수 있습니다. 성공 및 오류 이벤트에 대한 서버 응답은 개발자가 규칙의 $event.data을(를) 사용하여 액세스할 수 있는 양식 수준에서 노출됩니다.

코드 편집기에서 성공 및 오류 이벤트를 처리할 규칙을 작성하려면 다음 단계를 수행하십시오.