內容片段模型

上次更新： 2023-11-30

主題：

建立對象：

AEM中的內容片段模型為您的定義了內容結構內容片段，做為Headless內容的基礎。

若要使用內容片段模式，您可以：

為您的執行個體啟用內容片段模型功能
建立、和設定，您的內容片段模型
啟用您的內容片段模型以便在建立內容片段時使用
在所需的Assets資料夾上允許您的內容片段模型透過設定原則.

建立內容片段模型

瀏覽至工具，一般，然後開啟 內容片段模型.
導覽至適合您的檔案夾組態或子組態.
使用建立以開啟精靈。

注意

如果尚未啟用使用內容片段模型，則建立選項將無法使用。
指定「模 型標題」。您也可以定義各種屬性；例如，新增標籤， a 說明，並選取 啟用模型 至啟用模型如有需要。

注意

有關詳細資訊 預設預覽URL模式 另請參閱內容片段模型 — 屬性.
使用建立以儲存空白模型。訊息會指出動作是否成功，您可以選取開啟立即編輯模型，或完成以返回主控台。

定義內容片段模型

內容片段模式透過以下選項，有效地定義結果內容片段的結構 資料型別. 使用模型編輯器，您可以新增資料型別的例項，然後將其設定以建立必填欄位：

注意

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

瀏覽至工具，一般，然後開啟 內容片段模型.
導覽至容納您的內容片段模式的資料夾。
開啟所需的模型編輯；使用快速動作或選取模型，然後從工具列選取動作。

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

當欄位為必填，則標籤左窗格中標示為星號(*)。

新增欄位
- 將欄位所需的資料型別拖曳到所需位置：
- 將欄位新增至模型後，右側面板會顯示屬性可針對該特定資料型別定義的屬性。您可以在此處定義該欄位的必要條件。
  - 許多屬性的含義一目瞭然，如需更多詳細資訊，請參閱屬性.
  - 輸入 欄位標籤 將會自動完成 屬性名稱 — 如果為空白，則可在之後手動更新。
    
    注意
    
    手動更新屬性時 屬性名稱 對於資料型別，請注意，名稱必須僅包含A-Z、a-z、0-9和下劃線「_」作為特殊字元。
    
    如果在舊版AEM中建立的模型包含非法字元，請移除或更新這些字元。
  例如：
移除欄位

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

資料類型

定義模型時可選用多種資料型別：

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

屬性

許多屬性的含義一目瞭然，對於某些屬性，其他詳細資訊如下：

屬性名稱

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

注意

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

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

這是為了確保內容作者無法重複已新增至相同模型其他片段中的內容。

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

注意

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

注意

變數可能具有相同的獨特值做為相同片段的變數，但與其他片段變數中使用的值不同。

注意

如果您想使用MSM （這會建立內容片段的復本），則任何獨特應從在各自內容片段模式中使用的任何資料型別中移除限制。
另請參閱 內容參考 以取得該特定資料型別及其屬性的詳細資訊。
另請參閱 片段參考（巢狀片段） 以取得該特定資料型別及其屬性的詳細資訊。
可翻譯

檢查 可翻譯 內容片段模型編輯器中的欄位上的核取方塊將：
- 確保欄位的屬性名稱已新增到翻譯設定、上下文 /content/dam/<sites-configuration>，如果尚未存在。
- 對於GraphQL：設定 <translatable> 「」內容片段欄位上的屬性 yes，以允許GraphQL查詢篩選僅含有可翻譯內容的JSON輸出。

驗證

各種資料型別現在包含定義在結果片段中輸入內容時適用的驗證需求的可能性：

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

已定義為 多個欄位 (設定為 呈現為)擁有下列選項：
- 最小項目數量
- 項目數量上限
這些功能已經過驗證：
- 最大值會在原始內容片段編輯器.
- 兩者皆會在中驗證內容片段編輯器.

使用參照來形成巢狀內容

內容片段可使用下列任一種資料型別來形成巢狀內容：

內容參考
- 提供其他內容的簡單參照；任何型別。
- 可以為一個或多個參考（在產生的片段中）設定。
片段引用 （巢狀片段）
- 根據指定的特定模型，參考其他片段。
- 可讓您包含/擷取結構化資料。
  
  注意
  
  此方法與下列專案特別相關：搭配GraphQL使用內容片段的Headless內容傳送.
  
  * 可以為一個或多個參考（在產生的片段中）設定。

注意

AEM對下列專案具有週期性保護：

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

內容參考

內容參考可讓您轉譯來自其他來源的內容；例如，影像或內容片段。

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

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

內容參考

片段參考（巢狀片段）

「片段參考」會參考一或多個內容片段。此功能在擷取應用程式中使用的內容時特別有意義，因為它可讓您擷取具有多個圖層的結構化資料。

例如：

定義員工詳細資訊的模型；這些包括：
- 定義僱主（公司）的模型參考

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

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

注意

這與以下內容特別相關：搭配GraphQL使用內容片段的Headless內容傳送.

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

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

如此可讓片段作者根據適當的模型建立片段。
- 片段參考複合 — 允許片段作者藉由選取多個片段來建置複合

注意

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

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