定義內容片段模型 defining-content-fragment-models
Adobe Experience Manager (AEM) as a Cloud Service中的內容片段模型定義內容片段的內容結構。 這些片段隨後可用於頁面製作，或用作Headless內容的基礎。
本頁涵蓋如何使用專用編輯器定義您的內容片段模式。 請參閱管理您的內容片段模式，瞭解建立片段後可用的進一步工作與選項，包括內容片段主控台可用的動作、允許在資料夾上建立模式以及發佈模式。
- 「此模型已設定自訂UI結構描述。 此UI中顯示的欄位順序可能與UI結構描述不相符。 若要檢視與UI結構描述對齊的欄位，您必須切換到新的內容片段編輯器。」
定義內容片段模型 defining-your-content-fragment-model
內容片段模式透過選擇 資料型別，有效地定義了結果內容片段的結構。 使用模型編輯器，您可以新增資料型別的例項，然後將其設定以建立必填欄位：
-
在內容片段主控台中，選取內容片段模式的面板，並導覽至儲存您的內容片段模式的資料夾。
note note NOTE 您也可以在建立模型後直接開啟模型。 -
開啟 編輯 所需的模型；使用其中一個快速動作連結，或選取模型，然後從工具列選取動作。
開啟模型編輯器後，會顯示：
-
上：
- 首頁 圖示
- 在原始與新編輯器之間切換的選項
- 取消
- 儲存
-
左： 資料型別 可用於建立欄位
-
中間：欄位已與 新增 選項一起定義
-
右：使用最右側的圖示，您可在以下兩者之間選取：
- 屬性：定義並檢視所選欄位的屬性
- 模型詳細資料：顯示 已啟用 狀態、模型標題、標籤、描述 和 預覽URL
-
-
新增欄位
-
可以：
- 將資料型別從左側面板拖曳至中間面板中欄位的必要位置。
- 依資料型別選取 + 圖示以將其新增至欄位清單底部。
- 在中間面板中選取「新增」，然後從產生的下拉式清單中選取所需的資料型別，以在清單底部新增欄位。
note note NOTE 索引標籤預留位置 欄位必須一律顯示在現有欄位上方。 -
您可以使用欄位方塊左側的點狀結構來重新定位欄位：
-
將欄位新增至模型（且已選取）後，右側面板會顯示可針對該特定資料型別定義的 屬性。 您可以在此處定義特定的
欄位。-
許多屬性不言自明，如需詳細資訊，請參閱屬性（資料型別）。
-
輸入 欄位標籤 會自動完成 屬性名稱 （如果空白），之後可以手動更新。
note caution CAUTION 手動更新資料型別的屬性 Property Name 時，名稱必須僅包含 個 A-Z、a-z、0-9和下劃線「_」作為特殊字元。 如果在舊版AEM中建立的模型包含非法字元，請移除或更新這些字元。
例如：
note note NOTE 當欄位定義為 必要 時，中間窗格中標示的 標籤 會標示為字元(*)。 -
-
-
移除欄位
選取中間面板中適當欄位的垃圾桶圖示。
-
新增所有必要欄位，並視需要定義相關屬性。
-
選取 儲存 以保留定義。
資料類型 data-types
定義模型時可選用多種資料型別：
-
單行文字
- 為單行文字新增欄位；可以定義最大長度
- 欄位可設定為允許片段作者建立欄位的新執行個體
-
多行文字
- 可能是RTF、純文字或Markdown的文字區域
- 欄位可設定為允許片段作者建立欄位的新執行個體
note note NOTE 文字區域是否為RTF、純文字或Markdown，是由屬性 預設型別 在模型中定義。 此格式無法從內容片段編輯器變更，只能從模型變更。 -
數字
- 新增數值欄位
- 欄位可設定為允許片段作者建立欄位的新執行個體
-
布林值
- 新增布林值核取方塊
-
日期和時間
- 新增日期和/或時間欄位
-
分項清單
- 新增一組核取方塊、選項按鈕或下拉式清單欄位
- 您可以指定片段作者可用的選項
- 新增一組核取方塊、選項按鈕或下拉式清單欄位
-
標籤
- 允許片段作者存取及選取標籤區域
-
片段參考
-
參考其他內容片段；可用於建立巢狀內容
-
可以設定此資料類型以允許片段作者：
- 直接編輯參考的片段。
- 根據適當的模式建立新的內容片段
- 建立欄位的新執行個體
-
參考指定參考資源的路徑；例如
/content/dam/path/to/resource
-
-
內容參考
- 參考任何型別的其他內容；可用於建立巢狀內容
- 如果參照了影像，您可以選擇顯示縮圖
- 欄位可設定為允許片段作者建立欄位的新執行個體
- 參考指定參考資源的路徑；例如
/content/dam/path/to/resource
-
JSON物件
-
允許內容片段作者在片段的對應元素中輸入JSON語法。
- 允許AEM儲存您從其他服務複製/貼上的直接JSON。
- JSON會傳遞，並在GraphQL中輸出為JSON。
- 在內容片段編輯器中包括JSON語法醒目提示、自動完成和錯誤醒目提示。
-
-
索引標籤預留位置
-
允許引進索引標籤，以在編輯內容片段內容時使用。
- 這些在模型編輯器中顯示為分隔線，分隔內容資料型別清單的區段。 每個例項代表新索引標籤的開始。
- 在片段編輯器中，每個例項都會顯示為一個索引標籤。
note note NOTE 此資料型別僅用於格式設定，AEM GraphQL結構描述會忽略此資料型別。 索引標籤預留位置 欄位必須一律顯示在現有欄位上方。
-
屬性（資料型別） properties
許多屬性的含義一目瞭然，對於某些屬性，其他詳細資訊如下：
-
屬性名稱
手動更新資料型別的這個屬性時，名稱 必須 僅包含 個 A-Z、a-z、0-9和下劃線「_」作為特殊字元。
note caution CAUTION 如果在舊版AEM中建立的模型包含非法字元，請移除或更新這些字元。 -
呈現為
在片段中實現/轉譯欄位的各種選項。 這通常可讓您定義作者將看到欄位的單一例項，還是允許建立多個例項。 使用 多個欄位 時，您可以定義專案的最小和最大數量 — 如需詳細資訊，請參閱驗證。
-
欄位標籤
輸入 欄位標籤 會自動產生 屬性名稱，然後可視需要手動更新。 -
驗證
基本驗證可由機制使用，例如 Required 屬性。 有些資料型別有額外的驗證欄位。 如需詳細資訊，請參閱驗證。 -
對於「多行」 資料類型 ，可將「預設類型 」定義為：
- RTF 文字
- Markdown
- 純文字
如果未指定，此欄位會使用預設值 RTF。
在內容片段模型中變更 預設型別，只會在編輯器中開啟並儲存該片段後，對現有、相關的內容片段生效。
-
唯一
從目前模型建立的所有內容片段內容（適用於特定欄位）必須是唯一的。這是為了確保內容作者無法重複已新增至相同模型其他片段中的內容。
例如，內容片段模型中名為 的 單行文字
Country欄位在兩個相依的內容片段中不能有值Japan。 嘗試第二個執行個體時會發出警告。note note NOTE 確保每個語言根的唯一性。 note note NOTE 變數可以有與相同片段變數相同的 唯一 值，但與其他片段變數中使用的值不同。 -
如需特定資料型別及其屬性的詳細資訊，請參閱 內容參考。
-
如需特定資料型別及其屬性的詳細資訊，請參閱 片段參考（巢狀片段）。
-
可翻譯
核取內容片段模型編輯器中欄位上的 可翻譯 核取方塊將：
- 確認欄位的屬性名稱已新增至翻譯組態，內容
/content/dam/<sites-configuration>（如果尚未存在）。 - 對於GraphQL：將內容片段欄位上的
<translatable>屬性設定為yes，以允許GraphQL查詢篩選僅包含可翻譯內容的JSON輸出。
- 確認欄位的屬性名稱已新增至翻譯組態，內容
驗證 validation
各種資料型別現在包含定義在結果片段中輸入內容時適用的驗證需求的可能性：
-
單行文字
- 與預先定義的規則運算式比較。
-
數字
- 檢查特定值。
-
內容參考
- 測試特定型別的內容。
- 只能參考指定檔案大小或更小的資產。
- 只能參考預先定義的寬度和/或高度範圍（以畫素為單位）內的影像。
-
片段參考
- 測試特定內容片段模型。
-
最小專案數 / 最大專案數
已定義為 多個欄位 （以 Render As 設定）的欄位具有選項：
- 最小專案數
- 最大專案數
已在內容片段編輯器中驗證這些專案。
使用參照來形成巢狀內容 using-references-to-form-nested-content
內容片段可使用下列任一種資料型別來形成巢狀內容：
-
內容參考
> 這可防止使用者新增對目前片段的引用，並可能導致空白的片段引用選取器對話方塊。 -
GraphQL中的片段參考
> 如果您建立深層查詢，且該查詢傳回多個互相參照的內容片段，則它會在第一次出現時傳回null。
內容參考 content-reference
內容參考 資料型別可讓您轉譯來自其他來源的內容；例如，影像、頁面或體驗片段。
除了標準屬性之外，您還可以指定：
片段參考（巢狀片段） fragment-reference-nested-fragments
片段參考 資料型別可以參考一或多個內容片段。 此功能可讓您擷取多個圖層的結構化資料，在擷取應用程式中使用的內容時特別感興趣。
例如：
- 定義員工詳細資訊的模型；包括：
- 定義僱主（公司）的模型參考
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
除了標準屬性之外，您還可以定義：
-
呈現為：
-
multifield — 片段作者可以建立多個個別參考
-
fragmentreference — 允許片段作者選取片段的單一參考
-
-
模型型別
可選取多個模型。 將參照新增至內容片段時，任何參照的片段都必須使用這些模型建立。 -
根路徑
這會指定或表示任何參考片段的根路徑。 -
允許建立片段
如此可讓片段作者根據適當的模型建立片段。
- fragmentreferencecomposite — 允許片段作者藉由選取多個片段來建置複合
