설명서AEM 6.5사용 안내서

콘텐츠 조각 모델 content-fragment-models

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 사용자

AEM의 콘텐츠 조각 모델은 Headless 콘텐츠의 기반 역할을 하는 콘텐츠 조각에 대한 콘텐츠 구조를 정의합니다.

콘텐츠 조각 모델을 사용하려면 다음 작업을 수행할 수 있습니다.

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

콘텐츠 조각 모델 만들기 creating-a-content-fragment-model

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

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

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

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

  4. 모델 제목 ​을 지정합니다. 필요한 경우 태그, 설명 ​을 추가한 다음 모델 사용 ​을 선택하여 모델 사용을 설정할 수도 있습니다.

    제목 및 설명

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

콘텐츠 조각 모델 정의 defining-your-content-fragment-model

콘텐츠 조각 모델은 다양한 데이터 유형 ​을 사용하여 최종 콘텐츠 조각의 구조를 효과적으로 정의합니다. 모델 편집기를 사용하여 데이터 유형의 인스턴스를 추가한 다음 필요한 필드를 만들도록 구성할 수 있습니다.

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

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

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

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

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

    • 왼쪽: 이미 정의된 필드
    • 오른쪽: 필드를 만드는 데 사용할 수 있는 데이터 유형(필드가 만들어지면 사용할 속성)
    note note
    NOTE
    필드가 필수 ​로 표시되는 경우, 왼쪽 창에 나타나는 레이블 ​이 별표(*)와 함께 표시됩니다.

    속성

  4. 필드를 추가하려면

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

      필드에 대한 데이터 유형

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

      • 설명이 따로 필요하지 않은 다양한 속성들에 대한 자세한 내용은 속성을 참조하십시오.

      • 필드 레이블 ​을 입력하면 속성 이름 ​이 자동으로 채워집니다. 비어 있는 경우 이후에 수동으로 업데이트할 수 있습니다.

        note caution
        CAUTION
        데이터 형식의 속성 이름 속성을 수동으로 업데이트할 때 이름에 A-Z, a-z, 0-9 및 밑줄(_)만 포함해야 합니다.
        이전 버전의 AEM에서 만든 모델에 잘못된 문자가 포함되어 있는 경우, 해당 문자를 제거하거나 업데이트하십시오.

      예:

      필드 속성

  5. 필드를 제거하려면

    필요한 필드를 선택한 다음 휴지통 아이콘을 클릭합니다. 작업을 확인하는 메시지가 표시됩니다.

    제거

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

    저장

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

데이터 유형 data-types

모델을 정의하는 데 다양한 데이터 유형을 사용할 수 있습니다.

  • 한 줄 텍스트

    • 한 줄 텍스트 행의 필드를 하나 이상 추가합니다. 최대 길이를 정의할 수 있습니다.

  • 여러 줄 텍스트

    • 리치 텍스트, 일반 텍스트 또는 Markdown일 수 있는 텍스트 영역입니다.

  • 숫자

    • 숫자 필드를 하나 이상 추가합니다.

  • 부울

    • 부울 확인란을 추가합니다.

  • 날짜 및 시간

    • 날짜 및/또는 시간을 추가합니다.

  • 열거

    • 확인란, 라디오 버튼 또는 드롭다운 필드 집합 추가

  • 태그

    • 조각 작성자가 태그의 영역에 액세스하고 선택할 수 있습니다.

  • 콘텐츠 참조

    • 모든 유형의 다른 콘텐츠를 참조합니다. 중첩된 콘텐츠를 생성하는 데 사용할 수 있습니다.
    • 이미지가 참조되면 썸네일을 표시하도록 선택할 수 있습니다.

  • 조각 참조

    • 다른 콘텐츠 조각을 참조합니다. 중첩된 콘텐츠를 생성하는 데 사용할 수 있습니다.

    • 조각 작성자가 다음과 같은 작업을 수행할 수 있도록 데이터 유형을 구성할 수 있습니다.

      • 참조된 조각 직접 편집
      • 적절한 모델을 기반으로 콘텐츠 조각 만들기

  • JSON 오브젝트

    • 콘텐츠 조각 작성자가 조각의 해당 요소에 JSON 구문을 입력하도록 합니다.

      • 다른 서비스에서 복사 및 붙여넣기한 직접 JSON을 AEM에 저장하도록 합니다.
      • JSON이 전달되고 GraphQL에서 JSON으로 출력됩니다.
      • 콘텐츠 조각 편집기에 JSON 구문 강조, 자동 완성 및 오류 강조 표시를 포함합니다.

  • 탭 플레이스홀더

    • 콘텐츠 조각 콘텐츠를 편집할 때 사용할 탭을 가져올 수 있습니다.
      모델 편집기에서 콘텐츠 데이터 유형 목록의 섹션을 구분하는 구분선으로 표시됩니다. 각 인스턴스는 새 탭의 시작을 나타냅니다.
      조각 편집기에서 각 인스턴스는 탭으로 표시됩니다.

      note note
      NOTE
      이 데이터 유형은 순전히 서식에 사용되며 AEM GraphQL 스키마에서는 무시됩니다.

