AEM Headless的高级概念
此端到端教程将继续 基本教程 该文档介绍了Adobe Experience Manager (AEM) Headless和GraphQL的基础知识。 该高级教程说明了使用内容片段模型、内容片段和AEM GraphQL持久查询的深入方面,包括在客户端应用程序中使用GraphQL持久查询。
前提条件
完成 AEMas a Cloud Service的快速设置 配置AEMas a Cloud Service环境。
强烈建议您完成前面 基本教程 和 视频系列 教程,然后再继续执行此高级教程。 虽然您可以使用本地AEM环境完成本教程,但本教程仅介绍AEMas a Cloud Service的工作流。
目标
本教程涵盖以下主题:
- 使用验证规则和更高级的数据类型(如选项卡占位符、嵌套片段引用、JSON对象以及日期和时间数据类型)创建内容片段模型。
- 处理嵌套内容和片段引用时创作内容片段,并为内容片段创作治理配置文件夹策略。
- 使用带有变量和指令的GraphQL查询来探索AEM GraphQL API功能。
- 在AEM中使用参数保留GraphQL查询,并了解如何将缓存控制参数用于保留查询。
- 使用AEM Headless JavaScript SDK将持久查询请求集成到示例WKND GraphQL React应用程序中。
AEM Headless的高级概念概述
以下视频提供了本教程中涵盖的概念的高级概述。 本教程包括使用更高级的数据类型定义内容片段模型、嵌套内容片段以及在AEM中保留GraphQL查询。
项目设置
WKND站点项目具有所有必需的配置,因此您可以在完成 快速设置. 本节仅重点介绍在创建您自己的AEM Headless项目时可以使用的一些重要步骤。
审查现有配置
在AEM中开始任何新项目的第一步是创建其配置(作为工作区)并创建GraphQL API端点。 要查看或创建配置,请导航到 工具 > 常规 > 配置浏览器.
请注意, WKND Shared
已为该教程创建了站点配置。 要为您自己的项目创建配置,请选择 创建 并完成显示的创建配置模式中的表单。
审查GraphQL API端点
接下来,您必须配置要将GraphQL查询发送到的目标的API端点。 要查看现有端点或创建端点,请导航至 工具 > 常规 > GraphQL.
请注意, WKND Shared Endpoint
已创建。 要为项目创建端点,请选择 创建 并遵循工作流程。
查看WKND内容结构和语言根文件夹
明确定义的内容结构是AEM Headless实施成功的关键。 它有助于内容的可扩展性、可用性和权限管理。
语言根文件夹是使用ISO语言代码作为其名称(如EN或FR)的文件夹。 AEM翻译管理系统使用这些文件夹定义内容的主要语言和内容翻译的语言。
转到 导航 > 资产 > 文件.
导航到 WKND已共享 文件夹。 观察标题为“English”和名称为“EN”的文件夹。 此文件夹是WKND站点项目的语言根文件夹。
对于您自己的项目,请在配置中创建语言根文件夹。 请参阅以下部分 创建文件夹 以了解更多详细信息。
将配置分配给嵌套文件夹
最后,必须将项目配置分配给语言根文件夹。 通过此分配,可基于在您的项目配置中定义的内容片段模型创建内容片段。
要将语言根文件夹分配给配置,请选择文件夹,然后选择 属性 导航栏中。
接下来,导航到 Cloud Service 选项卡,并在中选择文件夹图标 云配置 字段。
在显示的模式窗口中,选择您之前创建的配置以为其分配语言根文件夹。
最佳实践
以下是在AEM中创建自己的项目时的最佳实践:
- 在建模文件夹层级时应考虑本地化和翻译。 换句话说,语言文件夹应该嵌套在配置文件夹中,这样可以轻松地翻译这些配置文件夹中的内容。
- 文件夹层次结构应保持扁平且简单明了。 避免在以后移动或重命名文件夹和片段,尤其是在发布以供实时使用之后,因为它更改了可能影响片段引用和GraphQL查询的路径。
入门和解决方案包
两个AEM 包 可用,可通过以下方式安装: 包管理器
- Advanced-GraphQL-Tutorial-Starter-Package-1.1.zip 将在本教程后面使用,其中包含示例图像和文件夹。
- Advanced-GraphQL-Tutorial-Solution-Package-1.2.zip 包含第1-4章的最终解决方案,包括新的内容片段模型、内容片段和持久化GraphQL查询。 对于希望直接跳入 客户端应用程序集成 章节。
此 React应用程序 — 高级教程 — WKND冒险 项目可用于查看和浏览示例应用程序。 此示例应用程序通过调用持久化的GraphQL查询从AEM检索内容,并在沉浸式体验中呈现该内容。
快速入门
要开始使用此高级教程,请执行以下步骤:
- 使用设置开发环境 AEMas a Cloud Service.
- 开始教程一章,位于 创建内容片段模型.