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

有數種 進階服務 和內容片段的演算相關。 若要使用這些服務，內容片段架構必須瞭解這些元件的資源型別。

這是透過設定 OSGi服務 — 內容片段元件設定.

下列情況需要此資訊：

  • 您需要實作自己的內容片段型元件，
  • 而且需要使用進階服務。

建議使用核心元件。

注意

  • 如果您不需要 進階服務 如下所述，您可以忽略此設定。

  • 當您延伸或使用現成元件時，不建議變更OSGi設定。

  • 您可以從頭開始撰寫只使用內容片段API （沒有進階服務）的元件. 但是，在這種情況下，您必須開發元件，以便處理適當的處理。

因此，建議使用核心元件。

需要設定的進階服務定義

需要註冊元件的服務包括：

  • 在發佈期間正確判斷相依性（亦即，如果片段和模型自上次發佈以來已變更，請確保片段和模型可隨頁面自動發佈）。
  • 支援全文檢索搜尋中的內容片段。
  • 管理/處理 中間內容。
  • 管理/處理 混合媒體資產。
  • 參考片段的Dispatcher排清（如果重新發佈包含片段的頁面）。
  • 使用段落式轉譯。

如果您需要這些功能中的一或多個，那麼使用現成可用的進階服務通常會比較容易，而不是從頭開始開發。

OSGi服務 — 內容片段元件設定

設定需要繫結到OSGi服務 內容片段元件設定：

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

注意

另請參閱 OSGi設定 以取得更多詳細資料。

例如：

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)

範例

如需範例，請參閱以下內容(在現成可用的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"

本頁內容