Experience League

Exit search

內容片段模型

AEM中的內容片段模型會定義內容片段. 這些功能可用於頁面編寫，或作為無頭內容的基礎。

若要使用內容片段模型，請執行下列動作：

為您的執行個體啟用內容片段模型功能
建立，和設定，您的內容片段模型
啟用內容片段模型用於建立內容片段時
在必要的資產資料夾上允許您的內容片段模型配置原則.

建立內容片段模型

導覽至工具, 一般，然後開啟 內容片段模型.
導覽至適合您配置，或子配置.
使用建立來開啟嚮導。

注意

若尚未啟用內容片段模型的使用, 建立選項將無法使用。
指定「模 型標題」。您也可以新增標籤, 說明，然後選取 啟用模型 to 啟用模型（如果需要）。
使用建立以保存空模型。訊息會指出動作的成功，您可以選取開啟要立即編輯模型，或完成返回控制台。

定義內容片段模型

所述內容片段模型使用選擇有效地定義所得內容片段的結構 資料類型. 使用模型編輯器，可以新增資料類型的例項，然後設定它們以建立必要欄位：

注意

編輯現有內容片段模型可能會影響相依片段。

導覽至工具, 一般，然後開啟 內容片段模型.
導覽至內容片段模型的資料夾。
開啟所需的模型編輯;使用快速操作，或從工具欄中選取模型，然後選取操作。

開啟模型編輯器後，會顯示：
- 左：欄位已定義
- 右：資 料類型 ，可用於建立欄位( 和屬性 ，以供建立欄位後使用)
注意

欄位為必填, 標籤在左窗格中所示，會以字元(*)。

新增欄位的方式
- 將必要的資料類型拖曳至欄位的必要位置：
- 將欄位新增至模型後，右側面板會顯示屬性可針對該特定資料類型定義。您可以在此定義該欄位的必要項目。
  - 許多屬性不言自明，如需其他詳細資訊，請參閱屬性.
  - 輸入 欄位標籤 會自動完成 屬性名稱 — 如果空白，之後可手動更新。
    
    注意
    
    手動更新屬性時 屬性名稱 對於資料類型，請注意，名稱只能包含A-Z、a-z、0-9和底線「_」作為特殊字元。
    
    如果在舊版AEM中建立的模型包含非法字元，請移除或更新這些字元。
  例如：
刪除欄位

選取必要欄位，然後按一下/點選垃圾桶圖示。系統會要求您確認動作。
新增所有必要欄位，並視需要定義相關屬性。例如：
選擇儲存以保留定義。

資料類型

定義模型時可選擇資料類型：

單行文字
- 添加一行文本的一個或多個欄位；可定義的最大長度
多行文字
- 可為RTF、純文字或Markdown的文字區域
數量
- 添加一個或多個數字欄位
布林值
- 新增布林值核取方塊
日期時間
- 新增日期和/或時間
列舉
- 新增一組核取方塊、選項按鈕或下拉式欄位
標記
- 允許片段作者存取和選取標籤區域
內容參考資料
- 參考任何類型的其他內容；可用於建立巢狀內容
- 如果參照影像，您可以選擇顯示縮圖
片段引用
- 參考其他內容片段；可用於建立巢狀內容
- 資料類型可設定為允許片段作者：
  - 直接編輯參考的片段。
  - 根據適當的模型建立新內容片段
JSON 物件
- 允許內容片段作者在片段的對應元素中輸入JSON語法。
  - 允許AEM儲存您從其他服務複製/貼上的直接JSON。
  - JSON會傳遞，並在GraphQL中輸出為JSON。
  - 在內容片段編輯器中包含JSON語法醒目提示、自動完成和錯誤醒目提示。
標籤預留位置
- 允許導入頁簽，以便在編輯內容片段內容時使用。
  這將在模型編輯器中顯示為分隔線，用於分隔內容資料類型清單的各節。每個例項代表新索引標籤的開頭。
  在片段編輯器中，每個例項都會顯示為索引標籤。
  
  注意
  
  此資料類型僅用於格式設定，AEM GraphQL結構會忽略它。

屬性

許多屬性不言自明，對於某些屬性，其他詳細資訊如下：

屬性名稱

手動更新資料類型的此屬性時，請注意名稱必須 cont 僅限 A-Z、a-z、0-9和底線「_」作為特殊字元。

注意

