定義內容片段模型

本章說明如何建立內容模型,並使用​內容片段模型​建立架構。 將審閱現有模型並建立新模型。 您也將了解可用來定義模型中結構的不同資料類型。

在本章中,您將為​貢獻者​建立新模型,這是那些將雜誌和冒險內容作為WKND品牌一部分的用戶的資料模型。

必備條件

本教學課程分為多部分,假設已完成快速設定中概述的步驟。

目標

  • 建立新的內容片段模型。
  • 識別可用的資料類型和建立模型的驗證選項。
  • 了解內容片段模型如何定義內容片段的資料架構和製作範本​兩者

內容片段模型概觀

上述影片提供使用內容片段模型的概觀。

注意

以上影片顯示以Contributors名稱建立​貢獻者​模型的過程。 在您自己的環境中執行步驟時,請確定標題使用單一形式:Contributor,不含​s。 內容片段模型的命名會驅動GraphQL API呼叫,此呼叫將在稍後的教學課程中執行。

Inspect冒險內容片段模型

在前一章中,數個歷險內容片段經過編輯,並顯示在外部應用程式上。 讓我們檢查探險內容片段模型,了解這些片段的基礎資料結構。

  1. 從​AEM開始​功能表導覽至​工具 > 資產 > 內容片段模型

    導覽至內容片段模型

  2. 導覽至​WKND Site​資料夾,並暫留在​Adventure​內容片段模型上,然後按一下​Edit​圖示(鉛筆)以開啟模型。

    開啟冒險內容片段模型

  3. 這會開啟​內容片段模型編輯器。 請注意,定義「探險」模型的欄位包含不同的​資料類型,例如​單行文字多行文字枚舉​和​內容參考

  4. 編輯器的右側欄列出可用的​資料類型,定義用於編寫內容片段的表單欄位。

  5. 在主面板中選擇​Title​欄位。 在右側欄中,按一下「屬性 」標籤:

    冒險標題屬性

    觀察​屬性名稱​欄位已設為adventureTitle。 這會定義持續存在AEM的屬性名稱。 屬性名稱​還將此屬性的​​名稱定義為資料架構的一部分。 透過GraphQL API公開內容片段資料時,將會使用此​索引鍵

    注意

    從模型衍生出內容片段後,修改欄位​​屬性名稱​具有下游效果。​現有片段中的欄位值將不再被參考,GraphQL公開的資料架構將會變更,影響現有應用程式。

  6. 向下捲動​Properties​標籤,並檢視​Validation Type​下拉式清單。

    可用驗證選項

    可用於​電子郵件​和​URL​的現成表單驗證。 您也可以使用規則運算式來定義​Custom​驗證。

  7. 按一下「取消」以關閉「內容片段模型編輯器」。

建立貢獻者模型

接下來,為​貢獻者​建立新模型,這是那些將雜誌和冒險內容作為WKND品牌一部分的用戶的資料模型。

  1. 按一下右上角的​建立​以開啟​建立模型​精靈。

  2. 對於​模型標題,請輸入:貢獻者​並按一下​建立

    內容片段模型精靈

    按一下​開啟​以開啟新建立的模型。

  3. 將​單行文字​元素拖放至主面板。 在​Properties​標籤上輸入以下屬性:

    • 欄位標籤: 完整名稱
    • 屬性名稱: fullName
    • 檢查​必要

    「全名」屬性欄位

  4. 按一下​資料類型​標籤,並將​多行文本​欄位拖放到​全名​欄位下。 輸入以下屬性:

    • 欄位標籤: 傳記
    • 屬性名稱: biographyText
    • 預設類型: RTF
  5. 按一下​資料類型​標籤,並拖放​內容參考​欄位。 輸入以下屬性:

    • 欄位標籤: 圖片參考
    • 屬性名稱: pictureReference
    • 根路徑: /content/dam/wknd

    設定​根路徑​時,您可以按一下​資料夾​圖示,以開啟模組來選取路徑。 這將限製作者可用來填入路徑的資料夾。

    根路徑已配置

  6. 將驗證新增至​圖片參考,以便只能使用​影像​的內容類型來填入欄位。

    限制為影像

  7. 按一下​資料類型​標籤,並將​枚舉​資料類型拖放到​圖片引用​欄位下。 輸入以下屬性:

    • 欄位標籤: 職業
    • 屬性名稱: occupation
  8. 使用​新增選項​按鈕,新增數個​選項。 對​選項標籤​和​選項值​使用相同的值:

    藝術家影響者攝影師旅行者作家YouTube

    佔用期權值

  9. 最終的​貢獻者​模型應如下所示:

    最終貢獻者模型

  10. 按一下​儲存​以儲存變更。

啟用貢獻者模型

內容片段模型必須為​啟用,內容作者才能使用它。 您可以​停用​內容片段模型,因此禁止作者使用。 回想一下,修改模型中欄位的​屬性名稱​會更改基礎資料架構,並可能對現有片段和外部應用程式產生顯著的下游影響。 建議您先謹慎規劃用於欄位​屬性名稱​的命名慣例,再為使用者啟用內容片段模型。

  1. 確保​貢獻者​模型目前處於​啟用​狀態。

    啟用貢獻者模型

    將滑鼠指標暫留在卡片上,按一下​Disable / Enable​圖示,即可切換內容片段模型的狀態。

恭喜!

恭喜,您剛建立了第一個內容片段模型!

後續步驟

在下一章製作內容片段模型中,您將根據內容片段模型建立和編輯新的內容片段。 您也會學習如何建立內容片段的變體。

本頁內容