콘텐츠 조각 맞춤화 및 확장 customizing-and-extending-content-fragments

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

작성 대상:

관리자
개발자

Adobe Experience Manager as a Cloud Service 내에서 컨텐츠 조각은 표준 자산을 확장합니다. 다음을 참조하십시오.

콘텐츠 조각에 대한 자세한 내용은 콘텐츠 조각 만들기 및 관리 및 콘텐츠 조각으로 페이지 작성을 참조하십시오.
표준 자산에 대한 자세한 내용은 Assets 관리를 참조하십시오.

아키텍처 architecture

콘텐츠 조각의 기본 구성 요소 부분은(는) 다음과 같습니다.

콘텐츠 조각 자체
하나 이상의 콘텐츠 요소(으)로 구성됩니다.
하나 이상의 콘텐츠 변형 이 있을 수 있습니다.

개별 콘텐츠 조각은 콘텐츠 조각 모델을 기반으로 합니다.

콘텐츠 조각 모델은 콘텐츠 조각을 만들 때 콘텐츠 조각의 구조를 정의합니다.
조각은 모델을 참조하므로 모델 변경 사항은 모든 종속 조각에 영향을 주거나 줄 수 있습니다.
모델은 데이터 유형을 기반으로 합니다.

새 변형을 추가하는 기능 등은 조각을 적절하게 업데이트해야 합니다.

note note
NOTE
콘텐츠 조각을 표시/렌더링하려면 계정에 모델에 대한 `read` 권한이 있어야 합니다.

note caution
CAUTION
기존 콘텐츠 조각 모델을 변경하면 종속된 조각이 영향을 받을 수 있습니다. 이로 인해 해당 조각에서 고립 속성이 발생할 수 있습니다.

Assets과 Sites 통합 integration-of-sites-with-assets

CFM(콘텐츠 조각 관리)은 다음과 같이 Adobe Experience Manager(AEM) Assets의 일부입니다.

컨텐츠 조각은 에셋입니다.
기존 Assets 기능을 사용합니다.
Assets(Admin Console 등)와 완전히 통합됩니다.

컨텐츠 조각은 다음과 같이 AEM Sites 기능으로 간주됩니다.

페이지를 작성할 때 사용됩니다.

Assets에 컨텐츠 조각 매핑 mapping-content-fragments-to-assets

자산에 대한 콘텐츠 조각

컨텐츠 조각 모델을 기반으로 하는 컨텐츠 조각은 단일 자산에 매핑됩니다.

모든 콘텐츠는 자산의 jcr:content/data 노드 아래에 저장됩니다.
- 요소 데이터는 마스터 하위 노드 아래에 저장됩니다.
  
  jcr:content/data/master
- 변형은 변형의 이름을 전달하는 하위 노드 아래에 저장됩니다.
  예: jcr:content/data/myvariation
- 각 요소의 데이터는 각 하위 노드에 요소 이름을 갖는 속성으로 저장됩니다.
  예를 들어 요소 text의 내용은 jcr:content/data/master의 속성 text(으)로 저장됩니다
메타데이터 및 관련 콘텐츠는 jcr:content/metadata 아래에 저장됩니다.
제목 및 설명을 제외하고, 기존 메타데이터로 간주되지 않고 jcr:content에 저장됩니다.

자산 위치 asset-location

표준 에셋과 마찬가지로 콘텐츠 조각은 아래에 보관됩니다.

/content/dam

자산 권한 asset-permissions

콘텐츠 조각 - 삭제 고려 사항을 참조하세요.

기능 통합 feature-integration

Assets 코어와 통합하려면 다음을 수행하십시오.

CFM(Content Fragment Management) 기능은 Assets 코어를 기반으로 합니다.
CFM은 카드/열/목록 보기의 항목에 대한 자체 구현을 제공합니다. 이러한 구현은 기존 Assets 컨텐츠 렌더링 구현에 연결됩니다.
콘텐츠 조각을 지원하기 위해 몇 가지 Assets 구성 요소가 확장되었습니다.

페이지에서 컨텐츠 조각 사용 using-content-fragments-in-pages

CAUTION

콘텐츠 조각 구성 요소는 핵심 구성 요소의 일부입니다. 자세한 내용은 핵심 구성 요소 개발을 참조하십시오.

