REST 끝점 제출 작업에 대한 적응형 양식 구성

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

사용자
개발자

REST 끝점에 제출 작업을 사용하여 제출된 데이터를 REST URL에 게시합니다. URL은 내부 서버(양식이 렌더링되는 서버) 또는 외부 서버일 수 있습니다.

AEM as a Cloud Service에서는 양식 제출을 처리하기 위한 다양한 제출 액션을 제공합니다. 적응형 양식 제출 액션 문서에서 이러한 옵션에 대해 자세히 알아볼 수 있습니다.

장점

적응형 Forms에 대한 REST 끝점에 제출 제출 액션을 구성하는 것의 이점 중 일부는 다음과 같습니다.

RESTful API를 통해 양식 데이터를 외부 시스템 및 서비스와 매끄럽게 통합할 수 있습니다.
적응형 Forms의 데이터 제출을 유연하게 처리하여 다이내믹하고 복잡한 데이터 구조를 지원합니다.
REST 끝점 URL의 매개 변수에 대한 양식 필드의 동적 매핑을 지원하여 조정 및 사용자 지정 가능한 데이터 제출을 허용합니다.

REST 끝점에 제출 작업 구성 steps-to-configure-submit-to-restendpoint-submit-action

제출 액션을 구성하려면 다음 작업을 수행하십시오.

콘텐츠 브라우저를 열고 적응형 양식의 안내서 컨테이너 구성 요소를 선택합니다.
안내서 컨테이너 속성 아이콘을 클릭합니다. 적응형 양식 컨테이너 대화 상자가 열립니다.
제출 탭을 클릭합니다.
작업 제출 드롭다운 목록에서 Rest 끝점에 제출 을 선택합니다.

데이터를 내부 서버에 게시하려면 리소스 경로를 제공합니다. 데이터는 리소스 경로에 게시됩니다. 예, /content/restEndPoint. 해당 게시 요청이 있는 경우 제출 요청에 대한 인증 정보가 사용됩니다.

데이터를 외부 서버에 게시하려면 URL을 제공합니다. URL 형식은 https://host:port/path_to_rest_end_point입니다. POST 요청을 익명으로 처리하는 경로를 구성해야 합니다.

위 예에서 사용자는 매개변수 param1을 사용하여 캡처한 정보를 textbox에 입력했습니다. param1을 사용하여 캡처한 데이터를 게시하는 구문은 다음과 같습니다.

String data=request.getParameter("param1");

마찬가지로 XML 데이터와 첨부 파일 게시에 사용되는 매개변수는 dataXml 및 attachments입니다.

예를 들어 스크립트의 이 두 매개변수를 사용하여 데이터를 REST 엔드포인트로 구문 분석합니다. 다음 구문을 사용하여 데이터를 저장하고 구문 분석합니다.

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

이 예에서 data는 XML 데이터를 저장하고 att는 첨부 파일 데이터를 저장합니다.

REST 엔드포인트에 제출 제출 액션은 양식에 입력된 데이터를 HTTP GET 요청의 일부로 구성된 확인 페이지에 제출합니다. 요청할 필드의 이름을 추가할 수 있습니다. 요청의 형식은 다음과 같습니다.

{fieldName}={request parameter name}

아래 이미지에 표시된 대로 param1과 param2는 다음 액션의 텍스트 상자 및 숫자 상자 필드에서 복사된 값이 포함된 매개변수로 전달됩니다.

또한 POST 요청을 활성화 하고 요청을 게시하는 URL을 제공할 수 있습니다. 양식을 호스팅하는 AEM 서버에 데이터를 제출하려면 AEM 서버 루트 경로에 해당되는 상대 경로를 사용합니다. 예, /content/forms/af/SampleForm.html. 데이터를 다른 서버에 제출하려면 절대 경로를 사용합니다.
완료 를 클릭합니다.