Importare utenti

Procedimento per l’importazione degli utenti

1. Creare un file per l’importazione
2. Andare su Amministrazione del sito > Utenti > Profili > Importa utenti
3. Aggiungere il file per l’importazione
4. Anteprima importazione utenti - controllare le impostazioni predefinite dei profili utenti
5. Anteprima importazione utenti - cliccare su Importa utenti
6. Risultati importazione utenti - mostra la lista degli utenti, le eccezioni fatte in fase di upload e il riepilogo del numero degli utenti.
7. Risultati importazione utenti - cliccare su Continua
8. Torna alla schermata Importa utenti

Importare utenti tramite file di testo

Ci sono varie opzioni per importare informazioni (campi associati a un utente) con questo metodo: dall’iscrizione degli utenti in corsi multipli con ruoli specifici per ciascun corso alla modifica delle informazioni nel Profilo utente alla cancellazione degli utenti dal sito.

Consiglio: generalmente non è necessario importare utenti in massa con Importare utenti. Per ridurre al minimo la gestione manuale degli account si suggerisce di considerare innanzitutto le modalità di autenticazione che non richiedono intervento manuale, come connettendosi a database esterni già esistenti o permettendo agli utenti di creare i propri account (Iscrizione spontanea). Consultare Autenticazione per maggiori informazioni.

Load video

YouTube

YouTube might collect personal data. Privacy Policy

ContinueDismiss

Formati file per importare gli utenti

Nel file di importazione degli utenti i campi vanno separati SOLO con una virgola (o da un altro delimitatore), senza spazi aggiuntivi. La prima riga (l’intestazione) deve contenere dei nomi i campi validi. Le altre righe (record) contengono le corrispondenti informazioni su ogni singolo utente.

Consiglio: Evitare l’uso di caratteri speciali, come virgolette o altri separatori, nei vari campi.

Consiglio: Per creare i file con le colonne e i campi richiesti, conviene usare un foglio di calcolo e salvare il file come “CSV (con i campi separati da una virgola)”. Per eventuali verifiche, questi file possono essere aperti con semplici editor di testo (come (EN) Notepad++). Si rammenti che i fogli di calcolo impostati per l’italiano, di norma, salvano i CSV con il delimitatore di elenco predefinito: il punto e virgola; bisognerà tenerlo presente in fase di importazione (vedi oltre).

File di prova valido per l’importazione

Assumendo di aver già creato il corso mate102 e i gruppi locali al corso e globali menzionati nel file, ecco come si presenterebbe un file valido per l’importazione di alcuni utenti (le intestazioni delle colonne nella prima riga del file sono evidenziate in grassetto per distinguerle dai dati degli utenti):

username,password,firstname,lastname,email,course1,group1,cohort1
gioro,belSegreto3$,Giovanni,Rossi,gioro@example.com,mate102,Sezione1,anno3
albebia,granSegreto4#,Alberto,Bianchi,albebia@example.com,mate102,Sezione3,anno4

Campi Utente che possono essere inclusi

Consiglio: Quando si usano i campi personalizzati per la prima volta, si consiglia vivamente di provare l’importazione con un file contenente un solo utente prima di avviare l’importazione da file.

Campi obbligatori

Questi sono i campi obbligatori per l’identificazione dell’utente: username,firstname,lastname,email I controlli di validità sono effettuati per:

• lo username, che può contenere solo caratteri alfabetici minuscoli, segno meno -, carattere di sottolineatura _, punto ., o simbolo at @
• l’email, che deve essere della forma: nome@esempio.com

Password

Nella schermata di Anteprima importazione utenti, dopo aver caricato il file .csv, è possibile settare le impostazioni per le password. Il campo password è infatti facoltativo se la voce Password per i nuovi utenti è impostata su Genera le password se necessario e inviale per email, ma è obbligatorio, e deve essere presente nel file .csv, se invece è impostata su Il campo è presente nel file.

Se inclusi, i valori dovranno soddisfare i requisiti delle Regole password del sito.

Per forzare il cambiamento password per un particolare utente, scrivere nel campo password changeme. Se omessa, sarà generata una password per ogni utente (durante il successivo Cron) e saranno inviate le email di registrazione. Il testo delle email di registrazione si trova nelle impostazioni della lingua su Amministrazione del sito > Lingua > Personalizzazione lingua inserendo come identificativo di stringa newusernewpasswordtext, dopo aver selezionato e caricato il language pack.