다른 에셋 유형과 마찬가지로 AEM 페이지에서 콘텐츠 조각을 참조할 수 있습니다. AEM은 페이지에 콘텐츠 조각을 포함할 수 있는 🔗구성 요소인 콘텐츠 조각 핵심 구성 요소 를 제공합니다. 이 콘텐츠 조각 핵심 구성 요소를 확장할 수도 있습니다.

구성 요소는 fragmentPath 속성을 사용하여 실제 콘텐츠 조각을 참조합니다. fragmentPath 속성은 다른 에셋 유형의 유사한 속성과 동일한 방식으로 처리됩니다. 예를 들어 콘텐츠 조각을 다른 위치로 이동할 때 사용됩니다.
구성 요소를 사용하여 표시할 변형을 선택할 수 있습니다.
또한 단락 범위를 선택하여 출력을 제한할 수 있습니다. 예를 들어, 다중 열 출력에 사용할 수 있습니다.
구성 요소에서 중간 콘텐츠를 사용할 수 있습니다.
- 여기에서 구성 요소를 사용하여 참조된 조각의 단락 사이에 다른 에셋(이미지 등)을 배치할 수 있습니다.
- 중간 콘텐츠:
  - 참조가 불안정할 수 있다는 것을 알고 있어야 합니다. 중간 콘텐츠(페이지 작성 시 추가됨)는 옆에 있는 단락에 고정된 관계가 없습니다. 중간 콘텐츠 위치 앞에 새 단락(콘텐츠 조각 편집기에서)을 삽입하면 상대 위치가 손실될 수 있습니다.
  - 변형 및 단락 필터 등 추가 매개 변수를 고려하여 페이지에서 렌더링되는 내용을 구성합니다.

NOTE

콘텐츠 조각 모델:

페이지에서 콘텐츠 조각을 사용하면 그 기반이 되는 콘텐츠 조각 모델이 참조됩니다.

즉, 페이지를 게시할 때 모델이 게시되지 않은 경우 이에 플래그가 지정되고 모델이 페이지와 함께 게시할 리소스에 추가됩니다.

다른 프레임워크와 통합 integration-with-other-frameworks

컨텐츠 조각은 다음과 통합할 수 있습니다.

번역

콘텐츠 조각은 AEM 번역 워크플로와(과) 완전히 통합됩니다. 아키텍처 수준에서 이는 다음을 의미합니다.

컨텐츠 조각의 개별 번역은 개별 조각입니다. 예를 들면 다음과 같습니다.
- 이러한 언어 루트는 서로 다른 언어 루트 아래에 있지만 관련 언어 루트 아래의 상대 경로를 공유합니다.
  
  /content/dam/<path>/en/<to>/<fragment>
  
  및
  
  /content/dam/<path>/de/<to>/<fragment>
규칙 기반 경로 외에도 콘텐츠 조각의 다른 언어 버전 간에는 다른 연결이 없습니다. UI에서 언어 변형 사이를 탐색할 수 있는 수단을 제공하지만 두 조각은 두 개의 개별 조각으로 처리됩니다.

note note
NOTE
AEM 번역 워크플로는 `/content`에서 작동합니다.
콘텐츠 조각 모델이 `/conf`에 있으므로 이러한 번역에 포함되지 않습니다. UI 문자열을 국제화할 수 있습니다.

메타데이터 스키마
- 콘텐츠 조각은 표준 에셋으로 정의할 수 있는 메타데이터 스키마를 사용하고 재사용합니다.
- CFM은 고유한 특정 스키마를 제공합니다.
  
  /libs/dam/content/schemaeditors/forms/contentfragment
  
  필요한 경우 이를 연장할 수 있습니다.
- 각 스키마 양식은 조각 편집기와 통합됩니다.

콘텐츠 조각 관리 API - 서버측 the-content-fragment-management-api-server-side

서버측 API를 사용하여 콘텐츠 조각에 액세스할 수 있습니다. 다음을 참조하십시오.

com.adobe.cq.dam.cfm

CAUTION

Adobe은 콘텐츠 구조에 직접 액세스하는 대신 서버측 API를 사용하는 것을 권장합니다.

주요 인터페이스 key-interfaces

