了解如何在 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
您的内容作者看不到您用于创建模型的实际数据类型和属性。这意味着您可能需要提供有关他们如何填写特定字段的帮助和信息。对于基本信息,您可以使用字段标签和默认值,但在更复杂的情况下,可能需要考虑项目特定的文档。
管理内容片段模型 managing-content-fragment-models
管理内容片段模型涉及:
- 启用(或禁用)内容片段模型——这使作者在创建内容片段时能够使用它们。
- 删除——始终需要执行删除操作,但您需要注意删除已用于内容片段的模型,特别是已发布的片段。
发布 publishing
在发布任何相关内容片段时/之前,需要发布内容片段模型。
模型一经发布,就会 锁定 为作者的只读架构。这旨在阻止进行可能导致现有 GraphQL 架构和查询出错的更改,尤其是在发布环境中。它在控制台中由 已锁定 指示。
当模型处于 已锁定 状态(在只读架构中)时,您可以查看模型的内容和结构,但无法直接编辑它们;但您可以从控制台或模型编辑器中管理 已锁定 模型。
后续内容 whats-next
现在您已了解基础知识,下一步是开始创建您自己的内容片段模型。
其他资源 additional-resources
-
基本处理——此页面主要基于 Sites 控制台,但许多/大多数功能也用于在 常规 控制台下导航到并操作内容片段模型。
-
快速入门指南