Show Menu
화제×

HTML5 양식 서비스 프록시

HTML5 양식 서비스 프록시는 제출 서비스에 대한 프록시를 등록하는 구성입니다. 서비스 프록시를 구성하려면 요청 매개 변수 submissionServiceProxy를 통해 제출 서비스의 URL을 지정합니다 .

서비스 프록시의 이점

서비스 프록시는 다음을 제거합니다.
  • HTML5 양식 워크플로우를 사용하려면 HTML5 양식 사용자를 위해 제출 서비스 "/content/xfaforms/submission/default"를 열어야 합니다. AEM 서버를 의도하지 않은 광범위한 사용자에게 노출합니다.
  • 서비스 URL은 양식의 런타임 모델에 포함됩니다. 서비스 URL 경로를 변경할 수 없습니다.
  • 제출은 2단계 과정입니다. 양식 데이터를 제출하려면 서버에 두 번 이상 가야 합니다. 따라서 서버의 로드를 증가시킵니다.
  • HTML5 양식은 PDF 요청 대신 POST 요청에서 데이터를 전송합니다. PDF 양식과 HTML5 양식을 모두 포함하는 워크플로우의 경우 제출 서류 처리 방법에는 두 가지 방법이 필요합니다.

토폴로지

HTML5 양식은 다음 토폴로지를 사용하여 AEM 서버에 연결할 수 있습니다.
  • AEM Server 또는 HTML5 양식이 POST를 통해 서버로 데이터를 전송하는 토폴로지.
  • 프록시 서버가 서버에 POST 데이터를 전송하는 토폴로지.
HTML5 양식 서비스 프록시 토폴로지
HTML5 양식은 AEM 서버에 연결하여 서버측 스크립트, 웹 서비스 및 제출을 실행합니다. HTML5 양식의 XFA 런타임은 다양한 매개 변수와 함께 "/bin/xfaforms/submitaction" 끝점에 대한 Ajax 호출을 사용하여 AEM 서버에 연결합니다. HTML5 양식은 AEM 서버를 연결하여 다음 작업을 수행합니다.

서버측 스크립트 및 웹 서비스 실행

서버에서 실행되도록 표시된 스크립트를 서버측 스크립트라고 합니다. 다음 표에는 서버측 스크립트 및 웹 서비스에 사용되는 모든 매개 변수가 나와 있습니다.
매개 변수
설명
활동
활동에는 요청을 트리거하는 이벤트가 포함됩니다. 클릭, 종료 또는 변경
contextSom
contextSom에는 이벤트가 실행되는 객체의 SOM 식이 포함되어 있습니다.
템플릿
템플릿에는 양식을 렌더링하는 데 사용되는 템플릿이 포함되어 있습니다.
contentRoot
contentRoot에는 양식을 렌더링하는 데 사용되는 템플릿 루트 디렉토리가 포함되어 있습니다.
데이터
데이터에는 양식을 렌더링하는 데 사용되는 일괄 바이트 수가 포함됩니다.
formDom
formDom에는 HTML5 양식의 DOM이 JSON 형식으로 포함되어 있습니다.
패킷
패킷이 양식으로 지정됩니다.
debugDir
debugDir에는 양식을 렌더링하는 데 사용되는 디버그 디렉토리가 포함되어 있습니다.

데이터 제출

전송 단추를 클릭하면 HTML5 양식이 서버에 데이터를 보냅니다. 다음 표에는 HTML5 양식이 서버로 보내는 모든 매개 변수가 나와 있습니다.
매개 변수
설명
템플릿
양식을 렌더링하는 데 사용되는 템플릿입니다.
contentRoot
양식을 렌더링하는 데 사용되는 템플릿 루트 디렉토리.
데이터
bata bytes used to render the form.
formDom
HTML5 양식의 DOM(JSON 형식)
submiturl
데이터 XML이 게시되는 URL입니다.
debugDir
양식을 렌더링하는 데 사용되는 디버그 디렉토리입니다.

제출 프록시는 어떻게 작동합니까?

제출 서비스 프록시는 제출 URL이 요청 매개 변수에 없는 경우 통과 역할을 합니다. 통과 장치 역할을 합니다. 요청을 /bin/xfaforms/submitaction 종료 지점에 보내고 XFA 런타임에 대한 응답을 보냅니다.
제출 서비스 프록시는 제출 URL이 요청 매개 변수에 있는 경우 토폴로지를 선택합니다.
  • AEM 서버가 데이터를 게시하면 프록시 서비스는 통과 역할을 합니다. 요청을 /bin/xfaforms/submitaction 종료 지점에 보내고 XFA 런타임에 대한 응답을 보냅니다.
  • 프록시가 데이터를 게시하면 프록시 서비스는 submitUrl을 제외한 모든 매개 변수를 /bin/xfaforms/submitaction 종료 지점에 전달하여 응답 스트림의 xml 바이트를 수신합니다. 그런 다음 프록시 서비스는 처리를 위해 데이터 xml 바이트를 submitUrl에 게시합니다.
  • 데이터(POST 요청)를 서버로 보내기 전에 HTML5 양식이 서버의 연결성 및 가용성을 확인합니다. 연결 및 가용성을 확인하기 위해 HTML 양식은 빈 헤드 요청을 서버에 보냅니다. 서버를 사용할 수 있는 경우 HTML5 양식이 데이터(POST 요청)를 서버로 전송합니다. 서버를 사용할 수 없는 경우 서버에 연결할 수 없다는 오류 메시지가 표시됩니다. 고급 탐지는 사용자가 양식을 리플로우하는 번거로움을 방지합니다. 프록시 서블릿은 헤드 요청을 처리하며 예외를 발생시키지 않습니다.