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

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

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

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

目标 objective

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

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

之后,可以创建内容片段模型并定义结构。可以在​ 工具 > 常规 > 内容片段模型 ​下完成此操作。

工具中的内容片段模型

选择此选项后,您导航到模型的位置并选择​ 创建。您可以在此处输入各种关键详细信息。

默认情况下,启用模型 ​选项已激活。这意味着,您的模型一经保存即可立即使用(用于创建内容片段)。如果需要,您可以禁用此选项 - 可以稍后启用(或禁用)现有模型。

创建内容片段模型

使用​ 创建 ​进行确认,然后可以​ 打开 ​您的模型以开始定义结构。

定义内容片段模型 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