Campi utente facoltativi

Nota: Le virgole all’interno di un campo devono essere codificate come &#44 - lo script le decodificherà di nuovo come virgole (i caratteri speciali devono essere codificati in base al codice HTML).

Consiglio: Per i campi booleani con solo due valori, usare 0 per falso e 1 per vero.

Per inserire ulteriori informazioni oltre a quelle obbligatorie, è possibile includere uno o più di questi campi utente facoltativi:

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

La maggior parte di questi sono campi del profilo utente o delle preferenze utente che possono essere compilati automaticamente al momento dell’importazione dell’utente oppure manualmente. Alcuni vanno inseriti utilizzando dei formati specifici. Consultare Campi aggiuntivi per ulteriori dettagli. Le accortezze principali da osservare sono:

country - usare il codice del paese composto da DUE LETTERE MAIUSCOLE, ad es. IT, AU,ES,GB,US. È necessario utilizzare due lettere maiuscole; l’uso di au, es o USA come codice paese condurrà a un errore del database. Se si riscontrano problemi nel trovare il codice di un paese è possibile consultare la lista di nomi dei paesi e rispettivi codici disponibile sul sito web ISO. Un errore frequente è l’uso di UK per il Regno Unito, che ha invece codice GB.

lang - utilizzare il codice di due lettere (o il codice esteso da quattro lettere) come specificato nei Language pack di Moodle, ad es. it, en, es, en_us, de, su Amministrazione del sito > Lingua > Language pack.

auth - Il campo auth va utilizzato se il sito usa un metodo di autenticazione alternativo, come LDAP, altrimenti il metodo di autenticazione sarà impostato di default su manuale e gli utenti che accedono con un metodo diverso non potranno effettuare il login. Utilizzare i codici abbreviati specificati su Plugin > Autenticazione per i diversi tipi, quali manual, nologin, ldap, cas, mnet, db, none.

È possibile impostare auth su nologin nel proprio file CSV, in modo che i nuovi utenti non possano effettuare il log in.

timezone - Dovrebbe essere nello stesso formato che si trova nelle impostazioni di localizzazione di Stato/Città/Località, es. Australia/Sydney, Asia/Kathmandu, Europa/Madrid, etc. La voce è sensibile alle maiuscole, quindi Europa/Roma funzionerà, ma europa/roma no.

Nota: È necessario usare un formato particolare per le impostazioni mailformat,maildisplay,htmleditor,autosubscribe

maildigest - Per evitare che gli utenti ricevano un numero spropositato di email da corsi o forum con sottoscrizione forzata, utilizzare il maildigest. Le opzioni per questo campo sono 0 = Nessuna raccolta, 1 = Raccolta completa e 2 = Raccolta oggetti.

Campi personalizzati del profilo utente

Sono facoltativi, e la scelta di utilizzarli o meno dipende dalla creazione di campi personalizzati del profilo utente (vedere Campi personalizzati). Il nome dell’intestazione della colonna del file sarà profile_field__xxxxx dove xxxx è il Nome abbreviato (univoco) del campo personalizzato del profilo utente che si è creato.

Il nome del campo dovrebbe rispettare le maiuscole del nome abbreviato del campo utente. Quindi, se per esempio il nome abbreviato (univoco) del campo personalizzato profilo utente è tutto in maiuscolo, ad esempio DOB, bisognerà usare un’intestazione profile_field_DOB per rispettare le maiuscole, e non profile_field_dob, che condurrà all’errore xxxxx non è nome di campo valido. Allo stesso modo, un nome abbreviato composto da maiuscole e minuscole come Dob dovrà avere un’intestazione profile_field_Dob. (Fanno eccezione i nomi abbreviati composti da sole lettere minuscole, per i quali l’intestazione non sarà sensibile alle maiuscole, si tratta di una stranezza storica: in ogni caso si consiglia di rispettare le maiuscole così da evitare errori)

profile_field_xxxxx

Esempio: Per creare il campo personalizzato genere, bisognerà scrivere il nome abbreviato genere nel nuovo campo, e scrivere profile_field_genere nell’intestazione del file .csv.

Per i campi personalizzati che consistono in date, utilizzare il formato standard ISO AAAA-MM-GG, come 2014-06-19, che verrà localizzato nell’interfaccia in modo appropriato. Ad esempio, se si ha un campo chiamato DataDiNascita, i campi saranno:

