本文概述了 Udemy Business 向第三方 LMS/LXP 发送的 xAPI 进度和完成语句。
- 要了解如何配置集成，请查看 Udemy Business 集成：xAPI。
注意：LMS/LXP 集成仅适用于 Enterprise 方案。
授权
支持的语句
Udemy Business 将发送以下动词：
课程语句：
- 进度事件：跟踪学习者在特定课程中的学习进度。
- 完成事件：记录学习者完成课程的情况。
学习路径语句：
- 进度事件：获取学习者在指定学习路径中学习一系列学习内容的进度。
- 完成事件：表示学习者已完成学习路径中的所有学习内容。
所有这些 xAPI 语句都会在事件发生时近乎实时地传输到 LMS/LXP 系统，确保及时更新学习者的活动和成就。
请注意，学习路径可以包括各种类型的内容，其中一些包括 Udemy 课程、自定义课程、Udemy 课程的部分内容、文章链接、外部视频、播客、Wiki 页面等。对于包含 Udemy Business Pro 的帐户，还可以在学习路径中添加评估或实验。
参与者
默认情况下，xAPI 语句中的参与者将使用 mbox（即电子邮件）属性来标识。但是，一些 LMS/LXP 系统不需要电子邮件即可让学员访问其系统。因此，还支持使用帐户对象来识别参与者。但是，对于用作标识符的帐户对象，LMS/LXP 应在 SSO 握手过程中将学习者的 lmsUserID 传递给 Udemy Business。请参阅此帮助中心文章，了解如何将 lmsUserID 配置为 SSO 的一部分。
使用 mbox 对象标识的参与者示例：
使用帐户对象标识的参与者示例：
默认情况下我们将为其发送帐户对象作为参与者标识符的 LMS/LXP 如下：
- 总计 LMS
对于上面未列出的集成了 Udemy Business xAPI 的 LMS/LXP，Udemy 默认会发送 mbox 标识符。
动词
课程语句
有进展
进度语句将用于发送学员在课程中的进度。进度是根据完成的讲座与课程内讲座总数的比率计算的。例如，如果一门课程包含 4 个讲座，时长分别为 30 分钟、40 分钟、50 分钟和 60 分钟，而学习者完成了第一个讲座，那么进度将记录为 25% (1/4)。每个讲座的持续时间将不计入进度百分比的计算。
进度百分比将在 completion 属性设置为 false 的结果对象中传递，百分比通过 0 到 1 之间的量表分数表示。
下面是一个课程进度语句示例：
已完成
完成语句将用于发送学员的课程完成情况。与进度语句类似，完成语句将包含一个结果对象，该对象将完成属性设置为 true，并将量表分数设置为 1，以指示 100% 完成。
下面是一个课程完成语句示例：
学习路径语句
有进展
进度语句将用于发送学习者在学习路径中的进度。进度是根据已完成的学习内容与学习路径中学习内容总数的比率来计算的。例如，如果学习路径包含 5 门课程、2 个链接和 3 个课程部分，学习者完成了 3 门课程和 2 个链接，则进度将记录为 50% (5/10)。在计算进度百分比时，不会计入每个内容的持续时间。
进度百分比将在结果对象中传递，完成属性设置为 false，百分比在扩展对象中以 0 到 100 之间的量表分数表示。
下面是一个学习路径进度语句示例：
已完成
完成语句将用于发送学习者完成学习路径的情况。与进度语句类似，完成语句将包含一个结果对象，该对象将完成属性设置为 true，并将量表分数设置为 100，以指示完成。
下面是一个学习路径完成语句示例：
对象
课程对象
语句的对象将是课程类型，并且活动的 ID 将设置为课程 URL，以唯一标识课程对象。以下是作为对象传递的 UB 课程示例：
学习路径对象
语句的对象将是系列类型，并且活动的 ID 将设置为学习路径 URL，以唯一标识学习路径对象。以下是作为对象传递的 UB 学习路径示例：
对于 SumTotal LMS/LXP 集成，ID 字段以组织的子域信息开头，即 sumtotaldemo，如以下示例所示。
语句的对象将是课程类型，并且活动的 ID 将设置为课程 URL，以唯一标识课程对象。以下是作为对象传递的 Udemy Business 课程示例：
注意：为将对象的活动 ID 从 xAPI 语句引用到课程 API 有效负载中的适当课程，向课程 API 添加了一个新属性 xapi_activity_id。
注意：SuccessFactors 和 Cornerstone OnDemand 集成的 xAPI 语句将与上面提供的示例有所不同。
错误处理 - 重试逻辑
当向 LMS/LXP 发送事件失败时，Udemy Business 将在 5 天内每天重试任何失败的语句两次。