第4章 — 定义Content Service模板

AEM Headless教程的第4章介绍了AEM可编辑模板在AEM Content Services上下文中的作用。 可编辑模板用于定义AEM Content Services通过组合启用Content Services的AEM组件向客户端公开的JSON内容结构。

了解“模板”在AEM Content Services中的角色

AEM可编辑模板用于定义访问的HTTP端点,以将事件内容公开为JSON。

传统上,使用AEM的可编辑模板来定义网页,但只是按惯例使用。 可编辑的模板可用于构成​ 任意 ​内容集;内容的访问方式:作为浏览器中的HTML,作为JavaScript (AEM SPA Editor)使用的JSON或移动设备应用程序是该页面请求方式的函数。

在AEM Content Services中,可编辑模板用于定义如何公开JSON数据。

对于WKND Mobile应用程序,我们将创建一个用于驱动单个API端点的可编辑模板。 虽然此示例非常简单以说明AEM Headless的概念,但您可以创建多个页面(或端点),每个页面或端点都会公开不同的内容集,以便创建更复杂、更有条理的API。

了解API端点

要了解如何构建API端点,并了解应向我们的WKND Mobile应用程序公开的内容,让我们重新访问设计。

事件API页面分解

如我们所见,我们有三个要提供给移动设备应用程序的逻辑内容集。

  1. 徽标
  2. 标记行
  3. 事件 ​的列表

为此,我们可以将这些要求映射到AEM组件(在本例中为AEM WCM核心组件),以便以JSON形式公开必需的内容。

  1. 徽标 ​通过​ 图像组件 ​显示
  2. 标记行 ​通过​ 文本组件 ​显示
  3. 事件 ​的列表通过​ 内容片段列表组件 ​显示,该组件又引用了一组事件内容片段。
NOTE
为了支持AEM Content Service的页面和组件的JSON导出,页面和组件必须​ 派生自AEM WCM核心组件
AEM WCM核心组件具有内置功能,可支持导出的页面和组件的标准化JSON架构。 本教程中使用的所有WKND Mobile组件(页面、图像、文本和内容片段列表)均派生自AEM WCM核心组件。

定义事件API模板

  1. 导航到​ 工具 > 常规 > 模板 >WKND Mobile

  2. 创建​ Events API ​模板:

    1. 点按顶部操作栏中的​ 创建
    2. 选择​ WKND Mobile - Empty Page ​模板
    3. 点按顶部操作栏中的​ 下一步
    4. 在模板标题字段中输入​ Events API
    5. 点按顶部操作栏中的​ 创建
    6. 点按​ 打开 ​打开新模板进行编辑
  3. 首先,我们允许通过编辑根布局容器的策略为内容建模所需的三个已识别AEM组件。 确保​ 结构 ​模式处于活动状态,选择​ Layout Container [Root],然后点按​ 策略 ​按钮。

  4. 在​ 属性 > 允许的组件 ​下,搜索​ WKND Mobile。 允许WKND Mobile组件组中的以下组件,以便它们可以在Events API页面上使用。

    • WKND Mobile > Image

      • 应用程序的徽标
    • WKND Mobile > Text

      • 应用程序的介绍性文本
    • WKND Mobile > Content Fragment List

      • 应用程序中可显示的事件类别列表
  5. 完成后,点按右上角的​ 完成 ​复选标记。

  6. 刷新 ​浏览器窗口以在左边栏中查看新的允许的组件列表。

  7. 从左边栏中的组件查找器中,拖入以下AEM组件:

    1. 徽标的​ Image
    2. 标记行的​ Text
    3. 事件的​ Content Fragment List
  8. 对于上述每个组件,选择它们并按​ 解锁 ​按钮。

  9. 但是,请确保​ 布局容器 ​为​ 锁定 ​以防止添加其他组件,或阻止删除这三个组件。

  10. 点按​ 页面信息 > 以管理员身份查看 ​以返回WKND Mobile模板列表。 选择新创建的​ Events API ​模板,然后点按顶部操作栏中的​ 启用

NOTE
请注意,用于显示内容的元件已添加到模板本身并锁定。 这是为了让作者编辑预定义的组件,但不要随意添加或删除组件,因为更改API本身可能会破坏有关JSON结构的假设并破坏消费应用程序。 所有API都必须稳定。

后续步骤

或者,通过AEM包管理器在AEM Author上安装com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip内容包。 此资源包包含本教程及前面章节中概述的配置及内容。

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