了解如何在 AEM 中创建内容片段模型 architect-headless-content-fragment-models

迄今为止的故事 story-so-far

AEM Headless 内容作者历程的开头,使用 AEM 对 Headless 进行内容建模的基础知识涵盖了与针对 Headless 进行创作相关的基本概念和术语。

本文基于这些原则编写,以便您了解如何为 AEM Headless 项目创建您自己的内容片段模型。

目标 objective

  • 受众:初学者
  • 目标:使用内容片段模型对 Headless CMS 进行内容建模的概念和机制。

创建内容片段模型 creating-content-fragment-models

之后,可以创建内容片段模型并定义结构。

  1. 在内容片段控制台中,选择内容片段模型面板。

  2. 导航到适合您的配置或子配置的文件夹。

  3. 使用​创建,打开​ 新内容片段模型 ​对话框。

    标题和描述

  4. 填写详细信息

  5. 使用​ 创建 ​保存空模型,或者​创建并打开

定义内容片段模型 defining-content-fragment-models

首次打开新模型时,您会看到 — 中间有一大块(相当大的)空白,左侧有一长串​数据类型,右侧有一长串​属性(开始处是空的,与选定字段的属性相同):

空白模型

那么——该如何操作?

您可以:

  • 将数据类型从左侧面板拖到中间面板中字段的所需位置。
  • 按数据类型选择+图标以将其添加到字段列表的底部。
  • 选择中间面板中的“添加”,然后从结果下拉列表中选择所需的数据类型,以在列表底部添加字段。

您已在定义模型!

在添加数据类型后,您需要为该字段定义​ 属性。 ​这些属性都取决于将使用的类型。例如:

数据属性

您的内容作者 your-content-authors

您的内容作者看不到您用于创建模型的实际数据类型和属性。这意味着您可能需要提供有关他们如何填写特定字段的帮助和信息。对于基本信息,您可以使用字段标签和默认值,但在更复杂的情况下,可能需要考虑项目特定的文档。

NOTE
请参阅“其他资源——内容片段模型”。

管理内容片段模型 managing-content-fragment-models

管理内容片段模型涉及:

  • 启用(或禁用)内容片段模型——这使作者在创建内容片段时能够使用它们。
  • 删除——始终需要执行删除操作,但您需要注意删除已用于内容片段的模型,特别是已发布的片段。

发布 publishing

在发布任何相关内容片段时/之前,需要发布内容片段模型。

NOTE
如果作者尝试发布的内容片段的模型尚未发布,则会显示一个选择列表来指示该情况,并且模型将随该片段一起发布。

模型一经发布,就会​ 锁定 ​为作者的只读架构。这旨在阻止进行可能导致现有 GraphQL 架构和查询出错的更改,尤其是在发布环境中。它在控制台中由​ 已锁定 ​指示。

当模型处于​ 已锁定 ​状态(在只读架构中)时,您可以查看模型的内容和结构,但无法直接编辑它们;但您可以从控制台或模型编辑器中管理​ 已锁定 ​模型。

后续内容 whats-next

现在您已了解基础知识,下一步是开始创建您自己的内容片段模型。

其他资源 additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab