Errores al matricular en Moodle

Los siguientes errores se originan en la plataforma de destino (Moodle) o en el servidor, por lo que su solución depende de tu proveedor técnico. Aquí te explicamos cómo identificarlos.

1. "La respuesta de URL no tiene el formato esperado (json)"

Si al intentar conectar recibes este mensaje exacto, es importante que sepas que la petición ha salido correctamente de Gesforma, pero el Moodle de destino no ha devuelto una respuesta válida. 

Posibles causas y soluciones:
1. Error en la URL (Causa más frecuente): La dirección web introducida no es válida, contiene espacios o lleva a una página de error (404).
Solución: revisa la URL que está indicada en la Acción en el apartado "Teleformación" y en caso contrario la ficha del Proveedor en el apartado "Moodle"

2. Bloqueo o Fallo en el Moodle: El servidor de tu Moodle está rechazando la conexión o está caído. 

Solución: Contacta con tu proveedor de Moodle e indícale que su plataforma no está devolviendo un formato JSON válido.

2. Error Genérico: "Error Moodle..." "Debuginfo Moodle"

Si recibes un mensaje que comienza con "Error Moodle" o contiene "Debuginfo Moodle"seguido de una descripción técnica o texto en inglés, significa que la plataforma de destino ha rechazado la conexión por un problema interno (servidor caído, mantenimiento o bloqueo de seguridad).
Solución 

Haz una captura de pantalla del mensaje completo. y envíasela a tu proveedor de Moodle indicando: "La integración está intentando conectar, pero vuestro servidor devuelve este error específico."

3. Error Específico: "invalidrecord... external_functions"

Este error indica que a tu Moodle le falta activar un permiso específico para permitir la lectura de datos (como el progreso de los alumnos). No es un error de conexión, sino de permisos faltantes en la configuración de Moodle.

Solución: 

Copia y pega el mensaje técnico a tu proveedor de Moodle para que sepan exactamente qué activar. Por ejemplo:

"Por favor, revisad los permisos del Web Service. Necesitamos que habilitéis la función externa llamada: block_configurable_reports_get_usercompletion para poder sincronizar el seguimiento."

4. Error Moodle al matricular supervisor: wsusercannotassign y Only enrolled users may be members of groups

Al matricular un grupo desde Gesforma a Moodle, el sistema no matricula al supervisor/inspector automáticamente. En Gesforma puede aparecer el error genérico: "Only enrolled users may be members of groups".

Diagnóstico (Cómo detectarlo): Este error genérico suele ocultar un problema de permisos en Moodle. Para confirmarlo, el cliente debe habilitar temporalmente la depuración de errores en su Moodle y volver a intentar el volcado. Si el log de Moodle devuelve el siguiente mensaje:

Error Moodle: wsusercannotassign. No tiene permisos para asignar el rol ([ID del rol]) a este usuario ([ID del usuario]) en este curso ([ID del curso]). ...entonces hemos identificado la causa raíz.

Causa Raíz: El usuario del Webservice (el token que Moodle usa para conectarse con Gesforma) no tiene los permisos suficientes en su servidor para asignar el rol de inspector/supervisor dentro de los cursos. Al fallar la asignación de este rol, el sistema aborta la matriculación en el grupo (generando el segundo error de que "solo los usuarios matriculados pueden estar en grupos").

Solución (Acción requerida por el cliente): El fallo no reside en Gesforma. El cliente debe contactar con su administrador de Moodle o soporte informático y facilitarles el mensaje de error exacto (wsusercannotassign). El administrador de Moodle deberá:

1. Revisar los permisos del usuario asociado al token del Webservice.

2. Otorgarle capacidad explícita para asignar roles (específicamente el rol del inspector) a nivel de curso/categoría.