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

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

표준 자산에 대한 자세한 내용은 Assets 관리 및 Assets 사용자 지정 및 확장을 참조하십시오.

컨텐츠 조각 모델:

• 구조화된 컨텐츠를 포함하는 컨텐츠 조각을 정의하는 데 사용됩니다.
• 콘텐츠 조각 모델은 콘텐츠 조각을 만들 때 콘텐츠 조각의 구조를 정의합니다.
• 조각이 모델을 참조하므로 모델 변경 사항은 모든 종속 조각에 영향을 줄 수 있습니다.
• 모델은 데이터 유형을 기반으로 합니다.
• 새 변형을 추가하는 기능 등은 조각을 적절하게 업데이트해야 합니다.

콘텐츠 조각 템플릿:

• 간단한 콘텐츠 조각을 정의하는 데 사용됩니다.
• 템플릿은 콘텐츠 조각을 만들 때 콘텐츠 조각의 (기본, 텍스트 전용) 구조를 정의합니다.
• 템플릿이 작성되면 조각에 복사됩니다. 따라서 템플릿에 대한 추가 변경 사항은 기존 조각에 반영되지 않습니다.
• 새 변형을 추가하는 기능 등은 조각을 적절하게 업데이트해야 합니다.
• 콘텐츠 조각 템플릿은(는) AEM 에코시스템 내의 다른 템플릿 메커니즘(예: 페이지 템플릿 등)과 다른 방식으로 작동합니다. 따라서 이러한 요소는 별도로 고려되어야 합니다.
• 템플릿을 기반으로 하는 경우 콘텐츠의 MIME 유형이 실제 콘텐츠에서 관리됩니다. 즉, 각 요소 및 변형은 서로 다른 MIME 유형을 가질 수 있습니다.

모든 콘텐츠는 자산의 jcr:content/data 노드 아래에 저장됩니다.

• 요소 데이터는 마스터 하위 노드 아래에 저장됩니다.

  jcr:content/data/master

• 변형은 변형의 이름을 전달하는 하위 노드 아래에 저장됩니다.
  예: jcr:content/data/myvariation

• 각 요소의 데이터는 각 하위 노드에 요소 이름의 속성으로 저장됩니다.
  예를 들어 요소 text의 내용은 jcr:content/data/master의 속성 text(으)로 저장됩니다

메타데이터 및 관련 콘텐츠는 jcr:content/metadata 아래에 저장됩니다.
제목 및 설명을 제외하고, 기존 메타데이터로 간주되지 않고 jcr:content에 저장됩니다.

조각의 모든 비콘텐츠 정보(예: 제목, 설명, 메타데이터, 구조)는 기본 자산에서만 관리됩니다.

조각의 첫 번째 요소 콘텐츠는 기본 에셋의 원래 렌디션에 매핑됩니다.

• 첫 번째 요소의 변형(있는 경우)은 기본 에셋의 다른 렌디션에 매핑됩니다.

추가 요소(있는 경우)는 주 자산의 하위 자산에 매핑됩니다.

• 이러한 추가 요소의 주요 내용은 각 하위 에셋의 원본 렌디션에 매핑됩니다.
• 추가 요소의 다른 변형(해당되는 경우)은 해당 하위 에셋의 다른 표현물에 매핑됩니다.

구성 요소는 fragmentPath 속성을 사용하여 실제 콘텐츠 조각을 참조합니다. fragmentPath 속성은 다른 에셋 유형의 유사한 속성과 동일한 방식으로 처리됩니다. 예를 들어 콘텐츠 조각을 다른 위치로 이동할 때 사용됩니다.

구성 요소를 사용하여 표시할 변형을 선택할 수 있습니다.

또한 출력을 제한하기 위해 단락 범위를 선택할 수 있습니다. 예를 들어 다중 열 출력에 사용할 수 있습니다.

구성 요소에서 중간 콘텐츠를 허용합니다.

• 여기에서 구성 요소를 사용하여 참조된 조각의 단락 사이에 다른 에셋(이미지 등)을 배치할 수 있습니다.

• 중간 콘텐츠 의 경우 다음을 수행해야 합니다.

  • 참조가 불안정할 수 있습니다. 중간 콘텐츠(페이지 작성 시 추가됨)는 옆에 있는 단락에 고정 관계가 없으며, 중간 콘텐츠의 위치가 상대 위치를 잃을 수 있기 전에 콘텐츠 조각 편집기에 새 단락을 삽입합니다
  • 검색 결과에 긍정 오류(false positive)를 방지하려면 추가 매개 변수(예: 변형 및 단락 필터)를 고려하십시오

리소스 유형
콘텐츠 조각 렌더링에 사용되는 구성 요소와 백그라운드 처리를 적용할 위치를 정의하는 데 sling:resourceTypes 목록을 제공할 수 있습니다.

참조 속성
속성 목록은 조각에 대한 참조가 각각의 컴포넌트에 대해 저장되는 위치를 지정하도록 구성될 수 있다.

렌더링할 요소가 정의된 속성의 이름은 element 또는 elementNames이어야 합니다.

