內容片段模型 content-fragment-models

AEM中的內容片段模型為您的定義了內容結構 內容片段, 做為Headless內容的基礎。

若要使用內容片段模型,您可以:

  1. 為您的執行個體啟用內容片段模型功能.
  2. 建立、和 設定,您的內容片段模型。
  3. 啟用您的內容片段模型 以便在建立內容片段時使用。
  4. 在所需的Assets資料夾上允許您的內容片段模型 透過設定 原則.

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

  1. 瀏覽至 工具資產,然後開啟 內容片段模型.

  2. 導覽至適合您的檔案夾 設定.

  3. 使用 建立 以開啟精靈。

    note caution
    CAUTION
    如果 未啟用內容片段模型,則 建立 選項無法使用。
  4. 指定「模 型標題」。您也可以新增 標籤, a 說明,並選取 啟用模型啟用模型 如有需要。

    標題和說明

  5. 使用 建立 以儲存空白模型。 訊息會指出動作是否成功,您可以選取 開啟 立即編輯模型,或 完成 以返回主控台。

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

內容片段模式透過以下選項,有效地定義結果內容片段的結構 資料型別. 使用模型編輯器,您可以新增資料型別的例項,然後將其設定以建立必填欄位:

CAUTION
編輯現有的內容片段模型可能會影響相依片段。
  1. 瀏覽至 工具資產,然後開啟 內容片段模型.

  2. 導覽至容納您的內容片段模式的資料夾。

  3. 開啟所需的模型 編輯;使用快速動作或選取模型,然後從工具列選取動作。

    開啟模型編輯器後,會顯示:

    • 左:欄位已定義
    • 右:資 料類型 ,可用於建立欄位( 和屬性 ,以供建立欄位後使用)
    note note
    NOTE
    當欄位為 必填,則 標籤 左窗格中標示為星號(*)。

    屬性

  4. 新增欄位

    • 將欄位所需的資料型別拖曳到所需位置:

      資料型別至欄位

    • 將欄位新增到模型後,右側面板會顯示 屬性 可針對該特定資料型別定義的屬性。 您可以在此處定義該欄位的必要條件。

      • 許多屬性的含義一目瞭然,如需更多詳細資訊,請參閱 屬性.

      • 輸入 欄位標籤 自動完成 屬性名稱 — 如果為空白,則可在之後手動更新。

        note caution
        CAUTION
        手動更新屬性時 屬性名稱 對於資料型別,名稱必須僅包含A-Z、a-z、0-9以及底線「_」作為特殊字元。
        如果在舊版AEM中建立的模型包含非法字元,請移除或更新這些字元。

      例如:

      欄位屬性

  5. 移除欄位

    選取必填欄位,然後按一下垃圾桶圖示。 系統會要求您確認動作。

    移除

  6. 新增所有必要欄位,並視需要定義相關屬性。 例如:

    儲存

  7. 選取 儲存 以保留定義。

資料類型 data-types

定義模型時可選用多種資料型別:

  • 單行文字

    • 新增一行或多行文字的欄位;可以定義最大長度
  • 多行文字

    • 可能是RTF、純文字或Markdown的文字區域
  • 數字

    • 新增一或多個數值欄位
  • 布林值

    • 新增布林值核取方塊
  • 日期和時間

    • 新增日期和/或時間
  • 分項清單

    • 新增一組核取方塊、選項按鈕或下拉式欄位
  • 標籤

    • 允許片段作者存取及選取標籤區域
  • 內容參考

    • 參考任何型別的其他內容;可用於 建立巢狀內容
    • 如果參照了影像,您可以選擇顯示縮圖
  • 片段引用

    • 參考其他內容片段;可用於 建立巢狀內容

    • 可以設定此資料類型以允許片段作者:

      • 直接編輯參考的片段。
      • 根據適當的模型建立內容片段
  • json物件

    • 允許內容片段作者在片段的對應元素中輸入JSON語法。

      • 允許AEM儲存您從其他服務複製並貼上的直接JSON。
      • JSON會傳遞,並在GraphQL中輸出為JSON。
      • 在內容片段編輯器中包括JSON語法醒目提示、自動完成和錯誤醒目提示。
  • 索引標籤預留位置

    • 允許引進索引標籤,以在編輯內容片段內容時使用。
      這會在模型編輯器中顯示為分隔線,用於分隔內容資料型別清單的各個區段。 每個例項代表新索引標籤的開始。
      在片段編輯器中,每個例項都會顯示為一個索引標籤。

      note note
      NOTE
      此資料型別僅用於格式設定,AEM GraphQL結構描述會忽略此資料型別。

