Hoy abordamos un tema técnico, que según parece  a muchos usuarios de moodle, les da muchos dolores de cabeza.

El uso principal de este archivo, es para actualizar cuentas de usuarios masivamente, o también para casos más aislados y para determinados campos opcionales de los perfiles de los usuarios.

El tipo de archivo que se suele generar, yo personalmente y por su facilidad de uso utilizo el bloc de notas, o el notepad++.

Las características principales del archivo CSV son:

• Cada línea del archivo contiene un registro.
• Cada registro es una serie de datos separados por comas.
• El primer registro del archivo es especial, y contiene una lista de nombres de campos. Este registro define el formato del resto del archivo.

Los campos obligatorios para la elaboración del CSV son lo siguientes, estos campos deben estar presentes en el primer registro, y deben definirse para cada usuario:

username, password, firstname, lastname, email

Los campos por defecto, estos campos son opcionales -si no están presentes, se tomarán los valores del administrador primario:

institution, department, city, country, lang, auth, timezone

Los Campos opcionales, son los nombres de los cursos son sus “nombres cortos” -si se incluyen los nombres cortos de los cursos el alumno se incribirá automáticamente en esos cursos. Los nombres de los grupos deben estar asociados a los cursos correspondientes, e.g., group1 a course1, etc:

idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, course1, course2, course3, course4, course5, group1, group2, group3, group4, group5, type1, type2, type3, type4, type5, role1, role2, role3, role4, role5, emailstop

Siempre que se construye un CSV hay que tener claro que campos obligatorios más los opcionales o por defecto vamos a necesitar, para que moodle si lo construimos todo correctamente los aceptará y nos los cargará sin problemas en la plataforma.

Nunca esta de más tener la base de datos abierta de la paltaforma donde estamos aplicando los cambios, para ver que estamos siguiendo la línea correcta del proceso

También tenemos que prestar mucha atención a los puntos que mencionamos a continuación:

• Las comas entre los datos se codificarán como &#44 -el script las decodificará automáticamente como comas.
• Para campos boleanos use 0 para falso y 1 para verdadero.
• Los tipos se usan para informar a Moodle si el usuario es un estudiante o un profesor en el caso de que el correspondiente curso exista (e.g., type2 corresponde a course2). 1 = Estudiante, 2 = Profesor editor y 3 = Profesor no editor. Si el tipo se deja en blanco, o si no se especifica curso, el usuario por defecto será el estudiante.
• Para los cursos, utilice el nombre corto del curso.
• Nota: Si un usuario ya está registrado en la base de datos de Moodle, el script devolverá el número userid (índice de la base de datos) de ese usuario, e inscribirá al usuario en los cursos SIN alterar la información anterior.

Para finalizar este extenso post, y a modo de ejemplo y orientación a todos nuestros lectores, aquí os ponemos un ejemplo del CSV, espero que os sirva a entenderlo todo correctamente

username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1
juanb, secreto, Juan, Benítez, janb@algo.edu, es, 3663737, 1, Intro101, Seccion1, 1
saraf, sercreta, Sara, Fernández, sarara@alomas.edu, es, 6736733, 0, Avanzado202, Seccion3, 3

Moodle es un CMS muy estricto a la hora de aceptar este tipo de información, si no se la facilitamos como os hemos explicado os va estar dando errores en la importación de los CSV continuamente.

Por eso os pedimos máxima concentración a la hora de realizar este tipo de tareas, que son laboriosas y precisan de mucha atención, una simple coma mal puesta o un espacio en blanco, pueden causarnos un gran problema en nuestra aplicación.

Saludos cordiales del equipo de Noticias Moodle