Innanzitutto occorre notare che di solito non è necessario importare utenti in massa. Per ridurre il proprio lavoro di manutenzione bisognerebbe, per prima cosa, esaminare i moduli di autenticazione che non richiedono gestione manuale, come la connessione a database esterni già esistenti oppure consentire agli utenti la creazione di propri account in autonomia. Consultare la sezione Autenticazione nei menu dell'amministratore.
Se non ci sono alternative all'importazione di utenti, è necessario formattare il file di testo come segue:
Campi obbligatori: questi campi devono essere inclusi nella primo record e definiti per ciascun utente
Utilizzare
firstname, lastname
quando si crea l'account ousername
quando si aggiornaCampi facoltativi: sono campi che possono ance essere omessi nel file. Se un campo facoltativo è valorizzato, verrà utilizzato il valore presente nel file. Se invece il campo non è valorizzato, verrà utilizzato il valore di default per quel campo.
institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, emailstop
Campi personalizzati: facoltativi, xxxxx è il nome campo personalizzato (ossia il nome abbreviato univoco)
profile_field_xxxxx
Campi speciali: usati per la modifica degli username e per la eliminazione di utenti, come mostrato sotto
deleted, oldusername
Campi per l'iscrizione (facoltativi): utilizzando i titoli abbreviati dei cors sarà possibile iscrivere automaticamente l'utente. La colonna "Type" permette di assegnare a ciscun utente un ruolo nel corso. Il valore 1 corrisponde al ruolo default del corso, 2 è il vecchio ruolo Docente e 3 il vecchio ruolo Docente non-editor. Si può anche usare il campo 'roleX' per specificare direttamente il ruolo da assegnare, valorizzando il campo con il nome abbreviato del ruolo oppure l'id (nomi numerici dei ruoli non sono supportati). Gli utenti possono anche essere assegnati a gruppi in un corso (group1 in course1, group2 in course2, ecc.). I gruppi anche sono identificati dal loro nome o dai propri id (nomi numerici di gruppi non sono supportati). Per ogni corso è anche possibile impostare la durata in giorni dell'iscrizione (enrolperiod1 per course1, enrolperiod2 per course 2, etc.).
course1, type1, role1, group1, enrolperiod1, course2, type2, role2, group2, enrolperiod2, ecc.
Di seguito si riporta un esempio di file di importazione valido:
username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1, enrolperiod1
jonest, verysecret, Tom, Jones, jonest@someplace.edu, en, 3663737, 1, Intro101, Section 1, 1, 30
reznort, somesecret, Trent, Reznor, reznort@someplace.edu, en_us, 6736733, 0, Advanced202, Section 3, 3, 90
E' possibile usare dei modelli per elaborare i valori di default:
%l
- sarà sostituito dal lastname%f
- sarà sostituito dal firstname%u
- sarà sostituito dallo username%%
- sarà sostituito dal %Tra il carattere percento (%) e ogni codifica letterale (l, f or u) sono permessi i seguenti modificatori:
Per esempio, se il nome è John e il cognome è Doe, i seguenti risultati saranno ottenuti con i modelli specificati:
L'elaborazione dei Modelli viene effettuata solo sui valori default, non viene effettuta sui valori presi dal file CSV.
Affinché siano creati username Moodle corretti, gli username saranno convertiti sempre in minuscolo. Inoltre, se l'opzione "Permetti l'uso di caratteri speciali negli username" nella pagina Politiche del Sito è off, caratteri differenti da lettere, cifre, trattini (-) e punti (.) verranno rimossi. Per esempio se il nome è John Jr. e il cognome è Doe, lo username %-f_%-l produrrà john jr._doe quando "Permetti l'uso di caratteri speciali negli username" è on, e johnjr.doe quando è off.
Quando la "Modalità di importazione" è impostata a "Crea tutti gli utenti, postponendo un progressivo agli username duplicati", a ciascun username duplicato prodotto dal modello verrà posposto un contatore incrementale. Per esempio, se il file CSV contiene gli utenti che si chiamano John Doe, Jane Doe e Jenny Doe senza username espliciti, il default username è %-1f%-l e la "Modalità di importazione" è impostata a "rea tutti gli utenti, postponendo un progressivo agli username duplicati", allora gli username prodotti saranno jdoe, jdoe2 and jdoe3.
Per default Moodle assume che si stanno creando nuovi account utenti e salta i record dove lo username corrisponde ad un account già esistente. E' comunque possibile selezionare Modalità di importazione in grado di aggiornare gli account.
Quando si aggiornano account già esistenti si possono anche cambiare gli username. Impostare "Modifica gli username" a SI e includere nel file da caricare un campo chiamato oldusername
.
Attenzione: ogni errore nell'aggiornamento degli account esistenti può incidere negativamente sui dati degli utenti. Porre molta attenzione quando si usano le opzioni per l'aggiornamento.
Se nel file è presente il campo deleted
, gli utenti con il valore 1 per tale campo saranno eliminati . In questo caso tutti gli altri campi possono essere omessi ad eccezione di username
.
Eliminazione e importazione di account possono essere effettuati con un singolo file CSV. Per esempio, il seguente file aggiunge l'utente Tom Jones e cancella l'utente reznort:
username, firstname, lastname, deleted
jonest, Tom, Jones, 0
reznort, , , 1