다음 세 가지 인터페이스는 진입점 역할을 할 수 있습니다.

콘텐츠 조각(콘텐츠 조각)

이 인터페이스를 사용하면 추상적인 방식으로 콘텐츠 조각을 사용하여 작업할 수 있습니다.

인터페이스는 다음과 같은 수단을 제공합니다.
- 기본 데이터 관리(예: 이름 가져오기, 제목/설명 가져오기/설정)
- 메타데이터 액세스
- 액세스 요소:
  - 목록 요소
  - 이름별 요소 가져오기
  - 요소 만들기(주의 사항 참조)
  - 요소 데이터 액세스(ContentElement 참조)
- 조각에 대해 정의된 목록 변형
- 전체적으로 변형 만들기
- 관련 콘텐츠 관리:
  - 컬렉션 나열
  - 컬렉션 추가
  - 컬렉션 제거
- 조각의 모델에 액세스
조각의 주요 요소를 나타내는 인터페이스는 다음과 같습니다.
- 콘텐츠 요소(콘텐츠 요소)
  - 기본 데이터(이름, 제목, 설명) 가져오기
  - 콘텐츠 가져오기/설정
  - 요소의 변형 액세스:
    - 목록 변형
    - 이름별 변형 가져오기
    - 변형 만들기(주의 사항 참조)
    - 변형 제거(주의 사항 참조)
    - 변형 데이터 액세스(ContentVariation 참조)
  - 변형 해결을 위한 바로 가기(지정된 변형을 요소에 사용할 수 없는 경우 구현별 추가 폴백 논리 적용)
- 콘텐츠 변형(콘텐츠 변형)
  - 기본 데이터(이름, 제목, 설명) 가져오기
  - 콘텐츠 가져오기/설정
  - 마지막으로 수정된 정보를 기반으로 한 간단한 동기화
세 개의 인터페이스( ContentFragment, ContentElement, ContentVariation)가 모두 콘텐츠 조각에 필요한 버전 관리 기능을 추가하는 Versionable 인터페이스를 확장합니다.
- 요소 버전 만들기
- 요소의 목록 버전
- 버전이 지정된 요소의 특정 버전 콘텐츠 가져오기

적응 - adaptTo() 사용 adapting-using-adaptto

다음 항목을 조정할 수 있습니다.

ContentFragment은(는) 다음 작업에 맞게 조정할 수 있습니다.
- Resource - 기본 Sling 리소스. 기본 Resource을(를) 업데이트하려면 ContentFragment 개체를 직접 다시 빌드해야 합니다.
- Asset - 콘텐츠 조각을 나타내는 DAM Asset 추상화입니다. Asset을(를) 직접 업데이트하려면 ContentFragment 개체를 다시 빌드해야 합니다.
ContentElement은(는) 다음 작업에 맞게 조정할 수 있습니다.
- ElementTemplate - 요소의 구조적 정보에 액세스합니다.
FragmentTemplate
Resource은(는) 다음 작업에 맞게 조정할 수 있습니다.
- ContentFragment

주의 사항 caveats

주의해야 할 사항은 다음과 같습니다.

전체 API는 API JavaDoc에 별도로 명시되지 않는 한 변경 내용을 자동으로 유지하지 하도록 설계되었습니다. 따라서 항상 해당 요청의 리소스 확인자(또는 실제로 사용 중인 확인자)를 커밋하십시오.
추가 작업이 필요할 수 있는 작업:
- Adobe은 ContentFragment에서 변형을 만들 것을 권장합니다. 이렇게 하면 모든 요소가 이 변형을 공유하고, 콘텐츠 구조의 새로운 변형을 반영하기 위해 필요에 따라 적절한 전역 데이터 구조가 업데이트됩니다.
- 요소를 통해 기존 변형을 제거하고 ContentElement.removeVariation()을(를) 사용하면 변형에 할당된 전역 데이터 구조가 업데이트되지 않습니다. 이러한 데이터 구조가 계속 동기화되도록 하려면 ContentFragment.removeVariation()을(를) 대신 사용하십시오.

콘텐츠 조각 관리 API - 클라이언트측 the-content-fragment-management-api-client-side

CAUTION

클라이언트측 API는 내부에 있습니다.

추가 정보 additional-information

다음을 참조하십시오.

