轉譯專用內容片段設定元件 content-fragments-configuring-components-for-rendering
有好幾個 進階服務 和內容片段的演算相關。 若要使用這些服務,這類元件的資源型別必須在內容片段框架中讓使用者知道這些元件。
這可透過設定 OSGi服務 — 內容片段元件設定.
在下列情況下,需要此資訊:
- 您需要實作自己的內容片段型元件,
- 而且需要使用進階服務。
Adobe建議使用核心元件。
CAUTION
-
如果您不需要 進階服務 如下所述,您可以忽略此設定。
-
當您延伸或使用現成可用的元件時,不建議變更OSGi設定。
-
您可以從頭開始撰寫只使用內容片段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設定 以取得更多詳細資料。
例如:
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
)範例 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
fbcff2a9-b6fe-4574-b04a-21e75df764ab