적응형 양식에 대한 사용자 지정 제출 작업 쓰기 writing-custom-submit-action-for-adaptive-forms

적응형 양식에서는 사용자가 지정한 데이터를 처리하려면 제출 작업이 필요합니다. 제출 작업은 적응형 양식을 사용하여 제출하는 데이터에 대해 수행되는 작업을 결정합니다. Adobe Experience Manager(AEM)에는 다음이 포함됩니다 OOTB 작업 제출 사용자가 제출한 데이터를 사용하여 수행할 수 있는 사용자 지정 작업을 보여 줍니다. 예를 들어 이메일 전송 또는 데이터 저장과 같은 작업을 수행할 수 있습니다.

제출 작업에 대한 워크플로우 workflow-for-a-submit-action

순서도는 제출 적응형 양식의 단추. 첨부 파일 구성 요소의 파일이 서버에 업로드되고 양식 데이터는 업로드된 파일의 URL로 업데이트됩니다. 클라이언트 내에서 데이터는 JSON 형식으로 저장됩니다. 클라이언트는 지정된 데이터를 마사지 하고 XML 형식으로 반환하는 내부 서블릿에 Ajax 요청을 보냅니다. 클라이언트는 이 데이터를 작업 필드로 수집합니다. 양식 제출 작업을 통해 데이터를 최종 서블릿(안내서 제출 서블릿)에 제출합니다. 그런 다음 서블릿은 컨트롤을 Submit 작업에 전달합니다. 제출 작업은 요청을 다른 sling 리소스에 전달하거나 브라우저를 다른 URL로 리디렉션할 수 있습니다.

XML 데이터 형식 xml-data-format

XML 데이터는 jcr:data 요청 매개 변수. 작업을 제출하면 매개 변수에 액세스하여 데이터를 처리할 수 있습니다. 다음 코드는 XML 데이터의 형식을 설명합니다. 양식 모델에 바인딩된 필드가 afBoundData 섹션을 참조하십시오. 바인딩되지 않은 필드는 afUnoundData 섹션을 참조하십시오. 의 형식에 대한 자세한 내용은 data.xml 파일, 적응형 양식 필드 미리 채우기 소개.

<?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

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

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

제출 액션 submit-action

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

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

다음 단계를 수행하여 CRX 저장소에 데이터를 저장한 다음 이메일을 보내는 사용자 지정 제출 작업을 만듭니다. 적응형 양식에는 CRX 저장소에 데이터를 저장하는 OOTB 제출 작업 저장소 컨텐츠(더 이상 사용되지 않음)가 포함되어 있습니다. 또한 CQ에서는 메일 이메일을 전송하는 데 사용할 수 있는 API입니다. Mail API를 사용하기 전에 [구성](https://docs.adobe.com/docs/en/cq/current/administering/notification.html?#Configuring the Mail Service) 시스템 콘솔을 통해 Day CQ Mail 서비스. 컨텐츠 저장(더 이상 사용되지 않음) 작업을 다시 사용하여 데이터를 저장소에 저장할 수 있습니다. 컨텐츠 저장(더 이상 사용되지 않음) 작업은 CRX 저장소의 /libs/fd/af/components/guidesubmittype/store 위치에서 사용할 수 있습니다.