적응형 Forms에 대한 사용자 지정 제출 액션 만들기 writing-custom-submit-action-for-adaptive-forms

적응형 양식은 즉시 사용할 수 있는(OOTB) 여러 제출 액션을 제공합니다. 제출 액션은 적응형 양식을 통해 수집된 데이터에 대해 수행할 작업의 세부 정보를 지정합니다. (예: 이메일에서 데이터 보내기)

사용자 지정 제출 액션을 만들어 에 포함되지 않은 기능을 추가할 수 있습니다. 즉시 사용 가능한 제출 액션 또는 단일 OOTB 제출 액션을 통해 지원되지 않습니다. 예를 들어 워크플로우에 데이터 제출, 데이터 저장소에 데이터 저장, 양식 제출자에게 이메일 알림 전송, 단일 제출 액션을 통해 승인 및 거부를 위해 제출된 양식의 처리를 담당하는 사람에게 이메일 전송 등의 작업을 수행할 수 있습니다.

XML 데이터 형식 xml-data-format

XML 데이터는 다음을 사용하여 서블릿으로 전송됩니다 jcr:data 요청 매개 변수. 제출 액션은 매개변수에 액세스하여 데이터를 처리할 수 있습니다. 다음 코드에서는 XML 데이터의 형식을 설명합니다. 양식 모델에 바인딩된 필드가 afBoundData 섹션. 바인딩되지 않은 필드는 afUnoundData섹션.

<?xml ?>
<afData>
<afUnboundData>
<data>
<field1>value</field2>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
</data>
</afUnboundData>
<afBoundData>
<!-- xml corresponding to the Form Model /XML Schema -->
</afBoundData>
</afData>

작업 필드 action-fields

제출 액션은 HTML을 사용하여 숨겨진 입력 필드를 추가할 수 있습니다. 입력 태그)를 클릭하여 렌더링된 양식 HTML에 추가합니다. 이러한 숨겨진 필드에는 양식 제출을 처리하는 동안 필요한 값이 포함될 수 있습니다. 양식을 제출할 때 이러한 필드 값은 제출 작업 시 제출 처리 시 사용할 수 있는 요청 매개 변수로 다시 게시됩니다. 입력 필드를 작업 필드라고 합니다.

예를 들어 양식을 채우는 데 걸린 시간을 캡처하는 제출 동작으로 숨겨진 입력 필드를 추가할 수도 있습니다 startTime 및 endTime.

스크립트는 startTime 및 endTime 양식을 렌더링할 때와 양식 제출 전 필드를 각각 표시합니다. 제출 액션 스크립트 post.jsp 은 요청 매개 변수를 사용하여 이러한 필드에 액세스하고 양식을 채우는 데 필요한 총 시간을 계산할 수 있습니다.

첨부 파일 file-attachments

제출 액션은 첨부 파일 구성 요소를 사용하여 업로드한 첨부 파일을 사용할 수도 있습니다. 작업 제출 스크립트는 Sling을 사용하여 이러한 파일에 액세스할 수 있습니다. RequestParameter API. 다음 isFormField api 메서드는 요청 매개 변수가 파일인지 양식 필드인지 식별하는 데 도움이 됩니다. 제출 작업에서 요청 매개 변수를 반복하여 파일 첨부 매개 변수를 식별할 수 있습니다.

다음 샘플 코드는 요청의 첨부 파일을 식별합니다. 그런 다음 를 사용하여 데이터를 파일로 읽습니다. API 가져오기. 마지막으로 데이터를 사용하여 Document 객체를 만들고 목록에 추가합니다.

RequestParameterMap requestParameterMap = slingRequest.getRequestParameterMap();
for (Map.Entry<String, RequestParameter[]> param : requestParameterMap.entrySet()) {
    RequestParameter rpm = param.getValue()[0];
    if(!rpm.isFormField()) {
        fileAttachments.add(new Document(rpm.get()));
    }
}

적응형 양식에 파일을 첨부할 때 서버는 적응형 양식 제출 후 첨부 파일의 유효성을 검사하고 다음과 같은 경우 오류 메시지를 반환합니다.

전달 경로 및 리디렉션 URL forward-path-and-redirect-url

필요한 작업을 수행한 후 제출 서블릿은 요청을 전달 경로로 전달합니다. 작업은 setForwardPath API를 사용하여 안내서 제출 서블릿에서 전달 경로를 설정합니다.

작업이 전달 경로를 제공하지 않으면 제출 서블릿이 리디렉션 URL을 사용하여 브라우저를 리디렉션합니다. 작성자는 적응형 양식 편집 대화 상자에서 감사 페이지 구성을 사용하여 리디렉션 URL을 구성합니다. 제출 액션 또는 안내서 제출 서블릿의 setRedirectUrl API를 통해 리디렉션 URL을 구성할 수도 있습니다. 안내서 제출 서블릿에서 setRedirectParameters API를 사용하여 리디렉션 URL로 전송된 요청 매개 변수를 구성할 수도 있습니다.

제출 동작 submit-action

제출 액션은 다음을 포함하는 sling:Folder입니다.

사용자 지정 제출 액션 만들기 creating-a-custom-submit-action

CRX 저장소에 데이터를 저장한 다음 이메일을 보내는 사용자 지정 제출 액션을 만들려면 다음 단계를 수행하십시오. 적응형 양식에는 CRX 저장소에 데이터를 저장하는 OOTB 제출 액션 저장소 콘텐츠(더 이상 사용되지 않음)가 포함되어 있습니다. 또한 AEM은 메일 이메일을 전송하는 데 사용할 수 있는 API입니다. Mail API를 사용하기 전에 시스템 콘솔을 통해 일별 CQ 메일 서비스를 구성합니다. 콘텐츠 저장(더 이상 사용되지 않음) 작업을 다시 사용하여 저장소에 데이터를 저장할 수 있습니다. 컨텐츠 저장(더 이상 사용되지 않음) 작업은 CRX 저장소의 /libs/fd/af/components/guidesubmittype/store에서 사용할 수 있습니다.

사용자 지정 제출 액션에 submitService 속성 사용 submitservice-property

다음을 포함하는 사용자 지정 제출 액션을 설정할 때 submitService 속성, 폼이 FormSubmitActionService 제출 시. 다음 FormSubmitActionService 를 사용합니다. getServiceName 값을 검색하는 메서드 submitService 속성. 의 값을 기반으로 함 submitService 등록 정보, 서비스는 적절한 제출 메서드를 호출합니다. 포함 FormSubmitActionService 에 업로드하는 사용자 지정 번들에 AEM Forms 서버입니다.

추가 submitService 에 대한 문자열 유형의 속성 sling:Folder 을(를) 활성화하기 위한 사용자 지정 제출 액션 Adobe Sign 적응형 양식용. 다음을 선택할 수 있습니다. Adobe Sign 활성화 의 옵션 전자 서명 섹션에 대한 값을 설정한 후에만 적응형 양식 컨테이너 속성의 섹션 submitService 사용자 지정 제출 액션의 속성입니다.