컨텐츠 조각 모델

컨텐츠 조각 모델은 컨텐츠 조각에 대한 컨텐츠 구조를 정의합니다.

컨텐츠 조각 모델을 사용하려면 다음을 수행합니다.

  1. 인스턴스에 대한 컨텐츠 조각 모델 기능 활성화
  2. 컨텐츠 조각 모델 생성구성
  3. 컨텐츠 조각을 만들 때 사용할 컨텐츠 조각을 만들 때 사용할 컨텐츠 조각 모델을 활성화합니다.
  4. 정책을 구성하여 필요한 자산 폴더의 컨텐츠 조각 모델을 허용합니다.

컨텐츠 조각 모델 만들기

  1. 도구, 자산​으로 이동한 후 컨텐츠 조각 모델​을 엽니다.

  2. 구성에 적절한 폴더로 이동합니다.

  3. 만들기​를 사용하여 마법사를 엽니다.

    주의

    컨텐츠 조각 모델 사용이 활성화되지 않은 경우 만들기 옵션을 사용할 수 없습니다.

  4. 모델 제목​을 지정합니다. 태그, 설명​을 추가하고 필요한 경우 모델 활성화를 선택하여 모델](#enabling-disabling-a-content-fragment-model)을 활성화할 수 있습니다.[

    제목 및 설명

  5. 만들기​를 사용하여 빈 모델을 저장합니다. 작업의 성공을 나타내는 메시지가 표시되면 열기​를 선택하여 모델을 즉시 편집하거나 완료​를 선택하여 콘솔로 돌아갈 수 있습니다.

컨텐츠 조각 모델 정의

컨텐츠 조각 모델은 데이터 유형 선택을 사용하여 결과 컨텐츠 조각 구조를 효과적으로 정의합니다. 모델 편집기를 사용하여 데이터 유형의 인스턴스를 추가한 다음 이를 구성하여 필수 필드를 만들 수 있습니다.

주의

기존 컨텐츠 조각 모델을 편집하면 종속된 조각이 영향을 받을 수 있습니다.

  1. 도구, 자산​으로 이동한 후 컨텐츠 조각 모델​을 엽니다.

  2. 컨텐츠 조각 모델을 포함하는 폴더로 이동합니다.

  3. 편집​에 필요한 모델을 엽니다. 빠른 작업을 사용하거나, 모델을 선택한 후 도구 모음에서 작업을 선택하십시오.

    모델 편집기를 열면 다음과 같이 표시됩니다.

    • 왼쪽: 이미 정의된 필드
    • 오른쪽: 필드를 만드는 데 사용할 수 있는 데이터 유형(필드가 만들어지면 사용할 속성)
    노트

    필드가 필수​이면 왼쪽 창에 표시되는 레이블​이 지정된 레이블은 별표(*)로 표시됩니다.

    속성

  4. 필드를 추가하려면

    • 필수 데이터 유형을 필드에 필요한 위치로 드래그합니다.

      필드에 대한 데이터 유형

    • 모델에 필드가 추가되면 오른쪽 패널에 그 특정 데이터 유형에 대해 정의할 수 있는 속성​이 표시됩니다. 여기에서 해당 필드에 필요한 사항을 정의할 수 있습니다.

      • 많은 속성은 자체 설명이므로 자세한 내용은 속성을 참조하십시오.
      • 필드 레이블​을 입력하면 속성 이름(비어 있는 경우)이 자동으로 완료되고 이후 수동으로 업데이트할 수 있습니다.

      예:

      필드 속성

  5. 필드를 제거하려면

    필요한 필드를 선택한 후 휴지통 아이콘을 클릭/탭합니다. 작업을 확인하는 메시지가 나타납니다.

    제거

  6. 필요한 모든 필드를 추가하고 필요에 따라 관련 속성을 정의합니다. 예:

    save

  7. 저장​을 선택하여 정의를 유지합니다.

데이터 유형

모델을 정의하는 데 사용할 수 있는 데이터 유형은 다음과 같습니다.

  • 한 줄 텍스트
    • 단일 텍스트 줄의 필드를 하나 이상 추가합니다.최대 길이를 정의할 수 있습니다.
  • 여러 줄 텍스트
    • 서식 있는 텍스트, 일반 텍스트 또는 마크다운일 수 있는 텍스트 영역
  • 번호
    • 숫자 필드를 하나 이상 추가합니다.
  • 부울
    • 부울 확인란 추가
  • 날짜 및 시간
    • 날짜 및/또는 시간 추가
  • 열거
    • 확인란, 라디오 단추 또는 드롭다운 필드 추가
  • 태그
    • 조각 작성자가 태그 영역에 액세스하고 선택할 수 있습니다.
  • 컨텐츠 참조
  • 조각 참조
    • 기타 컨텐츠 조각 참조은(는) 중첩 컨텐트 만들기에 사용할 수 있습니다.
    • 조각 작성자가 다음을 수행할 수 있도록 데이터 유형을 구성할 수 있습니다.
      • 참조된 조각을 직접 편집합니다.
      • 적절한 모델을 기반으로 새 컨텐츠 조각 만들기
  • JSON 개체
    • 컨텐츠 조각 작성자가 조각의 해당 요소에 JSON 구문을 입력할 수 있습니다.
      • 다른 서비스에서 복사/붙여 넣은 JSON을 AEM에 저장하도록 허용하려면.
      • JSON은 전달되고 GraphQL에서 JSON으로 출력됩니다.
      • 컨텐츠 조각 편집기에 JSON 구문 강조, 자동 완성 및 오류 강조 표시가 포함되어 있습니다.

속성

많은 속성이 자체 설명이므로 특정 속성에 대한 자세한 내용은 다음과 같습니다.

  • 렌더링조각
    에서 필드를 구현하거나 렌더링하기 위한 다양한 옵션입니다. 종종 이 기능을 사용하면 작성자가 필드의 단일 인스턴스를 표시할지 또는 여러 인스턴스를 만들 수 있는지 정의할 수 있습니다.

  • 필드
    레이블에
    필드 레이블은 속성 이름을 자동으로 생성하며, 필요한 경우 수동으로 업데이트할 수 있습니다.

  • ValidationBasic
    유효성 검사는 Requirements 속성과 같은 메커니즘에 의해 ​제공됩니다. 일부 데이터 유형에는 추가 유효성 검사 필드가 있습니다. 자세한 내용은 유효성 검사를 참조하십시오.

  • 데이터 유형 여러 줄 텍스트​의 경우 기본 유형​을 다음 중 하나로 정의할 수 있습니다.

    • 리치 텍스트
    • Markdown
    • 일반 텍스트

    지정하지 않으면 이 필드에 기본값인 리치 텍스트​가 사용됩니다.

    컨텐츠 조각 모델의 기본 유형 변경은 해당 조각을 편집기에서 열고 저장한 후에 기존 관련 컨텐츠 조각에만 적용됩니다.


  • UniqueContent(특정 필드의 경우)는 현재 모델에서 생성된 모든 컨텐츠 조각에서 고유해야 합니다.

    컨텐츠 작성자가 동일한 모델의 다른 조각에 이미 추가된 컨텐츠를 반복할 수 없도록 하는 데 사용됩니다.

    예를 들어 컨텐츠 조각 모델의 Country라는 단일 행 텍스트​필드는 두 개의 종속 컨텐츠 조각에 있는 Japan 값을 가질 수 없습니다. 두 번째 인스턴스를 시도하면 경고가 표시됩니다.

    노트

    언어 루트별로 고유성이 보장됩니다.

    노트

    변형은 동일한 조각의 변형과 동일한 고유 값을 가질 수 있지만 다른 조각의 변형에 사용된 값과 동일한 값을 가질 수는 없습니다.

  • 번역
    가능 CF 모델 편집기의 필드에서 "번역 가능" 체크 상자를 선택하면

    • 아직 없는 경우 필드의 속성 이름이 번역 구성 /content/dam/<tenant> 컨텍스트에 추가되어 있는지 확인합니다.
    • GraphQL의 경우:[컨텐츠 조각] 필드의 <translatable> 속성을 yes로 설정하여 번역 가능한 컨텐츠만 포함하는 JSON 출력에 대해 GraphQL 쿼리 필터를 허용합니다.
  • 특정 데이터 유형 및 해당 속성에 대한 자세한 내용은 조각 참조(중첩된 조각)​을 참조하십시오.

유효성 검사

이제 다양한 데이터 유형에는 결과 조각에서 컨텐츠를 입력할 때 유효성 검사 요구 사항을 정의할 수 있는 가능성이 포함됩니다.

  • 한 줄 텍스트
    • 미리 정의된 regex와 비교합니다.
  • 번호
    • 특정 값을 확인합니다.
  • 컨텐츠 참조
    • 특정 유형의 컨텐츠를 테스트합니다.
    • 지정된 파일 크기 이하의 자산만 참조할 수 있습니다.
    • 미리 정의된 폭 및/또는 높이 범위(픽셀 단위) 내의 이미지만 참조할 수 있습니다.
  • 조각 참조
    • 특정 컨텐츠 조각 모델을 테스트합니다.

참조 기능을 사용하여 중첩 컨텐트만들기

컨텐츠 조각은 다음 데이터 유형 중 하나를 사용하여 중첩된 컨텐츠를 만들 수 있습니다.

  • 컨텐츠 참조

    • 다른 콘텐트에 대한 간단한 참조를 제공합니다.모든 유형의
    • 하나 이상의 참조(결과 조각에서)에 대해 구성할 수 있습니다.
  • 조각 참조 (중첩된 조각)

    • 지정된 특정 모델에 따라 다른 조각을 참조합니다.

    • 구조화된 데이터를 포함/검색할 수 있습니다.

      노트

      이 방법은 GraphQL](/docs/experience-manager-cloud-service/assets/content-fragments/content-fragments-graphql.html?lang=ko)과 함께 내용 조각을 사용하여 [헤드리스 컨텐츠 전달과 함께 특히 유용합니다.

    • 하나 이상의 참조(결과 조각에서)에 대해 구성할 수 있습니다.

노트

AEM은 다음과 같은 경우에 재발을 보호할 수 있습니다.

  • 컨텐츠 참조
    이렇게 하면 사용자가 현재 조각에 대한 참조를 추가할 수 없습니다. 이로 인해 빈 조각 참조 선택기 대화 상자가 생길 수 있습니다.
  • GraphQL의 조각 참조
    서로 참조하는 여러 개의 컨텐츠 조각을 반환하는 딥 쿼리를 만들면 처음 발생할 때 null을 반환합니다.

컨텐츠 참조

컨텐츠 참조를 사용하면 다른 소스의 컨텐츠를 렌더링할 수 있습니다.예: 이미지 또는 컨텐츠 조각.

표준 속성 외에 다음을 지정할 수 있습니다.

  • 참조된 콘텐츠에 대한 루트 경로.
  • 참조할 수 있는 컨텐츠 유형입니다.
  • 파일 크기에 대한 제한 사항.
  • 이미지 제한. 컨텐츠 참조

조각 참조(중첩된 조각)

조각 참조는 하나 이상의 컨텐츠 조각을 참조합니다. 여러 레이어로 구조화된 데이터를 검색할 수 있으므로 앱에서 사용할 콘텐츠를 검색할 때 특히 관심 있는 기능입니다.

예:

  • 사원의 상세내역을 정의하는 모델다음과 같습니다.
    • 고용주(회사)를 정의하는 모델에 대한 참조
type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}
노트

