AEM 站点的 Adobe Learning Manager 参考站点（ALM 参考站点）包

Adobe Learning Manager (ALM) 与 Adobe Experience Manager (AEM) 站点集成。 如此一来，您就可以为 Adobe Learning Manager 创建自己的网站和响应式移动界面，并且只需进行最少的编码工作。 通过此集成，您可以为用户创建自定义学习体验。

为了构建此类体验，ALM 以 ZIP 文件的形式为 AEM 站点提供了一个 Adobe Learning Manager 参考站点包（ALM 参考站点包），您可以将其安装在 AEM 站点实例上。

该站点包中包含 AEM 站点网页模板和网站组件以及嵌入式小组件，例如学习目录、嵌入式小组件、日历等。

安装 ALM 参考站点包之后，即可开始为 Adobe Learning Manager 构建网站，并将其托管在 AEM 站点实例上。 然后，您的用户就可以将组件拖放到网站上。

安装 ALM 参考站点包

先决条件

• AEM 站点和 Adobe Commerce 的许可证。

• AEM 本地版 6.5 或 Adobe Experience Manager – 云服务
  

• Adobe Commerce 2.4.3

在保证 AEM 站点的环境安全后，必须安装 ALM 参考站点包。 此站点包中包含 AEM 网页和网站组件，可帮助您构建学习平台。

参考站点包托管在 GitHub 存储库中。

有关更多信息，请参阅说明文件。

在 Adobe Learning Manager 中创建应用程序

安装 AEM 站点包后，必须配置 ALM 应用程序将学习门户与 AEM 站点连接。

此方案适用于与 Adobe Learning Manager 配合 AEM 使用时的情形。

请按以下步骤操作：

1. 以集成管理员身份单击“应用程序”。
2. 要创建新应用程序，在页面右上角，单击“注册”。
3. 在“注册新应用程序”界面中，输入以下详细信息：
   1. 应用程序名称：正在创建的应用程序的名称。
   2. URL：组织的 URL。
   3. 重定向域：AEM 网站的托管域。 您还可以指定通配符。
   4. 描述：应用程序的描述。
   5. 范围：选择“学习者”角色的读取访问权限和“学习者”角色的写入权限。
   6. 是否仅针对此帐户：如果要将应用程序用于现有 ALM 帐户，请选择“是”。
4. 完成更改后，单击“保存”。

请注意遮挡屏幕中的应用程序凭据。

要批准应用程序，请单击“批准”。

获取令牌

在 AEM 中配置 ALM 帐户

登录流程（Adobe Learning Manager、AEM 和 Adobe Commerce）

• Adobe Commerce 仅支持用户名/密码，不支持任何基于 SAML 的即用型 SSO。
• 适用于 AEM 的 Adobe Learning Manager 参考站点实施可与 Adobe Commerce 用户名/密码配合使用。
• 从 Adobe Commerce 获取令牌后，我们还需要与 AEM 客户端 js 的 AEM 后端共享此令牌。 AEM 后端将使用此令牌与 Adobe Commerce 建立联系，从而获取用户的电子邮件。 使用电子邮件和已配置的 ALM Admin 刷新令牌时，系统将为学习者生成 ALM 访问令牌，并将其发送至 AEM 客户端 js 以呈现学习组件。

登录流程（Adobe Learning Manager 和 Adobe Commerce）

• 默认情况下，由于未获得来自 Commerce 的默认 SSO 支持，因此用户必须登录两次，一次登录 ALM，另一次登录 Commerce。
• 但是，如果在 Commerce 端通过扩展程序或自定义编码启用了支持 ALM 的 SSO（基于 SAML 2.0 的社交帐户登录，如 Facebook、Twitter、Linkedin、Microsoft 或 Adobe ID），则相同的 IDP 可用于 ALM 和 Commerce，并且可以避免输入两次登录凭据。

AEM + Adobe Learning Manager（已登录/未登录用户）

您现在可以利用 Adobe Learning Manager 向现有和潜在的客户及合作伙伴展示产品和培训内容，无需创建或登录帐户。此功能可为学习者提供快捷简单的培训预览，帮助您推动产品和培训的采用，有助于突显和推广产品功能。如此一来，您就可以有效地展示产品和服务，尤其是向潜在客户和合作伙伴进行展示，从而提高产品知名度。 访问的方便性和可达性均能帮助提高客户兴趣，从而推动培训注册和学习采用。 

使用此工作流程，学习者无需登录 Adobe Learning Manager 即可预览培训内容、访问培训信息或搜索培训。此工作流程不适用于本机 Adobe Learning Manager 界面（仅适用于 AEM 站点和其他无头界面）。

配置和启用学习平台连接器

本节着重介绍了配置和启用以下连接器所需的步骤：

培训数据访问

此连接器支持基于 AEM 站点或其他自定义的无头用户界面，以在学习者登录之前或之后检索培训信息并将其呈现给学习者，实现无缝的培训信息搜索。 

只有在使用基于 AEM 站点的界面或其他无头界面时，才需要使用此连接器。 

