핵심 구성 요소를 기반으로 하는 적응형 양식에서 적응형 Forms 단편 만들기 및 사용 adaptive-form-fragments
모든 양식은 특정 목적을 위해 디자인되었지만 대부분의 양식에는 이름 및 주소, 가족 세부 사항, 소득 세부 사항 등의 개인 세부 사항을 제공하는 것과 같은 몇 가지 일반적인 세그먼트가 있습니다. 양식 개발자는 새 양식을 만들 때마다 이러한 공통 세그먼트를 만들어야 합니다.
적응형 Forms은 패널 또는 필드 그룹과 같은 양식 세그먼트를 한 번만 만들어 적응형 Forms 간에 재사용할 수 있는 편리한 메커니즘을 제공합니다. 이러한 재사용 가능한 독립 세그먼트를 적응형 양식 조각이라고 합니다.
양식 조각은 여러 양식에 원활하게 통합되어 일관되고 전문적인 양식을 간편하게 만들 수 있습니다. 양식 조각의 “한번 변경하여 전체 반영” 기능을 통해 재사용성, 표준화와 브랜드 일관성을 보장합니다. 한 위치에서의 업데이트가 이러한 조각을 활용하는 모든 양식에 자동으로 전파되므로 유지 관리 가능성과 효율성이 개선됩니다.
문서에 조각을 여러 번 추가하고 해당 구성 요소의 데이터 바인딩 속성을 사용하여 다른 데이터 소스 또는 스키마에 연결할 수 있습니다. 예를 들어 영구, 통신 및 청구 주소에 동일한 주소 조각을 사용하고 이를 데이터 소스 또는 스키마의 다른 필드에 연결할 수 있습니다.
양식 단편 만들기 create-a-fragment
적응형 양식 조각을 처음부터 만들거나 기존 적응형 양식에 패널을 조각으로 저장할 수 있습니다. 양식 조각을 만들려면 다음 작업을 수행하십시오.
-
https://[호스트 이름]:[포트]/aem/forms.html에서 AEM Forms 인스턴스에 로그인합니다.
-
만들기 > 적응형 양식 조각 을 클릭합니다.
-
조각의 제목, 이름, 설명 및 태그를 지정합니다. 조각에 고유한 이름을 지정해야 합니다. 동일한 이름의 다른 조각이 존재하는 경우 조각을 생성하지 못합니다.
-
양식 템플릿을 선택합니다. 적응형 Forms 또는 기초 구성 요소 기반 적응형 Forms 또는 적응형 에 대한 양식 조각을 만들 수 있습니다.
- 핵심 구성 요소 기반 양식에 대한 양식 조각을 만들려면 핵심 구성 요소 기반 템플릿을 선택합니다.
- 기초 구성 요소 기반 양식에 대한 양식 조각을 생성하려면 기초 구성 요소 템플릿을 선택합니다. 예: /libs/fd/af/templateForFragment/defaultFragmentTemplate.
핵심 구성 요소 기반 양식의 양식 조각을 만들 때 양식 테마 선택 옵션을 사용하여 핵심 구성 요소 기반 테마를 선택합니다.
-
클릭하여 양식 모델 탭을 열고 다음에서 선택 드롭다운 메뉴에서 조각에 대해 다음 모델 중 하나를 선택합니다.
-
없음: 양식 모델을 사용하지 않고 조각을 처음부터 만들도록 지정합니다.
note note NOTE 적응형 Forms에서 단일 양식 조각(핵심 구성 요소 기반)을 여러 번 사용할 수 있습니다. none 기반 양식 조각과 schema 기반 양식 조각을 모두 지원합니다. -
스키마: AEM Forms에 업로드된 XML 또는 JSON 스키마를 사용하여 조각을 만들도록 지정합니다. 사용 가능한 XML 또는 JSON 스키마 중에서 조각을 위한 양식 모델로 업로드하거나 선택할 수 있습니다. XML 스키마를 선택하면 XML 스키마 복합 유형 드롭다운 상자에서 선택한 스키마에 있는 복합 유형을 선택하여 적응형 양식 조각을 만들 수도 있습니다. JSON 스키마를 선택하면 JSON 스키마 정의 드롭다운 상자에서 선택한 스키마에 있는 스키마 정의를 선택하여 적응형 양식 조각을 만들 수도 있습니다.
-
양식 데이터 모델: 양식 데이터 모델을 사용하여 조각을 만들도록 지정합니다. 양식 데이터 모델에서 하나의 데이터 모델 개체만 기반으로 적응형 양식 조각을 만들 수 있습니다. 양식 데이터 모델 정의 드롭다운 확장 지정된 양식 데이터 모델의 모든 데이터 모델 개체를 나열합니다. 목록에서 데이터 모델 개체를 선택합니다.
-
-
[만들기 ]를 클릭한 다음 [열기 ]를 클릭하여 편집 모드에서 기본 템플릿 조각을 엽니다. 편집 모드에서 적응형 양식 구성 요소를 조각에 추가할 수 있습니다.
스키마 또는 양식 데이터 모델을 기반으로 하는 적응형 양식 조각이 생성되면 적응형 양식 편집기에 있는 콘텐츠 브라우저의 데이터 소스 탭에 양식 데이터 모델 또는 스키마 요소가 나타납니다. 양식 모델 요소를 조각에 드래그 앤 드롭할 수 있습니다. 추가된 양식 모델 요소는 연결된 스키마의 원래 속성을 유지하면서 양식 구성 요소로 변환됩니다.
적응형 양식에 조각 추가 insert-a-fragment-in-an-adaptive-form
적응형 양식에 적응형 양식 조각을 추가하려면 다음 작업을 수행하십시오.
-
편집 모드에서 적응형 양식을 엽니다.
-
적응형 양식 조각 구성 요소를 양식에 추가하십시오.
-
사이드바에서 Assets 컨텐츠 브라우저를 클릭합니다. 자산 브라우저의 경로에서 적응형 양식 조각 옵션을 선택합니다. 양식의 모델에 따라 양식에 사용할 수 있는 모든 적응형 Forms 조각이 표시됩니다.
-
적응형 양식 단편을 적응형 양식의 적응형 양식 단편 구성 요소로 끌어다 놓습니다.
note note NOTE 적응형 양식 내에서 작성하려면 적응형 양식 조각을 사용할 수 없습니다. 또한 JSON 기반 적응형 양식에서 XSD 기반 조각을 사용할 수 없으며 그 반대의 방법도 사용할 수 없습니다.
적응형 양식 조각은 적응형 양식을 참조하여 추가되고 독립형 적응형 양식 조각과 동기화된 상태로 유지됩니다. 이는 적응형 양식 조각에 대한 모든 수정 사항이 조각이 적응형 Forms 내에 통합된 모든 인스턴스에 미러링됨을 의미합니다.
적응형 양식에 단편 포함 embed-a-fragment-in-adaptive-form
추가된 조각의 패널 도구 모음인 포함
포함된 조각은 더 이상 독립형 조각과 연결되지 않습니다. 적응형 양식 내에서 포함된 조각의 구성 요소를 편집할 수 있습니다.
조각 내 조각 사용 using-fragments-within-fragments
중첩된 적응형 양식 조각을 만들 수 있습니다. 즉, 다른 조각에서 조각을 드래그 앤 드롭할 수 있고 중첩된 조각 구조를 가질 수 있습니다.
적응형 양식에서 양식 조각을 여러 번 사용 using-form-fragment-mutiple-times-in-af
적응형 양식에서 비기반 및 스키마 기반 양식 조각을 여러 번 사용하여 각 양식 조각 필드에 대해 데이터를 고유하게 저장할 수 있습니다. 예를 들어, 주소 양식 조각을 사용하여 영구, 통신 및 현재 거주 주소에 대한 주소 세부 정보를 대출 애플리케이션 양식으로 수집할 수 있습니다.
데이터 바인딩을 위한 조각의 자동 매핑 auto-mapping-of-fragments-for-data-binding
XFA 양식 템플릿 또는 XSD 복합 유형을 사용하여 적응형 양식 조각을 만들고 해당 조각을 적응형 양식으로 드래그 앤 드롭하면 XFA 조각 또는 XSD 복합 유형이 조각 모델 루트가 XFA 조각 또는 XSD 복합 유형에 매핑된 해당 적응형 양식 조각으로 자동 대체됩니다.
구성 요소 편집 대화 상자에서 조각 에셋과 해당 바인딩을 변경할 수 있습니다.
AEM 콘텐츠 파인더의 적응형 양식 단편 라이브러리에서 바인딩된 적응형 양식 단편을 드래그 앤 드롭하고 적응형 양식 단편 패널의 구성 요소 편집 대화 상자에서 올바른 바인딩 참조를 제공할 수도 있습니다.
조각 관리 manage-fragments
AEM Forms UI를 사용하여 적응형 양식 조각에 대해 여러 작업을 수행할 수 있습니다.
-
https://[hostname]/aem/forms.html로 이동합니다. -
AEM Forms UI 도구 모음에서 선택 을 클릭하고 적응형 양식 조각을 선택합니다. 도구 모음에는 선택한 적응형 양식 조각에서 수행할 수 있는 다음 작업이 표시됩니다.
조각을 사용하여 작업할 때 기억해야 할 주요 사항 key-points-to-remember-when-working-with-fragments
- 조각 이름이 고유한지 확인합니다. 같은 이름의 기존 조각이 있는 경우 조각을 만들 수 없습니다.
- XDP 기반 적응형 양식에서 다른 XDP 조각을 포함하는 조각으로 패널을 저장하면 결과 조각이 하위 XDP 조각에 자동으로 바인딩됩니다. XSD 기반 적응형 양식인 경우 결과 조각은 스키마 루트에 바인딩됩니다.
- 적응형 양식 조각을 만들면 CRXDE Lite에서 적응형 양식에 대한 guideContainer 노드와 유사한 조각 노드가 만들어집니다.
- 다른 양식 데이터 모델을 사용하는 적응형 양식의 조각은 지원되지 않습니다. 예를 들어 XDP 기반 조각은 XSD 기반 적응형 양식에서 지원되지 않으며, 이와 반대입니다.
- 적응형 양식 조각은 AEM 콘텐츠 파인더의 적응형 양식 조각 탭을 통해 사용할 수 있습니다.
- 독립형 적응형 양식 조각의 모든 표현식, 스크립트 또는 스타일은 참조로 삽입되거나 적응형 양식에 임베드될 때 유지됩니다.
- 참조에 의해 삽입된 적응형 양식 단편을 적응형 양식 내에서 편집할 수 없습니다. 편집하려면 독립 실행형 적응형 양식 조각을 편집하거나 적응형 양식에 해당 조각을 임베드하십시오.
- 적응형 양식을 게시할 때 적응형 양식에 참조로 삽입된 독립 실행형 적응형 양식 조각을 게시해야 합니다.
- 업데이트된 적응형 양식 조각을 다시 게시하면 변경 사항이 조각이 사용되는 적응형 양식의 게시된 인스턴스에 반영됩니다.
- 확인 구성 요소가 포함된 적응형 양식은 익명 사용자를 지원하지 않습니다. 또한 적응형 양식 조각에서 확인 구성 요소를 사용하는 것은 권장되지 않습니다.
- (Mac만 해당) 양식 단편 기능이 모든 시나리오에서 완벽하게 작동하도록 하려면 /private/etc/hosts 파일에 다음 항목을 추가합니다.
127.0.0.1 <Host machine>호스트 컴퓨터: AEM Forms이 배포된 Apple Mac 컴퓨터입니다.
참조 조각 reference-fragments
양식을 만드는 데 사용할 수 있는 적응형 양식 조각을 참조하십시오.