了解 AEM Headless 內容模型基本知識

到目前為止

在AEM Headless 內容架構師歷程一開始，簡介部分介紹了和建立無周邊內容模型相關的基本概念和術語。

本文以這些基本知識為基礎，以便您了解如何為您的 AEM 無周邊專案建立內容模型。

目標

  • 對象：初學者
  • 目標：介紹 Headless CMS 內容模型的概念。

使用內容片段模型建立內容模型

內容 (資料) 模型是一套既有的技術，通常在開發關聯式資料庫時使用，那麼內容模型對 AEM Headless 代表什麼？

原因為何？

為確保您的應用程式能夠始終一致、有效率地從 AEM 要求和接收所需內容，這些內容必須結構化。

這表示您的應用程式預先知道回應採用的格式，因此知道如何處理回應。這比接收自由格式的內容要容易得多，自由格式的內容必須剖析以確定它包含什麼以及如何使用它。

運作方式簡介

AEM 使用內容片段來提供將內容 Headless 傳遞到應用程式所需的結構。

您的內容模型結構：

  • 是由您的內容片段模型的定義實現，
  • 做為內容片段的基礎，內容片段用於產生內容。
注意

內容片段模型也做為 AEM GraphQL 結構描述的基礎，用於擷取您的內容 - 在開發人員歷旅中有更多相關資訊。

對內容的要求是使用 AEM GraphQL API 發出的，這是標準 GraphQL API 的自訂實作。AEM GraphQL API 允許應用程式對您的內容片段執行 (複雜) 查詢，每個查詢都根據特定的模型類型。

然後，您的應用程式可以使用傳回的內容。

使用內容片段模型建立架構

內容片段模型提供多種機制，允許您定義內容的結構。

內容片段模型描述一個實體。

注意

必須在設定瀏覽器中啟用內容片段功能，以便您可以建立新模型。

秘訣

應該命名模型，以便內容作者在建立內容片段時知道要選取哪個模型。

在模型中：

  1. 資料類型允許您定義個別屬性。
    例如，將包含教師姓名的欄位定義為文字 並將他們的服務年限定義為​數字。
  2. 資料類型​內容參考​和​片段參考​允許您在 AEM 中建立與其他內容的關係。
  3. 片段參考​資料類型允許您將內容片段巢狀化 (根據模型類型) 藉此實現多層結構。這對建立內容模型很重要。

例如：

使用內容片段建立內容模型

資料類型

AEM 提供以下資料類型用於建立內容模型：

  • 單行文字
  • 多行文字
  • 數字
  • 布林值
  • 日期和時間
  • 列舉
  • 標記
  • 內容參考
  • 片段參考
  • JSON 物件
注意

更多詳細資訊位於「內容片段模型 - 資料類型」。

參考和巢狀內容

兩種資料類型允許您參考特定片段之外的內容：

  • 內容參考
    這提供對任何類型之其他內容的簡單參考。
    例如，您可以參考在指定之位置的影像。

  • 片段參考
    這提供對其他內容片段的參考。
    此類型的參考用於建立巢狀內容，引入建立內容模型時所需的關係。
    可以設定此資料類型以允許片段作者：

    • 直接編輯參考的片段。
    • 根據適當的模型建立新的內容片段
注意

您也可以使用文字區塊內的連結建立臨時參考。

結構階層 (巢狀片段)

對於建立內容模型，片段參考​資料類型允許您建立多層結構和關係。

使用此參考，您可以​連接​各種內容片段模型來表示相互關係。這可讓無周邊應用程式依照連接操作，並視需要存取內容。

注意

這應該小心使用，最佳做法可以定義為​視需要進行巢狀，但層數盡可能少。

這就是片段參考的作用，允許您參考另一個片段。

例如，您可能定義了以下內容片段模型：

  • 城市
  • 公司
  • 人員
  • 獎項

看起來很簡單，但當然一家公司既有 CEO 又有員工…這些都是人，每一個都被定義為人員。

人員可以獲得一個獎項 (或兩個)。

  • 我的公司 - 公司
    • CEO - 人員
    • 員工 - 人員
      • 人員獎項 - 獎項

這只是供初學者了解。根據複雜程度，獎項可以是特定於公司的，或者公司可以在特定城市設有主要辦公室。

可以使用片段參考來表示這些相互關係，因為您 (架構師)、您的內容作者和無周邊應用程式都可理解。

下一步

現在您已經了解了基本知識，下一步是了解如何在 AEM 建立內容片段模型。這將介紹和討論各種可用的參考，以及如何使用片段參考建立結構階層，這是建立無周邊模型的關鍵部分。

其他資源

本頁內容