속성 properties

설명이 따로 필요하지 않은 특정 속성들에 대한 자세한 내용은 아래를 참조하십시오.

  • 속성 이름

    데이터 형식의 이 속성을 수동으로 업데이트할 때 must 이름에는 only A-Z, a-z, 0-9 및 밑줄(_) 문자를 특수 문자로 포함합니다.

    note caution
    CAUTION
    이전 버전의 AEM에서 만든 모델에 잘못된 문자가 포함되어 있는 경우, 해당 문자를 제거하거나 업데이트하십시오.

  • 렌더링 형식
    조각의 필드를 구현하거나 렌더링하기 위한 다양한 옵션입니다. 이를 통해 작성자는 필드의 단일 인스턴스가 표시되는지 또는 작성자가 여러 인스턴스를 만들 수 있는지를 정의할 수 있습니다.

  • 필드 레이블
    필드 레이블 ​을 입력하면 속성 이름 ​이 자동으로 생성되며 필요한 경우 수동으로 업데이트할 수 있습니다.

  • 유효성 검사
    기본 유효성 검사는 필수 속성과 같은 메커니즘을 통해 사용할 수 있습니다. 일부 데이터 유형에는 추가 유효성 검사 필드가 있습니다. 자세한 내용은 유효성 검사를 참조하십시오.

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

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

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

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

  • 고유
    특정 필드의 경우, 콘텐츠는 현재 모델에서 만들어진 모든 콘텐츠 조각에서 고유해야 합니다.

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

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

    note note
    NOTE
    언어 루트별로 고유성이 보장됩니다.
    note note
    NOTE
    변형은 동일한 조각의 변형과 동일한 고유 값을 가질 수 있지만, 다른 조각의 변형에 사용되는 것과 동일한 값을 가질 수는 없습니다.

  • 특정 데이터 유형 및 그 속성에 대한 자세한 내용은 콘텐츠 참조 ​를 참조하십시오.

  • 특정 데이터 유형 및 그 속성에 대한 자세한 내용은 조각 참조(중첩된 조각) ​를 참조하십시오.

유효성 검사 validation

이제 다양한 데이터 유형에는 최종 조각에 콘텐츠를 입력하는 경우에 대한 유효성 검사 요구 사항을 정의할 수 있는 기능이 포함됩니다.

  • 한 줄 텍스트

    • 사전 정의된 정규 표현식과 비교합니다.

  • 숫자

    • 특정 값을 확인합니다.

  • 콘텐츠 참조

    • 특정 유형의 콘텐츠를 테스트합니다.
    • 지정된 파일 크기 이하의 자산만 참조할 수 있습니다.
    • 사전 정의된 폭 및/또는 높이 범위(픽셀 단위) 내의 이미지만 참조할 수 있습니다.

  • 조각 참조

    • 특정 콘텐츠 조각 모델을 테스트합니다.

참조를 사용하여 중첩된 콘텐츠 형성 using-references-to-form-nested-content

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

  • 콘텐츠 참조

    • 모든 유형의 다른 콘텐츠에 대한 간단한 참조를 제공합니다.
    • 최종 조각에서 하나의 참조 또는 여러 참조에 대해 구성할 수 있습니다.

  • 조각 참조(중첩된 조각)

NOTE
AEM은 다음에 대한 재발 방지 기능을 제공합니다.

  • 콘텐츠 참조
    따라서 사용자가 현재 조각에 대한 참조를 추가할 수 없습니다. 이로 인해 빈 조각 참조 선택기 대화 상자가 나타날 수 있습니다.

  • GraphQL의 조각 참조
    서로 참조하는 여러 콘텐츠 조각을 반환하는 복합 쿼리를 만들면 첫 번째 발생 시 null을 반환합니다.

콘텐츠 참조 content-reference

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

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

  • 참조된 콘텐츠의 루트 경로

  • 참조할 수 있는 콘텐츠 유형

  • 파일 크기 제한

  • 이미지를 참조한 경우:

    • 썸네일 표시
    • 높이 및 폭의 이미지 제한

콘텐츠 참조

조각 참조(중첩된 조각) fragment-reference-nested-fragments

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

예:

  • 다음을 포함하는 직원의 세부 정보를 정의하는 모델
    • 고용주(회사)를 정의하는 모델에 대한 참조
type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}
NOTE
이는 특히 GraphQL에서 콘텐츠 조각을 사용하여 Headless 콘텐츠를 게재할 때 유용합니다.

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

  • 렌더링 형식:

    • 다중 필드 - 조각 작성자는 여러 개별 참조를 생성할 수 있습니다.

    • 조각 참조 - 조각 작성자가 조각에 대한 단일 참조를 선택하도록 합니다.

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

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

  • 조각 생성 허용

    이를 통해 조각 작성자는 적절한 모델을 기반으로 조각을 만들 수 있습니다.

    • 조각 참조 합성 - 이 기능을 사용하면 조각 작성자가 여러 조각을 선택하여 합성을 빌드할 수 있습니다.

    조각 참조

