文档Learning Manager

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

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 -Cloud Service
  • Adobe Commerce 2.4.3

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

引用站点包托管在​ GitHub存储库 上。

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

在Adobe Learning Manager中创建应用程序

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

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

请按以下步骤操作：

  1. 以集成管理员身份单击​ “应用程序”。

  2. 要创建新应用程序，在页面右上角，单击​ “注册”。

  3. 在“注册新应用程序”界面中，输入以下详细信息：

    1. 应用程序名称：正在创建的应用程序的名称。
    2. URL：组织的 URL。
    3. 重定向域：AEM 网站的托管域。 您还可以指定通配符。
    4. 描述：应用程序的描述。
    5. 范围：选择“学习者”角色的读取访问权限和“学习者”角色的写入权限。
    6. 是否仅针对此帐户：如果要将应用程序用于现有 ALM 帐户，请选择“是”。

  4. 完成更改后，单击“保存”。

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


应用程序凭据

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

获取令牌

  1. 在“开发人员资源”选项卡中，单击​ 用于测试和开发的访问令牌。

    选择用于测试和开发的访问令牌

  2. 输入以下详细信息：


    输入令牌详细信息

    1. 获取 OAuth 代码：输入上一部分的客户端 ID 并更改范围。 单击“提交”以获取Oauth代码。
    2. 获取刷新令牌：输入上一部分中的客户端 ID 和密钥。 此外，请输入上一个步骤中获取的 OAuth 代码。 单击“提交”。
    3. 获取访问令牌：输入上一部分中的客户端 ID 和密钥。 此外，请输入上一个步骤中获得的刷新令牌。 单击“提交”。
    4. 获取访问令牌详细信息：输入上一个步骤中获得的访问令牌。 单击“提交”。

  3. 您可以从随后的 JSON 响应中获取详细信息。 响应由访问令牌、刷新令牌、用户角色、帐户 ID、用户 ID 和到期时间组成。 请注意刷新令牌，因为您将重复使用该令牌。

在AEM中配置ALM帐户

  1. 启动 AEM 实例。

  2. 单击“设置”>“Cloud Service”。

  3. 单击“Adobe Learning Manager配置”。


    选择Adobe Learning Manager配置

  4. 单击“创建”>“配置文件夹”。 为您的文件夹命名。


    创建配置

  5. 在学习项目中，选择您创建的配置。

  6. 输入配置的详细信息。


    创建配置文件夹

    1. Adobe Learning Manager模式：选择您希望如何为已登录和未登录的学习者提供学习体验。
    2. Adobe Learning Manager URL：输入托管学习服务的ALM实例的URL。
    3. 帐户ID：ALM帐户的ID。
    4. 客户端ID、客户端密钥和作者刷新令牌：输入在ALM中创建应用程序时获得的凭据。
    5. 小组件的自定义：有关更多信息，请参阅与AEM集成 .

  7. 保存并关闭配置。

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

自定义网页

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

  1. 启动 AEM 实例。

  2. 单击“站点”并打开配置页面。

  3. 单击​ 学习站点 > 语言管理器 > 英语。 项目中的所有网页都包含在该文件夹中。


    查看所有网页

  4. 选择任意模板并单击​ 编辑。

  5. 在页面上，单击组件设置按钮并更改组件的属性。


    “选择设置”按钮

  6. 预览更改或者您可以发布页面。

创建网页

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

  1. 在AEM主页面上，单击“创建”>“页面”。

  2. 选择要自定义的模板。 单击“下一步”。

  3. 输入页面属性。


    页面属性

  4. 要创建页面，请单击​ 创建。

  5. 选择新页面，然后单击​ 编辑。

  6. 在页面上插入组件，例如，学习 — 内容。


    按站点筛选

  7. 选择将在页面上显示的所需目录过滤器。

从 Blueprint 创建站点

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

  1. 在AEM起始页上，单击​ 站点。

  2. 单击​ 创建 > 站点。

  3. 单击“学习站点蓝图”。

    从Blueprint创建站点

  4. 单击“下一步”。

  5. 在属性页面上，输入页面元数据。 单击“创建”。


    选择学习站点蓝图

  6. 单击“主页”超链接即可导航至您创建的站点主页。 在此页面上，您可以自定义小组件和目录组件。

为您的网站编写代码

除了使用内置模板和使用 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 项目或网站，则应通过以下步骤导入这些组件。

  1. 安装ALM参考站点包。

  2. 打开 Web 项目并导航至 HTML 文件（适用于要在其中添加 Adobe Learning Manager 组件的网页或网页模板）。

  3. 加入会议

    打开 HTML 文件并将以下代码片段添加到页面组件，以便在呈现页面中存在的学习组件之前执行代码。

    <sly data-sly-use.configModel="com.adobe.learning.core.models.GlobalConfigurationModel"/>
    <meta name="cp-config" content="${configModel.config}" />

    上面的代码将映射的配置添加到页面的 meta 标签中，这是呈现学习组件所必需的。 有关更多详细信息，请参阅Adobe Learning Manager引用字符串。

  4. 确保已将配置映射到Web项目。

  5. 打开要导入AEM Sites组件的Learning Manager模板。

  6. 在模板页面编辑器中，导航至“允许的组件”容器并选择​ “策略”。

  7. 在“策略”页面中，导航至“属性”>“允许的组件”，然后选择以下组件：“学习 - 内容”、“学习 - 表单”和“学习 - 结构”

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

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

  1. 在模板页面编辑器上，单击“页面信息”，然后单击“页面策略”。

  2. 在“策略”页面中，导航到“属性”>“客户端库”，并将以下内容添加到模板页面：

    1. learning.site
    2. learning.ui
    3. learning.commerce

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

recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d