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

콘텐츠 조각 렌더링과 관련된 고급 서비스가 여러 개 있습니다. 이러한 서비스를 사용하려면 이러한 구성 요소의 리소스 유형이 컨텐츠 조각 프레임워크에 대해 자신을 인식해야 합니다.

이 작업은 OSGi 서비스 - 컨텐츠 조각 구성 요소 구성을 구성하여 수행합니다.

이 정보는 다음과 같은 경우에 필요합니다.

  • 컨텐츠 조각 기반 구성 요소를 구현해야 합니다.
  • 고급 서비스를 사용해야 합니다.

핵심 구성 요소를 사용하는 것이 좋습니다.

주의

  • 아래에 설명된 고급 서비스가 필요하지 않은 경우 이 구성을 무시할 수 있습니다.

  • 기본 구성 요소를 확장하거나 사용하는 경우 OSGi 구성을 변경하는 것이 좋습니다.

  • 컨텐츠 조각 API만 사용하는 구성 요소를 처음부터 작성할 수 있습니다(고급 서비스 없음). 그러나 이러한 경우 적절한 처리를 처리하도록 구성 요소를 개발해야 합니다.

따라서 핵심 구성 요소를 사용하는 것이 좋습니다.

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

구성 요소를 등록해야 하는 서비스는 다음과 같습니다.

  • 게시 중 올바르게 종속성을 결정합니다(즉, 조각 및 모델이 마지막 게시 이후 변경된 경우 페이지를 사용하여 자동으로 게시할 수 있는지 확인합니다).
  • 전체 텍스트 검색에서 컨텐츠 조각을 지원합니다.
  • 중간 컨텐츠의 관리/처리입니다.
  • 혼합 미디어 자산의 관리/처리.
  • 참조된 조각에 대한 디스패처가 플러시됩니다(조각을 포함하는 페이지가 다시 게시되는 경우).
  • 단락 기반 렌더링 사용

이러한 기능 중 하나 이상이 필요한 경우(일반적으로) 처음부터 새로 개발하는 대신 바로 사용 가능한 고급 서비스를 사용하는 것이 더 쉽습니다.

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

구성은 OSGi 서비스 컨텐츠 조각 구성 요소 구성​에 바인딩해야 합니다.

com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl

노트

자세한 내용은 OSGi 구성을 참조하십시오.

예:

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"

이 페이지에서는