사용자 지정 적응형 양식 템플릿 만들기

마지막 업데이트: 2023-12-07
노트

AEM Forms에 동적 템플릿이 도입되었습니다. AEM Sites 템플릿 편집기를 사용하여 다음과 같은 작업을 수행할 수 있습니다 동적 템플릿 만들기 또는 편집. 아래 문서에 언급된 템플릿은 정적 템플릿입니다. 이러한 기능은 기본 설치에서는 사용할 수 없습니다. 호환성 패키지 설치 을 클릭하여 환경에서 이러한 템플릿을 가져옵니다.

사전 요구 사항

적응형 양식 템플릿

적응형 양식 템플릿은 적응형 양식을 만드는 데 사용되는 특정 속성 및 콘텐츠 구조를 가진 특수 AEM 페이지 템플릿입니다. 템플릿에는 사전 구성된 레이아웃, 스타일 및 기본 초기 컨텐츠 구조가 있습니다.

양식을 만든 후에는 원래 템플릿 콘텐츠 구조에 대한 변경 사항이 양식에 반영되지 않습니다.

기본 적응형 양식 템플릿

AEM QuickStart는 다음과 같은 적응형 양식 템플릿을 제공합니다.

  • 설문 조사 템플릿: 여러 열이 구성된 응답형 레이아웃을 사용하여 단일 페이지 적응형 양식을 만들 수 있습니다. 레이아웃은 양식을 표시할 다양한 화면의 크기에 따라 자동으로 조정됩니다.
  • 단순 등록 템플릿: 마법사 레이아웃을 사용하여 여러 단계의 적응형 양식을 만들 수 있습니다. 이 레이아웃에서는 마법사가 다음 단계로 진행하기 전에 유효성이 검사되는 각 단계에 대한 단계 완료 표현식을 지정할 수 있습니다.
  • 탭 등록 템플릿: 임의의 순서로 탭을 방문할 수 있는 왼쪽 탭 레이아웃을 사용하여 다중 탭 적응형 양식을 만들 수 있습니다.
  • 고급 등록 템플릿: 여러 탭과 마법사가 있는 양식을 만들 수 있습니다. 이 레이아웃은 순서에 관계없이 탭을 방문할 수 있도록 해주는 탭-왼쪽 레이아웃 을 사용합니다. 서명 및 확인을 위해 Adobe Document Cloud 설계 서비스를 사용합니다.
  • 빈 템플릿: 머리글, 바닥글 및 초기 컨텐츠 없이 양식을 만들 수 있습니다. 텍스트 상자, 단추 및 이미지와 같은 구성 요소를 추가할 수 있습니다. 빈 템플릿을 사용하면 다음 작업을 수행할 수 있는 양식을 만들 수 있습니다 AEM 사이트 페이지에 포함.

이러한 템플릿에는 sling:resourceType 속성을 해당 페이지 구성 요소로 설정합니다. 페이지 구성 요소는 적응형 양식 컨테이너를 포함하는 CQ 페이지를 렌더링하고, 이 페이지는 결과적으로 적응형 양식을 렌더링합니다.

다음 표는 템플릿과 페이지 구성 요소 간의 연결을 열거합니다.

템플릿

페이지 구성 요소

/libs/fd/af/templates/surveyTemplate

/libs/fd/af/components/page/survey

/libs/fd/af/templates/simpleEnrollmentTemplate

/libs/fd/af/components/page/base

/libs/fd/af/templates/tabEnrollmentTemplate

/libs/fd/af/components/page/tabbedenrollment

/libs/fd/afaddon/templates/advancedEnrollmentTemplate

/libs/fd/afaddon/components/page/advancedenrollment

템플릿 편집기를 사용하여 적응형 양식 템플릿 만들기

