제출 액션 구성

제출 액션 소개

제출 액션은 사용자가 적응형 양식에서 제출 단추를 클릭하면 트리거됩니다. 적응형 양식에서 제출 액션을 구성할 수 있습니다. 적응형 양식은 몇 가지 즉시 제출 액션을 제공합니다. 기본 제출 액션을 복사하고 확장하여 고유한 제출 액션을 만들 수 있습니다. 그러나 요구 사항에 따라 제출 액션을 작성하여 등록하면 제출된 양식의 데이터를 처리할 수 있습니다. 제출 액션은 동기식 또는 비동기식 제출.

에서 제출 액션을 구성할 수 있습니다. 제출 섹션에 있는 섹션을 참조하십시오.

제출 액션 구성

제출 액션 구성

적응형 양식에서 사용할 수 있는 기본 제출 작업은 다음과 같습니다.

  • REST 끝점에 제출
  • 이메일 전송
  • 이메일을 통해 PDF 보내기
  • Forms Workflow 호출
  • 양식 데이터 모델을 사용하여 제출
  • Forms 포털 제출 액션
  • AEM 워크플로우 호출
노트

이메일 제출 액션을 통해 PDF 보내기 작업은 XFA 템플릿을 양식 모델로 사용하는 적응형 양식에만 적용할 수 있습니다.

노트

다음을 확인합니다. [AEM_Installation_Directory]\crx-quickstart\temp\datamanager\ASM 폴더
존재함. 첨부 파일을 임시로 저장하려면 디렉토리가 필요합니다. 디렉토리가 없으면 생성합니다.

주의

다음을 수행하는 경우 미리 채우기 데이터에 포함되지 않은 스키마(XML 스키마, JSON 스키마, 양식 템플릿 또는 양식 데이터 모델)에 대한 XML 또는 JSON 데이터 컴플레인이 있는 양식 템플릿, 양식 데이터 모델 또는 스키마 기반 적응형 양식 <afdata>, <afbounddata>, 및 </afunbounddata> 태그 뒤에 묶이지 않은 필드의 데이터(묶이지 않은 필드는 없는 적응형 양식 필드임) bindref 적응형 양식의 속성)이 손실됩니다.

적응형 양식에 대한 사용자 지정 제출 액션을 작성하여 사용 사례를 충족할 수 있습니다. 자세한 내용은 적응형 양식에 대한 사용자 정의 제출 액션 작성.

REST 끝점에 제출

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

{fieldName}={request parameter name}

아래 이미지에 표시된 대로, param1 및 param2 에서 복사된 값을 사용하여 매개 변수로 전달됩니다. 텍스트 상자 및 숫자 상자 다음 작업을 위한 필드입니다.

다음을 수행할 수도 있습니다. POST 요청 활성화 요청을 게시하기 위한 URL을 입력하십시오. 양식을 호스팅하는 Experience Manager 서버에 데이터를 제출하려면 Experience Manager 서버의 루트 경로에 해당하는 상대 경로를 사용합니다. 예: /content/forms/af/SampleForm.html. 다른 서버에 데이터를 제출하려면 절대 경로를 사용하십시오.

Rest 끝점 제출 작업 구성

Rest 끝점 제출 작업 구성

노트

필드를 REST URL의 매개 변수로 전달하려면 필드가 다른 패널에 배치된 경우에도 모든 필드에 다른 요소 이름이 있어야 합니다.

제출된 데이터를 리소스 또는 외부 나머지 끝점에 게시 

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

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

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

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

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

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

마찬가지로 XML 데이터 및 첨부 파일을 게시하는 데 사용하는 매개변수는 다음과 같습니다 dataXml 및 attachments.

예를 들어, 스크립트에서 이 두 매개 변수를 사용하여 데이터를 나머지 끝점으로 구문 분석합니다. 다음 구문을 사용하여 데이터를 저장하고 구문 분석합니다.

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

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

이메일 전송

다음 이메일 보내기 제출 액션은 양식 제출 시 한 명 이상의 수신자에게 이메일을 전송합니다. 생성된 이메일에는 사전 정의된 형식의 양식 데이터가 포함될 수 있습니다.

노트

이메일에 양식 데이터를 포함하기 위해서는 모든 양식 필드에 서로 다른 패널에 배치된 경우에도 서로 다른 요소 이름이 있어야 합니다.

이메일을 통해 PDF 보내기

다음 이메일을 통해 PDF 보내기 제출 액션은 양식 데이터가 포함된 PDF이 포함된 이메일을 양식을 성공적으로 제출하면 한 명 이상의 수신자에게 보냅니다.

