Si administras o gestionas proyectos de formación en plataformas Moodle, seguro que hay una tarea con la que te peleas casi a diario: la matriculación y gestión de usuarios. Si necesitas subir a tres personas, crear sus cuentas a mano desde la administración del sitio no supone ningún drama. Pero, ¿qué pasa cuando tienes que arrancar una formación con 300 o 500 alumnos de golpe? Es en ese momento cuando el archivo CSV se convierte en tu mayor salvavidas y, a veces, en tu mayor dolor de cabeza.
En este artículo descubrirás que, con una buena plantilla y conociendo los trucos del sistema, gestionar a cientos de alumnos te llevará apenas unos minutos,y si te interesa aquí te dejamos el webinar donde explicamos todo al detalle.
Un archivo CSV (Valores Separados por Comas) no es más que un archivo de datos plano. Su principal objetivo es inyectar una serie de datos directamente en la base de datos de Moodle de forma simultánea. La gran ventaja de dominar este formato es que te ahorra horas de trabajo manual, permitiéndote ejecutar múltiples pasos a la vez: desde crear cuentas de usuario hasta matricularlos en cursos específicos y asignarlos a diferentes grupos.
Para empezar a trabajar, solo necesitas una herramienta de hojas de cálculo como Microsoft Excel, OpenOffice o Google Sheets.
Para que tu archivo funcione, necesitas entender el proceso nativo de creación de un usuario. La primera fila de tu hoja de cálculo debe contener los nombres de los campos (encabezados) en inglés y estrictamente en minúsculas. Los mínimos imprescindibles para crear un usuario son:
username: El nombre de usuario que utilizará la persona para acceder al sistema.
firstname: El nombre de pila del alumno.
lastname: Los apellidos.
email: El correo electrónico. Es vital que sea correcto, ya que Moodle lo utiliza junto con el username para reconocer a los usuarios y no duplicarlos.
password: La contraseña del usuario. Consejo pro: Este campo es opcional. Si lo omites o no proporcionas una contraseña, puedes configurar la subida para que sea el propio Moodle quien genere y envíe las claves por correo electrónico a los usuarios de nueva creación.
El verdadero poder del CSV brilla cuando automatizas las matrículas y la organización de tu alumnado:
Cursos (course1) Para añadir a un estudiante directamente a una formación, utiliza el campo course1. El valor que debes introducir aquí no es el título largo del curso, sino su "nombre corto" (short name), el cual funciona como un ID único que identifica al curso dentro de toda la plataforma. Si quisieras matricular en más cursos, simplemente añadirías columnas como course2, course3, etc..
Grupos (group1) Si dentro de tu curso tienes a los alumnos divididos, usa la columna group1. Un error frecuente es intentar numerar los grupos en el encabezado (ej. group2, group3) para distintos alumnos del mismo curso. La forma correcta es usar group1 (porque hace referencia al course1) y, en las filas de los alumnos, escribir el nombre del grupo exacto al que van destinados (por ejemplo, "Grupo 1", "Grupo A").
Cohortes (cohort1) Las cohortes son agrupaciones a nivel global del sitio (ideales para agrupar a todos los empleados de una empresa o proyecto). Usando el campo cohort1, debes introducir el ID de la cohorte. Lo mejor de todo es que, si la cohorte no existe aún en la plataforma, Moodle es capaz de crearla sobre la marcha leyendo tu CSV.
¿Necesitas matricular hoy pero que los alumnos no puedan acceder hasta el lunes que viene? El CSV te permite gestionar esto:
enroltimestart1: Define el inicio de la matrícula. El formato es innegociable: AÑO-MES-DIA HORA:MINUTO (por ejemplo, 2026-03-02 08:00). Cuidado al usar Excel, ya que a veces altera este formato por defecto.
enrolperiod1: Establece la duración del acceso en días (por ejemplo, 30). El tiempo empieza a contar desde que la matrícula se activa.
Muchas formaciones requieren recoger datos que el formulario estándar de Moodle no contempla, como el DNI, nivel de inglés, CIF de la empresa, etc.. Estos campos deben ser creados previamente en Moodle por un administrador del sitio.
Para subirlos masivamente, el encabezado en tu CSV debe nombrarse como profile_field_ seguido del nombre corto de ese campo (por ejemplo, profile_field_dni o profile_field_ingles). Atención: Si el campo personalizado es un menú desplegable con opciones predefinidas, el texto que pongas en el CSV debe ser idéntico al configurado en Moodle, respetando minuciosamente las mayúsculas y minúsculas.
Una vez tienes tus datos estructurados, debes descargar la tabla. Lo ideal es guardarla como CSV separado por comas (UTF-8). El parámetro UTF-8 es fundamental: es el tipo de codificación que permite que Moodle lea correctamente las tildes y caracteres especiales, evitando que aparezcan rombos o símbolos extraños en los nombres.
Al subir el archivo a Moodle, presta mucha atención a la configuración:
1. Separador: Indica si tu archivo está separado por comas, puntos y comas o tabulaciones.
2. Tipo de subida: Normalmente usarás "Agregar nuevos y actualizar existentes". Esto es vital si estás subiendo a usuarios que ya han hecho formaciones contigo en el pasado y solo quieres matricularlos en un curso nuevo o añadirles un dato como el DNI.
3. Forzar cambio de contraseña: Si tú has introducido contraseñas en el archivo, marca la opción de forzar el cambio. Así, por seguridad y cumplimiento de protección de datos, el usuario tendrá que crear su propia clave al entrar por primera vez.
Si Moodle te lanza un error, confía en él; la máquina te quiere ayudar y casi siempre el fallo está en nuestro documento. Si te atascas, levántate, tómate un café y vuelve a revisar el archivo con la mente fresca.
Error 1: "El curso no es un nombre válido". Suele deberse a un simple error tipográfico en el nombre del campo (te has comido una letra en el encabezado).
Error 2: "No aparecen las opciones de configuración". Moodle oculta el menú de subida cuando detecta un valor inválido. Es el clásico error de los campos personalizados: si en Moodle la opción es "Otros", y en tu Excel has escrito "otros" (en minúscula), el sistema no lo reconoce y bloquea la subida.
Error 3: "Formato de archivo ilegible". Ocurre cuando indicas un separador equivocado en la interfaz (ej. marcas "coma" pero tu archivo iba por "tabulación").
Error 4: "Dirección duplicada". Este es un dolor de cabeza habitual. Pasa cuando intentas subir a un usuario antiguo, cuyo email ya está registrado, pero le has cambiado el criterio del username (por ejemplo, el año pasado usabas el propio email, y este año usas su DNI). Moodle detecta el email y, al ver que el username no cuadra, lo indica como “error” en la subida y no lo matricula en el curso.
Para cerrar, aquí tienes algunos consejos de oro para la administración de usuarios:
Evita el borrado de usuarios masivo, mejor suspender cuentas: Aunque existe un campo para borrar usuarios (deleted), no es recomendable porque es una acción irreversible. Si tienes inspecciones de entidades como Fundae (que obligan a retener datos por 4 años), borrar alumnos de cursos pasados por error puede ser catastrófico. En su lugar, usa el campo suspended con el valor 1 para desactivar el acceso del usuario sin perder su historial.
Revisa siempre los datos -> Correos de Fundae: Si impartes formación bonificada, asegúrate de que los emails sean personales e intransferibles. Fundae rechaza correos genéricos tipo info@empresa.com.
Usa plantillas: Crea un archivo base con todos los encabezados bien escritos y guárdalo como tu plantilla maestra. Te ahorrará incontables errores tipográficos de cara al futuro.
Dominar el CSV es dominar el tiempo en Moodle. Si sigues estos pasos, comprendes cómo interactúan los datos con la plataforma y prestas atención a los pequeños detalles de formato, la carga de cientos de estudiantes se convertirá en una tarea de apenas un par de minutos.
¡Mucho ánimo con tu próxima subida masiva!
¿Necesitas ayuda con tu plataforma Moodle?
En Inserver llevamos años metidos en el barro de Moodle: consultoría, soporte, actualizaciones, formación y proyectos reales. Y sí, somos Moodle Partner Premium.