En este artículo se describen las sentencias de progreso y contenido completado de xAPI que Udemy Business envía a los sistemas LMS/LXP de terceros.
- Para obtener información sobre cómo configurar la integración, consulta el artículo Integración del sistema de gestión del aprendizaje de Udemy Business: xAPI.
Nota: La integración de LMS/LXP solo está disponible con el Plan Enterprise.
Autorización
Sentencias admitidas
Udemy Business enviará los siguientes verbos:
Sentencias de cursos:
- Evento de progreso: hace un seguimiento del progreso del estudiante en un curso concreto.
- Evento de contenido completado: registra que el estudiante ha completado un curso.
Sentencias de vías de aprendizaje:
- Evento de progreso: captura el progreso del estudiante en una serie de elementos de contenido de aprendizaje como parte de una vía de aprendizaje designada.
- Evento de contenido completado: indica que el estudiante ha completado todo el contenido de aprendizaje de una vía de aprendizaje.
Todas estas sentencias de xAPI se transmiten al LMS/LXP casi en tiempo real a medida que los eventos van sucediendo, lo que garantiza unas actualizaciones oportunas sobre las actividades y los logros de los estudiantes.
Ten en cuenta que las vías de aprendizaje pueden incluir diversos tipos de contenido, entre los que se incluyen los siguientes: cursos de Udemy, cursos personalizados, porciones de cursos de Udemy, enlaces a artículos, vídeos externos, pódcasts, páginas de wikis, etc. Las cuentas que incluyan Udemy Business Pro también pueden añadir una evaluación o un laboratorio a la vía de aprendizaje.
Actor
Por defecto, el actor de la sentencia de xAPI se identificará mediante la propiedad de mbox (es decir, el correo electrónico). Sin embargo, algunos LMS/LXP no requieren que los estudiantes accedan mediante el correo electrónico. Por tanto, también se admite la identificación del actor a través de un objeto de cuenta. No obstante, para que el objeto de cuenta se utilice como identificador, el LMS/LXP debe proporcionar un lmsUserID del estudiante a Udemy Business como parte del protocolo de SSO. Consulta este artículo del centro de asistencia sobre la configuración de lmsUserID en el marco del SSO.
Ejemplo de un actor identificado mediante el objeto de mbox:
Ejemplo de un actor identificado mediante el objeto de cuenta:
Enviaremos un objeto de cuenta como identificador de actor por defecto a los siguientes LMS/LXP:
- LMS de SumTotal
Para los LMS/LXP integrados en xAPI de Udemy Business que no se indiquen en la lista anterior, Udemy enviará el identificador de mbox por defecto.
Verbo
Sentencias de cursos
Progreso
La sentencia de progreso se utilizará para enviar el progreso del estudiante en un curso. El progreso se calcula según la proporción de clases completadas con respecto al número total de clases del curso. Por ejemplo, si un curso tiene 4 clases de 30, 40, 50 y 60 minutos respectivamente, y el estudiante completa la primera clase, el progreso se registrará como el 25 % (1/4). La duración de las clases no se tendrá en cuenta para calcular el porcentaje de progreso.
El porcentaje de progreso se indicará en el objeto de result (resultado) con el atributo de completion (contenidos completados) fijado en false (falso) y se representará como una scaled score (puntuación en escala) entre 0 y 1.
A continuación se muestra un ejemplo de sentencia de progreso:
Contenido completado
La sentencia de contenidos completados se utilizará para informar de que el estudiante ha completado el curso. Al igual que la sentencia de progreso, la sentencia de contenido completado constará de un objeto de result (resultado) que tendrá el atributo de completion (contenido completado) fijado en true (verdadero) y la scaled score (puntuación en escala) fijada en 1 para indicar que el contenido se ha completado al 100 %.
A continuación se muestra un ejemplo de sentencia de contenidos completados:
Sentencias de vías de aprendizaje
Progreso
La sentencia de progreso se utilizará para enviar el progreso del estudiante en una vía de aprendizaje. El progreso se calcula según la proporción de contenido de aprendizaje completado con respecto al número total de elementos de contenido de aprendizaje en la vía de aprendizaje. Por ejemplo, si una vía de aprendizaje tiene 5 cursos, 2 enlaces y 3 porciones de cursos, y el estudiante completa 3 cursos y 2 enlaces, el progreso se registrará como al 50 % (5/10). La duración de cada elemento de contenido no se tendrá en cuenta para calcular el porcentaje de progreso.
El porcentaje de progreso se indicará en el objeto de result (resultado) con el atributo de completion (contenido completado) fijado en false (falso), y se representará en los objetos de extensions (extensiones) como una scaled score (puntuación en escala) entre 0 y 100.
A continuación se muestra un ejemplo de sentencia de progreso:
Contenido completado
La sentencia de contenido completado se utilizará para informar de que el estudiante ha completado la vía de aprendizaje. Al igual que la sentencia de progreso, la sentencia de contenido completado constará de un objeto de result (resultado) que tendrá el atributo de completion (contenido completado) fijado en true (verdadero) y la scaled score (puntuación en escala) fijada en 100 para indicar que el contenido se ha completado.
A continuación se muestra un ejemplo de sentencia de contenidos completados:
Objeto
Objeto de curso
El objeto de la sentencia será de tipo Course (curso) y el ID de la actividad se fijará a la URL del curso para identificar de forma única un objeto de curso. A continuación se muestra un ejemplo de un curso de Udemy Business transmitido como un objeto:
Objeto de vía de aprendizaje
El objeto de la sentencia será de tipo Collection (colección) y el ID de la actividad se fijará a la URL de la vía de aprendizaje para identificar de forma única un objeto de vía de aprendizaje. A continuación se muestra un ejemplo de una vía de aprendizaje de Udemy Business transmitida como un objeto:
Para la integración del LMS/LXP SumTotal, el campo ID comienza con la información sobre el subdominio de la organización, que es sumtotaldemo como se puede ver en el siguiente ejemplo.
El objeto de la sentencia será de tipo Course (curso) y el ID de la actividad se fijará a la URL del curso para identificar de forma única un objeto de curso. A continuación se muestra un ejemplo de un curso de Udemy Business transmitido como un objeto:
Nota: Para establecer una referencia del ID de la actividad del objeto desde la sentencia de xAPI al curso apropiado en la carga de la API del curso, se ha añadido el atributo xapi_activity_id a la API del curso.
Control de errores: lógica de reintento
Si se produce un error al enviar el evento al LMS/LXP, Udemy Business volverá a intentar enviar las sentencias fallidas dos veces al día durante 5 días.