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

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

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

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

目标 objective

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

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

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

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

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

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

当您首次打开一个新模型时，您将看到左侧有一个大的空白区域，右侧有一个较长的​ 数据类型 ​列表：

那么 - 该如何操作？

您可以将​ 数据类型 ​的实例拖到左侧空白区域，您已定义模型！

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

可以添加所需数量的字段。例如：

您的内容作者 your-content-authors

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

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

管理内容片段模型涉及：

发布 publishing

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

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

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

后续内容 whats-next

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

其他资源 additional-resources