定義內容AEM結構中的內容片段模型 內容片段, 作為無頭內容的基礎。
要使用內容片段模型,請執行以下操作:
導航到 工具。 資產,然後開啟 內容片段模型。
導航到適合您的資料夾 配置。
使用 建立 的子菜單。
如果 未啟用內容片段模型的使用,也請參見Wiki頁。 建立 選項。
指定「模 型標題」。也可以添加 標籤的 說明,然後選擇 啟用模型 至 啟用模型 的子菜單。
使用 建立 的子菜單。 消息將指示操作成功,您可以選擇 開啟 以立即編輯模型,或 完成 返回控制台。
所述內容片段模型使用選擇有效地定義所得內容片段的結構 資料類型。 使用模型編輯器,可以添加資料類型的實例,然後配置它們以建立必填欄位:
編輯現有內容片段模型可能會影響相關片段。
導航到 工具。 資產,然後開啟 內容片段模型。
導航到保存內容片段模型的資料夾。
開啟所需的模型 編輯;使用快速操作,或從工具欄中選擇模型,然後選擇操作。
開啟模型編輯器後,將顯示:
當欄位為 必需,也請參見Wiki頁。 標籤 在左窗格中指示,將標有標注符(*)。
添加欄位
將所需資料類型拖到欄位的所需位置:
將欄位添加到模型後,右面板將顯示 屬性 可為該特定資料類型定義的。 在此,您可以定義該欄位的必需內容。
許多屬性不言自明,有關詳細資訊,請參閱 屬性。
鍵入 欄位標籤 將自動完成 屬性名稱 — 如果為空,則可以隨後手動更新。
手動更新屬性時 屬性名稱 對於資料類型,請注意名稱必須只包含拉丁文字元、數字和下划線「_」作為特殊字元。
如果在早期版本中建立的模AEM型包含非法字元,請刪除或更新這些字元。
例如:
刪除欄位
選擇必填欄位,然後按一下/點擊垃圾桶表徵圖。 系統將要求您確認操作。
根據需要添加所有必需欄位並定義相關屬性。 例如:
選擇 保存 來堅持定義。
選擇資料類型可用於定義模型:
允許在編輯內容片段內容時使用頁籤。
這將在模型編輯器中顯示為分隔符,分隔內容資料類型清單的各節。 每個實例表示新頁籤的開始。
在片段編輯器中,每個實例將顯示為一個頁籤。
此資料類型純粹用於格式設定,GraphQL架AEM構忽略它。
許多屬性不言自明,對於某些屬性,其他詳細資訊如下:
屬性名稱
手動更新資料類型的此屬性時,請注意名稱 必須 含 僅 拉丁文字元、數字和下划線"_"作為特殊字元。
如果在早期版本中建立的模AEM型包含非法字元,請刪除或更新這些字元。
呈現為
用於在片段中實現/呈現該欄位的各種選項。 這通常允許您定義作者是將看到該欄位的單個實例,還是允許建立多個實例。
欄位標籤
輸入
欄位標籤 將自動生成 屬性名稱,如果需要,可手動更新。
驗證
基本驗證可由以下機制提供: 必需 屬性。 某些資料類型具有附加驗證欄位。 請參閱 驗證 的上界。
對於「多行」 資料類型 ,可將「預設類型 」定義為:
如果未指定,則預設值 富文本 欄位。
在內容 片段模型中變更「預設類型 」,只會在編輯器中開啟並儲存該片段後,對現有、相關的內容片段生效。
唯一
內容(對於特定欄位)必須在從當前模型建立的所有內容片段中是唯一的。
這用於確保內容作者不能重複已添加到同一模型另一個片段中的內容。
例如, 單行文本 欄位 Country
內容片段模型中不能具有 Japan
的子目錄。 當嘗試第二個實例時將發出警告。
確保每個語言根的唯一性。
變體可以具有相同 獨特 值作為同一片段的變體,但與用於其它片段的任何變體的值不相同。
請參閱 內容引用 的子菜單。
請參閱 片段引用(嵌套片段) 的子菜單。
可翻譯
檢查 可翻譯 「內容片段模型」編輯器中某個欄位的複選框將:
/content/dam/<sites-configuration>
,也請參見Wiki頁。<translatable>
「內容片段」欄位上的屬性 yes
,允許僅具有可翻譯內容的JSON輸出的GraphQL查詢篩選器。各種資料類型現在都包括定義在結果片段中輸入內容的驗證要求的可能性:
內容片段可以使用下列資料類型之一形成嵌套內容:
片段引用 (嵌套片段)
參照其它片段,取決於指定的特定模型。
允許您包括/檢索結構化資料。
該方法與 使用GraphQL的內容片段進行無頭內容傳遞。
具AEM有以下項的重複保護:
內容參考資料
這防止用戶添加對當前片段的引用。 這可能導致「片段引用選取器」對話框為空。
GraphQL中的片段引用
如果建立一個深度查詢,該查詢返回彼此引用的多個內容片段,則它將在第一次出現時返回null。
「內容引用」允許您從另一個源中呈現內容;例如,影像或內容片段。
除了標準屬性外,您還可以指定:
片段引用引用一個或多個內容片段。 在檢索內容以供您的應用程式使用時,此功能特別受關注,因為它允許您檢索具有多層的結構化資料。
例如:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
除了標準屬性外,您還可以定義:
呈現為:
多場 — 片段作者可以建立多個、單個、引用
碎片 — 允許片段作者選擇對片段的單個引用
模型類型
可以選擇多個模型。 創作內容片段時,必須使用這些模型建立任何引用的片段。
根路徑
這為引用的任何片段指定根路徑。
允許建立片段
這將允許片段作者基於相應的模型建立新片段。
已建立重複保護機制。 它禁止用戶在片段引用中選擇當前內容片段。 這可能導致「片段引用選取器」對話框為空。
GraphQL中還對片段引用提供重複保護。 如果跨兩個相互引用的內容片段建立深度查詢,則它將返回空值。
可以編輯 屬性 內容片段模型:
要完全控制內容片段模型的使用,您可以設定這些模型的狀態。
建立模型後,需要啟用它,以便:
要啟用標籤為以下任一模型:
使用 啟用 選項:
還可以禁用模型,以便:
禁用標籤為 已啟用 使用 禁用 選項:
要實施內容治理,您可以配置 策略 在「資產」資料夾上,以控制允許在該資料夾中建立片段的內容片段模型。
該機制類似於 允許頁面模板 的子級。
配置 策略 為 允許的內容片段模型:
導航並開啟 屬性 的子菜單。
開啟 策略 頁籤,您可以在其中配置:
繼承自<folder>
建立新子資料夾時,策略會自動繼承;如果子資料夾需要允許不同於父資料夾的模型,則可以重新配置策略(並斷開繼承)。
允許的內容片段模型 (依路徑)
允許使用多個模型。
允許的內容片段模型(按標籤)
允許使用多個模型。
保存 任何更改。
資料夾允許的內容片段模型解析如下:
刪除內容片段模型可能會影響相關片段。
要刪除內容片段模型:
導航到 工具。 資產,然後開啟 內容片段模型。
導航到保存內容片段模型的資料夾。
選擇模型,然後 刪除 的子菜單。
如果參照了模型,則會給出警告。 採取適當行動。
在發佈任何相關內容片段時/之前,需要發佈內容片段模型。
要發佈內容片段模型,請執行以下操作:
導航到 工具。 資產,然後開啟 內容片段模型。
導航到保存內容片段模型的資料夾。
選擇模型,然後 發佈 的子菜單。
發佈狀態將在控制台中指示。
如果發佈模型尚未發佈的內容片段,則選擇清單將指示此情況,並且模型將隨片段一起發佈。
如果內容片段模型未被任何片段引用,則可以取消發佈這些模型。
取消發佈內容片段模型:
導航到 工具。 資產,然後開啟 內容片段模型。
導航到保存內容片段模型的資料夾。
選擇模型,然後 取消發佈 的子菜單。
發佈狀態將在控制台中指示。
如果嘗試取消發佈當前由一個或多個片段使用的模型,則會發出錯誤警告,通知您:
該消息建議您檢查 引用 小組進一步調查:
此功能為已發佈的內容片段模型提供了治理。
內容片段模型確定中的GraphQL查詢的架AEM構。
一AEM旦建立內容片段模型,就會建立GraphQL架構,並且它們可以同時存在於作者和發佈環境中。
發佈上的架構是最關鍵的,因為它們為以JSON格式即時傳送內容片段內容奠定了基礎。
修改內容片段模型或編輯內容片段模型時可能會出現問題。 這意味著模式更改,這反過來又可能影響現有GraphQL查詢。
將新欄位添加到內容片段模型中(通常)不會產生任何有害影響。 但是,修改現有資料欄位(例如,其名稱)或刪除欄位定義將在請求這些欄位時中斷現有的GraphQL查詢。
使用戶在編輯已用於即時內容交付的模型時瞭解風險(換句話說,就是已發佈的模型)。
同時,避免意外的變化。
如果修改的模型被重新發佈,則其中任何一個可能會中斷查詢。
要解決這些問題,內容片段模型包括 鎖定 在作者上進入只讀模式 — 一旦發佈即可。 這由 鎖定:
當模型為 鎖定 (在只讀模式下),可以查看模型的內容和結構,但無法編輯它們。
您可以管理 鎖定 控制台或模型編輯器中的模型:
主控台
在控制台中,可以使用 解鎖 和 鎖 工具欄中的操作:
你可以 解鎖 用於啟用編輯的模型。
如果選擇 解鎖 將顯示警告,您必須確認 解鎖 操作:
然後可開啟模型進行編輯。
您也可以 鎖 模型隨後。
重新發佈模型將立即將其重新 鎖定 (只讀)模式。
模型編輯器
開啟已鎖定的模型時,系統將發出警告,並顯示以下三個操作: 取消。 查看只讀。 編輯:
如果選擇 查看只讀 可以查看模型的內容和結構:
如果選擇 編輯 您可以編輯和保存更新:
頂部可能仍有警告,但此時模型已由現有內容片段使用。
取消 將返回控制台。