렌더링할 변형이 정의된 속성의 이름은 variation 또는 variationName이어야 합니다.

elementNames을(를) 사용하여 여러 요소를 지정하여 여러 요소의 출력이 지원되는 경우 실제 표시 모드는 displayMode 속성으로 정의됩니다.

• 값이 singleText이고 구성된 요소가 하나만 있는 경우 요소는 중간 콘텐츠, 레이아웃 지원 등이 있는 텍스트로 렌더링됩니다. 단일 요소만 렌더링되는 조각의 기본값입니다.
• 그렇지 않으면 훨씬 더 간단한 접근 방식("양식 보기"라고 할 수 있음)이 사용됩니다. 여기에서는 중간 콘텐츠가 지원되지 않으며 조각 콘텐츠가 "있는 그대로" 렌더링됩니다.

조각이 displayMode == singleText에 대해 렌더링되는 경우(묵시적 또는 명시적으로) 다음 추가 속성이 재생됩니다.

• paragraphScope은(는) 모든 단락을 렌더링할지 또는 단락 범위만 렌더링할지 여부를 정의합니다(값: all 대 range).

• paragraphScope== range인 경우 paragraphRange 속성은 렌더링할 단락 범위를 정의합니다

번역

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

• 컨텐츠 조각의 개별 번역은 실제로 별도의 조각입니다. 예를 들면 다음과 같습니다.

  • 이러한 언어 루트는 서로 다른 언어 루트 아래에 있습니다.

    /content/dam/<path>/en/<to>/<fragment>

    및

    /content/dam/<path>/de/<to>/<fragment>

  • 하지만 언어 루트 아래에서 정확히 동일한 상대 경로를 공유합니다.

    /content/dam/<path>/en/<to>/<fragment>

    및

    /content/dam/<path>/de/<to>/<fragment>

• 규칙 기반 경로 외에, 콘텐츠 조각의 서로 다른 언어 버전 간에는 더 이상 연결되지 않습니다. UI에서 언어 변형 사이를 이동하는 수단을 제공하긴 하지만, 두 개의 개별 조각으로 처리됩니다.

메타데이터 스키마

• 콘텐츠 조각은 표준 에셋으로 정의할 수 있는 메타데이터 스키마를 (재)사용합니다.

• CFM은 고유한 특정 스키마를 제공합니다.

  /libs/dam/content/schemaeditors/forms/contentfragment

  필요한 경우 이를 연장할 수 있습니다.

• 각 스키마 양식은 조각 편집기와 통합됩니다.

조각 템플릿(조각 템플릿)

조각을 만드는 데 FragmentTemplate.createFragment()을(를) 사용합니다.

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

이 인터페이스는 다음을 나타냅니다.

• 콘텐츠 조각을 만들 콘텐츠 조각 모델 또는 콘텐츠 조각 템플릿
• 및 (생성 후) 해당 조각의 구조 정보

이 정보는 다음과 같습니다.

• 기본 데이터 액세스(제목, 설명)

• 조각 요소의 템플릿/모델에 액세스합니다.

  • 목록 요소 템플릿
  • 주어진 요소에 대한 구조 정보 가져오기
  • 요소 템플릿에 액세스(ElementTemplate 참조)

• 조각 변형에 대한 템플릿에 액세스합니다.

  • 목록 변형 템플릿
  • 주어진 변형에 대한 구조적 정보 가져오기
  • 변형 템플릿에 액세스(VariationTemplate 참조)

• 초기 관련 콘텐츠 가져오기

중요한 정보를 나타내는 인터페이스:

• ElementTemplate

  • 기본 데이터(이름, 제목) 가져오기
  • 초기 요소 콘텐츠 가져오기

• VariationTemplate

  • 기본 데이터(이름, 제목, 설명) 가져오기

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

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

인터페이스는 다음과 같은 수단을 제공합니다.

• 기본 데이터 관리(예: 이름 가져오기, 제목/설명 가져오기/설정)

• 메타데이터 액세스

• 액세스 요소:

  • 목록 요소

  • 이름별 요소 가져오기

  • 새 요소 만들기(주의 사항 참조)

  • 요소 데이터 액세스(ContentElement 참조)

• 조각에 대해 정의된 목록 변형

• 전체적으로 새 변형 만들기

• 관련 콘텐츠 관리:

  • 컬렉션 나열
  • 컬렉션 추가
  • 컬렉션 제거

• 조각의 모델 또는 템플릿 액세스

조각의 주요 요소를 나타내는 인터페이스는 다음과 같습니다.

• 콘텐츠 요소(콘텐츠 요소)

  • 기본 데이터(이름, 제목, 설명) 가져오기

  • 콘텐츠 가져오기/설정

  • 요소의 변형 액세스:

    • 목록 변형
    • 이름별 변형 가져오기
    • 새 변형 만들기(주의 사항 참조)
    • 변형 제거(주의 사항 참조)
    • 변형 데이터 액세스(ContentVariation 참조)

  • 변형 해결을 위한 바로 가기(지정된 변형을 요소에 사용할 수 없는 경우 구현별 추가 폴백 논리 적용)