템플릿 편집기를 사용하여 적응형 양식의 구조 및 초기 콘텐츠를 지정할 수 있습니다. 예를 들어 모든 양식 작성자가 등록 양식에 텍스트 상자, 탐색 단추 및 제출 단추를 적게 만들도록 할 수 있습니다. 작성자가 다른 등록 양식과 일치하는 양식을 만드는 데 사용할 수 있는 템플릿을 만들 수 있습니다. AEM 템플릿 편집기를 사용하면 다음 작업을 수행할 수 있습니다.

  • 구조 레이어에서 양식의 머리글 및 바닥글 구성 요소 추가
  • 양식에 대한 초기 콘텐츠를 제공합니다.
  • 테마를 지정합니다.
  • 제출, 재설정 및 이동 등의 작업을 지정합니다.

자세한 내용은 템플릿 편집기.

CRXDE에서 적응형 양식 템플릿 만들기

사용 가능한 템플릿 대신 템플릿을 만들어 적응형 양식을 만들 수 있습니다. 사용자 지정 템플릿은 적응형 양식 컨테이너 및 페이지 요소(예: 머리글 및 바닥글)를 참조하는 다양한 페이지 구성 요소를 기반으로 합니다.

웹 사이트의 기본 페이지 구성 요소를 사용하여 이러한 구성 요소를 만들 수 있습니다. 또는 기본 제공 템플릿에서 사용하는 적응형 양식의 페이지 구성 요소를 확장할 수 있습니다.

simpleEnrollmentTemplate과 같은 사용자 지정 템플릿을 만들려면 다음 단계를 수행하십시오.

  1. 작성 인스턴스의 CRXDE Lite으로 이동합니다.

  2. /apps 디렉터리 아래에 응용 프로그램의 폴더 구조를 만듭니다. 예를 들어 애플리케이션 이름이 mycompany인 경우 이 이름으로 폴더를 만듭니다. 일반적으로 응용 프로그램 폴더에는 구성 요소, 구성, 템플릿, src 및 설치 디렉토리가 있습니다. 이 예에서는 구성 요소, 구성 및 템플릿 폴더를 만듭니다.

  3. /libs/fd/af/templates 폴더로 이동합니다.

  4. 다음을 복사합니다. simpleEnrollmentTemplate 노드.

  5. /apps/mycompany/templates 폴더로 이동합니다. 마우스 오른쪽 단추로 클릭하고 를 선택합니다. 붙여넣기.

  6. 필요한 경우 복사한 템플릿 노드의 이름을 변경합니다. 예를 들어 등록 템플릿으로 이름을 변경합니다.

  7. /apps/mycompany/templates/enrollment-template 위치로 이동합니다.

  8. 수정 jcr:titlejcr:description 속성 jcr:content 노드를 사용하여 템플릿과 복사한 템플릿을 구분합니다.

  9. 다음 jcr:content 수정된 템플릿의 노드에는 guideContainerguideformtitle 구성 요소. guideContainer 은 적응형 양식을 담는 컨테이너입니다. 다음 guideformtitle 구성 요소에 응용 프로그램 이름, 설명 등이 표시됩니다.

    대신 guideformtitle, 사용자 지정 구성 요소 또는 parsys 구성 요소. 예: 제거 guideformtitle, 사용자 지정 구성 요소 추가 또는 parsys 구성 요소 노드. 다음을 확인합니다. sling:resourceType 구성 요소의 속성이 구성 요소를 참조하며 동일한 속성이 페이지에 정의됩니다 component.jsp 파일.

  10. /apps/mycompany/templates/enrollment-template/jcr:content 위치로 이동합니다.

  11. 를 엽니다. 속성 탭을 클릭하고 의 값을 변경합니다. cq:designPath 속성을 /etc/designs/mycompany로 변경합니다.

  12. 이제 다음에 대한 /etc/designs/mycompany 노드를 cq:Page 유형.

적응형 양식 페이지 구성 요소 만들기

