內容片段範本 content-fragment-templates

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Developing

建立對象：

Developer

CAUTION

AEM 6.4已結束延伸支援，本檔案不再更新。如需詳細資訊，請參閱技術支援期. 尋找支援的版本此處.

CAUTION

某些內容片段功能需要應用 AEM 6.4 Service Pack 2(6.4.2.0).

CAUTION

內容片段模型現在建議您建立所有片段。

內容片段模型用於We.Retail中的所有範例。

建立內容片段時會選取範本。它們為新片段提供了基本結構、元素和變異。用於內容片段的範本需受Granite Configuration Manager的規範。

現成可用的範本位於：

/libs/settings/dam/cfm/templates

您可以在下方為內容片段建立網站特定範本：

/apps/settings/dam/cfm/templates

用於覆蓋現成可用的模板或提供客戶特定、應用程式範圍的模板的位置，這些模板不打算在運行時擴展/更改。
/conf/global/settings/dam/cfm/templates

需要在執行階段變更之執行個體範圍客戶專屬範本的位置。

優先順序順序為（降序） /conf, /apps, /libs.

CAUTION

您必須不會變更 /libs 路徑。

這是因為 /libs 下次升級執行個體時即會覆寫（而當您套用Hotfix或Feature Pack時，很可能會覆寫）。

設定和其他變更的建議方法為：

重新建立所需項目(亦即， /libs)底下 /apps
在內進行任何變更 /apps

範本的基本結構如下：

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

具體結構為：

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

有關節點及其屬性的詳細資訊包括：

範本

名稱

類型

值

<template-name>

nt:unstructured

此節點是每個模板的根節點。此為必要項目，且名稱應是唯一的。

jcr:title

String

必填

範本的標題(顯示於 建立片段 精靈)。

jcr:description

String

可選

說明範本用途的文字(顯示於 建立片段 精靈)。

initialAssociatedContent

String[]

可選

依預設，具有系列路徑的陣列應與新建立的內容片段相關聯。

precreateElements

Boolean

必填

true，如果在建立內容片段時，應建立代表內容片段元素（主版元素除外）的子資產； false 如果應該「即時」建立它們。

附註:目前此參數必須設為 true.

version

Long

必填

內容結構的版本；目前支援：

附註:目前此參數必須設為 2.

元素

名稱

類型

值

elements

nt:unstructured

必填

包含內容片段元素定義的節點。此為必要項目，需要包含主要元素，但可以包含[1..n]子節點。

使用模板時，元素子分支將被複製到片段的模型子分支。

第一個元素(如CRXDE Lite中所檢視)會自動被視為 main 元素；節點名稱無關，節點本身除以主要資產表示外，沒有特殊意義；其他元素會以子資產的形式處理。

元素名稱

名稱

類型

值

<element-name>

nt:unstructured

此節點定義元素。此為必要項目，且名稱應是唯一的。

jcr:title

String

必填

元素的標題（顯示在片段編輯器的元素選取器中）。

defaultContent

String

可選

預設: ""

元素的初始內容；僅使用 precreateElements = true

initialContentType

String

可選

預設: text/html

元素的初始內容類型；僅使用 precreateElements = true;目前支援：

text/html
text/plain
text/x-markdown

name

String

必填

元素的內部名稱；片段類型必須是唯一的。

變數

名稱

類型

值

variations

nt:unstructured

可選

此選用節點包含內容片段初始變異的定義。

變數名稱

名稱

類型

值

<variation-name>

nt:unstructured

若變異節點存在，則此為必要項目

定義初始變數。
依預設，變異會新增至內容片段的所有元素。

變異的初始內容將與個別元素相同(請參閱 defaultContent/ initialContentType)

jcr:title

String

必填

變異的標題(顯示在片段編輯器的變異標籤（左側欄）。

jcr:desciption

String

可選

預設: ""

提供變異說明的文字 (顯示在片段編輯器的變異標籤（左側欄）。

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e