노트

이 제출 액션은 기록 문서 템플릿이 있는 XFA 기반 적응형 양식 및 XSD 기반 적응형 양식에 사용할 수 있습니다.

Forms Workflow 호출

다음 Forms Workflow에 제출 제출 옵션은 기존 Adobe LiveCycle 또는 JEE의 AEM Forms 프로세스에 데이터 xml 및 첨부 파일(있는 경우)을 전송합니다.

Forms Workflow 제출 액션을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 양식 워크플로우를 사용하여 양식 데이터 제출 및 처리.

양식 데이터 모델을 사용하여 제출

다음 양식 데이터 모델을 사용하여 제출 제출 액션은 양식 데이터 모델의 지정된 데이터 모델 개체에 대해 제출된 적응형 양식 데이터를 해당 데이터 소스에 기록합니다. 제출 액션을 구성할 때 해당 데이터 소스에 다시 쓸 제출된 데이터의 데이터 모델 개체를 선택할 수 있습니다.

또한 양식 데이터 모델 및 기록 문서(DoR)를 사용하여 데이터 소스에 양식 첨부 파일을 제출할 수 있습니다.

양식 데이터 모델에 대한 자세한 내용은 AEM Forms 데이터 통합.

Forms 포털 제출 액션

다음 Forms 포털 제출 액션 옵션을 사용하면 AEM Forms 포털에서 양식 데이터를 사용할 수 있습니다.

Forms 포털 및 제출 작업에 대한 자세한 내용은 을 참조하십시오. 초안 및 제출 구성 요소.

AEM 워크플로우 호출

다음 AEM 워크플로우 호출 제출 액션은 적응형 양식을 AEM 워크플로. 양식이 제출되면 작성자 인스턴스에서 관련 워크플로우가 자동으로 시작됩니다. 데이터 파일, 첨부 파일 및 기록 문서를 상대 폴더 또는 워크플로의 페이로드 아래 또는 변수에 저장할 수 있습니다. 워크플로가 외부 데이터 스토리지에 대해 표시된 경우 페이로드 옵션이 아닌 변수 옵션을 사용할 수 있습니다. 워크플로우 모델에 사용할 수 있는 변수 목록에서 선택할 수 있습니다. 워크플로가 워크플로 생성 시점이 아니라 이후 단계에서 외부 데이터 스토리지에 대해 표시된 경우 필요한 변수 구성이 있는지 확인합니다.

를 사용하기 전에 AEM 워크플로우 호출 제출 액션, Experience Manager DS 설정 구성. AEM 워크플로우 만들기에 대한 내용은 OSGi의 양식 중심 워크플로.

제출 액션은 워크플로우의 페이로드 위치에 다음을 배치합니다. 그러나 워크플로 모델이 외부 데이터 저장용으로 표시된 경우에는 변수 옵션만 표시되고 페이로드 옵션은 표시되지 않습니다.

  • 데이터 파일: 적응형 양식에 제출된 데이터가 포함되어 있습니다. 다음을 사용할 수 있습니다. 데이터 파일 경로 페이로드를 기준으로 파일 이름 및 파일 경로를 지정하는 옵션입니다. 예를 들어 /addresschange/data.xml 경로는 라는 폴더를 만듭니다. addresschange 페이로드를 기준으로 배치합니다. 만 지정할 수도 있습니다. data.xml 폴더 계층 구조를 만들지 않고 제출된 데이터만 전송합니다. 변수 옵션을 사용하고 워크플로우 모델에 사용할 수 있는 변수 목록에서 변수를 선택합니다.
노트

워크플로 모델이 외부 데이터 스토리지에 대해 표시되는지 여부에 관계없이 변수를 사용할 수 있습니다.

  • 첨부 파일: 다음을 사용할 수 있습니다 첨부 파일 경로 적응형 양식에 업로드된 첨부 파일을 저장할 폴더 이름을 지정하는 옵션입니다. 폴더는 페이로드를 기준으로 생성됩니다. 워크플로가 외부 데이터 저장소로 표시된 경우 변수 옵션을 사용하고 워크플로 모델에 사용할 수 있는 변수 목록에서 변수를 선택합니다.

  • 기록 문서: 적응형 양식에 대해 생성된 기록 문서가 포함되어 있습니다. 다음을 사용할 수 있습니다. 기록 문서 경로 페이로드를 기준으로 기록 문서 파일의 이름과 파일 경로를 지정하는 옵션입니다. 예를 들어 /addresschange/DoR.pdf 경로는 라는 폴더를 만듭니다. addresschange 페이로드와 관련하여 다음을 배치합니다. DoR.pdf 페이로드 관련 만 지정할 수도 있습니다. DoR.pdf 폴더 계층 구조를 만들지 않고 기록 문서만 저장하려면. 워크플로가 외부 데이터 저장소로 표시된 경우 변수 옵션을 사용하고 워크플로 모델에 사용할 수 있는 변수 목록에서 변수를 선택합니다.

