內容片段範本

注意

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

注意

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

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

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

現成可用的範本位於：

/libs/settings/dam/cfm/templates

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

/apps/settings/dam/cfm/templates

覆蓋現成可用範本或提供客戶特定、應用程式範圍範本的位置，這些範本在執行時期不會延伸／變更。
/conf/global/settings/dam/cfm/templates

需要在執行時期變更的整個客戶特定範本位置。

優先順序為（降序）/conf、/apps、/libs。

注意

您必須不要變更/libs路徑中的任何項目。

這是因為下次升級實例時會覆寫/libs的內容（套用修補程式或功能套件時，很可能會覆寫）。

配置和其他更改的建議方法為：

在/apps下重新建立所需項目（如/libs中所存在）
在/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` required	範本的標題（顯示在建立片段精靈中）。
`jcr:description`	`String` 可選	描述模板用途的文本（顯示在建立片段嚮導中）。
`initialAssociatedContent`	`String[]` 可選	預設情況下，具有系列路徑的陣列，應與新建立的內容片段相關聯。
`precreateElements`	`Boolean` 必要	`true`,if the subsasets resporting the elements（master element除外）of the content fragment is created;false如果應「即時」建立。注意:目前，此參數必須設為 `true`。
`version`	`Long` 必要	內容結構版本；目前支援：注意:目前，此參數必須設為 `2`。

元素

名稱類型值

名稱	類型	值
`elements`	`nt:unstructured` 必要	包含內容片段元素定義的節點。它是強制性的，並且需要為Main元素包含至少一個子節點，但可以包含[1..n]子節點。使用模板時，元素子分支將被複製到片段的模型子分支。第一個元素（如CRXDE Lite中所述）被自動視為main元素；節點名稱無關，節點本身除了以主資產表示外，沒有特殊意義；其他元素則視為子資產處理。

elements

nt:unstructured

必要

包含內容片段元素定義的節點。它是強制性的，並且需要為Main元素包含至少一個子節點，但可以包含[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` 可選	此可選節點包含內容片段的初始變化的定義。

variations

nt:unstructured

可選

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

變數名稱

名稱類型值

名稱	類型	值
`<variation-name>`	`nt:unstructured` 變異節點存在時所需	定義初始變化。依預設，變數會新增至內容片段的所有元素。變數的初始內容會與個別元素相同（請參閱`defaultContent/ initialContentType`）
`jcr:title`	`String` 必要	變數的標題(顯示在片段編輯器的變數標籤中（左側欄）)。
`jcr:desciption`	`String` 可選預設: ""	提供變化（顯示在片段編輯器的變化標籤中）說明的文本。

<variation-name>

nt:unstructured

變異節點存在時所需

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

變數的初始內容會與個別元素相同（請參閱defaultContent/ initialContentType）

jcr:title

String

必要

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

jcr:desciption

String

可選