• Udemy Business 学习管理系统集成:xAPI 语句

    本文概括介绍 Udemy Business 通过与 LMS/LXP/LRS 等第三方系统集成的 xAPI 发送的语句来报告学员的进度和课程完成情况。

    注意:LMS/LXP 集成仅适用于 Enterprise 方案。

    授权

    支持的语句

    Udemy Business 将发送与学员的进度和课程完成情况相对应的以下动词:

    1. 进度事件
    2. 完成事件

    这些语句将在事件发生时近乎实时地发布到 LMS/LXP 系统。

    参与者

    默认情况下,xAPI 语句中的参与者将使用 mbox(即电子邮件)属性来标识。但是,一些 LMS/LXP 系统不需要电子邮件即可让学员访问其系统。因此,还支持使用帐户对象来识别参与者。但是,对于用作标识符的帐户对象,LMS/LXP 应在 SSO 握手过程中将学员的 lmsUserId 传递给 Udemy Business参阅此帮助中心文章,了解如何将 lmsUserId 配置为 SSO 的一部分。

    使用 mbox 对象标识的参与者示例: 

    mbox_object.png

    使用帐户对象标识的参与者示例: 

    account_object.png

    默认情况下我们将为其发送帐户对象作为参与者标识符的 LMS/LXP 如下:

    • 总计 LMS

    对于上面未列出的 Udemy Business xAPI 集成的 LMS/LXP,我们将默认发送 mbox 标识符。

    动词

    有进展

    进度语句将用于发送学员在课程中的进度。进度是根据完成的讲座与课程内讲座总数的比率计算的。例如,如果一门课程包含 4 个讲座,分别为 30 分钟、40 分钟、50 分钟和 60 分钟,并且学员完成了第一个讲座,那么进度将被记录为 25% (1/4)。每个讲座的持续时间将不计入进度百分比的计算。

    进度百分比将在 completion 属性设置为 false结果对象中传递,百分比通过 0 到 1 之间的量表分数表示。

    下面是一个示例进度语句

    progressed_statement.png

    已完成

    完成语句将用于发送学员的课程完成情况。与进度语句类似,完成语句将包含一个结果对象,该对象将 completion 属性设置为 true,并将量表分数设置为 1,以指示 100% 完成。

    下面是一个示例完成语句:

    completion_statement.png


    对象

    语句的对象将是课程类型,并且活动的 ID 将设置为课程 URL 以唯一标识课程对象。以下是作为对象传递的 Udemy Business 课程示例:

    ub_course_passed_as_an_object.png

    注意:为将对象的活动 ID 从 xAPI 语句引用到课程 API 有效负载中的适当课程,向课程 API 添加了一个新属性 xapi_activity_id

    错误处理 - 重试逻辑

    当向 LMS/LXP 发送事件失败时,Udemy Business 将在 5 天内每天重试任何失败的语句两次。

    阅读文章