Adobe Learning Manager 中的 xAPI

什么是 xAPI?

Experience API (xAPI) 是一种在线学习软件规范,允许学习内容和学习系统互动,以记录和跟踪所有类型的学习体验。 学习体验会记录于学习记录存储 (LRS) 中。 LRS 既可以存在于传统的学习管理系统 (LMS) 中,也可以独立存在。

有关 xAPI 的更多信息, 请参阅:  https://github.com/adlnet/xAPI-Spec

Adobe Learning Manager 如何支持 xAPI?

Adobe Learning Manager 内置 LRS。该 LRS 能够完全接受来自 Adobe Learning Manager 中托管内容的 xAPI 语句。甚至接受第三方生成的 xAPI 语句。 这些 xAPI 语句存储在 Adobe Learning Manager 中,并可导出到 Adobe Learning Manager 外部,以可视化方式存储到任何第三方数据仓库系统中。

何时使用 xAPI?

如果您迫切需要捕获不同系统之间最终用户的学习体验,  或者需要跟踪学习者对培训内容的确切参与情况,那么您可以用到 xAPI。 xAPI 不仅仅包含“开始”、“进行中”和“完成”等属性(仅仅是 SCORM 捕获的属性)。

在 Adobe Learning Manager 中使用 xAPI

设置应用程序

  1. 以集成管理员身份登录。选择“应用程序”>“注册”

    应用程序注册
    应用程序注册

  2. 注册新应用程序。

    创建应用程序
    创建应用程序

  3. 定义应用程序的范围。

    • 如果启用管理员角色 xAPI 读写权限,则管理员可以发布和获取 xAPI 语句和文档。
    • 如果启用学习者角色 xAPI 读写权限,则学习者可以发布和获取 xAPI 语句和文档。
  4. 保存更改。您会获得开发人员 ID 和密钥。

端点

单击下方链接查看 xAPI Swagger 文档:

https://learningmanagereu.adobe.com/docs/learningmanagerapi/xapi/

注意:Adobe Learning Manager 支持的 xAPI 版本为 1.0.3。

API 身份验证

Adobe Learning Manager xAPI 使用 OAuth 2.0 框架对客户端应用程序进行身份验证和授权。 注册应用程序后,便可获取 clientId 和 clientSecret。 Get URL 会使用 Adobe Learning Manager 用户预配置的帐户(如 SSO、Adobe ID)对其进行身份验证,因此可在浏览器中使用。 

GET https://learningmanager.adobe.com/oauth/o/authorize?client_id=<输入 clientId>&redirect_uri=<输入要重定向到的 URL>&state=<任意字符串数据>&scope=<admin:xapi 或 learner:xapi>&response_type=CODE。

将 xAPI 语句作为 Adobe Learning Manager 学习对象进行跟踪

作者现在可以在创建课程时选择 xAPI 模块,以监控 Adobe Learning Manager 以外的用户体验。例如,您可以使用此功能评估用于第三方课程消费平台上的用户活动。

  1. 创建“活动模块”时,请从“类型”选项的弹出菜单中选择“基于 xAPI 的模块”。

    创建基于 xAPI 的模块
    创建基于 xAPI 的模块

  2. 您需要提供 IRI。 如果未提供,Adobe Learning Manager 会自动生成一个。

    注意:

    活动对应的 IRI 在帐户中具有唯一性, 即在 Adobe Learning Manager 中,两个模块不能具有相同的 IRI。 下列情况会生成新的 IRI:

    • 在不同帐户之间共享具有 xAPI 模块的课程。
    • 再次出现具有 xAPI 模块的认证

     

    任何具有上述 IRI 的 xAPI 语句均会在以上模块中被跟踪,并反映在 Adobe Learning Manager 报告中。 

  3. 若要复制自动生成的 IRI,请重新访问“活动模块”页面。

  4. 发布模块。

注意事项:

  • Adobe Learning Manager 当前仅支持将 mbox 用作标识符。 不支持其他标识符,如 mboz_sha1、openid 和 account。
  • 在 Adobe Learning Manager 中使用时,stateId 和 profileId 为 UUID。
  • PUT 请求不会覆盖 xAPI 代理/配置文件、活动/配置文件以及活动/状态的文档
  • Actor中不支持身份不明的组。
  • GET 语句不支持“related_activities”参数。
  • GET 语句不支持“format=ids”和“format=canonical”参数。
  • 即便 xAPI 语句作废,也不会撤销发布该语句时在 Adobe Learning Manager 中执行的任何操作。

生成报告

生成的 xAPI 报告可以是 Excel 格式。 以管理员身份打开“报告”>“Excel 报告”>“xAPI 活动报告”

下载的报告中包含学习者和管理员针对所有语句发布的全部信息。

可以使用 FTP 和 Box 连接器为任何第三方集成生成或计划相同的报告 请执行以下步骤:

以集成管理员身份登录>打开 FTP/Box 连接器>从左侧窗格中选择“xAPI 活动报告”>选择计划/生成报告。

计划报告
计划报告

注意:
  • xAPI 语句中仅发送原始分数,而不发送最高分数时,测试分数不会在 LT 中显示。
  • 要在 Adobe Learning Manager 中获取百分比分数,可通过 xAPI 发送换算分数。

示例报告

下载

Adobe, Inc.

更快、更轻松地获得帮助

新用户?