连接器将训练元数据导出到数据存储和检索解决方案以及支持搜索的系统。 因此，您可以将基于 AEM 站点的用户界面或其他自定义的无头用户界面配置为使用这两个服务来检索培训数据、呈现网页并为学习者提供优化的培训搜索功能。例如，基于 AEM 站点的非登录界面可以使用导出的元数据来帮助学习者搜索、浏览和访问显示培训信息的培训页面。 

启用此连接器以构建和呈现基于 AEM 站点的网页，并在登录前后为学习者提供自定义体验。 启用此连接器以构建和呈现基于 AEM 站点的网页，并在登录前后为学习者提供自定义体验。

• Adobe Learning Manager CDN 基本 URL - 在“培训数据访问”连接页面输入数据检索 CDN 服务路径的基本 URL。
  
• 管理员刷新令牌 - 输入您在之前部分中确定的刷新令牌。
  
• 培训元数据基本 URL — 在“培训数据访问”连接页面输入支持搜索和搜索数据检索服务路径的基本 URL。
• Adobe Learning Manager 注册 URL - 输入集成管理员为帐户生成的自注册 URL，学习者可通过该 URL 注册培训。

AEM +Adobe Learning Manager + Adobe Commerce（已登录/未登录用户）

Adobe Learning Manager 现提供解决方案，帮助您将学习平台与 Adobe Commerce 无缝集成。 此版本能够帮助您轻松地将本机、基于 AEM 站点或其他无头 Adobe Learning Manager 界面连接到 Adobe Commerce。 通过此集成，您可以在学习平台中实现电子商务功能。 您现在可以为客户和商业合作伙伴提供付费培训，还可以在本机和非本机 Adobe Learning Manager 界面上轻松购买培训内容。 学习者无需登录 Adobe Learning Manager 即可预览培训内容、访问培训信息或搜索培训。

用户可以使用现有的 AEM 应用程序并予以批准，而不是创建新的应用程序。

• Adobe Learning Manager CDN 基本 URL - 在 Adobe Commerce 连接页面输入数据检索 CDN 服务路径的基本 URL。
  
• Adobe Commerce URL - 输入您正在使用的 Adobe Commerce 实例的 URL。
  
• GraphQL 代理路径 - 客户端 Adobe Learning Manager 组件直接访问 Adobe Commerce GraphQL 端点，因此可能会发生 CORS 错误。 为了避免此错误，所有调用都必须从与 AEM 相同的端点执行，或者通过添加 CORS 标头的代理来执行。
  
• Adobe Commerce 应用商店名称 - 输入您在前面部分中确定的 Adobe Commerce 应用商店名称。
  
• Adobe Commerce 客户令牌生存期（秒）- 输入客户令牌生存期，以指明登录会话的预定时间段。
  
• 管理员刷新令牌 - 输入您在之前部分中确定的刷新令牌。

自定义网页

使用 AEM 参考站点和可用小组件自定义您的网页。

创建网页

除了参考站点包提供的模板之外，您还可以基于 AEM 中的模板创建网页。

从 Blueprint 创建站点

ALM 参考站点包提供了一个“学习站点蓝图”，可让您为学习平台创建网站。 AEM 蓝图允许您直接通过 AEM 站点组件构建网页。 您无需使用任何模板。 

为您的网站编写代码

除了使用内置模板和使用 WYSIWYG 组件从头开始创建网站之外，您还可以编写代码并构建网站。

代码位于参考站点 GitHub 存储库，助您轻松上手。

模板的主要部分包括： 

• core：包含所有核心功能（如 OSGi 服务、侦听器或调度器）以及组件相关 Java 代码（如 servlet 或请求过滤器）的 Java 包。
  
• ui.apps：包含项目的 /apps（和 /etc）部分，即 JS&CSS 客户端库、组件和模板。
  
• ui.content：包含使用 ui.apps 中的组件的示例内容
  
• ui.frontent：包含 React 组件。

所有代码都在存储库中，以便您能够正常使用。 

导入 Adobe Learning Manager 组件并将其添加到现有网页或模板

安装 AEM 参考站点包会将 Adobe Learning Manager 组件添加到 AEM 站点实例中。 默认情况下，您可以将这些组件添加到我们提供的现有网络项目（网站）学习站点中。 这些组件也可在您通过“学习站点蓝图”创建的网站中使用。

但是，如果您想将这些新添加的 Adobe Learning Manager 组件用于现有 Web 项目或网站，则应通过以下步骤导入这些组件。

以下过程让模板能够满足导入的 Adobe Learning Manager 组件的客户端库依赖关系。

包含这些组件的网页应加载这些库，以便成功呈现和使用组件。

1. 在模板页面编辑器上，单击“页面信息”，然后单击“页面策略”。
2. 在“策略”页面中，导航到“属性”>“客户端库”，并将以下内容添加到模板页面：
   1. learning.site
   2. learning.ui
   3. learning.commerce

保存此模板后，您可以在从此模板派生的所有网页中添加 Adobe Learning Manager 组件。