内容建模
欢迎阅读有关Adobe Experience Manager (AEM)中的内容片段和GraphQL端点的教程一章。 我们将介绍如何利用内容片段、创建片段模型以及在AEM中使用GraphQL端点。
内容片段提供了一种用于跨渠道管理内容的结构化方法,提供了灵活性和可重用性。 在AEM中启用内容片段允许创建模块化内容,从而增强一致性和适应性。
首先,我们将引导您在AEM中启用内容片段,其中包括实现无缝集成所需的配置和设置。
接下来,我们将介绍如何创建片段模型,其中定义了结构和属性。 了解如何根据您的内容要求设计模型并有效地管理它们。
然后,我们将演示如何从模型创建内容片段,从而提供有关创作和发布的分步指南。
此外,我们将探讨定义AEM GraphQL端点。 GraphQL会高效地从AEM中检索数据,我们将设置和配置端点以公开所需数据。 持久查询将优化性能和缓存。
在本教程中,我们将提供说明、代码示例和实用提示。 到最后,您将具备启用内容片段、创建片段模型、生成片段以及定义AEM GraphQL端点和持久查询的技能。 让我们开始吧!
上下文感知配置
-
导航到 工具>配置浏览器,为Headless体验创建配置。
提供 title 和 name,并检查 GraphQL持久查询 和 内容片段模型。
内容片段模型
-
导航到 工具>内容片段模型,然后选择具有在步骤1中创建的配置名称的文件夹。
-
在文件夹中,选择 创建 并命名模型 Teaser。 将以下数据类型添加到 Teaser 模型。
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 数据类型 名称 必填 选项 内容引用 资源 是 根据需要添加默认图像。 例如: /content/dam/wknd-headless/assets/AdobeStock_307513975.mp4 单行文本 标题 是 单行文本 前置标题 否 多行文本 描述 否 确保默认类型为RTF 枚举 样式 是 呈现为下拉列表。 选项为Hero ->Hero和Featured ->精选 -
在文件夹内,创建名为 选件 的第二个模型。 单击“创建”并为模型命名“选件”,然后添加以下数据类型:
table 0-row-4 1-row-4 2-row-4 3-row-4 数据类型 名称 必填 选项 内容引用 资源 是 添加默认图像。 例如: /content/dam/wknd-headless/assets/AdobeStock_238607111.jpeg
多行文本 描述 否 多行文本 文章 否 -
在文件夹内,创建名为 图像列表 的第三个模型。 单击“创建”并为模型命名“图像列表”,然后添加以下数据类型:
table 0-row-4 1-row-4 数据类型 名称 必填 选项 片段引用 列表项目 是 呈现为多个字段。 允许的内容片段模型为“选件”。
内容片段
-
现在,导航到Assets并为新站点创建文件夹。 单击创建并命名文件夹。
-
创建文件夹后,选择该文件夹并打开其 属性。
-
在文件夹的 云配置 选项卡中,选择之前创建的配置。
单击进入新文件夹并创建Teaser。 单击 创建 和 内容片段 并选择 Teaser 模型。 将模型命名为 Hero,然后单击 创建。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 名称 注释 资源 保留为默认值或选择其他资源(视频或图像) 标题 Explore. Discover. Live.
前置标题 Join use for your next adventure.
描述 留空 样式 Hero
GraphQL 端点
-
导航到 工具> GraphQL
-
单击 创建,为新端点提供一个名称并选择新创建的配置。
GraphQL 持久查询
-
让我们测试新端点。 导航到 Tools > GraphQL查询编辑器,并为窗口右上角的下拉列表选择我们的端点。
-
在查询编辑器中,创建几个不同的查询。
code language-graphql { teaserList { items { title } } }
您应该获得一个列表,其中包含在以上创建的单个片段。
对于本练习,请创建AEM Headless应用程序使用的完整查询。 创建按路径返回单个Teaser的查询。 在查询编辑器中,输入以下查询:
code language-graphql query TeaserByPath($path: String!) { component: teaserByPath(_path: $path) { item { __typename _path _metadata { stringMetadata { name value } } title preTitle style asset { ... on MultimediaRef { __typename _authorUrl _publishUrl format } ... on ImageRef { __typename _authorUrl _publishUrl mimeType width height } } description { html plaintext } } } }
在底部的 查询变量 输入中,输入:
code language-json { "path": "/content/dam/pure-headless/hero" }
note note NOTE 您可能需要根据文件夹和片段名称调整查询变量 path
。运行查询以接收之前创建的内容片段的结果。
-
单击 保存 以保留(保存)查询并命名查询 Teaser。 这允许我们在应用程序中按名称引用查询。
后续步骤
恭喜!您已成功将AEM as a Cloud Service配置为允许创建内容片段和GraphQL端点。 您还创建了一个内容片段模型和内容片段,并定义了GraphQL端点和持久查询。 现在,您已准备好进入下一教程章节,您将在该章节中了解如何创建使用您在本章中创建的内容片段和GraphQL端点的AEM Headless React应用程序。