內容片段模型 content-fragment-models
AEM中的內容片段模型為您的定義了內容結構 內容片段， 做為Headless內容的基礎。
若要使用內容片段模式，您可以：
- 為您的執行個體啟用內容片段模型功能
- 建立、和 設定，您的內容片段模型
- 啟用您的內容片段模型 以便在建立內容片段時使用
- 在所需的Assets資料夾上允許您的內容片段模型 透過設定 原則.
建立內容片段模型 creating-a-content-fragment-model
-
瀏覽至 工具， 一般，然後開啟 內容片段模型.
-
導覽至適合您的檔案夾 組態或子組態.
-
使用 建立 以開啟精靈。
note caution CAUTION 如果尚未啟用使用內容片段模型，則 建立 選項將無法使用。 -
指定 模型標題.
您也可以定義各種屬性；例如，新增 標籤， a 說明，並選取 啟用模型 至 啟用模型 如有需要。note note NOTE 有關詳細資訊 預設預覽URL模式 另請參閱 內容片段模型 — 屬性. 
-
使用 建立 以儲存空白模型。 訊息會指出動作是否成功，您可以選取 開啟 立即編輯模型，或 完成 以返回主控台。
定義內容片段模型 defining-your-content-fragment-model
內容片段模式透過以下選項，有效地定義結果內容片段的結構 資料型別. 使用模型編輯器，您可以新增資料型別的例項，然後將其設定以建立必填欄位：
-
瀏覽至 工具， 一般，然後開啟 內容片段模型.
-
導覽至容納您的內容片段模式的資料夾。
-
開啟所需的模型 編輯；使用快速動作或選取模型，然後從工具列選取動作。
開啟模型編輯器後，會顯示：
- 左：欄位已定義
- 右：資 料類型 ，可用於建立欄位( 和屬性 ，以供建立欄位後使用)
note note NOTE 當欄位為 必填，則 標籤 左窗格中標示為星號(*)。
-
新增欄位
-
將欄位所需的資料型別拖曳到所需位置：
-
將欄位新增至模型後，右側面板會顯示 屬性 可針對該特定資料型別定義的屬性。 您可以在此處定義該欄位的必要條件。
-
許多屬性的含義一目瞭然，如需更多詳細資訊，請參閱 屬性.
-
輸入 欄位標籤 將會自動完成 屬性名稱 — 如果為空白，則可在之後手動更新。
note caution CAUTION 手動更新屬性時 屬性名稱 對於資料型別，請注意，名稱必須僅包含A-Z、a-z、0-9和下劃線「_」作為特殊字元。 如果在舊版AEM中建立的模型包含非法字元，請移除或更新這些字元。
例如：
-
-
-
移除欄位
選取必填欄位，然後選取垃圾桶圖示。 系統會要求您確認動作。
-
新增所有必要欄位，並視需要定義相關屬性。 例如：
-
選取 儲存 以保留定義。
資料類型 data-types
定義模型時可選用多種資料型別：
-
單行文字
- 新增一行或多行文字的欄位；可以定義最大長度
-
多行文字
- RTF、純文字或Markdown文字區域
-
數字
- 新增一或多個數值欄位
-
布林值
- 新增布林值核取方塊
-
日期和時間
- 新增日期和/或時間
-
分項清單
- 新增一組核取方塊、選項按鈕或下拉式清單欄位
-
標籤
- 允許片段作者存取及選取標籤區域
-
內容參考
- 參考任何型別的其他內容；可用於 建立巢狀內容
- 如果參照了影像，您可以選擇顯示縮圖
-
片段引用
-
參考其他內容片段；可用於 建立巢狀內容
-
可以設定此資料類型以允許片段作者：
- 直接編輯參考的片段。
- 根據適當的模型建立新的內容片段
-
-
json物件
-
允許內容片段作者在片段的對應元素中輸入JSON語法。
- 允許AEM儲存您從其他服務複製/貼上的直接JSON。
- JSON會傳遞，並在GraphQL中輸出為JSON。
- 在內容片段編輯器中包括JSON語法醒目提示、自動完成和錯誤醒目提示。
-
-
索引標籤預留位置
-
允許引進索引標籤，以在編輯內容片段內容時使用。
這會在模型編輯器中顯示為分隔線，用於分隔內容資料型別清單的各個區段。 每個例項代表新索引標籤的開始。
在片段編輯器中，每個例項都會顯示為一個索引標籤。note note NOTE 此資料型別僅用於格式設定，AEM GraphQL結構描述會忽略此資料型別。
-
屬性 properties
許多屬性的含義一目瞭然，對於某些屬性，其他詳細資訊如下：
-
屬性名稱
手動更新資料型別的此屬性時，請注意名稱 必須 contain 僅限 A-Z、a-z、0-9和下劃線「_」作為特殊字元。
note caution CAUTION 如果在舊版AEM中建立的模型包含非法字元，請移除或更新這些字元。 -
呈現為
在片段中實現/轉譯欄位的各種選項。 通常，此屬性可讓您定義作者是否看到欄位的單一例項，或允許建立多個例項。 時間 多個欄位 用於定義專案的最小和最大數量 — 請參閱 驗證 以取得更多詳細資料。 -
欄位標籤
輸入 欄位標籤 將自動產生 屬性名稱，然後可視需要手動更新。 -
驗證
基本驗證可由以下機制提供 必填 屬性。 有些資料型別有額外的驗證欄位。 另請參閱 驗證 以取得更多詳細資料。 -
對於「多行」 資料類型 ，可將「預設類型 」定義為：
- RTF文字
- Markdown
- 純文字
若未指定，則預設值 RTF文字 用於此欄位。
在內容 片段模型中變更「預設類型 」，只會在編輯器中開啟並儲存該片段後，對現有、相關的內容片段生效。
-
獨特
從目前模型建立的所有內容片段內容（適用於特定欄位）必須是唯一的。這是為了確保內容作者無法重複已新增至相同模型其他片段中的內容。
例如， 單行文字 已呼叫的欄位
Country在內容片段模型中不能有Japan於兩個相依內容片段中。 嘗試第二個執行個體時會發出警告。note note NOTE 確保每個語言根的唯一性。 note note NOTE 變數可能具有相同的 獨特 值做為相同片段的變數，但與其他片段變數中使用的值不同。 note caution CAUTION 如果您想使用MSM （這會建立內容片段的復本），則任何 獨特 應從在各自內容片段模式中使用的任何資料型別中移除限制。 -
另請參閱 內容參考 以取得該特定資料型別及其屬性的詳細資訊。
-
另請參閱 片段參考（巢狀片段） 以取得該特定資料型別及其屬性的詳細資訊。
-
可翻譯
檢查 可翻譯 內容片段模型編輯器中的欄位上的核取方塊將：
- 確保欄位的屬性名稱已新增到翻譯設定、上下文
/content/dam/<sites-configuration>，如果尚未存在。 - 對於GraphQL：設定
<translatable>「 」內容片段欄位上的屬性yes，以允許GraphQL查詢篩選僅含有可翻譯內容的JSON輸出。
- 確保欄位的屬性名稱已新增到翻譯設定、上下文
驗證 validation
各種資料型別現在包含定義在結果片段中輸入內容時適用的驗證需求的可能性：
使用參照來形成巢狀內容 using-references-to-form-nested-content
內容片段可使用下列任一種資料型別來形成巢狀內容：
-
- 提供其他內容的簡單參照；任何型別。
- 可以為一個或多個參考（在產生的片段中）設定。
-
片段引用 （巢狀片段）
-
根據指定的特定模型，參考其他片段。
-
可讓您包含/擷取結構化資料。
note note NOTE 此方法與下列專案特別相關： 搭配GraphQL使用內容片段的Headless內容傳送. * 可以為一個或多個參考（在產生的片段中）設定。
-
-
內容參考這可防止使用者新增對目前片段的參考。 這可能會導致空的片段參考選擇器對話方塊。
-
GraphQL中的片段參考如果您建立深層查詢，並傳回彼此參照的多個內容片段，則第一次出現時將會傳回null。
內容參考 content-reference
內容參考可讓您轉譯來自其他來源的內容；例如，影像或內容片段。
除了標準屬性之外，您還可以指定：
-
此 根路徑 適用於任何參考內容
-
可參考的內容型別
-
檔案大小限制
-
如果參照影像：
- 顯示縮圖
- 影像高度和寬度的限制
片段參考（巢狀片段） fragment-reference-nested-fragments
「片段參考」會參考一或多個內容片段。 此功能在擷取應用程式中使用的內容時特別有意義，因為它可讓您擷取具有多個圖層的結構化資料。
例如：
- 定義員工詳細資訊的模型；這些包括：
- 定義僱主（公司）的模型參考
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
除了標準屬性之外，您還可以定義：
-
呈現為：
-
多欄位 — 片段作者可以建立多個個別參考
-
片段參考 — 允許片段作者選取片段的單一參照
-
-
模型型別
可選取多個模型。 製作內容片段時，必須使用這些模型建立任何參照的片段。 -
根路徑
這會指定所參考之任何片段的根路徑。 -
允許建立片段
如此可讓片段作者根據適當的模型建立片段。
- 片段參考複合 — 允許片段作者藉由選取多個片段來建置複合
內容片段模型 — 屬性 content-fragment-model-properties
您可以編輯 屬性 的內容片段模型：
-
基本
-
模型標題
-
標籤
-
說明
-
上傳影像
-
預設預覽URL模式
note note NOTE 這僅由 新 內容片段編輯器。 另請參閱 內容片段模型 以取得進一步資訊。
-
啟用或停用內容片段模型 enabling-disabling-a-content-fragment-model
為了完全控制內容片段模型的使用，它們有一個您可以設定的狀態。
啟用內容片段模型 enabling-a-content-fragment-model
建立模型時，必須啟用該模型，以便：
- 可在建立內容片段時選擇。
- 可在內容片段模型中參考。
- 可供GraphQL使用，因此會產生結構描述。
若要啟用被標示為下列其中一項的模型：
- 草稿 ：mew （從未啟用）。
- 已停用 ：已特別停用。
您使用 啟用 選項來自：
- 當選取所需的「模型」時，頂部工具列。
- 對應的「快速動作」(Quick Action) （將滑鼠移到所需模型上）。
停用內容片段模型 disabling-a-content-fragment-model
也可以停用模型，以便：
-
模型無法再用來作為建立基礎 新 內容片段。
-
但是：
- GraphQL結構描述會持續產生，且仍可查詢（以避免影響JSON API）。
- 您仍可以從GraphQL端點查詢及傳回任何以模型為基礎的內容片段。
-
該模型無法再參考，但現有參考將保持不變，並且仍可以從GraphQL端點查詢和返回。
若要停用標示為 已啟用 您使用 停用 選項來自：
- 當選取所需的「模型」時，頂部工具列。
- 對應的「快速動作」(Quick Action) （將滑鼠移到所需模型上）。
允許資產資料夾中的內容片段模型 allowing-content-fragment-models-assets-folder
若要實作內容控管，您可以設定 原則 ，以控制在該資料夾中允許建立片段的內容片段模型。
若要設定 原則 的 允許的內容片段模型：
-
導覽並開啟 屬性 ，作為所需的Assets資料夾。
-
開啟 原則 標籤，您可在其中設定：
-
繼承自
<folder>建立新的子資料夾時，會自動繼承原則；如果子資料夾需要允許與父資料夾不同的模型，則可以重新設定原則（並中斷繼承）。
-
允許的內容片段模型（依路徑）
可允許多個模型。
-
允許的內容片段模型（依標籤）
可允許多個模型。
-
-
儲存 任何變更。
允許用於資料夾的內容片段模型的解析如下：
- 此 原則 的 允許的內容片段模型.
- 如果空白，請嘗試使用繼承規則來決定原則。
- 如果繼承鏈沒有傳遞結果，請檢視 Cloud Service 該資料夾的設定（也請先直接設定，然後再透過繼承）。
- 如果以上所有內容均未提供任何結果，則該資料夾不允許使用模型。
刪除內容片段模型 deleting-a-content-fragment-model
若要刪除內容片段模型：
-
瀏覽至 工具， 一般，然後開啟 內容片段模型.
-
導覽至容納您的內容片段模式的資料夾。
-
選取您的模型，然後 刪除 工具列中的。
note note NOTE 如果參照模型，則會發出警告。 採取適當行動。
發佈內容片段模型 publishing-a-content-fragment-model
內容片段模型需要在任何相關內容片段發佈時/之前發佈。
若要發佈內容片段模型：
-
瀏覽至 工具， 一般，然後開啟 內容片段模型.
-
導覽至容納您的內容片段模式的資料夾。
-
選取您的模型，然後 發佈 工具列中的。
主控台會指出發佈狀態。note note NOTE 如果您發佈的內容片段尚未發佈模型，選擇清單會指出這一點，模型會與片段一起發佈。
取消發佈內容片段模型 unpublishing-a-content-fragment-model
如果內容片段模型未由任何片段引用，則可取消發佈這些模型。
若要取消發佈內容片段模型：
-
瀏覽至 工具， 一般，然後開啟 內容片段模型.
-
導覽至容納您的內容片段模式的資料夾。
-
選取您的模型，然後 取消發佈 工具列中的。
主控台會指出發佈狀態。
如果您嘗試取消發佈一個或多個片段目前使用的模型，則會出現錯誤警告，通知您：
訊息會建議您檢查 引用 面板以進一步調查：
鎖定的 (已發佈的) 內容片段模型 locked-published-content-fragment-models
此功能為已發佈的內容片段模型提供控管。
挑戰 the-challenge
-
內容片段模型決定AEM中GraphQL查詢的結構描述。
-
AEM GraphQL結構描述會在建立內容片段模型後立即建立，而且可存在於製作和發佈環境中。
-
發佈上的結構描述最為關鍵，因為它們為JSON格式的內容片段內容的即時傳送奠定了基礎。
-
-
修改內容片段模型或編輯內容片段模型時，可能會出現問題。 這表示結構描述變更，進而可能影響現有的GraphQL查詢。
-
將新欄位新增到內容片段模式通常不應有任何有害影響。 但是，修改現有資料欄位（例如，其名稱）或刪除欄位定義時，將會在請求這些欄位時中斷現有GraphQL查詢。
需求 the-requirements
-
讓使用者瞭解在編輯已用於即時內容傳送的模型（即已發佈的模型）時的風險。
-
此外，也可避免非預期的變更。
如果修改後的模型重新發佈，這兩種情況都可能中斷查詢。
解決方案 the-solution
為了解決這些問題，內容片段模型包括 已鎖定 在發佈後立即對作者設為唯讀模式。 這由以下指示 已鎖定：
當模型為 已鎖定 （在「唯讀」模式中），您可以檢視模型的內容和結構，但無法加以編輯。
您可以管理 已鎖定 從主控台或模型編輯器中的模型：
-
主控台
在主控台中，您可以使用來管理唯讀模式 解鎖 和 鎖定 工具列中的動作：
-
您可以 解鎖 啟用編輯的模型。
如果您選取 解鎖，則會顯示警告，您必須確認 解鎖 動作：
然後您可以開啟模型以進行編輯。
-
您也可以 鎖定 之後模型。
-
重新發佈模型會立即將其放回 已鎖定 （唯讀）模式。
-
-
模型編輯器
-
當您開啟已鎖定的模型時，會出現警告，並顯示三個動作： 取消， 以唯讀方式檢視， 編輯：
-
如果您選取 以唯讀方式檢視 您可以檢視模型的內容和結構：
-
如果您選取 編輯 您可以編輯並儲存更新：
note note NOTE 頂端可能仍會顯示警告，但此時模型已由現有內容片段使用。 -
取消 將帶您返回主控台。
-