NOTE
재발 방지 메커니즘을 사용할 수 있습니다. 이는 사용자가 조각 참조에서 현재 콘텐츠 조각을 선택할 수 없도록 합니다. 이로 인해 빈 조각 참조 선택기 대화 상자가 나타날 수 있습니다.
또한 GraphQL에는 조각 참조에 대한 재발 방지 기능이 있습니다. 서로 참조하는 두 개의 콘텐츠 조각 간에 복합 쿼리를 만들면 null을 반환합니다.

콘텐츠 조각 모델 활성화 또는 비활성화 enabling-disabling-a-content-fragment-model

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

콘텐츠 조각 모델 활성화 enabling-a-content-fragment-model

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

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

다음 중 하나로 플래그가 지정된 모델을 활성화하려면 다음 작업을 수행합니다.

  • 초안: mew(활성화되지 않음)
  • 사용 안 함: 사용할 수 없습니다.

다음 중 하나에서 사용 옵션을 사용할 수 있습니다.

  • (필요한 모델이 선택되어 있는 경우) 상단 도구 모음
  • 해당 빠른 작업(필요한 모델 위에 마우스 놓기)

초안 모델 또는 비활성화된 모델 활성화

콘텐츠 조각 모델 비활성화 disabling-a-content-fragment-model

모델을 비활성화하여

  • 해당 모델을 더 이상 새 콘텐츠 조각 생성을 위한 기반으로 사용하지 않도록 할 수 있습니다.

  • 하지만

    • GraphQL 스키마는 JSON API에 영향을 주지 않도록 계속 생성되며 계속 쿼리할 수 있습니다.
    • 해당 모델을 기반으로 하는 모든 콘텐츠 조각은 여전히 GraphQL 엔드포인트에서 쿼리하고 반환할 수 있습니다.

  • 해당 모델은 더 이상 참조할 수 없지만 기존 참조는 그대로 유지되므로 GraphQL 엔드포인트에서 쿼리하고 반환할 수 있습니다.

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

  • (필요한 모델이 선택되어 있는 경우) 상단 도구 모음
  • 해당 빠른 작업(필요한 모델 위에 마우스 놓기)

활성화된 모델 비활성화

자산 폴더에서 콘텐츠 조각 모델 허용 allowing-content-fragment-models-assets-folder

콘텐츠 거버넌스를 구현하기 위해 Assets 폴더에서 정책 ​을 구성하여 해당 폴더에서 조각 생성에 허용되는 콘텐츠 조각 모델을 제어할 수 있습니다.

NOTE
이 메커니즘은 페이지의 고급 속성에서 페이지 및 그 하위 페이지에 대해 페이지 템플릿을 허용하는 것과 유사합니다.

허용되는 콘텐츠 조각 모델 ​에 대해 정책 ​을 구성하려면 다음 작업을 수행합니다.

  1. 필요한 자산 폴더의 속성 ​으로 이동하여 엽니다.

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

    • 상속 위치<folder>

      하위 폴더를 만들 때 정책이 자동으로 상속됩니다. 하위 폴더에서 상위 폴더와 다른 모델을 허용해야 하는 경우 정책을 재구성하고 상속을 끊을 수 있습니다.

    • 경로에 의해 허용된 콘텐츠 조각 모델

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

    • 태그에 의해 허용된 콘텐츠 조각 모델

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

    콘텐츠 조각 모델 정책

  3. 모든 변경 내용을 저장 ​합니다.

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

  • 허용되는 콘텐츠 조각 모델 ​에 대한 정책
  • 비어 있는 경우 상속 규칙을 사용하여 정책을 결정하십시오.
  • 상속 체인이 결과를 전달하지 않는 경우 해당 폴더에 대한 Cloud Services 구성을 살펴보십시오(처음에는 직접, 그 다음에는 상속을 통해).
  • 어느 것도 결과를 전달하지 않는 경우에는 해당 폴더에 대해 허용되는 모델이 없음을 의미합니다.

콘텐츠 조각 모델 삭제 deleting-a-content-fragment-model

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

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

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

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

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

    note note
    NOTE
    참조되는 모델의 경우, 경고가 표시됩니다. 적절한 조치를 취하십시오.

콘텐츠 조각 모델 게시 publishing-a-content-fragment-model

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

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

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

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

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

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

콘텐츠 조각 모델 게시 취소 unpublishing-a-content-fragment-model

조각에서 콘텐츠 모델을 참조하지 않는 경우 이를 게시 취소할 수 있습니다.

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

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

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

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

콘텐츠 조각 모델 - 속성 content-fragment-model-properties

콘텐츠 조각 모델의 속성 ​을 편집할 수 있습니다.

  • 기본

    • 모델 제목
    • 태그
    • 설명
    • 이미지 업로드
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2