AEM Headless教程的第4章介绍了AEM可编辑模板在AEM内容服务上下文中的角色。 可编辑的模板用于定义AEM Content Services通过组合启用了Content Services的AEM组件而向客户公开的JSON内容结构。
AEM可编辑的模板用于定义将用来将事件内容显示为JSON的HTTP端点。
传统上,AEM可编辑的模板用于定义网页,但这种用法只是惯例。 可编辑的模板可用于撰写任何内容集;如何访问该内容:作为浏览器中的HTML,JavaScript(AEM SPA Editor)或移动设备应用程序使用的JSON取决于该页面的请求方式。
在AEM Content Services中,可编辑的模板用于定义JSON数据的显示方式。
对于WKND Mobile应用程序,我们将创建一个可编辑的模板,该模板将用于驱动单个API端点。 尽管此示例简单地说明了AEM Headless的概念,但您可以创建多个页面(或端点),每个页面都公开不同的内容集,以创建更复杂、组织更好的API。
要了解如何编写API端点,并了解应将哪些内容显示到我们的WKND Mobile应用程序,请让我们重新访问设计。
如我们所见,我们有三组逻辑内容要提供给移动设备应用程序。
为此,我们可以将这些要求映射到AEM组件(在本例中为AEM WCM核心组件),以便将必需的内容显示为JSON。
要支持AEM内容服务对页面和组件进行JSON导出,页面和组件必须从AEM WCM核心组件派生。
AEM WCM核心组 件提供了内置功能,可支持导出的页面和组件的标准化JSON模式。本教程中使用的所有WKND移动设备组件(页面、图像、文本和内容片段列表)均源自AEM WCM核心组件。
导航到工具 > 常规 > 模板 >WKND Mobile。
创建Events API模板:
首先,我们允许三个已识别的AEM组件,通过编辑根布局容器的Policy来对内容进行建模。 确保结构模式处于活动状态,选择Layout Container [Root],然后点按Policy按钮。
在属性 > 允许的组件下,搜索WKND Mobile。 允许WKND Mobile组件组中的以下组件,以便在Events API页面上使用。
WKND Mobile > Image
WKND Mobile > Text
WKND Mobile > Content Fragment List
完成后,点按右上角的Done复选标记。
刷新浏览器窗口,以在左边 栏 中查看新允许的组件列表。
从左边栏的组件查找器中,拖入以下AEM组件:
对于上述每个组件,选择它们并按“解锁” 按钮。
但是,请确保布局容器为锁定的,以防止添加其他组件,或者删除这三个组件。
点按页面信息 > 在管理员中查看,以返回到WKND Mobile模板列表。 选择新创建的Events API模板,然后点按顶部操作栏中的启用。
请注意,用于显示内容的组件会添加到模板本身并被锁定。 这是为了允许作者编辑预定义的组件,但不能任意添加或删除组件,因为更改API本身可能会破坏JSON结构的假设并破坏耗费的应用程序。 所有API都需要稳定。
或者,也可以选择通过AEM Package Manager在AEM作者上安装com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip内容包。 此包包含教程本章及前几章中概述的配置和内容。