屬性 properties

許多屬性的含義一目瞭然,對於某些屬性,其他詳細資訊如下:

  • 屬性名稱

    手動更新資料型別的此屬性時,名稱 必須 contain 僅限 A-Z、a-z、0-9和底線「_」當作特殊字元。

    note caution
    CAUTION
    如果在舊版AEM中建立的模型包含非法字元,請移除或更新這些字元。
  • 呈現為
    在片段中實現/轉譯欄位的各種選項。 這通常可讓您定義作者會看到欄位的單一例項,還是允許建立多個例項。

  • 欄位標籤
    輸入 欄位標籤 自動產生 屬性名稱,然後可視需要手動更新。

  • 驗證
    基本驗證可由以下機制提供 必填 屬性。 有些資料型別有額外的驗證欄位。 另請參閱 驗證 以取得更多詳細資料。

  • 對於「多行」 資料類型 ,可將「預設類型 ​」定義為:

    • RTF文字
    • Markdown
    • 純文字

    若未指定,則預設值 RTF文字 用於此欄位。

    變更 預設型別 在內容片段模型中,只有在編輯器中開啟並儲存該片段後,該片段才會對現有、相關的內容片段生效。

  • 獨特
    從目前模型建立的所有內容片段內容(適用於特定欄位)必須是唯一的。

    這是為了確保內容作者無法重複已新增至相同模型其他片段中的內容。

    例如, 單行文字 已呼叫的欄位 Country 在內容片段模型中不能有 Japan 於兩個相依內容片段中。 嘗試第二個執行個體時會發出警告。

    note note
    NOTE
    確保每個語言根的唯一性。
    note note
    NOTE
    變數可能具有相同的 獨特 值做為相同片段的變數,但與其他片段變數中使用的值不同。
  • 另請參閱 內容參考 以取得該特定資料型別及其屬性的詳細資訊。

  • 另請參閱 片段參考(巢狀片段) 以取得該特定資料型別及其屬性的詳細資訊。

驗證 validation

各種資料型別現在包含定義在結果片段中輸入內容時適用的驗證需求的可能性:

  • 單行文字

    • 與預先定義的規則運算式比較。
  • 數字

    • 檢查特定值。
  • 內容參考

    • 測試特定型別的內容。
    • 只能參考指定檔案大小或更小的資產。
    • 只能參考預先定義的寬度和/或高度範圍(以畫素為單位)內的影像。
  • 片段引用

    • 測試特定內容片段模型。

使用參照來形成巢狀內容 using-references-to-form-nested-content

內容片段可使用下列任一種資料型別來形成巢狀內容:

  • 內容參考

    • 提供其他內容的簡單參照;任何型別。
    • 它可以設定為一個參考或多個參考(在產生的片段中)。
  • 片段引用 (巢狀片段)

NOTE
AEM對下列專案具有週期性保護:
  • 內容參考
    這可防止使用者新增對目前片段的引用。 這可能會導致空的片段參考選擇器對話方塊。

  • GraphQL中的片段參考
    如果您建立深層查詢,且該查詢傳回多個互相參照的內容片段,則該查詢在第一次出現時會傳回null。

內容參考 content-reference

內容參考可讓您轉譯來自其他來源的內容;例如,影像或內容片段。

除了標準屬性之外,您還可以指定:

  • 根路徑 適用於任何參考內容

  • 可參考的內容型別

  • 檔案大小限制

  • 如果參照影像:

    • 顯示縮圖
    • 影像高度和寬度的限制

內容參考

片段參考(巢狀片段) fragment-reference-nested-fragments

「片段參考」會參考一或多個內容片段。 此功能在擷取用於應用程式的內容時特別有意義,因為它可讓您擷取具有多個圖層的結構化資料。

例如:

  • 定義員工詳細資訊的模型;這些包括:
    • 定義僱主(公司)的模型參考
type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}
NOTE
以下內容對此特別感興趣: 搭配GraphQL使用內容片段的Headless內容傳送.

除了標準屬性之外,您還可以定義:

  • 呈現為

    • 多欄位 — 片段作者可以建立多個個別參考

    • 片段參考 — 允許片段作者選取片段的單一參照

  • 模型型別
    可選取多個模型。 製作內容片段時,必須已使用這些模型建立任何參照的片段。

  • 根路徑
    這會指定所參考之任何片段的根路徑。

  • 允許建立片段

    如此可讓片段作者根據適當的模型建立片段。

    • 片段參考複合 — 允許片段作者藉由選取多個片段來建置複合

    片段引用

