了解如何在 AEM 中建立內容片段模型 architect-headless-content-fragment-models

目前進度 story-so-far

AEM Headless 內容作者歷程的一開始,AEM Headless 內容模型基本知識介紹了和 Headless 內容製作相關的基本概念和術語。

此文章以這些原則為基礎,讓您了解如何為 AEM Headless 專案建立自己的內容片段模型。

目標 objective

  • 客群:初學者
  • 目標:使用內容片段模型為您的 Headless CMS 建立內容模型的概念和機制。

建立內容片段模型 creating-content-fragment-models

然後可以建立內容片段模型並定義其結構。

  1. 在內容片段主控台中,選擇內容片段模型面板。

  2. 根據您的設定或子設定導覽至適合的資料夾。

  3. 使用「建立」開啟「新內容片段模型」對話框。

    標題和說明

  4. 填寫詳細資訊

  5. 使用「建立」來儲存空模型,或選擇「建立並開啟」。

定義內容片段模型 defining-content-fragment-models

第一次開啟新模型時,您會看到 — 中間有一個大的(相當大的)空白區域,左側有​ 個資料型別 ​的長清單,右側有​個屬性 (一開始是空的,就像所選欄位一樣):

空白模型

那麼 -該怎麼做?

下列兩個動作您可以擇一執行:

  • 將資料型別從左側面板拖曳至中間面板中欄位的必要位置。
  • 依資料型別選取+圖示以將其新增至欄位清單底部。
  • 選取中間面板中的「新增」 ,然後從產生的下拉式清單中選取所需的資料型別,以在清單底部新增欄位。

您已在定義模型!

新增資料類型後,您需要為該欄位定義​屬性。所使用的類型會決定這些屬性。例如:

資料屬性

您的內容作者 your-content-authors

您的內容作者看不到您用於建立模型的實際資料類型和屬性。這表示您可能必須提供相關協助和資訊讓他們完成特定欄位。對於基本資訊,您可以使用欄位標籤和預設值,但可能需要考慮更複雜案例的專案特定文件。

NOTE
請參閱其他資源 - 內容片段模型。

管理內容片段模型 managing-content-fragment-models

管理您的內容片段模型涉及:

  • 啟用 (或停用) 它們 - 這使作者在建立內容片段時可以使用。
  • 刪除 - 總是需要刪除功能,但您必須注意不要刪除已經有內容片段在使用的模型,特別是已發佈的片段。

發佈 publishing

內容片段模型需要在任何相關內容片段發佈時/之前發佈。

NOTE
如果作者想要發佈的內容片段尚未發佈其模型,在這個情況下會出現選取清單,而模型會與片段一起發佈。

一旦模型發佈,就會被​ 鎖定 ​成作者的唯讀模式。這旨在防止可能導致現有 GraphQL 結構和查詢錯誤的變更,尤其是在發佈環境。它在主控台中顯示為​鎖定

當模型為​鎖定 (唯讀模式) 時,可以看到模型的內容和結構,但不能直接編輯;儘管您可以從主控台或模型編輯器管理​ 鎖定 ​模型。

後續步驟 whats-next

現在您已經了解了基本知識,下一步是開始建立您自己的內容片段模型。

其他資源 additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab