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

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

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

장점

를 구성할 때의 몇 가지 이점 REST 끝점에 제출 적응형 Forms에 대한 제출 액션은 다음과 같습니다.

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

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

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

  1. 콘텐츠 브라우저를 열고 적응형 양식의 안내서 컨테이너 구성 요소를 선택합니다.

  2. 안내서 컨테이너 속성 안내서 속성 아이콘을 클릭합니다. 적응형 양식 컨테이너 대화 상자가 열립니다.

  3. 제출 탭을 클릭합니다.

  4. 다음에서 제출 액션 드롭다운 목록에서 다음을 선택합니다. Rest 끝점에 제출.
    Rest에 제출 엔드포인트의 작업 구성

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

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

    감사 페이지 매개변수로 전달된 필드 값 매핑

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

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

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

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

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

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

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

    {fieldName}={request parameter name}

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

    REST 엔드포인트 제출 액션 구성

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

  5. 완료 ​를 클릭합니다.

모범 사례

  • 외부 서버에 데이터를 게시할 때 URL이 안전한지 확인하고 민감한 정보를 보호하기 위해 POST 요청을 익명으로 처리하도록 경로를 구성합니다.
  • REST URL에서 필드를 매개변수로 전달하려면 필드가 다른 패널에 배치되는 경우에도 모든 필드의 요소 이름이 서로 달라야 합니다.

관련 문서

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab