Herramientas de usuario

Herramientas del sitio


moodle:upload_users

Carga de usuarios mediante un fichero CSV

Formato del fichero

El fichero CSV es un fichero de texto que puede ser creado en cualquier procesador de textos y que contendrá líneas de texto con el siguiente formato:

  • Cada línea contendrá campos separados por comas (u otros delimitadores, pero la coma es el estándar), sin comillas (“). No hay que poner delimitador al final de la línea.
  • La primera línea es especial y contiene los nombres de los campos
  • El resto de las líneas contendrán los valores para cada uno de dichos campos

Delimitadores

Moodle soporta de forma estándar el punto y coma (;), la coma (,), los dos puntos (:) y el tabulador como separadores entre campos.

Asegúrese de especificar al importar desde Moodle el caracter separador que haya usado en el fichero en el desplegable Delimitador CVS.

Caracteres especiales y tildes

Moodle soporta una amplia variedad de formatos para los caracteres especiales. Para poder incluir tildes y eñes se puede codificar el fichero en UTF-8 o en ISO-8859-15. A la hora de subir el fichero a Moodle asegúrese de especificar el mismo formato en el desplegable Codificación.

Hay diversos editores en Windows que permiten especificar el formato en el que se codificarán los caracteres especiales. Uno especialmente versátil y completamente gratuito es Notepad++.

A. Campos obligatorios

Son los siguientes:

username, password, firstname, lastname, email

Deben estar en inglés, no es posible traducirlos ya que internamente así se llaman. Pueden estar en cualquier orden, ya que el significado de cada dato se obtiene del correspondiente campo del primer registro (el que contiene los nombres).

Se harán las siguientes comprobaciones sobre estos campos obligatorios:

  1. username solo puede contener letras alfabéticas minúsculas , números, guiones '-', guiones bajos '_', puntos '.', o arrobas '@'
  2. password los requisitos están en función de los requisitos de las passwords que haya establecido el administrador de Moodle. Para forzar que el usuario cambie la contraseña la primera vez que entre al sistema el valor que hay que poner es “changeme”.
  3. email verifica que sea una dirección de email correctamente formada

Ejemplo de un fichero válido con los campos obligatorios

username, password, firstname, lastname, email
jperez, thisispass, Juan, Perez, jperez@gmail.com
slopez, anotherpass, Sergio, Lopez, s_lopez@gmail.com

B. Campos opcionales

To provide values other than the default include one or more of these

institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, emailstop

Custom profile field names

xxxxx is the real custom user profile field name (i.e. the unique shortname)

profile_field_xxxxx

Create the custom fields BEFORE importing. Use the standard header. The “shortname” for your custom field is xxxxx. The first record must include “profile_field_xxxxx”. Example: To create a custom field “genre”, you must write a shortname “genre” in the new field, and write “profile_field_genre” in the header of the .csv file.

Special fields

Used for changing of usernames or deleting of users

oldusername, deleted

Enrolment fields

Optional

course1, type1, role1, group1, enrolperiod1, course2, type2, role2, group2, enrolperiod2 etc.
  • course is the “shortname” if present the user will be enrolled in those courses.
  • type refers to the role to be used for associated course enrolment. Value 1 is default course role, 2 is legacy Teacher role and 3 is legacy Non-editing Teacher.
  • You can use role field instead to specify roles directly - use either role short name or id (numeric names of roles are not supported).
  • Users may be also assigned to groups in course (group1 in course1, group2 in course2, etc.). A group is identified by name or id (numeric group names are not supported).

Commas within a field must be encoded as &#44 - the script will decode these back to commas.

For Boolean fields, use 0 for false and 1 for true.

Turn email off: emailstop set to 1 if the email address should be disabled (default: email is enabled):

To prevent users from receiving a large number of emails from courses or forced subscription forums use the maildigest. The options for this field are 0 = No digest, 1 = Complete digest and 2 = Digest with just subjects.

Example of a valid upload file with optional fields

username, password, firstname, lastname, email, course1, group1
jonest, verysecret, Tom, Jones, jonest@someplace.edu, math102, Section 1
reznort, somesecret, Trent, Reznor, reznort@someplace.edu, math102, Section 3

Referencias

moodle/upload_users.txt · Última modificación: 2013/10/17 10:31 por jherrero