Adobe Experience League

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

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

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

주의

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

주의

즉시 사용 가능한 구성 요소를 확장하거나 사용하는 경우에는 구성을 변경하는 것이 좋습니다.

주의

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

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

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

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

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

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

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"