內容片段模型

注意

AEM GraphQL API(針對內容片段傳送)將於2021年初發行。

相關檔案已可供預覽使用。

內容片段模型定義內容片段的內容結構。

若要使用內容片段模型,請:

  1. 為您的例項啟用內容片段模型功能
  2. 建立,並設 定內容片段模型
  3. 啟用您的內容片段 模型,以便在建立內容片段時使用

建立內容片段模型

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

  2. 導覽至適合您configuration的資料夾。

  3. 使用​Create​開啟嚮導。

    注意

    如果未啟用內容片段模型的使用,則​Create​選項將不可用。

  4. 指定「模 型標題」。您也可以視需要新增​Tags​和​Description

    標題和說明

  5. 使用​Create​來儲存空的模型。 一條消息將指示操作成功,您可以選擇​Open​立即編輯模型,或選擇​Done​返回控制台。

定義內容片段模型

所述內容片段模型使用選擇​資料類型​有效地定義所生成的內容片段的結構。 使用模型編輯器,您可以新增資料類型的例項,然後設定它們以建立必要欄位:

注意

編輯現有的內容片段模型可能會影響相依片段。

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

  2. 導覽至包含內容片段模型的檔案夾。

  3. 開啟​Edit​所需的型號;使用快速動作,或從工具列中選取模型和動作。

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

    • 左:欄位已定義
    • 右:資 料類型 ,可用於建立欄位( 和屬性 ,以供建立欄位後使用)
    注意

    當欄位為「必 」時,左側窗格中指出的「標籤 」將會標示為字元( *)。

  4. 要添加欄位

    • 將必要的資料類型拖曳至欄位的必要位置。

    • 將欄位添加到模型後,右側面板將顯示可為該特定資料類型定義的​屬性。 您可以在這裡定義該欄位的必要項目。
      許多屬性都不言而喻,如需詳細資訊,請參閱Properties

  5. 刪除欄位

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

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

  7. 選擇​保存​以保存定義。

資料類型

可以選擇資料類型來定義模型:

  • 單行文字
    • 在一行文字中新增一或多個欄位;最大長度可以定義
  • 多行文字
    • 文字區域可以是Rich Text、Plain Text或Markdown
  • 數量
    • 添加一個或多個數字欄位
  • 布林值 (Boolean)
    • 新增布林核取方塊
  • 日期時間
    • 新增日期和/或時間
  • 列舉
    • 新增一組核取方塊、選項按鈕或下拉式欄位
  • 標記
    • 允許片段作者存取和選取標籤區域
  • 內容參考資料

屬性

許多屬性都不言自明,對於某些屬性,其他詳細資訊如下:

  • 演算
    方式用於實現/演算片段中欄位的各種選項。這通常可讓您定義作者將看到欄位的單一執行個體,或允許建立多個執行個體。

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

  • ValidationBasic
    驗證可由Required屬性等機 ​制使用。有些資料類型有附加驗證欄位。 如需詳細資訊,請參閱Validation

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

    • RTF
    • Markdown
    • 純文字

    如果未指定,則此欄位將使用預設值​Rich Text

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

驗證

現在,各種資料類型都可能定義驗證需求,以便在產生的片段中輸入內容:

  • 單行文字
    • 比較預先定義的規則運算式。
  • 數量
    • 檢查特定值。

啟用或停用內容片段模型

若要完全控制內容片段模型的使用,他們可以設定狀態。

啟用內容片段模型

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

  • 可供在建立新的內容片段時選取。
  • 可從內容片段模型中參考。
  • 適用於GraphQL;因此,將生成模式。

若要啟用標幟為下列任一項的模型:

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

您可以使用​Enable​選項,其中一個選項為:

  • 當選取了所需的「模型」(Model)時,頂部工具欄。
  • 相應的快速操作(將滑鼠移到所需的模型上)。

啟用繪製或禁用的模型

禁用內容片段模型

也可以禁用模型,以便:

  • 此模型不再做為建立​new​內容片段的基礎。
  • 但是:
    • GraphQL架構會持續產生且仍可查詢(以避免影響JSON API)。
    • 任何基於模型的內容片段仍可從GraphQL端點查詢和返回。
  • 模型不能再被引用,但現有參照保持不變,仍可查詢並從GraphQL端點返回。

要禁用標籤為​Enabled​的模型,請使用​Disable​選項,其中一個選項為:

  • 當選取了所需的「模型」(Model)時,頂部工具欄。
  • 相應的快速操作(將滑鼠移到所需的模型上)。

禁用啟用的模型

刪除內容片段模型

注意

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

要刪除內容片段模型:

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

  2. 導覽至包含內容片段模型的檔案夾。

  3. 從工具欄中選擇型號,然後選擇​Delete

    注意

    如果模型被參照,則會發出警告。 採取適當行動。

發佈內容片段模型

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

若要發佈內容片段模型:

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

  2. 導覽至包含內容片段模型的檔案夾。

  3. 從工具列中選擇您的型號,然後按​Publish
    發佈狀態將在控制台中指示。

    注意

    如果您發佈模型尚未發佈的內容片段,則選擇清單會指出此點,而模型將會隨片段一起發佈。

取消發佈內容片段模型

如果內容片段模型未被任何片段參照,則可以解除發佈這些模型。

若要解除發佈內容片段模型:

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

  2. 導覽至包含內容片段模型的檔案夾。

  3. 從工具列中選取您的模型,然後按​Unpublish
    發佈狀態將在控制台中指示。

本頁內容