定义内容片段模型

在本章中，了解如何对内容建模并使用构建模式 内容片段模型. 您将了解可用于定义模式作为模型一部分的不同数据类型。

我们创建了两个简单的模型， 团队 和 人员. 的 团队 数据模型具有名称、短名称和描述，并引用 人员 数据模型，包含全名、个人简介、个人简介和职业列表。

此外，您还欢迎按照基本步骤创建自己的模型，并调整相应的步骤（如GraphQL查询和React应用程序代码），或者只是按照这些章节中概述的步骤操作。

前提条件

这是一个多部分教程，假定 AEM创作环境可用.

目标

• 创建内容片段模型。
• 确定用于构建模型的可用数据类型和验证选项。
• 了解内容片段模型如何定义 both 内容片段的数据架构和创作模板。

创建项目配置

项目配置包含与特定项目关联的所有内容片段模型，并提供了组织模型的方法。 必须至少创建一个项目 之前 创建内容片段模型。

1. 登录AEM 作者 环境(例如 https://author-pYYYY-eXXXX.adobeaemcloud.com/)

2. 从AEM开始屏幕中，导航到 工具 > 常规 > 配置浏览器.

   

3. 单击 创建，位于右上角

4. 在结果对话框中，输入：

   • 标题*: 我的项目
   • 名称*: my-project (首选使用连字符使用全部小写来分隔单词。 此字符串会影响客户端应用程序执行请求时所针对的唯一GraphQL端点。)
   • 检查 内容片段模型
   • 检查 GraphQL永久查询

   

创建内容片段模型

接下来，为 团队 和 人员.

创建人员模型

为 人员，表示属于团队的人员的数据模型。

1. 从AEM开始屏幕中，导航到 工具 > 常规 > 内容片段模型.

   

2. 导航到 我的项目 文件夹。

3. 点按 创建 在右上角调出 创建模型 向导。

4. 在 模型标题 字段，输入 人员 点按 创建. 在结果对话框中，点按 打开，以构建模型。

5. 拖放 单行文本 元素。 在 属性 选项卡：

   • 字段标签: 全名
   • 属性名称: fullName
   • 检查 必需

   

   的 属性名称 定义保留到AEM的属性的名称。 的 属性名称 还定义 key 作为数据架构一部分的此属性的名称。 此 key 在通过GraphQL API公开内容片段数据时使用。

6. 点按 数据类型 选项卡，并拖放 多行文本 字段 全名 字段。 输入以下属性：

   • 字段标签: 传记
   • 属性名称: biographyText
   • 默认类型: 富文本

7. 单击 数据类型 选项卡，并拖放 内容参考 字段。 输入以下属性：

   • 字段标签: 配置文件图片
   • 属性名称: profilePicture
   • 根路径: /content/dam

   配置 根路径，您可以单击 文件夹 图标来显示用于选择路径的模式窗口。 这会限制作者可用于填充路径的文件夹。 /content/dam 是存储所有AEM Assets（图像、视频、其他内容片段）的根。

8. 向 图片参考 以便仅查看内容类型 图像 可用于填充字段。

   

9. 单击 数据类型 选项卡，并拖放 明细列表 下方的数据类型 图片参考 字段。 输入以下属性：

   • 渲染为: 复选框
   • 字段标签: 职业
   • 属性名称: occupation

10. 添加多个 选项 使用 添加选项 按钮。 对 选项标签 和 选项值:

    艺术家, 影响者, 摄影师, 旅行者, 作者, YouTube

11. 最后 人员 模型应如下所示：

    

12. 单击 保存 以保存更改。

创建团队模型

为 团队，这是一组人员的数据模型。 “团队”模型引用“人员”模型来表示团队的成员。

1. 在 我的项目 文件夹，点按 创建 在右上角， 创建模型 向导。

2. 在 模型标题 字段，输入 团队 点按 创建.

   点按 打开 在结果对话框中，打开新创建的模型。

3. 拖放 单行文本 元素。 在 属性 选项卡：

   • 字段标签: 标题
   • 属性名称: title
   • 检查 必需

4. 点按 数据类型 选项卡，并拖放 单行文本 元素。 在 属性 选项卡：

   • 字段标签: 短名称
   • 属性名称: shortName
   • 检查 必需
   • 检查 独特
   • 在， 验证类型 >选择 自定义
   • 在， 自定义验证正则表达式 > enter ^[a-z0-9\-_]{5,40}$ — 这可确保只能输入小写字母数字值和5到40个字符的破折号。

   的 shortName 属性为我们提供了一种基于缩短路径查询单个团队的方法。 的 独特 设置可确保该值始终对此模型的每个内容片段唯一。

5. 点按 数据类型 选项卡，并拖放 多行文本 字段 短名称 字段。 输入以下属性：

   • 字段标签: 描述
   • 属性名称: description
   • 默认类型: 富文本

6. 单击 数据类型 选项卡，并拖放 片段引用 字段。 输入以下属性：

   • 渲染为: 多字段
   • 字段标签: 团队成员
   • 属性名称: teamMembers
   • 允许的内容片段模型:使用文件夹图标选择 人员 模型。

7. 最后 团队 模型应如下所示：

   

8. 单击 保存 以保存更改。

9. 现在，您应该从以下两个模型开始工作：

   

发布项目配置和内容片段模型

审核后，发布 Project Configuration & Content Fragment Model

1. 从AEM开始屏幕中，导航到 工具 > 常规 > 配置浏览器.

2. 点按旁边的复选框 我的项目 点按 发布

   

3. 从AEM开始屏幕中，导航到 工具 > 常规 > 内容片段模型.

4. 导航到 我的项目 文件夹。

5. 点按 人员 和 团队 模型和点按 发布

   

恭喜！

恭喜，您刚刚创建了您的第一个内容片段模型！

后续步骤

在下一章中， 创作内容片段模型，则可以根据内容片段模型创建和编辑新的内容片段。 您还可以了解如何创建内容片段的变体。

相关文档

• 内容片段模型

Business.Adobe.com 资源