如果在舊版AEM中建立的模型包含非法字元，請移除或更新這些字元。
呈現為
用於在片段中實現/呈現欄位的各種選項。這通常可讓您定義作者會看到欄位的單一例項，或是允許建立多個例項。
欄位標籤
輸入
欄位標籤 會自動產生 屬性名稱，如有需要，可手動更新。
驗證
基本驗證可由下列機制提供：必填屬性。有些資料類型有新增驗證欄位。請參閱驗證以取得詳細資訊。
對於「多行」 資料類型 ，可將「預設類型」定義為：
- RTF
- Markdown
- 純文字
若未指定，則預設值 RTF 用於此欄位。

在內容 片段模型中變更「預設類型 」，只會在編輯器中開啟並儲存該片段後，對現有、相關的內容片段生效。
不重複
內容（針對特定欄位）在從目前模型建立的所有內容片段中必須是唯一的。

這可確保內容作者無法重複已新增至相同模型另一個片段中的內容。

例如， 單行文字 欄位 Country 內容片段模型中的「」不能有值 Japan 在兩個相依內容片段中。嘗試第二個執行個體時會發出警告。

注意

確保每個語言根的唯一性。

注意

變數可以有相同唯一值作為相同片段的變數，但與其他片段的任何變數所用的值不同。
請參閱 內容參考 以取得有關該特定資料類型及其屬性的詳細資訊。
請參閱 片段參考（巢狀片段） 以取得有關該特定資料類型及其屬性的詳細資訊。
可翻譯

檢查 可翻譯 內容片段模型編輯器中欄位上的核取方塊將：
- 確認欄位的屬性名稱已新增至翻譯設定、內容 /content/dam/<sites-configuration>，如果尚未出現。
- 若為GraphQL:設定 <translatable> 「內容片段」欄位上的屬性 yes，允許GraphQL查詢篩選器只能輸出可翻譯的內容。

驗證

各種資料類型現在都包含為內容輸入到產生片段時定義驗證需求的可能性：

單行文字
- 比較預先定義的規則運算式。
數量
- 檢查特定值。
內容參考資料
- 測試特定內容類型。
- 只能參考指定檔案大小或較小的資產。
- 只能參考預先定義的寬度和/或高度範圍內（以像素為單位）的影像。
片段引用
- 測試特定內容片段模型。

使用參考來形成巢狀內容

內容片段可使用下列其中一種資料類型，以形成巢狀內容：

內容參考資料
- 提供對其他內容的簡單參考；任何類型。
- 可針對一或多個參照（在產生的片段中）進行設定。
片段參考 （巢狀片段）
- 參照其他片段，取決於指定的特定模型。
- 可讓您包含/擷取結構化資料。
  
  注意
  
  該方法與透過GraphQL使用內容片段進行無頭式內容傳送.
  
  * 可針對一或多個參照（在產生的片段中）進行設定。

注意

AEM對以下項目提供重複防護：

內容參考資料
這會防止使用者新增參考至目前的片段。這可能會導致空白的片段參考選擇器對話方塊。
GraphQL中的片段參考
如果您建立深層查詢，並傳回彼此參照的多個內容片段，則第一次出現時會傳回null。

內容參考資料

「內容參考」可讓您從其他來源轉譯內容；例如影像或內容片段。

除了標準屬性之外，您還可以指定：

此 根路徑 任何參考內容
可參考的內容類型
檔案大小限制
如果已參考影像：
- 顯示縮圖
- 高度和寬度的影像限制

內容參考資料

片段參考（巢狀片段）

片段參考會參考一或多個內容片段。擷取要在您應用程式中使用的內容時，這項功能特別受關注，因為它可讓您擷取含有多個圖層的結構化資料。

例如：

定義員工詳細資訊的模型；包括：
- 對定義雇主（公司）的模型的引用

type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}

注意

這與透過GraphQL使用內容片段進行無頭式內容傳送.

除了標準屬性之外，您還可以定義：

呈現為:
- 多場 — 片段作者可建立多個個別的參考
- 碎片 — 允許片段作者選取片段的單一參考
模型類型
可以選取多個模型。編寫內容片段時，必須已使用這些模型建立任何參考的片段。
根路徑
這會指定所參考任何片段的根路徑。
允許建立片段

這可讓片段作者根據適當的模型建立新片段。
- 碎裂組合 — 可讓片段作者選取多個片段，以建立複合

注意

已建立重複保護機制。它禁止使用者在片段參考中選取目前的內容片段。這可能會導致空白的片段參考選擇器對話方塊。

GraphQL中的片段參考也提供週期性保護。如果您在互相參照的兩個內容片段間建立深層查詢，則會傳回null。