创建内容片段模型

上次更新: 2024-01-26
  • 创建对象:
  • Intermediate
    Developer

本章介绍创建五个内容片段模型的步骤:

  • 联系信息
  • 地址
  • 人员
  • 位置
  • 团队

内容片段模型允许定义内容类型之间的关系并保留此类关系,例如架构。 使用嵌套片段引用、各种内容数据类型和选项卡类型进行可视内容组织。 更高级的数据类型,如选项卡占位符、片段引用、JSON对象以及日期和时间数据类型。

本章还介绍如何增强内容引用(如图像)的验证规则。

前提条件

这是一个高级教程。 在继续本章之前,请确保您已完成 快速设置. 请确保您也阅读了前面的文章 概述 章节以了解有关高级教程设置的更多信息。

目标

  • 创建内容片段模型。
  • 为模型添加选项卡占位符、日期和时间、JSON对象、片段引用和内容引用。
  • 将验证添加到内容引用。

内容片段模型概述

以下视频简要介绍了内容片段模型以及在本教程中如何使用它们。

创建内容片段模型

让我们为WKND应用程序创建一些内容片段模型。 如果您需要有关创建内容片段模型的基本介绍,请参阅 基本教程.

  1. 导航到​工具 > 常规 > 内容片段模型

    内容片段模型路径

  2. 选择 WKND已共享 查看站点的现有内容片段模型的列表。

联系信息模型

接下来,创建一个包含人员或地点联系人信息的模型。

  1. 选择 创建 在右上角。

  2. 为模型指定“联系信息”标题,然后选择 创建. 在显示的成功模式中,选择 打开 以编辑新创建的模型。

  3. 从拖动开始 单行文本 字段到模型上。 给它一个 字段标签 中的“Phone” 属性 选项卡。 属性名称会自动填写为 phone. 选中复选框以生成字段 必填.

  4. 导航至 数据类型 选项卡,然后添加另一个 单行文本 “电话”字段下的字段。 给它一个 字段标签 “电子邮件”的URL并将其设置为 必填.

Adobe Experience Manager附带一些内置的验证方法。 这些验证方法允许您向内容片段模型中的特定字段添加治理规则。 在这种情况下,让我们添加一个验证规则,以确保用户在填写此字段时只能输入有效的电子邮件地址。 在 验证类型 下拉列表,选择 电子邮件.

您完成的内容片段模型应如下所示:

联系人信息模型路径

完成后,选择 保存 以确认您的更改并关闭内容片段模型编辑器。

地址模型

接下来,为地址创建模型。

  1. WKND已共享,选择 创建 从右上角。

  2. 输入“地址”标题,然后选择 创建. 在显示的成功模式中,选择 打开 以编辑新创建的模型。

  3. 拖放 单行文本 将字段置于模型上,并赋予 字段标签 “街道地址”的。 然后,属性名称将填写为 streetAddress. 选择 必填 复选框。

  4. 重复上述步骤并向模型添加四个“单行文本”字段。 使用以下标签:

    • 城市
    • 状态
    • 邮政编码
    • 国家/地区
  5. 选择 保存 以保存对地址模型的更改。

    已完成的“地址”片段模型应如下所示:
    地址模型

人员模型

接下来,创建一个包含人员信息的模型。

  1. 在右上角,选择 创建.

  2. 将模型标题命名为“人员”,然后选择 创建. 在显示的成功模式中,选择 打开 以编辑新创建的模型。

  3. 从拖动开始 单行文本 字段到模型上。 给它一个 字段标签 “全名”。 属性名称会自动填写为 fullName. 选中复选框以生成字段 必填.

    全名选项

  4. 内容片段模型可以在其他模型中引用。 导航至 数据类型 选项卡,然后拖放 片段引用 字段并为其指定“联系人信息”标签。

  5. 属性 选项卡,在 允许的内容片段模型 字段中,选择文件夹图标,然后选择 联系信息 之前创建的片段模型。

  6. 添加 内容引用 字段并赋予 字段标签 “个人资料图片”中的。 选择下的文件夹图标 根路径 以打开路径选择模式。 通过选择选择根路径 内容 > 资产,然后选中复选框 WKND已共享. 使用 选择 按钮以保存路径。 最终文本路径应为 /content/dam/wknd-shared.

    内容引用根路径

  7. 仅接受指定的内容类型,选择“图像”。

    配置文件图片选项

  8. 要限制图像文件大小和尺寸,请查看内容引用字段的一些验证选项。

    仅接受指定的文件大小,选择“小于或等于”,则其他字段会显示在下方。
    仅接受指定的文件大小

  9. 对象 Max,输入“5”,对于 选择单位,选择“兆字节(MB)”。 此验证仅允许选择指定大小的图像。

  10. 仅接受指定的图像宽度,选择“最大宽度”。 在 最大值(像素) 字段,输入“10000”。 选择相同的选项 仅接受指定的图像高度.

    这些验证可确保添加的图像不超过指定的值。 验证规则现在应当如下所示:

    内容引用验证规则

  11. 添加 多行文本 字段并赋予 字段标签 《传记》的封面。 离开 默认类型 下拉菜单作为默认的“富文本”选项。

    传记选项

  12. 导航至 数据类型 选项卡,然后拖动 明细列表 “传记”下面的字段。 而不是默认内容 呈现为 选项,选择 下拉列表 然后给它一个 字段标签 “讲师经验级别”的数量。 输入一系列讲师体验级别选项,例如 专家、高级、中级.

  13. 接下来,拖动另一个 明细列表 字段,然后选择“讲师体验级别”下的“复选框” 呈现为 选项。 给它一个 字段标签 “技能”的URL。 学习攀岩、冲浪、骑自行车、滑雪和背包等不同技能。 选项标签和选项值应匹配如下:

    技能明细列表

  14. 最后,使用创建“管理员详细信息”字段标签 多行文本 字段。