username,firstname,lastname,email,profile_field_DataDiNascita
blumbergh,Bill,Lumbergh,blumbergh@example.com,1990-02-19
pgibbons,Peter,BGibbons,pgibbons@example.com,1996-06-05
tsmykowski,Tom,Smykowski,tsmykowski@example.com,1970-01-01 

Per i campi personalizzati che consistono in un valore scelto da una lista, utilizzare il valore corrispondente della lista, così come lo si è definito. Ad esempio: un campo personalizzato divisione con uno dei tre valori Gestione, Sviluppo o Training. Inserire semplicemente una di queste tre parole (ad es. Training) come valore per il campo in questione. Esempio:

username,firstname,lastname,email,profile_field_divisione
blumbergh,Bill,Lumbergh,blumbergh@example.com,Gestione
pgibbons,Peter,BGibbons,pgibbons@example.com,Sviluppo
tsmykowski,Tom,Smykowski,tsmykowski@example.com,Training

Campi speciali per la modifica degli utenti

Tre campi speciali sono utilizzati per la gestione degli account utenti, oldusername, deleted e suspended. Vedere sotto per ulteriori dettagli.

Campi per l’iscrizione

Eventualmente, è possibile iscrivere gli utenti ai corsi esistenti tramite l’iscrizione manuale. Solo l’iscrizione manuale si effettua in questo modo; se per un corso il metodo iscrizione manuale è disabilitato, allora l’iscrizione non sarà effettuata.

A tal fine, utilizzare campi di questo tipo nel file per l’importazione:

course1,type1,role1,group1,enrolperiod1,enrolstatus1,course2,type2,role2,group2,enrolperiod2,enrolstatus2

ecc.

I campi dell’intestazione devono avere un suffisso numerico, cosicché type1,role1,group1,enrolperiod1 e enrolstatus1 si applichino tutti a course1, quelli col suffisso 2 a course2 e così via. Anche se si sta effettuando l’iscrizione a un singolo corso, è comunque necessario usare il suffisso 1 nei nomi delle intestazioni, ovvero course1,role1, ecc. Non utilizzare la semplice intestazione senza il numero, ovvero course,role, ecc, perché genererà un errore.

course# (dove # è un suffisso numerico) è il nome abbreviato del corso; se presente, l’utente verrà iscritto al corso in questione. Non utilizzare il nome completo del corso, o ciò genererà un errore. Questo è l’UNICO campo obbligatorio per effettuare l’iscrizione con successo, tutti gli altri sono facoltativi.

type# è il ruolo da assegnare al momento dell’iscrizione. Il valore 1 è il ruolo predefinito all’interno del corso, 2 è il ruolo ereditato (così come definito nel corso) di docente e 3 è il ruolo ereditato di docente non editor.

role# può essere utilizzato per specificare direttamente i ruoli, usando o il nome abbreviato del ruolo o l’ID del ruolo (i valori numerici dei ruoli qui non sono supportati). Generalmente si utilizza il nome abbreviato del ruolo come specificato su Amministrazione del sito > Utenti > Autorizzazioni > Gestione ruoli, ad esempio student, editingteacher, ecc.. Se la colonna dei ruoli viene tralasciata, gli utenti verranno iscritti al corso con il ruolo predefinito, in genere quello di studente.

group# può essere usato per inserire gli studenti in gruppi all’interno dei corsi, usando nome o ID (i codici numerici dei gruppi non sono supportati).

Nota: se il gruppo non esiste, verrà creato sul momento.

enrolperiod# può essere usato per impostare la durata dell’iscrizione, in giorni, per ciascun corso. Se non impostato esplicitamente qui, a tutti gli utenti verrà assegnata una durata secondo quanto impostato nel metodo Iscrizione manuale al corso (il cui valore predefinito è di 0, che indica una durata illimitata).

enrolstatus# è facoltativo, in quanto tutti i nuovi iscritti sono attivi di default. Se si usa il valore di 1, gli utenti nel corso verranno sospesi; se un utente è stato precedentemente impostato come inattivo/sospeso, allora il valore di 0 lo renderà di nuovo attivo.

Aggiungere gli utenti ai gruppi globali

È possibile aggiungere gli utenti a qualsiasi Gruppo globale esistente usando solo lo username e l’ID Gruppo globale, quindi un file con due campi soltanto. Si noti che si tratta di un’eccezione alla normale procedura in cui sono richiesti nome, cognome e indirizzo email dell’utente.