filter.xml

콘텐츠 조각 관리에 대한 filter.xml이(가) Assets 핵심 콘텐츠 패키지와 겹치지 않도록 구성되어 있습니다.

세션 편집 edit-sessions

CAUTION

이 배경 정보를 고려하십시오. 리포지토리에 비공개 영역(으)로 표시되어 있으므로 여기에서 변경할 수 없지만, 경우에 따라 변경 내용이 제대로 작동하는지 이해하는 데 도움이 될 수 있습니다.

여러 보기(= HTML 페이지)에 걸쳐 있을 수 있는 컨텐츠 조각 편집은 원자적입니다. 이러한 원자 형식의 다중 보기 편집 기능은 일반적인 AEM 개념이 아니므로 콘텐츠 조각은 편집 세션 이라는 것을 사용합니다.

편집 세션은 사용자가 편집기에서 콘텐츠 조각을 열 때 시작됩니다. 사용자가 저장 또는 취소 를 선택하여 편집기를 떠나면 편집 세션이 종료됩니다.

기본적으로 모든 편집은 다른 모든 AEM 편집과 마찬가지로 live 콘텐츠에서 수행됩니다. 편집 세션이 시작되면 편집되지 않은 현재 상태의 버전이 만들어집니다. 사용자가 편집을 취소하면 해당 버전이 복원됩니다. 사용자가 저장 을 클릭하면 live 콘텐츠에서 편집이 실행되어 모든 변경 내용이 이미 유지되므로 구체적인 작업은 수행되지 않습니다. 또한 저장 을 클릭하면 전체 텍스트 검색 정보를 만들거나 혼합 미디어 자산을 처리하거나 둘 다 처리하는 등의 백그라운드 처리가 트리거됩니다.

예를 들어 사용자가 편집 세션을 저장하거나 취소하지 않고 편집기를 종료하려고 하는 경우, 경계 사례에 대한 몇 가지 안전 조치가 있습니다. 또한 데이터 손실을 방지하기 위해 정기적으로 자동 저장할 수 있습니다.
두 명의 사용자가 동일한 콘텐츠 조각을 동시에 편집할 수 있으므로 서로의 변경 사항을 덮어쓸 수 있습니다. 이를 방지하려면 조각에 DAM 관리의 체크아웃 작업을 적용하여 콘텐츠 조각을 잠가야 합니다.

예 examples

예: 기존 콘텐츠 조각 액세스 example-accessing-an-existing-content-fragment

이를 위해 API를 나타내는 리소스를 다음과 같이 조정할 수 있습니다.

com.adobe.cq.dam.cfm.ContentFragment

예:

// first, get the resource
Resource fragmentResource = resourceResolver.getResource("/content/dam/fragments/my-fragment");
// then adapt it
if (fragmentResource != null) {
    ContentFragment fragment = fragmentResource.adaptTo(ContentFragment.class);
    // the resource is now accessible through the API
}

예제: 컨텐츠 조각 만들기 example-creating-a-new-content-fragment

프로그래밍 방식으로 콘텐츠 조각을 만들려면 모델 리소스에서 가져온 FragmentTemplate을(를) 사용합니다.

예:

Resource modelRsc = resourceResolver.getResource("...");
FragmentTemplate tpl = modelRsc.adaptTo(FragmentTemplate.class);
ContentFragment newFragment = tpl.createFragment(parentRsc, "A fragment name", "A fragment description.");

예: 자동 저장 간격 지정 example-specifying-the-auto-save-interval

구성 관리자(ConfMgr)를 사용하여 자동 저장 간격(초 단위)을 정의할 수 있습니다.

노드: <conf-root>/settings/dam/cfm/jcr:content
속성 이름: autoSaveInterval
유형: Long
기본값: 600(10분), /libs/settings/dam/cfm/jcr:content에 정의됨

자동 저장 간격을 5분으로 설정하려면 노드에서 속성을 정의합니다.

예:

노드: /conf/global/settings/dam/cfm/jcr:content
속성 이름: autoSaveInterval
유형: Long
값: 300(5분은 300초와 같음)

페이지 작성을 위한 구성 요소 components-for-page-authoring

자세한 내용은

핵심 구성 요소 - 콘텐츠 조각 구성 요소(권장)

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab