了解如何在 AEM 中创建内容片段模型 architect-headless-content-fragment-models
迄今为止的故事 story-so-far
在 AEM Headless 内容作者历程的开头,使用 AEM 对 Headless 进行内容建模的基础知识涵盖了与针对 Headless 进行创作相关的基本概念和术语。
本文基于这些内容编写,以便您了解如何为 AEM Headless 项目创建您自己的内容片段模型。
目标 objective
- 受众:初学者
- 目标:使用内容片段模型对 Headless CMS 进行内容建模的概念和机制。
创建内容片段模型 creating-content-fragment-models
之后,可以创建内容片段模型并定义结构。可以在“工具”>“Assets”>“内容片段模型”下执行此操作。
选择此选项后,您导航到模型的位置并选择 创建。您可以在此处输入各种关键详细信息。
默认情况下,启用模型 选项已激活。这意味着,您的模型一经保存即可立即使用(用于创建内容片段)。如果需要,您可以禁用此选项 - 可以稍后启用(或禁用)现有模型。
使用 创建 进行确认,然后可以 打开 您的模型以开始定义结构。
定义内容片段模型 defining-content-fragment-models
当您首次打开一个新模型时,您将看到左侧有一个大的空白区域,右侧有一个较长的 数据类型 列表:
那么 - 该如何操作?
您可以将 数据类型 的实例拖到左侧空白区域,您已定义模型!
在添加数据类型后,您需要为该字段定义 属性。这些都取决于将使用的类型。例如:
可以添加所需数量的字段。例如:
您的内容作者 your-content-authors
您的内容作者看不到您用于创建模型的实际数据类型和属性。这意味着您可能需要提供有关他们如何填写特定字段的帮助和信息。对于基本信息,您可以使用字段标签和默认值,但在更复杂的情况下,可能需要考虑项目特定的文档。
管理内容片段模型 managing-content-fragment-models
管理内容片段模型涉及:
- 启用(或禁用)内容片段模型 – 这使作者在创建内容片段时能够使用它们。
- 删除 - 始终需要执行删除操作,但您需要注意删除已用于内容片段的模型,特别是已发布的片段。
发布 publishing
在发布任何相关内容片段时/之前,需要发布内容片段模型。
模型一经发布,就会 锁定 为作者的只读架构。这旨在阻止进行可能导致现有 GraphQL 架构和查询出错的更改,尤其是在发布环境中。它在控制台中由 已锁定 指示。
当模型处于 已锁定 状态(在只读架构中)时,您可以查看模型的内容和结构,但无法直接编辑它们;但您可以从控制台或模型编辑器中管理 已锁定 模型。
后续内容 whats-next
现在您已了解基础知识,下一步是开始创建您自己的内容片段模型。
其他资源 additional-resources
-
基本处理 — 此页面主要基于 站点 控制台,但许多/大多数功能也涉及导航到 Assets 控制台下的 内容片段模型 并对其执行操作。
-
快速入门指南