NOTE
已建立重複保護機制。 它禁止使用者在片段參考中選取目前的內容片段。 這可能會導致空的片段參考選擇器對話方塊。
GraphQL中也有片段參考的週期性保護。 如果您在兩個互相參照的內容片段間建立深層查詢,則會傳回null。

啟用或停用內容片段模型 enabling-disabling-a-content-fragment-model

為了完全控制內容片段模型的使用,您可以設定其狀態。

啟用內容片段模型 enabling-a-content-fragment-model

建立模型後,必須將其啟用,以便:

  • 可在建立內容片段時選擇。
  • 可在內容片段模型中參照。
  • 它可供GraphQL使用;因此會產生結構。

若要啟用被標示為下列其中一項的模型:

  • 草稿 :mew (從未啟用)。
  • 已停用 :已停用。

您可以使用 啟用 選項來自:

  • 當選取所需的「模型」時,頂部工具列。
  • 對應的「快速動作」(Quick Action) (將滑鼠移到所需模型上)。

啟用草稿或已停用的模型

停用內容片段模型 disabling-a-content-fragment-model

也可以停用模型,以便:

  • 模型無法再用來作為建立基礎 內容片段。

  • 但是:

    • GraphQL結構描述會持續產生,且仍可查詢(以避免影響JSON API)。
    • 您仍可以從GraphQL端點查詢及傳回任何以模型為基礎的內容片段。
  • 該模型無法再參考,但現有參考將保持不變,並且仍可以從GraphQL端點查詢和返回。

若要停用標示為 已啟用,您會使用 停用 選項來自:

  • 當選取所需的「模型」時,頂部工具列。
  • 對應的「快速動作」(Quick Action) (將滑鼠移到所需模型上)。

停用啟用的模型

允許資產資料夾中的內容片段模型 allowing-content-fragment-models-assets-folder

若要實作內容控管,您可以設定 原則 ,以控制在該資料夾中允許建立片段的內容片段模型。

NOTE
其機制類似於 允許頁面範本 頁面及其子頁面(在頁面的進階屬性中)。

若要設定 原則允許的內容片段模型

  1. 導覽並開啟 屬性 ,作為所需的Assets資料夾。

  2. 開啟 原則 標籤,您可在其中設定:

    • 繼承自<folder>

      建立子資料夾時,會自動繼承原則;如果子資料夾需要允許與父資料夾不同的模型,則可以重新設定原則(並中斷繼承)。

    • 允許的內容片段模型(依路徑)

      可允許多個模型。

    • 允許的內容片段模型(依標籤)

      可允許多個模型。

    內容片段模型原則

  3. 儲存 任何變更。

允許用於資料夾的內容片段模型的解析如下:

  • 原則允許的內容片段模型.
  • 如果空白,請嘗試使用繼承規則來決定原則。
  • 如果繼承鏈沒有傳遞結果,請檢視 Cloud Service 該資料夾的設定(也請先直接設定,然後再透過繼承)。
  • 如果以上所有內容均未提供任何結果,則該資料夾不允許使用模型。

刪除內容片段模型 deleting-a-content-fragment-model

CAUTION
刪除內容片段模型可能會影響相依片段。

若要刪除內容片段模型:

  1. 瀏覽至 工具資產,然後開啟 內容片段模型.

  2. 導覽至容納您的內容片段模式的資料夾。

  3. 選取您的模型,然後 刪除 工具列中的。

    note note
    NOTE
    如果參照模型,則會發出警告。 採取適當的動作。

發佈內容片段模型 publishing-a-content-fragment-model

發佈任何相依內容片段時/之前,必須發佈內容片段模型。

若要發佈內容片段模型:

  1. 瀏覽至 工具資產,然後開啟 內容片段模型.

  2. 導覽至容納您的內容片段模式的資料夾。

  3. 選取您的模型,然後 發佈 工具列中的。
    主控台會指出發佈狀態。

    note note
    NOTE
    如果您發佈的內容片段尚未發佈模型,選擇清單會指出這一點,模型會與片段一起發佈。

取消發佈內容片段模型 unpublishing-a-content-fragment-model

如果內容片段模型未由任何片段引用,則可取消發佈這些模型。

若要取消發佈內容片段模型:

  1. 瀏覽至 工具資產,然後開啟 內容片段模型.

  2. 導覽至容納您的內容片段模式的資料夾。

  3. 選取您的模型,然後 取消發佈 工具列中的。
    主控台會指出發佈狀態。

內容片段模型 — 屬性 content-fragment-model-properties

您可以編輯 屬性 的內容片段模型:

  • 基本

    • 模型標題
    • 標籤
    • 說明
    • 上傳影像
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2