内容建模

欢迎阅读有关Adobe Experience Manager (AEM)中的内容片段和GraphQL端点的教程一章。 我们将介绍如何利用内容片段、创建片段模型以及在AEM中使用GraphQL端点。

内容片段提供了一种用于跨渠道管理内容的结构化方法,提供了灵活性和可重用性。 在AEM中启用内容片段允许创建模块化内容,从而增强一致性和适应性。

首先,我们将引导您在AEM中启用内容片段,其中包括实现无缝集成所需的配置和设置。

接下来,我们将介绍如何创建片段模型,其中定义了结构和属性。 了解如何根据您的内容要求设计模型并有效地管理它们。

然后,我们将演示如何从模型创建内容片段,从而提供有关创作和发布的分步指南。

此外,我们将探讨定义AEM GraphQL端点。 GraphQL会高效地从AEM中检索数据,我们将设置和配置端点以公开所需数据。 持久查询将优化性能和缓存。

在本教程中,我们将提供说明、代码示例和实用提示。 到最后,您将具备启用内容片段、创建片段模型、生成片段以及定义AEM GraphQL端点和持久查询的技能。 让我们开始吧!

上下文感知配置

  1. 导航到​ 工具>配置浏览器,为Headless体验创建配置。

    创建文件夹

    提供​ title ​和​ name,并检查​ GraphQL持久查询 ​和​ 内容片段模型

内容片段模型

  1. 导航到​ 工具>内容片段模型,然后选择具有在步骤1中创建的配置名称的文件夹。

    模型文件夹

  2. 在文件夹中,选择​ 创建 ​并命名模型​ 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 ->精选

    Teaser模型

  3. 在文件夹内,创建名为​ 选件 ​的第二个模型。 单击“创建”并为模型命名“选件”,然后添加以下数据类型:

    table 0-row-4 1-row-4 2-row-4 3-row-4
    数据类型 名称 必填 选项
    内容引用 资源 添加默认图像。 例如: /content/dam/wknd-headless/assets/AdobeStock_238607111.jpeg
    多行文本 描述
    多行文本 文章

    优惠模型

  4. 在文件夹内,创建名为​ 图像列表 ​的第三个模型。 单击“创建”并为模型命名“图像列表”,然后添加以下数据类型:

    table 0-row-4 1-row-4
    数据类型 名称 必填 选项
    片段引用 列表项目 呈现为多个字段。 允许的内容片段模型为“选件”。

    图像列表模型

内容片段

  1. 现在,导航到Assets并为新站点创建文件夹。 单击创建并命名文件夹。

    添加文件夹

  2. 创建文件夹后,选择该文件夹并打开其​ 属性

  3. 在文件夹的​ 云配置 ​选项卡中,选择之前创建的配置

    资产文件夹AEM Headless云配置

    单击进入新文件夹并创建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 端点

  1. 导航到​ 工具> GraphQL

    AEM GraphiQL

  2. 单击​ 创建,为新端点提供一个名称并选择新创建的配置。

    AEM Headless GraphQL终结点

GraphQL 持久查询

  1. 让我们测试新端点。 导航到​ Tools > GraphQL查询编辑器,并为窗口右上角的下拉列表选择我们的端点。

  2. 在查询编辑器中,创建几个不同的查询。

    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

    运行查询以接收之前创建的内容片段的结果。

  3. 单击​ 保存 ​以保留(保存)查询并命名查询​ Teaser。 这允许我们在应用程序中按名称引用查询。

后续步骤

恭喜!您已成功将AEM as a Cloud Service配置为允许创建内容片段和GraphQL端点。 您还创建了一个内容片段模型和内容片段,并定义了GraphQL端点和持久查询。 现在,您已准备好进入下一教程章节,您将在该章节中了解如何创建使用您在本章中创建的内容片段和GraphQL端点的AEM Headless React应用程序。

下一章:AEM Headless API和React

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4