选择 保存 以确认您的更改并关闭内容片段模型编辑器。

位置模型

下一个内容片段模型描述了物理位置。 此模型使用制表符占位符。 选项卡占位符通过对内容进行分类,有助于分别在模型编辑器和片段编辑器中整理数据类型。 每个占位符在内容片段编辑器中创建一个选项卡,类似于Internet浏览器中的选项卡。 位置模型应有两个选项卡:“位置详细信息”和“位置地址”。

  1. 与以前一样,选择 创建 以创建另一个内容片段模型。 对于“模型标题”,输入“位置”。 选择 创建 后接 打开 在显示的成功模式窗口中。

  2. 添加 制表符占位符 字段到模型并将其标记为“位置详细信息”。

  3. 拖放 单行文本 并标记为“名称”。 在此字段标签下方,添加 多行文本 字段并将其标记为“Description”。

  4. 接下来,添加 片段引用 字段并将其标记为“联系人信息”。 在属性选项卡中的下 允许的内容片段模型,选择 文件夹图标 并选择之前创建的“联系信息”片段模型。

  5. 添加 内容引用 字段。 将其标记为“Location Image”。 此 根路径 应为 /content/dam/wknd-shared.仅接受指定的内容类型,选择“图像”。

  6. 我们还要添加 JSON对象 “位置图像”下的字段。 由于此数据类型比较灵活,因此可用于显示要包含在内容中的任何数据。 在这种情况下,JSON对象用于显示有关天气的信息。 将JSON对象标记为“按季节显示天气”。 在 属性 选项卡,添加 描述 因此用户可以清楚地看到应该在此处输入哪些数据:“关于按季节(春季、夏季、秋季和冬季)的事件位置天气的JSON数据。”

    JSON对象选项

  7. 要创建“位置地址”选项卡,请添加 制表符占位符 字段到模型并将其标记为“Location Address”。

  8. 拖放 片段引用 字段,在属性选项卡中,将其标记为“Address”,然后在 允许的内容片段模型,选择 地址 模型。

  9. 选择 保存 以确认您的更改并关闭内容片段模型编辑器。 已完成的库位模型应如下所示:

    内容引用选项

团队模型

最后,创建一个描述人员团队的模型。

  1. WKND已共享 页面,选择 创建 以制作另一个内容片段模型。 对于“模型标题”,输入“团队”。 与以前一样,选择 创建 后接 打开 在显示的成功模式窗口中。

  2. 添加 多行文本 字段到表单。 下 字段标签,输入“Description”。

  3. 添加 日期和时间 字段到模型并将其标记为“团队创建日期”。 在这种情况下,保留默认值 类型 设置为“Date”,但请注意,也可以使用“Date & Time”或“Time”。

    日期和时间选项

  4. 导航至 数据类型 选项卡。 在“团队创建日期”下方,添加 片段引用. 在 呈现为 在下拉列表中选择“多字段”。 对象 字段标签,输入“团队成员”。 此字段链接到 人员 之前创建的模型。 由于数据类型是多字段的,因此可以添加多个人员片段,从而能够创建一组人员。

    片段引用选项

  5. 允许的内容片段模型,使用文件夹图标打开选择路径模式窗口,然后选择 人员 模型。 使用 选择 按钮以保存路径。

    选择人员模型

  6. 选择 保存 以确认您的更改并关闭内容片段模型编辑器。

向冒险模型添加片段引用

与团队模型具有对人员模型的片段引用类似,必须从冒险模型引用团队和位置模型,才能在WKND应用程序中显示这些新模型。

  1. WKND已共享 页面上,选择 冒险 模型,然后选择 编辑 从顶部导航中。

    冒险编辑路径

  2. 在表单底部的“What to Bring”下方,添加 片段引用 字段。 输入 字段标签 “位置”的URL。 下 允许的内容片段模型,选择 位置 模型。

    位置片段引用选项

  3. 再添加一个 片段引用 字段并将其标记为“讲师团队”。 下 允许的内容片段模型,选择 团队 模型。

    团队片段引用选项

  4. 添加其他 片段引用 字段并将其标记为“管理员”。

    管理员片段引用选项

  5. 选择 保存 以确认您的更改并关闭内容片段模型编辑器。

最佳实践

有一些与创建内容片段模型相关的最佳实践:

  • 创建映射到UX组件的模型。 例如,WKND应用程序具有用于冒险、文章和位置的内容片段模型。 您还可以添加标题、促销活动或免责声明。 每个示例都构成一个特定的UX组件。

  • 创建尽可能少的模型。 通过限制模型数量,您可以最大限度地重复使用并简化内容管理。

  • 根据需要深度嵌套内容片段模型,但仅在需要时进行嵌套。 回想一下,嵌套是通过片段引用或内容引用完成的。 假设最多有5层嵌套。

恭喜!

恭喜!您现在添加了选项卡,使用日期和时间以及JSON对象数据类型,并了解了关于片段和内容引用的更多信息。 您还添加了内容引用验证规则。

后续步骤

本系列下一章将涵盖 创作内容片段 您在本章中创建的模型中的。 了解如何使用本章介绍的数据类型以及创建文件夹策略来限制可以在资源文件夹中创建哪些内容片段模型。

虽然它是本教程的可选内容,但请确保在真实的生产环境中发布所有内容。 有关AEM中“创作”和“发布”环境的审查,请参阅
AEM Headless和GraphQL视频系列.

在此页面上