[AEM Sites]{class="badge positive" title="適用於AEM Sites)。"}

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

Adobe Experience Manager (AEM) as a Cloud Service中的內容片段模型定義內容片段的內容結構。 這些片段隨後可用於頁面製作,或用作Headless內容的基礎。

本頁涵蓋如何使用專用編輯器定義您的內容片段模式。 請參閱管理您的內容片段模式,瞭解建立片段後可用的進一步工作與選項,包括內容片段主控台可用的動作允許在資料夾上建立模式以及發佈模式

NOTE
使用您的內容片段模型和內容片段時,請留意最佳實務
CAUTION
如果要查詢多個引用的片段,則建議不要讓各種片段模式具有名稱相同,但型別不同的欄位名稱。
如需詳細資訊,請參閱搭配內容片段使用的AEM GraphQL API — 限制
NOTE
如果您使用此新編輯器建立模型,您應該一律將此編輯器用於該模型。
如果您接著使用原始模型編輯器開啟模型,您會看到訊息:
  • 「此模型已設定自訂UI結構描述。 此UI中顯示的欄位順序可能與UI結構描述不相符。 若要檢視與UI結構描述對齊的欄位,您必須切換到新的內容片段編輯器。」

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

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

CAUTION
編輯現有內容片段已使用的模型可能會影響這些相依片段。
  1. 在內容片段主控台中,選取內容片段模式的面板,並導覽至儲存您的內容片段模式的資料夾。

    note
    NOTE
    您也可以在建立模型後直接開啟模型。
  2. 開啟​ 編輯 ​所需的模型;使用其中一個快速動作連結,或選取模型,然後從工具列選取動作。

    屬性

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

    • 上:

      • 首頁​圖示
      • 原始與新編輯器之間切換的選項
      • 取消
      • 儲存
    • 左: 資料型別​可用於建立欄位

    • 中間:欄位已與​ 新增 ​選項一起定義

    • 右:使用最右側的圖示,您可在以下兩者之間選取:

      • 屬性:定義並檢視所選欄位的屬性
      • 模型詳細資料:顯示​ 已啟用 ​狀態、模型標題標籤描述​和​預覽URL
  3. 新增欄位

    • 可以:

      • 將資料型別從左側面板拖曳至中間面板中欄位的必要位置。
      • 依資料型別選取​ + ​圖示以將其新增至欄位清單底部。
      • 在中間面板中選取「新增」,然後從產生的下拉式清單中選取所需的資料型別,以在清單底部新增欄位。
      note
      NOTE
      索引標籤預留位置​欄位必須一律顯示在現有欄位上方。
    • 您可以使用欄位方塊左側的點狀結構來重新定位欄位:

      移動欄位

    • 將欄位新增至模型(且已選取)後,右側面板會顯示可針對該特定資料型別定義的​屬性。 您可以在此處定義特定的
      欄位。

      • 許多屬性不言自明,如需詳細資訊,請參閱屬性(資料型別)

      • 輸入​ 欄位標籤 ​會自動完成​屬性名稱 (如果空白),之後可以手動更新。

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

      例如:

      欄位屬性

      note
      NOTE
      當欄位定義為​ 必要 ​時,中間窗格中標示的​ 標籤 ​會標示為字元(*)。
  4. 移除欄位

    選取中間面板中適當欄位的垃圾桶圖示。

    移除

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

  6. 選取​ 儲存 ​以保留定義。

資料類型 data-types

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

  • 單行文字

    • 為單行文字新增欄位;可以定義最大長度
    • 欄位可設定為允許片段作者建立欄位的新執行個體
  • 多行文字

    • 可能是RTF、純文字或Markdown的文字區域
    • 欄位可設定為允許片段作者建立欄位的新執行個體
    note
    NOTE
    文字區域是否為RTF、純文字或Markdown,是由屬性​ 預設型別 ​在模型中定義。
    此格式無法從內容片段編輯器變更,只能從模型變更。
  • 數字

    • 新增數值欄位
    • 欄位可設定為允許片段作者建立欄位的新執行個體
  • 布林值

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

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

    • 新增一組核取方塊、選項按鈕或下拉式清單欄位
      • 您可以指定片段作者可用的選項
  • 標籤

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

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

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

      • 直接編輯參考的片段。
      • 根據適當的模式建立新的內容片段
      • 建立欄位的新執行個體
    • 參考指定參考資源的路徑;例如/content/dam/path/to/resource

    note
    NOTE
    AEM針對下列專案提供週期性保護:
    • 內容參考> 這可防止使用者新增對目前片段的參考,並可能導致空白的片段參考選擇器對話方塊。

    • GraphQL> 中的片段參考如果您建立深層查詢,並傳回彼此參照的多個內容片段,第一次出現時就會傳回null。

    note caution
    CAUTION
    如果要查詢多個引用的片段,則建議不要讓各種片段模式具有名稱相同,但型別不同的欄位名稱。
    如需詳細資訊,請參閱搭配內容片段使用的AEM GraphQL API — 限制

    內容參考 content-reference

    內容參考​資料型別可讓您轉譯來自其他來源的內容;例如,影像、頁面或體驗片段。

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

    • 根路徑,指定或代表要儲存任何參考內容的位置

      note
      NOTE
      如果您想在使用內容片段編輯器時直接在此欄位上傳和參考影像,則必須使用此選項。
      如需詳細資訊,請參閱參考影像
    • 可參考的內容型別

      note
      NOTE
      如果您想要在使用內容片段編輯器時直接上傳和參考此欄位中的影像,這些必須包含​影像
      如需詳細資訊,請參閱參考影像
    • 檔案大小限制

    • 如果參照影像:

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

    內容參考

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

    片段參考​資料型別可以參考一或多個內容片段。 此功能可讓您擷取多個圖層的結構化資料,在擷取應用程式中使用的內容時特別感興趣。

    例如:

    • 定義員工詳細資訊的模型;包括:
      • 定義僱主(公司)的模型參考
    code language-xml
    type EmployeeModel {
        name: String
        firstName: String
        company: CompanyModel
    }
    
    type CompanyModel {
        name: String
        street: String
        city: String
    }
    
    note
    NOTE
    片段參考對搭配GraphQL🔗使用內容片段的Headless內容傳遞特別感興趣。

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

    • 呈現為

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

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

    • 模型型別
      可選取多個模型。 將參照新增至內容片段時,任何參照的片段都必須使用這些模型建立。

    • 根路徑
      這會指定或表示任何參考片段的根路徑。

    • 允許建立片段

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

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

      片段參考

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