定义内容片段模型 content-fragment-models
在本章中，了解如何使用 内容片段模型 对内容建模并构建架构。 了解可用于将架构定义为模型一部分的不同数据类型。
我们创建了两个简单模型，团队 和 人员。 团队 数据模型具有名称、简短名称和描述，并引用 人员 数据模型，该模型具有全名、个人资料详细信息、个人资料图片和职业列表。
此外，还欢迎您按照基本步骤创建自己的模型，并调整相应的步骤，如GraphQL查询和React应用程序代码，或只是按照这些章节中概述的步骤进行操作。
先决条件 prerequisites
这是一个多部分教程，并假定有AEM创作环境可用。
目标 objectives
- 创建内容片段模型。
- 确定用于构建模型的可用数据类型和验证选项。
- 了解内容片段模型如何定义 两者 内容片段的数据架构和创作模板。
创建项目配置
项目配置包含与特定项目关联的所有内容片段模型，并提供组织模型的方法。 在创建内容片段模型 之前，必须 至少创建一个项目。
-
登录到AEM 作者 环境（例如
https://author-pYYYY-eXXXX.adobeaemcloud.com/） -
从AEM开始屏幕中，导航到 工具 > 常规 > 配置浏览器。
-
单击右上角的 创建
-
在生成的对话框中，输入：
- 标题*：我的项目
- 名称*：my-project(偏好使用所有小写字母并使用连字符分隔单词。 此字符串会影响客户端应用程序执行请求的唯一GraphQL端点。)
- 检查 内容片段模型
- 检查 GraphQL持久查询
创建内容片段模型
接下来，为 团队 和 人员 创建两个模型。
创建人员模型
创建 人员 的模型，该模型是表示属于某个团队的人员的数据模型。
-
从AEM开始屏幕中，导航到 工具 > 常规 > 内容片段模型。
-
导航到 我的项目 文件夹。
-
点按右上角的 创建 以显示 创建模型 向导。
-
在 模型标题 字段中，输入 人员 并点按 创建。 在生成的对话框中，点按 打开 以构建模型。
-
将 单行文本 元素拖放到主面板上。 在 属性 选项卡上输入以下属性：
- 字段标签：全名
- 属性名称：
fullName - 检查 必需
属性名称 定义保留到AEM的属性的名称。 属性名称 还将此属性的 键 名称定义为数据架构的一部分。 此 键 在通过GraphQL API公开内容片段数据时使用。
-
点按 数据类型 选项卡，并将 多行文本 字段拖放到 全名 字段下。 输入以下属性：
- 字段标签：个人简历
- 属性名称：
biographyText - 默认类型：富文本
-
单击 数据类型 选项卡并拖放 内容引用 字段。 输入以下属性：
- 字段标签：个人资料图片
- 属性名称：
profilePicture - 根路径：
/content/dam
配置 根路径 时，您可以单击 文件夹 图标以调出模式窗口来选择路径。 这会限制作者可以使用哪些文件夹填充路径。
/content/dam是存储所有AEM Assets（图像、视频、其他内容片段）的根。 -
向 图片引用 添加验证，以便只有 图像 的内容类型可用于填充该字段。
-
单击 数据类型 选项卡，并将 枚举 数据类型拖放到 图片引用 字段下。 输入以下属性：
- 呈现为：复选框
- 字段标签：职业
- 属性名称：
occupation
-
使用 添加选项 按钮添加多个 选项。 对 选项标签 和 选项值 使用相同的值：
艺人，影响者，摄影师，旅行者，作者，YouTuber
-
最终 人员 模型应如下所示：
-
单击 保存 以保存更改。
创建团队模型
为 团队 创建模型，这是人员团队的数据模型。 团队模型引用“人员”模型来表示团队成员。
-
在 我的项目 文件夹中，点按右上角的 创建 以显示 创建模型 向导。
-
在 模型标题 字段中，输入 团队 并点按 创建。
在生成的对话框中点按 打开 以打开新创建的模型。
-
将 单行文本 元素拖放到主面板上。 在 属性 选项卡上输入以下属性：
- 字段标签：标题
- 属性名称：
title - 检查 必需
-
点按 数据类型 选项卡，并将 单行文本 元素拖放到主面板上。 在 属性 选项卡上输入以下属性：
- 字段标签：短名称
- 属性名称：
shortName - 检查 必需
- 检查 唯一
- 在下，验证类型 >选择 自定义
- 在下，自定义验证正则表达式 >输入
^[a-z0-9\-_]{5,40}$— 这可以确保只能输入5到40个字符之间的小写字母数字值和破折号。
shortName属性提供了一种根据缩短路径查询单个团队的方法。 唯一 设置确保此模型的每个内容片段的值始终是唯一的。 -
点按 数据类型 选项卡，并将 多行文本 字段拖放到 短名称 字段下。 输入以下属性：
- 字段标签：描述
- 属性名称：
description - 默认类型：富文本
-
单击 数据类型 选项卡并拖放 片段引用 字段。 输入以下属性：
- 呈现为：多个字段
- 字段标签：团队成员
- 属性名称：
teamMembers - 允许的内容片段模型：使用文件夹图标选择 人员 模型。
-
最终 团队 模型应如下所示：
-
单击 保存 以保存更改。
-
您现在应该可以从以下两个模型工作：
Publish项目配置和内容片段模型
审核和验证后，发布Project Configuration和Content Fragment Model
-
从AEM开始屏幕中，导航到 工具 > 常规 > 配置浏览器。
-
点按 我的项目 旁边的复选框，然后点按 Publish
-
从AEM开始屏幕中，导航到 工具 > 常规 > 内容片段模型。
-
导航到 我的项目 文件夹。
-
点按 人员 和 团队 模型，然后点按 Publish
恭喜！ congratulations
恭喜，您刚刚创建了您的第一个内容片段模型！
后续步骤 next-steps
在下一章创作内容片段模型中，您将基于内容片段模型创建和编辑新的内容片段。 您还将了解如何创建内容片段的变体。