• 콘텐츠 변형(콘텐츠 변형)

  • 기본 데이터(이름, 제목, 설명) 가져오기
  • 콘텐츠 가져오기/설정
  • 마지막으로 수정된 정보를 기반으로 한 간단한 동기화

세 개의 인터페이스( ContentFragment, ContentElement, ContentVariation)가 모두 콘텐츠 조각에 필요한 버전 관리 기능을 추가하는 Versionable 인터페이스를 확장합니다.

• 요소의 새 버전 만들기
• 요소의 목록 버전
• 버전이 지정된 요소의 특정 버전 콘텐츠 가져오기

ContentFragment은(는) 다음 작업에 맞게 조정할 수 있습니다.

• Resource - 기본 Sling 리소스. 기본 Resource을(를) 직접 업데이트하려면 ContentFragment 개체를 다시 만들어야 합니다.

• Asset - 콘텐츠 조각을 나타내는 DAM Asset 추상화입니다. Asset을(를) 직접 업데이트하려면 ContentFragment 개체를 다시 빌드해야 합니다.

ContentElement은(는) 다음 작업에 맞게 조정할 수 있습니다.

• ElementTemplate - 요소의 구조적 정보에 액세스합니다.

FragmentTemplate은(는) 다음 작업에 맞게 조정할 수 있습니다.

• Resource - 참조된 모델 또는 복사된 원본 템플릿을 결정하는 Resource;

  • Resource을(를) 통해 변경한 내용은 FragmentTemplate에 자동으로 반영되지 않습니다.

Resource은(는) 다음 작업에 맞게 조정할 수 있습니다.

• ContentFragment
• FragmentTemplate

API는 UI에서 지원하는 기능을 제공하도록 구현됩니다.

전체 API는 API JavaDoc에 별도로 명시되지 않는 한 변경 내용을 자동으로 유지하지 ​하도록 설계되었습니다. 따라서 항상 각 요청의 리소스 해결자(또는 실제로 사용 중인 해결자)를 커밋해야 합니다.

추가 작업이 필요할 수 있는 작업:

• 새 요소를 만들거나 제거해도 조각 템플릿 기반 단순 조각의 데이터 구조는 업데이트되지 않습니다.

• ContentElement에서 새 변형을 만들어도 데이터 구조가 업데이트되지 않습니다(하지만 ContentFragment에서 전역적으로 만들어도 됨).

• 기존 변형을 제거해도 데이터 구조가 업데이트되지 않습니다.

filter.xml

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

세션 시작

• 콘텐츠 조각의 새 버전이 만들어집니다.
• 자동 저장이 시작되었습니다.
• 쿠키가 설정됩니다. 쿠키는 현재 편집된 조각을 정의하며 편집 세션이 열려 있습니다.

세션 완료

• 자동 저장이 중지되었습니다.

• 커밋 시:

  • 마지막으로 수정된 정보가 업데이트됩니다.
  • 쿠키가 제거됩니다.

• 롤백 시:

  • 편집 세션이 시작될 때 만들어진 콘텐츠 조각의 버전이 복원됩니다.
  • 쿠키가 제거됩니다.

편집

• 모든 변경 사항(자동 저장 포함)은 분리된 보호 영역이 아닌 활성 콘텐츠 조각에서 수행됩니다.
• 따라서 이러한 변경 사항은 각 콘텐츠 조각을 참조하는 AEM 페이지에 즉시 반영됩니다

페이지 입력

• 각 쿠키를 확인하여 편집 세션이 이미 있는지 확인합니다.

  • 존재하는 경우 현재 편집 중인 콘텐츠 조각에 대한 편집 세션이 시작되었는지 확인합니다

    • 현재 조각인 경우 세션을 다시 설정합니다.
    • 그렇지 않은 경우 이전에 편집한 콘텐츠 조각에 대한 편집을 취소하고 쿠키를 제거해 보십시오(나중에 편집 세션이 표시되지 않음).

  • 편집 세션이 존재하지 않는 경우 사용자가 처음으로 변경할 때까지 기다립니다(아래 참조).

• 페이지에서 콘텐츠 조각이 이미 참조되었는지 확인하고 참조된 경우 적절한 정보를 표시합니다.

콘텐츠 변경

• 사용자가 콘텐츠를 변경하고 편집 세션이 없을 때마다 새 편집 세션이 만들어집니다(세션 시작 참조).

페이지 나가기

• 편집 세션이 있고 변경 사항이 지속되지 않는 경우, 사용자에게 잠재적인 콘텐츠 손실을 알리고 페이지에서 머물 수 있도록 해 주는 모달 확인 대화 상자가 표시됩니다.

노드: <*conf-root*>/settings/dam/cfm/jcr:content

속성 이름: autoSaveInterval

유형: Long

기본값: 600(10분), /libs/settings/dam/cfm/jcr:content에 정의됨

노드: /conf/global/settings/dam/cfm/jcr:content

속성 이름: autoSaveInterval

유형: Long

값: 300(5분은 300초와 같음)