렌더링용 구성 요소를 구성하는 콘텐츠 조각

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

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

주의

필요하지 않은 경우 고급 서비스 아래에 설명되어 있으므로 이 구성을 무시할 수 있습니다.

주의

기본 구성 요소를 확장하거나 사용할 때는 구성을 변경하지 않는 것이 좋습니다.

주의

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

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

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

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

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

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

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

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

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

노트

다음을 참조하십시오 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`)

주의

이는 6.5 이후 이정표에서 변경될 수 있습니다.

예

예를 들어 다음을 참조하십시오(기본 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"