적응형 양식의 서버 측 유효성 재검사

일반적으로 모든 온라인 데이터 캡처 시스템에서 개발자는 클라이언트측에 일부 JavaScript 유효성 검사를 배치하여 몇 가지 비즈니스 규칙을 적용합니다. 그러나 최신 브라우저에서는 최종 사용자가 이러한 유효성 검사를 무시하고 웹 브라우저 개발 도구 콘솔과 같은 다양한 기술을 사용하여 수동으로 제출을 수행할 수 있습니다. 이러한 기법은 적응형 양식에도 유효합니다. Forms 개발자는 다양한 유효성 검사 논리를 만들 수 있지만, 기술적으로 최종 사용자는 이러한 유효성 검사 논리를 무시하고 잘못된 데이터를 서버에 제출할 수 있습니다. 잘못된 데이터는 양식 작성자가 적용한 비즈니스 규칙을 위반할 수 있습니다.

서버측 유효성 재검사 기능은 서버에서 적응형 양식을 디자인하는 동안 적응형 양식 작성자가 제공한 유효성 검사를 실행할 수도 있습니다. 양식 유효성 검사 측면에서 표시되는 데이터 제출 및 비즈니스 규칙 위반의 가능한 타협을 방지합니다.

서버에서 확인할 사항

서버에서 다시 실행되는 적응형 양식의 모든 즉시 사용 가능한(OOTB) 필드 유효성 검사는 다음과 같습니다.

  • 필수
  • 유효성 검사 그림 절
  • 유효성 검사 표현식

서버측 유효성 검사 활성화

사용 서버에서 다시 유효성 검사 사이드바의 적응형 양식 컨테이너 아래에서 현재 양식에 대한 서버측 유효성 검사를 활성화하거나 비활성화합니다.

서버측 유효성 검사 활성화

서버측 유효성 검사 활성화

최종 사용자가 이러한 유효성 검사를 무시하고 양식을 제출하는 경우 서버에서 유효성 검사를 다시 수행합니다. 서버 끝에서 유효성 검사가 실패하면 제출 트랜잭션이 중지됩니다. 최종 사용자에게 다시 원래 양식이 표시됩니다. 캡처된 데이터 및 제출된 데이터는 오류로서 사용자에게 제시된다.

노트

서버 측 유효성 검사가 양식 모델의 유효성을 검사합니다. 유효성 검사를 위해 별도의 클라이언트 라이브러리를 만들고 동일한 클라이언트 라이브러리에서 HTML 스타일링 및 DOM 조작과 같은 다른 항목과 혼합하지 않는 것이 좋습니다.

유효성 검사 표현식에서 사용자 지정 함수 지원

복잡한 유효성 검사 규칙이 있는 경우 정확한 유효성 검사 스크립트는 사용자 지정 함수에 상주하며 작성자는 필드 유효성 검사 표현식에서 이러한 사용자 지정 함수를 호출합니다. 서버측 유효성 검사를 수행하는 동안 이 사용자 정의 함수 라이브러리를 알고 사용할 수 있도록 양식 작성자는 아래 AEM 클라이언트 라이브러리의 이름을 구성할 수 있습니다. 기본 아래 표시된 대로 적응형 양식 컨테이너 속성의 탭

유효성 검사 표현식에서 사용자 지정 함수 지원

유효성 검사 표현식에서 사용자 지정 함수 지원

작성자는 적응형 양식에 따라 customJavaScript 라이브러리를 구성할 수 있습니다. 라이브러리에서 jquery 및 underscore.js 타사 라이브러리에 종속성이 있는 재사용 가능한 함수만 유지합니다.

제출 액션 시 오류 처리

Experience Manager 보안 및 강화 지침의 일부로 404.jsp 및 500.jsp와 같은 사용자 지정 오류 페이지를 구성합니다. 이러한 처리기는 양식 404 또는 500 오류를 제출할 때 호출됩니다. 이러한 오류 코드가 Publish 노드에서 트리거되면 핸들러도 호출됩니다.

자세한 내용은 오류 핸들러로 표시된 페이지 사용자 지정.

이 페이지에서는