轉譯專用內容片段設定元件

上次更新: 2023-12-07

有好幾個 進階服務 和內容片段的演算相關。 若要使用這些服務,這類元件的資源型別必須在內容片段框架中讓使用者知道這些元件。

這可透過設定 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 包含片段參照的屬性名稱;例如, fragmentPathfileReference
元素屬性 dam.cfm.component.elementsProp 包含要呈現之元素名稱的屬性名稱;例如,elementName
變數屬性
dam.cfm.component.variationProp 包含要呈現之變數名稱的屬性名稱;例如,variationName

對於某些功能(例如,僅呈現段落範圍),您必須遵循某些慣例:

屬性名稱 說明
paragraphRange

字串屬性,定義段落範圍(若在 單一元素轉譯模式.

格式:

  • 11-31-3;6;7-8*-3;5-*
  • 只有在 paragraphScope 設為 range
paragraphScope

字串屬性,定義在中時如何輸出段落 單一元素轉譯模式.

值:

  • all :呈現所有段落
  • range :呈現以下專案提供的段落範圍: paragraphRange
paragraphHeadings 布林值屬性,定義標題(例如 h1h2h3)均計算為段落(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"

本頁內容