사용자 지정 템플릿은 페이지 구성 요소 /libs/fd/af/components/page/base를 참조하므로 기본 템플릿과 스타일이 동일합니다. 구성 요소 참조를 속성으로 찾을 수 있습니다 sling:resourceType /apps/mycompany/templates/enrollment-template/jcr:content 노드에 정의됩니다. base는 핵심 제품 구성 요소이므로 이 구성 요소를 수정하지 마십시오.

  1. /apps/mycompany/templates/enrollment-template/jcr:content 노드로 이동하여 속성의 값을 수정합니다 sling:resourceType 대상: /apps/mycompany/components/page/enrollmentpage

  2. /libs/fd/af/components/page/base 노드를 /apps/mycompany/components/page 폴더에 복사합니다.

  3. 복사된 구성 요소의 이름을 로 변경합니다. enrollmentpage.

  4. (contentpage가 이미 있는 경우에만) 기존 이 있는 경우 다음 단계 (a-d)를 수행합니다 contentpage구성 요소를 참조하십시오. 기존 항목이 없는 경우 contentpage웹 사이트의 구성 요소를 resourceSuperType속성을 사용하여 OOTB 기본 페이지를 지정합니다.

    1. 의 경우 enrollmentpage 노드, 속성의 값 설정 sling:resourceSuperType mycompany/components/page/contentpage에 연결합니다. 다음 contentpage 구성 요소는 사이트의 기본 페이지 구성 요소입니다. 다른 페이지 구성 요소가 확장할 수 있습니다. 아래의 스크립트 파일 제거 enrollmentpage, 제외 head.jsp, content.jsp, 및 library.jsp. 다음 sling:resourceSuperType 구성 요소: contentpage 이 경우 에는 이러한 모든 스크립트가 포함됩니다. 탐색 모음 및 바닥글을 포함한 머리글은 contentpage 구성 요소.

    2. 파일 열기 head.jsp.

      JSP 파일에 줄이 포함되어 있습니다 <cq.include script="library.jsp"/>.

      다음 library.jsp 파일에 guide.theme.simpleEnrollment 클라이언트 라이브러리로, 적응형 양식에 대한 스타일이 포함되어 있습니다.

      페이지 구성 요소 enrollmentpage 이(가) 독점 상태임 head.jsp 을 재정의하는 파일 head.jsp 파일 contentpage 구성 요소.

    3. 에 모든 스크립트 포함 head.jsp 파일용 contentpage 구성 요소를 head.jsp 파일용 enrollmentpage 구성 요소.

    4. 다음에서 content.jsp 스크립트를 사용하면 페이지를 렌더링할 때 포함된 다른 구성 요소에 대한 참조나 페이지 콘텐츠를 추가할 수 있습니다. 예를 들어 사용자 지정 구성 요소를 추가하는 경우 applicationformheader: JSP 파일의 구성 요소에 다음 참조를 추가해야 합니다.

      <cq:include path="applicationformheader" resourceType="mycompany/components/applicationformheader"/>

      마찬가지로 parsys 템플릿 노드 구조의 구성 요소에 사용자 지정 구성 요소도 포함됩니다.

적응형 양식 클라이언트 라이브러리 만들기

다음 head.jsp 파일 enrollmentpage 새 템플릿의 구성 요소에 클라이언트 라이브러리가 포함됩니다 guide.theme.simpleEnrollment. 기본 템플릿에서도 이 클라이언트 라이브러리를 사용합니다. 다음 방법 중 하나를 사용하여 새 템플릿의 스타일을 변경합니다.

  • 사용자 지정 테마 정의 및 기본 테마 바꾸기 guide.theme.simpleEnrollment (사용자 지정 테마 포함)
  • /etc/designs/mycompany에서 새 클라이언트 라이브러리를 정의합니다. jsp 페이지의 기본 테마 항목 뒤에 클라이언트 라이브러리를 포함합니다. 이 클라이언트 라이브러리에 재정의된 모든 스타일과 추가 Java Script 파일을 포함합니다.
노트

테마는 적응형 양식을 렌더링하는 데 사용되는 페이지 구성 요소에 포함된 클라이언트 라이브러리를 나타냅니다. 클라이언트 라이브러리는 주로 적응형 양식의 모양을 제어합니다.

이 페이지에서는