Show Menu
화제×

컨텐츠 조각 렌더링용 구성 요소 구성

컨텐츠 조각 렌더링과 관련된 몇 가지 고급 서비스가 있습니다. 이러한 서비스를 사용하려면 이러한 구성 요소의 리소스 유형이 컨텐츠 조각 프레임워크에 대해 알려져야 합니다.
이 작업은 OSGi 서비스 - 컨텐츠 조각 구성 요소를 구성함으로써 수행됩니다 .
이 정보는 다음과 같은 경우에 필요합니다.
  • 고유한 컨텐츠 조각 기반 구성 요소를 구현해야 합니다.
  • 고급 서비스를 사용해야 합니다.
핵심 구성 요소를 사용하는 것이 좋습니다.
  • 아래에 설명된 고급 서비스가 ​필요하지 않은 경우 이 구성을 무시할 수 있습니다.
  • 기본 구성 요소를 확장 또는 사용하는 경우 OSGi 구성을 변경하지 않는 것이 좋습니다.
  • 컨텐츠 조각 API만 사용하는 구성 요소를 처음부터 작성할 수 있습니다(고급 서비스 ​없음). 그러나 이러한 경우 적절한 처리를 처리하도록 구성 요소를 개발해야 합니다.
따라서 핵심 구성 요소를 사용하는 것이 좋습니다.

구성이 필요한 고급 서비스의 정의

구성 요소를 등록해야 하는 서비스는 다음과 같습니다.
  • 게시 중 올바르게 종속성 확인(즉, 조각과 모델이 마지막 게시 이후 변경된 경우 페이지와 함께 자동으로 게시되도록 확인)
  • 전체 텍스트 검색에서 컨텐츠 조각 지원.
  • 중간 컨텐츠의 관리/ 처리.
  • 혼합 미디어 자산의 관리/ 처리.
  • 참조된 조각에 대한 디스패처 플러시(조각을 포함하는 페이지가 다시 게시되는 경우).
  • 단락 기반 렌더링 사용
이러한 기능 중 하나 이상이 필요한 경우(일반적으로) 처음부터 새로 개발하는 대신 기본 고급 서비스를 사용하는 것이 더 쉽습니다.

OSGi 서비스 - 컨텐츠 조각 구성 요소 구성

구성은 OSGi 서비스 컨텐츠 조각 구성 요소 구성에 바인딩해야 합니다 .
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
자세한 내용은 OSGi 구성을 참조하십시오.
예:
OSGi 구성은 다음과 같습니다.
레이블 OSGi 구성 설명
리소스 유형 dam.cfm.component.resourceType 등록할 리소스 유형;예:
core/wcm/components/contentfragment/v1/contentfragment
참조 속성 dam.cfm.component.fileReferenceProp 조각에 대한 참조가 들어 있는 속성의 이름;예: fragmentPath 또는 fileReference
요소 속성 dam.cfm.component.elementsProp 렌더링할 요소의 이름이 들어 있는 속성의 이름;예: elementName
변화 속성 dam.cfm.component.variationProp 렌더링할 변형 이름이 포함된 속성의 이름;예: variationName
일부 기능의 경우 구성 요소는 사전 정의된 규칙을 준수해야 합니다. 다음 표에서는 서비스가 해당 속성을 정확하게 감지하고 처리할 수 있도록 구성 요소에서 각 단락(즉 jcr:paragraph 각 구성 요소 인스턴스에 대해)에 대해 정의해야 하는 속성에 대해 자세히 설명합니다.
속성 이름 설명
paragraphScope
단락을 단일 요소 렌더링 모드에서 출력하는 방법을 정의하는 문자열 속성입니다.
값:
  • all :모든 단락을 렌더링합니다.
  • range :를 사용하여 paragraphRange
paragraphRange
단일 요소 렌더링 모드에서 출력할 단락 범위를 정의하는 문자열 속성입니다.
형식:
  • 1 또는 1-3 1-3;6;7-8 또는 *-3;5-*
    • - 범위 표시기
    • ; 목록 구분 기호
    • * 와일드카드
  • paragraphScope range
paragraphHeadings 머리글(예: h1 , h2 h3 )을 단락( true )으로 계산하는지 또는 계산되지 않았는지( false )를 정의하는 부울 속성

예를 들어, 다음(기본 AEM 인스턴스에서)을 참조하십시오.
/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config

여기에는 다음이 포함됩니다.
dam.cfm.component.resourceType="core/wcm/components/contentfragment/v1/contentfragment"
dam.cfm.component.fileReferenceProp="fragmentPath"
dam.cfm.component.elementsProp="elementName"
dam.cfm.component.variationProp="variationName"