La forma da utilizzare è cohort# e, così come per l’iscrizione ai corsi, è necessario aggiungere un suffisso numerico a ciascuna intestazione, quindi si avrà cohort1,cohort2, ecc.

È necessario utilizzare ID Gruppo globale interni o non numerici di Gruppi globali esistenti; non è possibile utilizzare il nome completo. (Si noti che l’ID Gruppo globale è ciò che in altre circostanze viene chiamato Nome abbreviato.)

Il file CSV si presenterà così:

username,cohort1,cohort2
student1,nursing,2016class
student2,nursing,2014class
student3,nursing,2014class

MNet

Gli utenti MNet esistenti possono essere aggiunti a corsi, gruppi o gruppi globali come spiegato sotto utilizzando l’intestazione mnethostid.

1. Per l’iscrizione ai corsi sono richiesti username+mnethostid+course
2. Per aggiungere gli utenti ai gruppi sono richiesti username+mnethostid+course+group
3. Per aggiungere gli utenti ai gruppi globali sono richiesti username+mnethostid+cohort
4. Per sospendere/riattivare gli account utenti sono richiesti username+mnethostid+suspended

Tutte le altre operazioni non sono contemplate. Non è possibile aggiungere utenti, eliminarli o modificarli (ovvero modificarne nome, indirizzo email, altri campi profilo, ecc.)

Configurare i ruoli globali

Gli utenti possono anche essere importati in dei ruoli globali già definiti, usando il nome abbreviato del ruolo globale come specificato su Amministrazione del sito > Utenti > Autorizzazioni > Gestione ruoli per i ruoli con uno specifico contesto.

sysrole1,sysrole2,sysrole3

ecc.

Gli utenti possono essere importati con uno specifico ruolo globale (in genere Manager o Creatore di corsi) inserendo il nome abbreviato del ruolo in questione. Possono essere importati altri ruoli solo se questi sono già stati assegnati nel contesto sistema. Si veda Creare ruoli personalizzati. Possono essere assegnati ruoli multipli usando i campi sysrole2, sysrole3, ecc. Si noti che i suffissi numerici non sono in nessun modo correlati ai numeri dei campi necessari ai fini dell’iscrizione. I numeri devono essere in ordine crescente a partire da 1.

Togliere ruoli globali: Gli utenti possono anche essere rimossi da un dato ruolo globale inserendo il nome abbreviato del ruolo in questione preceduto dal segno meno: -. Se al momento l’utente è assegnato al ruolo in questione, ne verrà rimosso. Se invece l’utente non è assegnato al ruolo globale in questione, il valore nel campo verrà ignorato. Il valore nel campo deve comunque riferirsi a un ruolo globale che esiste nel sistema, altrimenti genererà un errore.

Esempio di file per importare utenti con ruoli globali

Anteprima Importazione utenti

Ci sono varie impostazioni per controllare al meglio la riuscita dell’importazione che si desidera ottenere. Queste impostazioni si trovano sulla pagina Anteprima Importazione utenti.

Attenzione: gli errori generati durante la modifica degli account esistenti possono danneggiare gli utenti. Fare attenzione quando si utilizzano le opzioni di modifica.

Modalità di importazione

La Modalità di importazione specifica come gestire i profili esistenti.

Crea solamente i nuovi utenti, ignora gli utenti già esistenti

è la modalità di importazione predefinita di Moodle. Crea un nuovo account utente per ogni nuovo record del file importato. Se uno username che si trova nel file importato corrisponde a uno username già esistente, il record viene saltato. Saltando l’account utente esistente, i dati nel record in questione non vengono toccati (a differenza dell’opzione Crea i nuovi utenti ed aggiorna gli utenti già esistenti) e non viene creato un secondo account utente (a differenza dell’opzione Crea tutti gli utenti, aggiungendo un numero agli username ove necessario).

Crea tutti gli utenti, aggiungendo un numero agli username ove necessario

crea un nuovo account utente per ogni record del file importato. Se viene trovato un account utente già esistente, verrà creato un nuovo account con un suffisso numerico apposto allo username. Ad esempio, se già esiste un account utente che ha come username jsmith e il file importato contiene un record con lo username jsmith, verrà creato un account utente supplementare con il numero 1 aggiunto allo username, che andrà a creare l’utente jsmith1.

