Forms 포털 구성 요소에 대한 템플릿 맞춤화 customizing-templates-for-forms-portal-components
사전 요구 사항 prerequisites
HTML 및 CSS 관련 실무 지식
개요 overview
AEM Forms 사용자 인터페이스를 사용하면 모든 양식에 메타데이터를 추가할 수 있습니다. 사용자 지정 메타데이터는 조직의 양식을 나열하고 검색하는 동안 사용자 경험을 향상시킬 수 있습니다.
Forms 포털을 사용하면 양식 목록에서 사용자 지정 메타데이터를 사용할 수 있습니다. 에셋에 대한 사용자 지정 템플릿을 만드는 동안 해당 레이아웃을 수정하고 CSS 스타일 세트와 함께 사용자 지정 메타데이터를 사용할 수 있습니다.
다양한 Forms 포털 구성 요소에 대한 사용자 지정 템플릿을 만들 수 있도록 다음을 수행하십시오.
사용자 지정 템플릿 만들기 creating-a-nbsp-custom-template
-
/apps 아래에 sling:Folder 노드 만들기
"fpContentType" 속성을 추가합니다. 사용자 지정 템플릿을 정의하는 구성 요소에 따라 속성에 적절한 값을 지정합니다.
-
검색 및 목록 구성 요소: "/libs/fd/fp/formTemplate"
-
초안 및 제출 구성 요소:
- 초안 섹션: /libs/fd/fp/draftTemplate
- 제출 섹션: /libs/fd/fp/submissionsTemplate
-
링크 구성 요소: /libs/fd/fp/linkTemplate
레이아웃 템플릿을 선택하는 동안 표시할 제목을 추가합니다.
note note NOTE 제목은 만든 sling:Folder의 노드 이름과 다를 수 있습니다. 다음 이미지는 Search & List 구성 요소에 대한 구성을 보여 줍니다.
-
-
사용자 지정 템플릿으로 사용할 수 있도록 이 폴더에 template.html 파일을 만듭니다.
-
사용자 지정 템플릿을 작성하고 아래 설명된 대로 사용자 지정 메타데이터를 사용합니다.
작업 예 working-example
다음은 Forms 포털이 검색 및 목록 구성 요소에 대한 사용자 지정 Geometrixx Gov 카드 레이아웃을 획득하는 사용자 지정 템플릿의 샘플 구현입니다.
<div class="__FP_boxes-container __FP_single-color">
<div class="boxes __FP_boxes __FP_single-color" data-repeatable="true">
<div class="__FP_boxes-thumbnail">
<img src ="${path}/jcr:content/renditions/cq5dam.thumbnail.319.319.png"/>
</div>
<h3 class="__FP_single-color" title="${name}" tabindex="0">${name}</h3>
<p>${description}</p>
<div class="boxes-icon-cont __FP_boxes-icon-cont">
<div class="op-dow">
<a href="${formUrl}" target="_blank" class="__FP_button ${htmlStyle}" title="${config-htmlLinkText}">${localize-Apply}</a>
<a href="${pdfUrl}" class="__FP_button ${pdfStyle}" title="${config-pdfLinkText}">${localize-Download}</a>
</div>
</div>
</div>
</div>
사용자 정의 템플릿에 대한 기술 사양 technical-specifications-for-custom-templates
Forms 포털 구성 요소에 대한 사용자 지정 템플릿에는 반복 가능한 항목과 반복 불가능한 항목이 포함되어 있습니다. 반복 가능한 항목은 나열할 기본 엔티티입니다. 반복 가능한 항목의 예로는 검색 및 목록 작성자, 초안 및 제출, 링크 구성 요소 등이 있습니다.
Forms 포털은 자리 표시자가 사용자 지정/기본 제공 메타데이터를 표시할 수 있는 구문을 제공합니다. 양식, 초안 또는 제출 결과를 표시한 후 자리 표시자가 채워집니다.
반복 가능한 항목을 포함하려면 특성 data-repeatable 의 값을 true(으)로 구성하십시오.
설명한 예제에서 두 개의 Div 요소가 사용자 지정 템플릿의 맨 위에 있습니다. 첫 번째는 "__FP_boxes-container" CSS 클래스와 함께 나열되는 양식의 컨테이너 요소로 작동합니다. 두 번째는 "__FP_boxes" CSS 클래스와 함께 기본 엔터티용 템플릿이며, 이 경우 폼입니다. Div 요소에 있는 data-repeatable 특성의 값은 true. 입니다.
각 자리 표시자에는 배타적인 기본 메타데이터 세트가 있습니다. 양식의 특정 위치에 사용자 지정 메타데이터를 표시하려면 해당 위치에 ${metadata_prop} 속성 을(를) 추가하십시오.
이 예제에서 메타데이터 속성은 여러 인스턴스에 사용됩니다. 예를들어,description,name,formUrl,htmlStyle,pdfUrl,pdfStyle 및 path 에서 지정된 방식으로 사용됩니다.
기본 제공 메타데이터 out-of-the-box-metadata
다양한 Forms 포털 구성 요소는 목록에 사용할 수 있는 독점적인 메타데이터 세트를 제공합니다.
Search & Lister 구성 요소 search-amp-lister-component
-
양식의 제목: 제목
-
이름: 양식 이름(대부분 제목과 동일)
-
설명: 양식에 대한 설명
-
formUrl: 양식을 HTML으로 렌더링할 URL
-
pdfUrl: 양식을 PDF으로 렌더링할 URL
-
assetType: 에셋의 유형입니다. 유효한 값에는 양식, PDF 양식, 인쇄 양식 및 적응형 양식 이 포함됩니다.
-
htmlStyle& pdfStyle: 렌더링에 각각 사용되는 HTML 및 PDF 아이콘의 표시 스타일입니다. 유효한 값은 "__FP_display_none" 또는 비어 있습니다.
- downloadUrl: 에셋을 다운로드할 URL입니다.
사용자 인터페이스에서 로컬라이제이션, 정렬 및 구성 속성 사용 지원(Search & List만 해당):
-
지역화 지원: 정적 텍스트를 지역화하려면
${localize-YOUR_TEXT}
특성을 사용하고 지역화된 값이 없는 경우 사용할 수 있도록 설정하십시오.
설명한 예제에서 특성${localize-Apply}
및${localize-Download}
은(는) 적용 및 다운로드 텍스트를 현지화하는 데 사용됩니다. -
정렬 지원: 검색 결과를 정렬하려면 HTML 요소를 클릭합니다. 테이블 레이아웃에서 정렬을 구현하려면 특정 테이블 헤더에 "data-sortKey" 속성을 추가하십시오. 또한 해당 값을 정렬할 메타데이터로 추가합니다.
예를 들어 그리드 보기의 "Title" 헤더의 경우 "data-sortKey" 헤더의 값은 "title"입니다. 특정 열의 값을 정렬할 수 있도록 제목을 클릭합니다. -
구성 속성 사용: 검색 및 목록 구성 요소에 사용자 인터페이스에서 사용할 수 있는 몇 가지 구성이 있습니다. 예를들어 편집 대화 상자를 통해 저장된 HTML 도구 설명 텍스트를 표시하려면
${config-htmlLinkText}
특성을 사용합니다. 마찬가지로 PDF 도구 설명 텍스트의 경우${config-pdfLinkText}
특성을 사용하십시오.
링크 구성 요소 link-component
- 양식의 제목: 제목
- formUrl: 양식을 HTML으로 렌더링할 URL
- target: 링크의 대상 특성입니다. 유효한 값은 "_blank" 및 "_self"입니다.
- 링크 텍스트: 링크 캡션
초안 및 제출 구성 요소 drafts-amp-submissions-component
- 경로: 초안/제출 메타데이터 노드의 경로 초안 또는 제출을 열 수 있도록 확장자가 .HTML인 URL과 함께 사용합니다.
- contextPath: AEM 인스턴스의 컨텍스트 경로
- firstLetter: 적응형 양식 제목의 첫 글자(대문자)로, 초안으로 저장되거나 제출되었습니다.
- formName: 초안으로 저장되거나 제출된 적응형 양식의 제목입니다.
- draftID: 나열된 초안의 ID(초안 섹션의 템플릿에서만 사용).
- submitID: 나열된 제출 서류의 ID(제출 서류 섹션의 템플릿에서만 사용).
- 상태: 제출된 양식의 상태입니다. (제출 서류 섹션의 템플릿에서만 사용하십시오.)
- 설명: 초안 또는 제출과 관련된 적응형 양식에 대한 설명입니다.
- diffTime: 현재 시간과 초안에 대한 마지막 저장 작업의 차이입니다. 또는 현재 시간과 제출에 대해 마지막으로 제출된 작업 간의 차이입니다.
- iconClass: 초안/제출의 첫 번째 문자를 표시하는 데 사용되는 CSS 클래스입니다. Forms 포털에는 다양한 색상 배경을 제공하는 다음 클래스가 포함되어 있습니다.
- 소유자: 초안/제출을 만든 사용자입니다.
- 오늘: 초안 또는 제출 날짜가
DD:MM:YYYY
형식입니다. - TimeNow: 초안 또는 제출 시간이
HH:MM:SS
24시간 형식으로 생성됨
참고:
-
초안 및 제출 구성 요소 아래의 초안 섹션에 있는 삭제 옵션에 대해 CSS 클래스 이름을 "__FP_deleteDraft"로 지정합니다. 또한 해당 초안의 초안 ID인 값이 ${draftID} 인 "draftID" 특성을 포함하십시오.
-
열린 초안 및 제출에 대한 링크를 만드는 동안 앵커 태그에 대한 href 특성 값으로 ${path}.html 을(를) 지정할 수 있습니다.
A. 컨테이너 요소
B. "path" 메타데이터에서 각 양식에 저장된 축소판을 가져올 수 있는 고정 계층 구조를 포함합니다.
각 양식의 템플릿 섹션에 사용되는 C. 데이터 반복 가능 특성
D. "적용" 문자열 현지화
E. 구성 속성 pdfLinkText 사용
F. "pdfUrl" 메타데이터 사용
팁, 요령 및 알려진 문제 tips-tricks-and-known-issues
- 사용자 지정 템플릿에서 작은따옴표(')를 사용하지 마십시오.
- 사용자 지정 메타데이터의 경우 이 속성을 jcr:content/metadata 노드에만 저장하십시오. 다른 위치에 저장하면 Forms 포털에서 메타데이터를 표시할 수 없습니다.
- 사용자 지정 메타데이터 또는 기존 메타데이터의 이름에 콜론(:)이 포함되어 있지 않은지 확인하십시오. 이 경우 사용자 인터페이스에 표시할 수 없습니다.
- 데이터 반복 가능 에 Link 구성 요소에 대한 중요도가 없습니다. Adobe 구성 요소용 템플릿에서는 이 속성을 사용하지 않는 것이 좋습니다.