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