Crea i nuovi utenti ed aggiorna gli utenti già esistenti

crea un nuovo account utente per ogni nuovo utente del file importato. Se viene trovato un account utente già esistente con lo stesso username, l’informazione dell’account viene modificata con i dati che si trovano nel file importato.

Aggiorna solamente gli utenti già esistenti

ignora ogni nuovo utente trovato nel file per l’importazione e, se nel file caricato viene trovata un record corrispondente a uno username esistente, ne modifica le informazioni del profilo utente.

Password per i nuovi utenti

Quando viene creato un nuovo account utente, Moodle può generare una nuova password (se questa non viene fornita) o può richiedere una password nel file importato.

Genera le password se necessario e inviale per email

crea una password di default per il nuovo account utente se non ne viene fornita una nel file importato.

Il campo è presente nel file

richiede che venga fornita una password nel file importato. Se non viene fornita nessuna password, si genererà un errore e l’account utente non verrà creato.

Impostazione campi del profilo utente

Le opzioni per Impostazione campi del profilo utente sono disponibili solo quando la Modalità di importazione permette che gli account utenti esistenti vengano modificati. Specificano il modo in cui Moodle gestisce le informazioni per gli utenti esistenti.

Nessuna modifica

ignora i dettagli dell’utente nel file importato e lascia invariati i dati dell’account utente esistente.

Utilizza i valori contenuti nel file

sostituisce i dati dell’account utente esistente con i dati forniti nel file importato.

Utilizza i valori contenuti nel file ed i valori di default

sostituisce i dati dell’account utente esistente con i dati forniti nel file importato e inserisce i valori di default per i dettagli degli utenti esistenti quando non viene fornito nessun dato nel file importato.

Utilizza i valori contenuti nel file ed i valori di default se i campi sono vuoti

se i campi sono vuoti (ovvero non contengono già dei dati), aggiunge i dettagli dell’account utente esistente tramite i dati forniti nel file importato e inserisce i valori di default per i dettagli dell’utente esistente quando non viene fornito nessun dato nel file importato.

Password per gli utenti già esistenti

L’opzione Password per gli utenti già esistenti specifica come gestire i dettagli della password per gli account utenti esistenti quando Impostazione campi del profilo utente è impostato per utilizzare i valori contenuti nel file.

Nessuna modifica

ignora il campo password nel file importato e lascia invariata la password dell’account utente esistente

Aggiorna

sostituisce la password dell’account utente esistente con la password fornita nel file importato

Forza il cambiamento della password

L’opzione Forza il cambiamento della password determina quando segnalare un account utente in modo che al successivo tentativo di login venga chiesto all’utente di cambiare la password.

Utenti che hanno una password debole

Se l’account utente ha una password debole, secondo quanto specificato dalle Regole password del sito, l’utente verrà forzato a cambiare la password al prossimo tentativo di log in. Questa opzione non viene mostrata se il sito non possiede delle proprie Regole password.

Nessuno

A nessuno degli utenti del file importato verrà richiesto di cambiare la password durante il prossimo tentativo di login.

Tutti

A tutti gli utenti del file importato verrà richiesto di cambiare la password durante il prossimo tentativo di login.

Consenti la modifica degli username

Se il file importato contiene il campo speciale oldusername, è possibile rinominare un utente, passano da un vecchio username (oldusername) a un nuovo username. L’impostazione di default non consente la modifica degli username. Si raccomanda di ricordare che se lo username di un utente viene modificato, l’utente dovrà utilizzare il nuovo username per effettuare il login.

No

ignora il campo oldusername e lascia invariato lo username dell’account utente esistente.

Sì

consente che lo username dell’account utente esistente venga modificato dai dati forniti nel campo username del file importato. Il vecchio username verrà cercato e aggiornato con i dati forniti nella colonna username.

Consenti eliminazione utenti

Se il file importato contiene il campo speciale deleted, è possibile utilizzare il file importato per eliminare gli account utenti esistenti. L’impostazione di default non consente le eliminazioni. Si raccomanda di ricordare che se un account utente viene eliminato, l’utente in questione non sarà più in grado di effettuare il login. Come prevenzione, gli account utenti degli amministratori del sito non possono essere eliminati con questo metodo.

No

ignora il campo speciale deleted nel file importato e lascia invariati gli account utenti esistenti.

Sì

consente che gli account utenti esistenti vengano eliminati quando il valore del campo deleted è di 1.