설명서AEM 6.5사용 안내서

렌더링용 구성 요소를 구성하는 콘텐츠 조각 content-fragments-configuring-components-for-rendering

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

작성 대상:

  • 개발자

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

이 작업은 OSGi 서비스 - 콘텐츠 조각 구성 요소 구성을(를) 구성하여 수행됩니다.

CAUTION
아래에 설명된 고급 서비스가 필요하지 않은 경우 이 구성을 무시할 수 있습니다.
CAUTION
기본 구성 요소를 확장하거나 사용할 때는 구성을 변경하지 않는 것이 좋습니다.
CAUTION
고급 서비스 없이 콘텐츠 조각 API만 사용하는 구성 요소를 처음부터 작성할 수 있습니다. 그러나 이러한 경우 구성 요소가 적절한 처리를 수행하도록 개발해야 합니다.
따라서 핵심 구성 요소를 사용하는 것이 좋습니다.

구성이 필요한 고급 서비스의 정의 definition-of-advanced-services-that-need-configuration

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

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

이러한 기능 중 하나 이상이 필요한 경우 (일반적으로) 처음부터 개발하는 대신 기본 기능을 사용하는 것이 더 쉽습니다.

OSGi 서비스 - 콘텐츠 조각 구성 요소 구성 osgi-service-content-fragment-component-configuration

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

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

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

예:

cfm-01

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

일부 기능(예: 단락 범위만 렌더링)의 경우 일부 규칙을 준수해야 합니다.

속성 이름
설명
paragraphRange

단일 요소 렌더링 모드 인 경우 출력할 단락의 범위를 정의하는 문자열 속성입니다.

형식:

  • 1 또는 1-3 또는 1-3;6;7-8 또는 *-3;5-*
  • paragraphScope이(가) 다음으로 설정된 경우에만 평가됨 range
paragraphScope

단일 요소 렌더링 모드 인 경우 단락이 출력되는 방법을 정의하는 문자열 속성입니다.

값:

  • all : 모든 단락을 렌더링합니다
  • range : 제공된 단락의 범위를 렌더링합니다. paragraphRange
paragraphHeadings
머리글(예: h1, h2, h3)이 단락(true) 또는 단락(false)으로 계산되는지 여부를 정의하는 부울 속성
CAUTION
이는 6.5 이후 이정표에서 변경될 수 있습니다.

예 example

예를 들어 다음을 참조하십시오(기본 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"
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2