Progreso Académico y Badges
Seguimiento Académico y Certificados MoodleManagement v1.1 permite consultar el progreso académico de los alumnos y registrar los badges (certificados/insignias) que obtienen en Moodle, todo desde FacturaScripts.
Progreso Académico La pestaña "Progreso Académico" en la ficha de cada usuario mapeado muestra en tiempo real los datos de avance del alumno en todos sus cursos.
Para consultar el progreso:
- Vaya a Gestión Moodle > Usuarios Moodle
- Abra la ficha de un usuario
- Haga clic en la pestaña "Progreso Académico" La información se obtiene en tiempo real de Moodle (no se almacena localmente), por lo que siempre muestra el estado actual.
Para cada curso en el que el alumno está matriculado se muestra:
- Nombre del curso
- Porcentaje de completitud: barra de progreso visual con el porcentaje numérico. Se calcula a partir de las actividades que tienen tracking de completion habilitado en Moodle.
- Calificación: nota obtenida en el gradebook del curso. Se muestra la calificación final del curso si está disponible.
- Actividades completadas: número de actividades marcadas como completadas respecto al total de actividades con tracking.
- Último acceso: fecha y hora del último acceso del alumno al curso.
Requisitos en Moodle:
- El tracking de completion debe estar habilitado a nivel de sitio: Administración del sitio > General > Funciones avanzadas > Habilitar rastreo de finalización.
- Cada curso que quiera trackear debe tener el seguimiento de finalización activado en su configuración.
- Las actividades deben tener condiciones de finalización configuradas para que cuenten en el porcentaje.
- El gradebook debe estar activo para que se muestren calificaciones.
Funciones WS necesarias (deben estar agregadas al servicio):
- core_completion_get_course_completion_status
- core_completion_get_activities_completion_status
- gradereport_user_get_grade_items Si un curso no tiene tracking de completion habilitado, la columna de progreso mostrará "No disponible". Si no tiene gradebook configurado, la columna de calificación estará vacía.
Badges y Certificados Los badges (insignias) de Moodle son reconocimientos que se otorgan a los alumnos por cumplir ciertos criterios: completar un curso, obtener una calificación mínima, completar actividades específicas, etc.
MoodleManagement v1.1 introduce un modelo para almacenar estos badges en FacturaScripts, permitiendo consultarlos, vincularlos con facturas y llevar un registro histórico.
Qué se almacena de cada badge Cada badge registrado en FacturaScripts incluye:
- Nombre del badge
- Descripción
- Curso asociado (si el badge está vinculado a un curso)
- Fecha de emisión: cuándo se le otorgó al alumno
- Fecha de expiración: si el badge tiene caducidad
- Hash único: identificador único del badge emitido (permite verificar autenticidad)
- URL del badge: enlace a la página del badge en Moodle
- URL de la imagen: imagen/icono del badge
- Vinculación con factura: posibilidad de asociar el badge con una factura de FS
Sincronización automática Cada vez que se guarda un registro de mapeo de usuario (MoodleUserMap), el sistema sincroniza automáticamente los badges de ese usuario. Esto ocurre mediante un worker que:
- Detecta el evento de guardado
- Consulta a Moodle los badges del usuario vía la API (core_badges_get_user_badges)
- Compara con los badges ya registrados en FS usando el hash único
- Crea nuevos registros para badges no existentes
- Actualiza los existentes si han cambiado (ej: nueva fecha de expiración) Esto significa que los badges se actualizan de forma transparente conforme se interactúa con los usuarios, sin intervención manual.
Sincronización manual Además de la sincronización automática, existen dos formas de sincronizar manualmente: Desde la ficha de un usuario:
- Abra la ficha de un usuario mapeado
- Haga clic en el botón "Sincronizar Badges"
- El sistema consulta y actualiza los badges de ese usuario
Sincronización masiva:
- Vaya a Gestión Moodle > Certificados
- Haga clic en "Sincronizar Todo"
- El sistema itera todas las instancias Moodle activas y todos los usuarios mapeados
- Sincroniza los badges de cada usuario
- Este proceso puede tardar dependiendo del número de usuarios y la velocidad de la API
Consultar badges Listado global:
- Vaya a Gestión Moodle > Certificados
- Se muestra la lista de todos los badges registrados
- Filtros disponibles: por contacto, por instancia Moodle
Badges de un usuario:
- Abra la ficha de un usuario mapeado
- La pestaña de certificados muestra los badges de ese usuario específico
Detalle de un badge:
- Haga clic en un badge del listado
- Se muestra toda la información: nombre, descripción, curso, fechas, imagen, URLs, hash
Requisitos Funciones WS necesarias:
- core_badges_get_user_badges En Moodle, los badges deben estar habilitados: Administración del sitio > General > Funciones avanzadas > Habilitar insignias.