AEM中的內容片段模型為您的定義了內容結構 內容片段, 做為Headless內容的基礎。
若要使用內容片段模式,您可以:
瀏覽至 工具, 一般,然後開啟 內容片段模型.
導覽至適合您的檔案夾 組態或子組態.
使用 建立 以開啟精靈。
如果尚未啟用使用內容片段模型,則建立選項將無法使用。
指定「模 型標題」。您也可以定義各種屬性;例如,新增 標籤, a 說明,並選取 啟用模型 至 啟用模型 如有需要。
有關詳細資訊 預設預覽URL模式 另請參閱 內容片段模型 — 屬性.
使用 建立 以儲存空白模型。 訊息會指出動作是否成功,您可以選取 開啟 立即編輯模型,或 完成 以返回主控台。
內容片段模式透過以下選項,有效地定義結果內容片段的結構 資料型別. 使用模型編輯器,您可以新增資料型別的例項,然後將其設定以建立必填欄位:
編輯現有的內容片段模型可能會影響相依片段。
瀏覽至 工具, 一般,然後開啟 內容片段模型.
導覽至容納您的內容片段模式的資料夾。
開啟所需的模型 編輯;使用快速動作或選取模型,然後從工具列選取動作。
開啟模型編輯器後,會顯示:
當欄位為 必填,則 標籤 左窗格中標示為星號(*)。
新增欄位
將欄位所需的資料型別拖曳到所需位置:
將欄位新增至模型後,右側面板會顯示 屬性 可針對該特定資料型別定義的屬性。 您可以在此處定義該欄位的必要條件。
許多屬性的含義一目瞭然,如需更多詳細資訊,請參閱 屬性.
輸入 欄位標籤 將會自動完成 屬性名稱 — 如果為空白,則可在之後手動更新。
手動更新屬性時 屬性名稱 對於資料型別,請注意,名稱必須僅包含A-Z、a-z、0-9和下劃線「_」作為特殊字元。
如果在舊版AEM中建立的模型包含非法字元,請移除或更新這些字元。
例如:
移除欄位
選取必填欄位,然後選取垃圾桶圖示。 系統會要求您確認動作。
新增所有必要欄位,並視需要定義相關屬性。 例如:
選取 儲存 以保留定義。
定義模型時可選用多種資料型別:
此資料型別僅用於格式設定,AEM GraphQL結構描述會忽略此資料型別。
許多屬性的含義一目瞭然,對於某些屬性,其他詳細資訊如下:
屬性名稱
手動更新資料型別的此屬性時,請注意名稱 必須 contain 僅限 A-Z、a-z、0-9和下劃線「_」作為特殊字元。
如果在舊版AEM中建立的模型包含非法字元,請移除或更新這些字元。
呈現為
在片段中實現/轉譯欄位的各種選項。 通常,此屬性可讓您定義作者是否看到欄位的單一例項,或允許建立多個例項。 時間 多個欄位 用於定義專案的最小和最大數量 — 請參閱 驗證 以取得更多詳細資料。
欄位標籤
輸入 欄位標籤 將自動產生 屬性名稱,然後可視需要手動更新。
驗證
基本驗證可由以下機制提供 必填 屬性。 有些資料型別有額外的驗證欄位。 另請參閱 驗證 以取得更多詳細資料。
對於「多行」 資料類型 ,可將「預設類型 」定義為:
若未指定,則預設值 RTF文字 用於此欄位。
在內容 片段模型中變更「預設類型 」,只會在編輯器中開啟並儲存該片段後,對現有、相關的內容片段生效。
獨特
從目前模型建立的所有內容片段內容(適用於特定欄位)必須是唯一的。
這是為了確保內容作者無法重複已新增至相同模型其他片段中的內容。
例如, 單行文字 已呼叫的欄位 Country
在內容片段模型中不能有 Japan
於兩個相依內容片段中。 嘗試第二個執行個體時會發出警告。
確保每個語言根的唯一性。
變數可能具有相同的 獨特 值做為相同片段的變數,但與其他片段變數中使用的值不同。
如果您想使用MSM (這會建立內容片段的復本),則任何 獨特 應從在各自內容片段模式中使用的任何資料型別中移除限制。
另請參閱 內容參考 以取得該特定資料型別及其屬性的詳細資訊。
另請參閱 片段參考(巢狀片段) 以取得該特定資料型別及其屬性的詳細資訊。
可翻譯
檢查 可翻譯 內容片段模型編輯器中的欄位上的核取方塊將:
/content/dam/<sites-configuration>
,如果尚未存在。<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。
您可以編輯 屬性 的內容片段模型:
模型標題
標記
說明
上傳影像
預設預覽 URL 模式
這僅由 新 內容片段編輯器。 另請參閱 內容片段模型 以取得進一步資訊。
為了完全控制內容片段模型的使用,它們有一個您可以設定的狀態。
建立模型時,必須啟用該模型,以便:
若要啟用被標示為下列其中一項的模型:
您使用 啟用 選項來自:
也可以停用模型,以便:
若要停用標示為 已啟用 您使用 停用 選項來自:
若要實作內容控管,您可以設定 原則 ,以控制在該資料夾中允許建立片段的內容片段模型。
其機制類似於 允許頁面範本 頁面及其子頁面(在頁面的進階屬性中)。
若要設定 原則 的 允許的內容片段模型:
導覽並開啟 屬性 ,作為所需的Assets資料夾。
開啟 原則 標籤,您可在其中設定:
繼承自<folder>
建立新的子資料夾時,會自動繼承原則;如果子資料夾需要允許與父資料夾不同的模型,則可以重新設定原則(並中斷繼承)。
允許的內容片段模型 (依路徑)
可允許多個模型。
允許的內容片段模型(依標籤)
可允許多個模型。
儲存 任何變更。
允許用於資料夾的內容片段模型的解析如下:
刪除內容片段模型可能會影響相依片段。
若要刪除內容片段模型:
瀏覽至 工具, 一般,然後開啟 內容片段模型.
導覽至容納您的內容片段模式的資料夾。
選取您的模型,然後 刪除 工具列中的。
如果參照模型,則會發出警告。 採取適當行動。
內容片段模型需要在任何相關內容片段發佈時/之前發佈。
若要發佈內容片段模型:
瀏覽至 工具, 一般,然後開啟 內容片段模型.
導覽至容納您的內容片段模式的資料夾。
選取您的模型,然後 發佈 工具列中的。
主控台會指出發佈狀態。
如果您發佈的內容片段尚未發佈模型,選擇清單會指出這一點,模型會與片段一起發佈。
如果內容片段模型未由任何片段引用,則可取消發佈這些模型。
若要取消發佈內容片段模型:
瀏覽至 工具, 一般,然後開啟 內容片段模型.
導覽至容納您的內容片段模式的資料夾。
選取您的模型,然後 取消發佈 工具列中的。
主控台會指出發佈狀態。
如果您嘗試取消發佈一個或多個片段目前使用的模型,則會出現錯誤警告,通知您:
訊息會建議您檢查 引用 面板以進一步調查:
此功能為已發佈的內容片段模型提供控管。
內容片段模型決定AEM中GraphQL查詢的結構描述。
AEM GraphQL結構描述會在建立內容片段模型後立即建立,而且可存在於製作和發佈環境中。
發佈上的結構描述最為關鍵,因為它們為JSON格式的內容片段內容的即時傳送奠定了基礎。
修改內容片段模型或編輯內容片段模型時,可能會出現問題。 這表示結構描述變更,進而可能影響現有的GraphQL查詢。
將新欄位新增到內容片段模式通常不應有任何有害影響。 但是,修改現有資料欄位(例如,其名稱)或刪除欄位定義時,將會在請求這些欄位時中斷現有GraphQL查詢。
讓使用者瞭解在編輯已用於即時內容傳送的模型(即已發佈的模型)時的風險。
此外,也可避免非預期的變更。
如果修改後的模型重新發佈,這兩種情況都可能中斷查詢。
為了解決這些問題,內容片段模型包括 已鎖定 在發佈後立即對作者設為唯讀模式。 這由以下指示 已鎖定:
當模型為 已鎖定 (在「唯讀」模式中),您可以檢視模型的內容和結構,但無法加以編輯。
您可以管理 已鎖定 從主控台或模型編輯器中的模型:
主控台
在主控台中,您可以使用來管理唯讀模式 解鎖 和 鎖定 工具列中的動作:
您可以 解鎖 啟用編輯的模型。
如果您選取 解鎖,則會顯示警告,您必須確認 解鎖 動作:
然後您可以開啟模型以進行編輯。
您也可以 鎖定 之後模型。
重新發佈模型會立即將其放回 已鎖定 (唯讀)模式。
模型編輯器
當您開啟已鎖定的模型時,會出現警告,並顯示三個動作: 取消, 以唯讀方式檢視, 編輯:
如果您選取 以唯讀方式檢視 您可以檢視模型的內容和結構:
如果您選取 編輯 您可以編輯並儲存更新:
頂端可能仍會顯示警告,但此時模型已由現有內容片段使用。
取消 將帶您返回主控台。