콘텐츠 조각 모델 정의 defining-content-fragment-models
Adobe Experience Manager(AEM) as a Cloud Service의 콘텐츠 조각 모델은 콘텐츠 조각의 콘텐츠 구조를 정의합니다. 그런 다음 이 조각은 페이지 작성에 사용하거나 Headless 콘텐츠의 기반으로 사용할 수 있습니다.
이 페이지에서는 전용 편집기를 사용하여 콘텐츠 조각 모델을 정의하는 방법을 다룹니다. 콘텐츠 조각 콘솔에서 사용할 수 있는 작업, 폴더에서 모델 허용 및 모델 게시를 포함하여 조각을 만든 후 사용할 수 있는 추가 작업 및 옵션에 대해서는 콘텐츠 조각 모델 관리를 참조하십시오.
콘텐츠 조각 모델 정의 defining-your-content-fragment-model
콘텐츠 조각 모델은 다양한 데이터 유형 을 사용하여 최종 콘텐츠 조각의 구조를 효과적으로 정의합니다. 모델 편집기를 사용하여 데이터 유형의 인스턴스를 추가한 다음 필요한 필드를 만들도록 구성할 수 있습니다.
-
콘텐츠 조각 콘솔에서 콘텐츠 조각 모델에 대한 패널을 선택하고 콘텐츠 조각 모델을 포함하는 폴더로 이동합니다.
note note NOTE 모델을 만든 후바로 모델을 열 수도 있습니다. -
편집 에 필요한 모델을 엽니다. 빠른 작업을 사용하거나, 모델을 선택한 후 도구 모음에서 작업을 선택하십시오.
모델 편집기를 열면 다음과 같이 표시됩니다.
- 왼쪽: 이미 정의된 필드
- 오른쪽: 필드를 만드는 데 사용할 수 있는 데이터 유형(필드가 만들어지면 사용할 속성)
note note NOTE 필드가 필수 로 정의되는 경우, 왼쪽 창에 나타나는 레이블 이 별표(*)와 함께 표시됩니다. 
-
필드를 추가하려면
-
필수 데이터 유형을 필드에 필요한 위치로 드래그합니다.
-
모델에 필드가 추가되면 오른쪽 패널에 그 특정 데이터 유형에 대해 정의할 수 있는 속성 이 표시됩니다. 여기에서 해당 필드에 필요한 사항을 정의할 수 있습니다.
-
설명이 따로 필요하지 않은 속성도 많습니다. 자세한 내용은 속성(데이터 형식)을 참조하세요.
-
필드 레이블 을 입력하면 속성 이름 이 자동으로 채워집니다. 비어 있는 경우 이후에 수동으로 업데이트할 수 있습니다.
note caution CAUTION 데이터 유형의 속성 이름 속성을 수동으로 업데이트할 때에는 이름에 A-Z, a-z, 0-9 및 밑줄 “_”만 포함해야 합니다. 이전 버전의 AEM에서 만든 모델에 잘못된 문자가 포함되어 있는 경우, 해당 문자를 제거하거나 업데이트하십시오.
예:
-
-
-
필드를 제거하려면
필수 필드를 선택한 다음 휴지통 아이콘을 선택합니다. 작업을 확인하는 메시지가 표시됩니다.
-
모든 필수 필드를 추가하고 필요에 따라 관련 속성을 정의합니다. 예:
-
정의를 유지하려면 저장 을 선택합니다.
데이터 유형 data-types
모델을 정의하는 데 다양한 데이터 유형을 사용할 수 있습니다.
-
한 줄 텍스트
- 한 줄의 텍스트에 대한 필드를 추가합니다. 최대 길이를 정의할 수 있습니다.
- 조각 작성자가 필드의 새 인스턴스를 만들 수 있도록 필드를 구성할 수 있습니다
-
여러 줄 텍스트
- 리치 텍스트, 일반 텍스트 또는 Markdown일 수 있는 텍스트 영역입니다.
- 조각 작성자가 필드의 새 인스턴스를 만들 수 있도록 필드를 구성할 수 있습니다
note note NOTE 텍스트 영역이 리치 텍스트, 일반 텍스트 또는 Markdown 인지 여부는 모델에서 기본 유형 속성에 의해 정의됩니다. 이 포맷은 콘텐츠 조각 편집기가 아니라 모델에서만 변경할 수 있습니다. -
숫자
- 숫자 필드 추가
- 조각 작성자가 필드의 새 인스턴스를 만들 수 있도록 필드를 구성할 수 있습니다
-
부울
- 부울 확인란을 추가합니다.
-
날짜 및 시간
- 날짜 및/또는 시간 필드 추가
-
열거
- 확인란, 라디오 버튼 또는 드롭다운 필드 세트 추가
- 조각 작성자가 사용할 수 있는 옵션을 지정할 수 있습니다
- 확인란, 라디오 버튼 또는 드롭다운 필드 세트 추가
-
태그
- 조각 작성자가 태그의 영역에 액세스하고 선택할 수 있습니다.
-
조각 참조
-
다른 콘텐츠 조각을 참조합니다. 중첩된 콘텐츠를 생성하는 데 사용할 수 있습니다.
-
조각 작성자가 다음과 같은 작업을 수행할 수 있도록 데이터 유형을 구성할 수 있습니다.
- 참조된 조각 직접 편집
- 적절한 모델을 기반으로 새 콘텐츠 조각 만들기
- 필드의 새 인스턴스 만들기
-
참조는 참조된 리소스에 대한 경로를 지정합니다(예:
/content/dam/path/to/resource).
-
-
조각 참조(UUID)
-
다른 콘텐츠 조각을 참조합니다. 중첩된 콘텐츠를 생성하는 데 사용할 수 있습니다.
-
조각 작성자가 다음과 같은 작업을 수행할 수 있도록 데이터 유형을 구성할 수 있습니다.
- 참조된 조각 직접 편집
- 적절한 모델을 기반으로 새 콘텐츠 조각 만들기
- 필드의 새 인스턴스 만들기
-
편집기에서 참조는 참조된 리소스에 대한 경로를 지정합니다. 내부적으로 참조는 리소스를 참조하는 UUID(범용 고유 ID)로 유지됩니다
- UUID를 알 필요가 없습니다. 조각 편집기에서 필요한 조각을 찾아볼 수 있습니다
-
-
콘텐츠 참조
- 모든 유형의 다른 콘텐츠를 참조합니다. 중첩된 콘텐츠를 생성하는 데 사용할 수 있습니다.
- 이미지가 참조되면 썸네일을 표시하도록 선택할 수 있습니다.
- 조각 작성자가 필드의 새 인스턴스를 만들 수 있도록 필드를 구성할 수 있습니다
- 참조는 참조된 리소스에 대한 경로를 지정합니다(예:
/content/dam/path/to/resource).
-
콘텐츠 참조(UUID)
- 모든 유형의 다른 콘텐츠를 참조합니다. 중첩된 콘텐츠를 생성하는 데 사용할 수 있습니다.
- 이미지가 참조되면 썸네일을 표시하도록 선택할 수 있습니다.
- 조각 작성자가 필드의 새 인스턴스를 만들 수 있도록 필드를 구성할 수 있습니다
- 편집기에서 참조는 참조된 리소스에 대한 경로를 지정합니다. 내부적으로 참조는 리소스를 참조하는 UUID(범용 고유 ID)로 유지됩니다
- UUID를 알 필요가 없습니다. 조각 편집기에서 필요한 에셋 리소스를 찾아볼 수 있습니다
-
JSON 오브젝트
-
콘텐츠 조각 작성자는 조각의 해당 요소에 JSON 구문을 입력할 수 있습니다.
- AEM이 다른 서비스에서 복사/붙여넣기한 직접 JSON을 저장하도록 합니다.
- JSON이 전달되고 GraphQL에서 JSON으로 출력됩니다.
- 콘텐츠 조각 편집기에 JSON 구문 강조, 자동 채우기 및 오류 강조 표시를 포함합니다.
-
-
탭 플레이스홀더
-
콘텐츠 조각 콘텐츠를 편집할 때 사용할 탭을 가져올 수 있습니다.
- 이는 모델 편집기에서 콘텐츠 데이터 유형 목록의 섹션을 구분하는 구분선으로 표시됩니다. 각 인스턴스는 새 탭의 시작을 나타냅니다.
- 조각 편집기에서 각 인스턴스는 탭으로 표시됩니다.
note note NOTE 이 데이터 유형은 순전히 서식에 사용되며 AEM GraphQL 스키마에서는 무시됩니다.
-
속성(데이터 유형) properties
설명이 따로 필요하지 않은 특정 속성들에 대한 자세한 내용은 아래를 참조하십시오.
-
속성 이름
데이터 유형의 이 속성을 수동으로 업데이트할 때에는 이름에 A-Z, a-z, 0-9 및 밑줄 “_”만 포함해야 합니다.
note caution CAUTION 이전 버전의 AEM에서 만든 모델에 잘못된 문자가 포함되어 있는 경우, 해당 문자를 제거하거나 업데이트하십시오. -
렌더링 형식
조각의 필드를 구현하거나 렌더링하기 위한 다양한 옵션입니다. 이를 통해 작성자에게 필드의 단일 인스턴스가 표시되는지 또는 작성자가 여러 인스턴스를 만들 수 있는지를 정의할 수 있습니다. 여러 필드 를 사용하면 최소 및 최대 항목 수를 정의할 수 있습니다. 자세한 내용은 유효성 검사를 참조하세요.
-
필드 레이블
필드 레이블 을 입력하면 속성 이름 이 자동으로 생성되며, 필요한 경우 수동으로 업데이트할 수 있습니다. -
유효성 검사
기본 유효성 검사는 필수 속성과 같은 메커니즘을 통해 사용할 수 있습니다. 일부 데이터 유형에는 추가 유효성 검사 필드가 있습니다. 자세한 내용은 유효성 검사를 참조하십시오. -
데이터 유형 여러 줄 텍스트 의 경우 기본 유형 을 다음 중 하나로 정의할 수 있습니다.
- 리치 텍스트
- Markdown
- 일반 텍스트
지정하지 않으면 이 필드에 기본값인 리치 텍스트 가 사용됩니다.
콘텐츠 조각 모델의 기본 유형 변경은 해당 조각을 편집기에서 열고 저장한 후에 기존 관련 콘텐츠 조각에만 적용됩니다.
-
고유
특정 필드의 경우, 콘텐츠는 현재 모델에서 만들어진 모든 콘텐츠 조각에서 고유해야 합니다.콘텐츠 작성자가 동일한 모델의 다른 조각에 이미 추가된 콘텐츠를 반복할 수 없도록 하는 데 사용됩니다.
예를 들어
Country라고 하는 콘텐츠 조각 모델의 한 줄 텍스트 필드는 두 개의 종속 콘텐츠 조각에서Japan값을 가질 수 없습니다. 두 번째 인스턴스를 시도하면 경고가 표시됩니다.note note NOTE 언어 루트별로 고유성이 보장됩니다. note note NOTE 변형은 동일한 조각의 변형과 동일한 고유 값을 가질 수 있지만, 다른 조각의 변형에 사용되는 것과 동일한 값을 가질 수는 없습니다. -
특정 데이터 유형 및 그 속성에 대한 자세한 내용은 콘텐츠 참조 를 참조하십시오.
-
특정 데이터 유형 및 그 속성에 대한 자세한 내용은 조각 참조(중첩된 조각) 를 참조하십시오.
-
변환 가능
콘텐츠 조각 모델 편집기의 필드에서 변환 가능 확인란을 선택하면
- 필드의 속성 이름이 아직 존재하지 않는 경우 번역 구성, 컨텍스트
/content/dam/<sites-configuration>에 추가됩니다. - GraphQL의 경우: 콘텐츠 조각 필드의
<translatable>속성을yes로 설정하여 GraphQL 쿼리가 변환 가능한 콘텐츠만 포함하는 JSON 출력을 필터링하도록 합니다.
- 필드의 속성 이름이 아직 존재하지 않는 경우 번역 구성, 컨텍스트
유효성 검사 validation
이제 다양한 데이터 유형에는 최종 조각에 콘텐츠를 입력하는 경우에 대한 유효성 검사 요구 사항을 정의할 수 있는 기능이 포함됩니다.
-
한 줄 텍스트
- 사전 정의된 정규 표현식과 비교합니다.
-
숫자
- 특정 값을 확인합니다.
-
콘텐츠 참조
- 특정 유형의 콘텐츠를 테스트합니다.
- 지정된 파일 크기 이하의 자산만 참조할 수 있습니다.
- 사전 정의된 폭 및/또는 높이 범위(픽셀 단위) 내의 이미지만 참조할 수 있습니다.
-
조각 참조
- 특정 콘텐츠 조각 모델을 테스트합니다.
-
최소 항목 수 / 최대 항목 수
다중 필드(렌더링 형식(으)로 설정)로 정의된 필드에는 다음 옵션이 있습니다.
- 최소 항목 수
- 최대 항목 수
콘텐츠 조각 편집기에서 유효성을 검사합니다.
참조를 사용하여 중첩된 콘텐츠 형성 using-references-to-form-nested-content
콘텐츠 조각은 다음 데이터 유형 중 하나를 사용하여 중첩된 콘텐츠를 형성할 수 있습니다.
-
-
모든 유형의 다른 콘텐츠에 대한 간단한 참조를 제공합니다.
-
데이터 유형에서 제공:
- 콘텐츠 참조 - 경로 기반
- UUID(콘텐츠 참조) - UUID 기반
-
최종 조각에서 하나 이상의 참조에 대해 구성할 수 있습니다.
-
-
조각 참조(중첩된 조각)
-
지정된 특정 모델에 따라 다른 조각을 참조합니다.
-
데이터 유형에서 제공:
- 조각 참조 - 경로 기반
- 조각 참조(UUID) - UUID 기반
-
구조화된 데이터를 포함/검색할 수 있습니다.
note note NOTE 이 방법은 특히 GraphQL을 통해 콘텐츠 조각을 사용하여 Headless 콘텐츠를 게재할 때 사용할 수 있습니다. * 최종 조각에서 하나 이상의 참조에 대해 구성할 수 있습니다.
-
-
콘텐츠 참조
이렇게 하면 사용자가 현재 조각에 대한 참조를 추가할 수 없으며 빈 조각 참조 선택기 대화 상자가 나타날 수 있습니다. -
GraphQL의 조각 참조
서로 참조하는 여러 콘텐츠 조각을 반환하는 복합 쿼리를 만들면 첫 번째 발생 시 null을 반환합니다.
콘텐츠 참조 content-reference
콘텐츠 참조 및 콘텐츠 참조(UUID) 데이터 형식을 사용하면 다른 소스의 콘텐츠를 렌더링할 수 있습니다(예: 이미지, 페이지 또는 경험 조각).
표준 속성 외에 다음을 지정할 수 있습니다.
조각 참조(중첩된 조각) fragment-reference-nested-fragments
조각 참조 및 조각 참조(UUID) 데이터 형식은 하나 이상의 콘텐츠 조각을 참조할 수 있습니다. 여러 계층으로 구조화된 데이터를 검색할 수 있어 앱에서 사용할 콘텐츠를 검색할 때 특히 유용한 기능입니다.
예:
- 다음을 포함하는 직원의 세부 정보를 정의하는 모델
- 고용주(회사)를 정의하는 모델에 대한 참조
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
표준 속성 외에 다음을 정의할 수 있습니다.
-
렌더링 형식:
-
다중 필드 - 조각 작성자는 여러 개별 참조를 생성할 수 있습니다.
-
조각 참조 - 조각 작성자가 조각에 대한 단일 참조를 선택하도록 합니다.
-
-
모델 유형
여러 모델을 선택할 수 있습니다. 참조를 콘텐츠 조각에 추가할 때 이러한 모델을 사용하여 참조된 조각을 만들어야 합니다. -
루트 경로
참조된 조각의 루트 경로를 지정하거나 나타냅니다. -
조각 생성 허용
이를 통해 조각 작성자는 적절한 모델을 기반으로 조각을 만들 수 있습니다.
- 조각 참조 합성 - 이 기능을 사용하면 조각 작성자가 여러 조각을 선택하여 합성을 빌드할 수 있습니다.
