설명서AEM as a Cloud Service사용 안내서

HTML5 양식용 양식 템플릿 렌더링 rendering-form-template-for-html-forms

Last update: Thu Jul 17 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager as a Cloud Service
  • 주제:

작성 대상:

  • 관리자
  • 사용자
  • 개발자

HTML5 Forms 기능은 조기 액세스 프로그램의 일부로 제공됩니다. 액세스 권한을 요청하려면 공식(회사) 이메일 ID에서 aem-forms-ea@adobe.com으로 이메일을 보내십시오.

렌더링 끝점 render-endpoint

HTML5 forms에는 양식 서식 파일의 모바일 렌더링을 활성화하기 위해 REST 끝점으로 노출되는 프로필 개념이 있습니다. 이러한 프로필은 프로필 렌더러 ​와(과) 연결되어 있습니다. Forms OSGi 서비스를 호출하여 양식의 HTML 표시를 생성하는 JSP 페이지입니다. 프로필 노드의 JCR 경로는 렌더링 끝점의 URL을 결정합니다. 'default' 프로필을 가리키는 폼의 기본 렌더링 끝점은 다음과 같습니다.

https://<host>:<port>/content/xfaforms/profiles/default.html?contentRoot=<양식 xdp>&template=<xdp>이 포함된 폴더의 경로

예, http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=c:/xdps&template=sampleForm.xdp

사용자 지정 프로필의 경우 끝점이 그에 따라 변경됩니다. 예를 들어, 사용자 지정 프로필의 중단점은 다음과 같습니다.

http://localhost:4502/content/xfaforms/profiles/hrforms.html?contentRoot=c:/xdps&template=sampleForm.xdp

템플릿이 FormSubmission이라는 응용 프로그램의 AEM 저장소에 있는 경우 URI는 다음과 같습니다.

http://localhost:4502/content/xfaforms/profiles/default.html?
 contentRoot=crx:///content/dam/formsanddocuments/FormSubmission/1.0
 &template=sampleForm.xdp

렌더링 매개 변수 render-parameters

양식을 HTML으로 렌더링하는 동안 지원되는 요청 매개 변수는 다음과 같습니다.

매개변수
설명
템플릿
이 매개 변수는 템플릿 파일의 이름을 지정합니다.
contentRoot
이 매개 변수는 템플릿 및 관련 리소스가 있는 경로를 지정합니다. 이 경로는 서버 파일 시스템 경로이거나 저장소 경로이거나 http 또는 ftp 경로일 수 있습니다.
submitUrl
이 매개 변수는 양식 데이터 xml이 게시되는 URL을 지정합니다.

양식 템플릿과 데이터 병합 merge-data-with-form-template

매개변수
설명
dataRef
이 매개 변수는 템플릿과 병합되는 데이터 파일의 절대 경로 ​를 지정합니다. 이 매개 변수는 데이터를 xml 형식으로 반환하는 나머지 서비스의 URL일 수 있습니다.
데이터
이 매개 변수는 템플릿과 병합되는 UTF-8 인코딩 데이터 바이트를 지정합니다. 이 매개 변수를 지정하면 HTML5 양식에서 dataRef 매개 변수를 무시합니다.

렌더링 매개 변수 전달 passing-the-render-parameter

HTML5 forms에서는 렌더링 매개 변수를 전달하는 세 가지 메서드를 지원합니다. URL, 키-값 쌍 및 프로필 노드를 통해 매개 변수를 전달할 수 있습니다. 렌더링 매개 변수에서 키-값 쌍은 프로필 노드 다음에 오는 가장 높은 우선 순위를 갖습니다. URL 요청 매개 변수가 가장 우선합니다.

  • URL 요청 매개 변수: URL에 렌더링 매개 변수를 지정할 수 있습니다. URL 요청 매개 변수에서 매개 변수는 최종 사용자에게 표시됩니다. 예를 들어 다음 제출 URL은 URL의 템플릿 매개 변수를 포함합니다. http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=/Applications/FormSubmission/1.0&template=sampleForm.xdp

  • SetAttribute 요청 매개 변수: 렌더링 매개 변수를 키-값 쌍으로 지정할 수 있습니다. SetAttribute 요청 매개 변수에서 매개 변수는 최종 사용자에게 표시되지 않습니다. 다른 JSP에서 HTML5 양식 프로필 렌더러 JSP로 요청을 전달하고 요청 개체에 setAttribute ​을(를) 사용하여 모든 렌더링 매개 변수를 전달할 수 있습니다. 이 방법의 우선 순위가 가장 높습니다.

  • 프로필 노드 요청 매개 변수: 렌더링 매개 변수를 프로필 노드의 노드 속성으로 지정할 수 있습니다. 프로필 노드 요청 매개 변수에서 매개 변수는 최종 사용자에게 표시되지 않습니다. 프로필 노드는 요청이 전송되는 노드입니다. 매개 변수를 노드 속성으로 지정하려면 CRXDE lite를 사용합니다.

매개 변수 제출 submit-parameters

HTML5 forms에서 데이터를 제출하고 AEM 서버에서 서버측 스크립트 및 웹 서비스를 실행합니다. AEM 서버에서 서버측 스크립트 및 웹 서비스를 실행하는 데 사용되는 매개 변수에 대한 자세한 내용은 HTML5 양식 서비스 프록시를 참조하십시오.

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