定义内容片段模型

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

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

此外,您还欢迎按照基本步骤创建自己的模型,并调整相应的步骤(如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资产(图像、视频、其他内容片段)的根。

  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. 点按 人员团队 模型和点按 发布

    发布内容片段模型

恭喜!

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

后续步骤

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

相关文档

在此页面上