Resumen
La integración de xAPI permite que KnowledgeCity reenvíe la actividad de aprendizaje a un Learning Record Store (LRS) externo a medida que ocurre. Mediante el manejador de xAPI saliente, KnowledgeCity construye y envía declaraciones (statements) xAPI para eventos de aprendizaje clave, de modo que su sistema de informes reciba un registro en vivo del progreso de los alumnos. Este artículo explica cómo habilitar xAPI, dirigirlo a su LRS, proteger la conexión y elegir qué eventos se envían.
Introducción
xAPI (también conocido como Tin Can) es un estándar para describir experiencias de aprendizaje como declaraciones y entregarlas a un Learning Record Store. En KnowledgeCity, el manejador de xAPI saliente vigila los eventos de aprendizaje, traduce cada uno a una declaración xAPI, y la publica en el LRS que usted configura. Esto mantiene sincronizado un sistema externo de análisis o cumplimiento con lo que los alumnos realmente hacen dentro de la plataforma.
Esta configuración la gestionan Super Admins y administradores responsables de conectar KnowledgeCity con sistemas de informes externos. Es útil cuando su organización consolida datos de aprendizaje de múltiples fuentes en un solo LRS, o necesita un registro duradero y basado en estándares de la actividad de los alumnos fuera de KnowledgeCity.
Conceptos clave
- xAPI statement (declaración xAPI): un registro estandarizado de un único evento de aprendizaje, que describe al alumno (actor), la acción (verbo), y el elemento sobre el que se actúa (objeto), que KnowledgeCity envía a su LRS.
- Learning Record Store (LRS): el sistema externo que recibe y almacena las declaraciones que envía KnowledgeCity, para que pueda generar informes sobre la actividad allí.
- LRS host: la dirección del endpoint de su LRS donde KnowledgeCity publica las declaraciones.
- Bearer authentication (autenticación Bearer): una opción que autentica cada solicitud al LRS con un token bearer proporcionado por su proveedor de LRS.
- Basic authentication (autenticación básica): una opción que autentica cada solicitud usando un par de nombre de usuario y contraseña emitido por su LRS.
- Custom headers (encabezados personalizados): encabezados de solicitud adicionales que puede agregar para que KnowledgeCity incluya cualquier valor extra que requiera su LRS en cada llamada.
- Event mapping (asignación de eventos): la selección que controla qué eventos de aprendizaje se convierten en declaraciones, abarcando Registered, Attempted, Completed, Passed, Progress e Initialized.
Pasos a seguir
Abrir la página de Integrations
Inicie sesión como Super Admin, abra el menú Settings en el panel superior de la interfaz, y seleccione Integrations. Esto abre la página de detalles de Integrations, donde las conexiones a sistemas externos están agrupadas en secciones.
Habilitar xAPI
Localice la configuración de xAPI y active la opción Enable. Habilitar xAPI activa el manejador saliente para que, a partir de este momento, los eventos de aprendizaje sean elegibles para enviarse a su LRS.
Configurar el host del LRS
En el campo LRS host, introduzca la dirección del endpoint de su Learning Record Store. KnowledgeCity publica cada declaración xAPI en esta dirección, así que confirme el valor con su proveedor de LRS antes de depender de la conexión.
Elegir un método de autenticación
Seleccione cómo debe autenticarse KnowledgeCity ante su LRS:
- Elija Bearer y proporcione el token bearer suministrado por su LRS.
- Elija Basic y proporcione el nombre de usuario y la contraseña emitidos por su LRS.
Use el método que especifique su proveedor de LRS, y trate el token, el nombre de usuario y la contraseña como secretos que no deben compartirse públicamente.
Agregar encabezados personalizados
Si su LRS requiere valores adicionales en cada solicitud, agréguelos como custom headers. Para cada encabezado, proporcione su nombre y valor. KnowledgeCity incluye estos encabezados en cada declaración que envía, junto con la autenticación que configuró.
Asignar qué eventos se envían
Elija qué eventos de aprendizaje convierte KnowledgeCity en declaraciones. El manejador puede enviar declaraciones para los siguientes eventos:
- Registered: el alumno se registra para un elemento de aprendizaje.
- Initialized: el alumno inicia un elemento de aprendizaje.
- Attempted: el alumno realiza un intento en un elemento de aprendizaje.
- Progress: el alumno avanza en un elemento de aprendizaje.
- Completed: el alumno termina un elemento de aprendizaje.
- Passed: el alumno cumple los criterios de aprobación de un elemento de aprendizaje.
Seleccione solo los eventos que necesita su sistema de informes, para que el LRS reciba las declaraciones que importan y no se llene con actividad que no rastrea.
Guardar y verificar
Guarde su configuración. Después de guardar, genere la actividad de aprendizaje relevante y confirme que las declaraciones correspondientes lleguen a su LRS. Si las declaraciones no aparecen, vuelva a verificar el host del LRS, los valores de autenticación y cualquier encabezado personalizado requerido.
Conclusión
Configurar la integración de xAPI conecta directamente a KnowledgeCity con su Learning Record Store, de modo que los eventos de registro, inicio, intentos, progreso, finalización y aprobación fluyen hacia afuera como declaraciones estandarizadas mientras los alumnos trabajan. Al habilitar xAPI, configurar el host del LRS, proteger la conexión con autenticación Bearer o Basic y cualquier encabezado personalizado, y asignar los eventos que le importan, le da a su sistema de informes externo una vista confiable y en tiempo real de la actividad de aprendizaje.