이는 GraphQL](/docs/experience-manager-cloud-service/assets/content-fragments/content-fragments-graphql.html?lang=ko)의 컨텐츠 조각을 사용하여 [헤드리스 컨텐츠 제공과 함께 특히 유용합니다.

표준 속성 외에 다음을 정의할 수 있습니다.

  • 렌더링 형식:

    • 멀티필드 - 조각 작성자가 여러 개의 개별 참조를 만들 수 있습니다.

    • fragmentreference - 조각 작성자가 조각 단일 참조를 선택할 수 있습니다.

  • 모델
    유형여러 모델을 선택할 수 있습니다. 컨텐츠 조각을 작성할 때 참조된 조각은 이러한 모델을 사용하여 만들어야 합니다.

  • 루트
    경로참조된 모든 조각의 루트 경로를 지정합니다.

  • 조각 생성 허용

    그러면 조각 작성자가 적절한 모델을 기반으로 새 조각을 만들 수 있습니다.

    • fragmentreferencomposite - 조각 작성자가 여러 조각을 선택하여 합성을 작성할 수 있습니다.

    조각 참조

노트

재발방지 장치가 마련되었다. 따라서 사용자는 조각 참조에서 현재 컨텐츠 조각을 선택할 수 없습니다. 이로 인해 빈 조각 참조 선택기 대화 상자가 생길 수 있습니다.
또한 GraphQL의 조각 참조에 대한 반복 보호가 있습니다. 서로 참조하는 두 개의 컨텐츠 조각에 대해 전체 쿼리를 만들면 null이 반환됩니다.

컨텐츠 조각 모델활성화 또는 비활성화

컨텐츠 조각 모델의 사용을 완벽하게 제어하기 위해 설정할 수 있는 상태가 있습니다.

컨텐츠 조각 모델활성화

모델이 만들어지면 다음을 수행할 수 있도록 활성화해야 합니다.

  • 새 컨텐츠 조각을 만들 때 선택할 수 있습니다.
  • 컨텐츠 조각 모델 내에서 참조할 수 있습니다.
  • GraphQL에서 사용할 수 있습니다.따라서 스키마가 생성됩니다.

다음 중 하나로 플래그가 지정된 모델을 활성화하려면:

  • 초안 :mew(활성화되지 않음).
  • 사용 안 함 :이 특별히 비활성화되어 있습니다.

다음 중 하나에서 Enable 옵션을 사용합니다.

  • 필수 모델이 선택되면 상단 도구 모음입니다.
  • 해당 빠른 작업(필요한 모델 위에 마우스 놓기)입니다.

초안 또는 사용 불가능한 모델 활성화

컨텐츠 조각 모델비활성화

다음과 같은 방법으로 모델을 비활성화할 수도 있습니다.

  • 모델은 더 이상 new 컨텐츠 조각을 만드는 기준으로 사용할 수 없습니다.
  • 하지만:
    • GraphQL 스키마는 계속 생성되며 여전히 쿼리할 수 있습니다(JSON API에 영향을 주지 않기 위해).
    • 모델의 모든 컨텐츠 조각은 GraphQL 끝점에서 쿼리하여 반환할 수 있습니다.
  • 모델을 더 이상 참조할 수 없지만 기존 참조는 그대로 유지되며 GraphQL 끝점에서 쿼리하여 반환할 수 있습니다.

활성화됨​으로 플래그가 지정된 모델을 비활성화하려면 다음 중 하나에서 비활성화 옵션을 사용합니다.

  • 필수 모델이 선택되면 상단 도구 모음입니다.
  • 해당 빠른 작업(필요한 모델 위에 마우스 놓기)입니다.

활성화된 모델 비활성화

자산 폴더에 컨텐츠 조각 모델 허용

컨텐츠 거버넌스를 구현하려면 자산 폴더에 정책​을 구성하여 해당 폴더의 조각 만들기에 허용되는 컨텐츠 조각 모델을 제어할 수 있습니다.

노트

이 메커니즘은 페이지의 고급 속성에서 페이지 템플릿](/docs/experience-manager-cloud-service/sites-cloud/authoring/features/templates.html?lang=ko#allowing-a-template-author)과 해당 하위 페이지를 허용하는 [과 유사합니다.

허용된 컨텐츠 조각 모델​에 대한 정책​을 구성하려면:

  1. 필요한 자산 폴더에 대해 속성​을 탐색하고 엽니다.

  2. 다음 항목을 구성할 수 있는 정책 탭을 엽니다.

    • 상속 위치<folder>

      정책은 새 하위 폴더를 만들 때 자동으로 상속됩니다.하위 폴더가 상위 폴더와 다른 모델을 허용해야 하는 경우 정책을 다시 구성할 수 있습니다(및 상속은 손상됨).

    • 경로에서 허용된 컨텐츠 조각 모델

      여러 모델을 사용할 수 있습니다.

    • 태그로 허용된 컨텐츠 조각 모델

      여러 모델을 사용할 수 있습니다.
      컨텐츠 조각 모델 정책

  3. 변경 사항을 저장합니다.

폴더에 대해 허용되는 컨텐츠 조각 모델은 다음과 같이 해결됩니다.

  • 허용된 컨텐츠 조각 모델​에 대한 정책.
  • 비어 있으면 상속 규칙을 사용하여 정책을 결정하십시오.
  • 상속 체인이 결과를 전달하지 않는 경우 해당 폴더에 대한 Cloud Services 구성(먼저 직접 그리고 상속을 통해)을 확인합니다.
  • 위 항목 중 어떤 결과도 제공하지 않으면 해당 폴더에 대해 허용되는 모델이 없습니다.

컨텐츠 조각 모델 삭제

주의

컨텐츠 조각 모델을 삭제하면 종속된 조각이 영향을 받을 수 있습니다.

컨텐츠 조각 모델을 삭제하려면

  1. 도구, 자산​으로 이동한 후 컨텐츠 조각 모델​을 엽니다.

  2. 컨텐츠 조각 모델을 포함하는 폴더로 이동합니다.

  3. 모델을 선택한 후 도구 모음에서 삭제​를 클릭합니다.

    노트

    참조되는 모델의 경우 경고가 표시됩니다. 적절하게 조치하십시오.

컨텐츠 조각 모델 게시

컨텐츠 조각 모델은 종속된 컨텐츠 조각이 게시될 때/게시되기 전에 게시해야 합니다.

컨텐츠 조각 모델을 게시하려면

  1. 도구, 자산​으로 이동한 후 컨텐츠 조각 모델​을 엽니다.

  2. 컨텐츠 조각 모델을 포함하는 폴더로 이동합니다.

  3. 모델을 선택한 후 도구 모음에서 게시​를 클릭합니다.
    게시된 상태가 콘솔에 표시됩니다.

    노트

    모델이 아직 게시되지 않은 컨텐츠 조각을 게시하는 경우 선택 목록에 이것이 표시되고 모델이 조각과 함께 게시됩니다.

컨텐츠 조각 모델게시 취소

컨텐츠 조각 모델은 조각에서 참조되지 않는 경우 게시 취소할 수 있습니다.

컨텐츠 조각 모델을 게시 취소하려면 다음을 수행하십시오.

  1. 도구, 자산​으로 이동한 후 컨텐츠 조각 모델​을 엽니다.

  2. 컨텐츠 조각 모델을 포함하는 폴더로 이동합니다.

  3. 모델을 선택하고 도구 모음에서 게시 취소​를 선택합니다.
    게시된 상태가 콘솔에 표시됩니다.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free