Introduzione
Gli utenti possono essere iscritti ai corsi dai Superadmin, dai Power User con i relativi permessi, oppure possono autoiscriversi. In alternativa, i Superadmin o i Power User con relativi permessi possono iscrivere più utenti a corsi e sessioni di corsi Instructor-Led Training (ILT) o assegnare gli istruttori alle sessioni tramite file CSV, velocizzando i processi di iscrizione e assegnazione.
Questo articolo è una guida alla creazione di file CSV correttamente formattati per questo scopo.
Altri articoli nella Knowledge Base offrono invece informazioni su come:
- iscrivere gli utenti a corsi e-learning
- iscrivere gli utenti ai corsi ILT (Instructor-Led Training)
- gestire le iscrizioni
- gestire le autoiscrizioni e la lista d'attesa
Iscrivere Utenti a più Corsi e Sessioni Utilizzando File CSV
Per iscrivere più utenti a più di un corso, o a più di una sessione tramite file CSV, connettersi come Superadmin, quindi accedere al Menu Amministrazione cliccando sull'icona dell'ingranaggio in alto a destra, identificare la sezione E-Learning e fare clic su Gestione Corsi. Cliccare Gestione Iscrizioni in alto a destra e selezionare Gestione Iscrizioni via CSV.
Si aprirà sulla destra della pagina il pannello a scomparsa Gestione Iscrizioni da CSV. Selezionare l'opzione Iscrivi Utenti.
Per un corretto caricamento del file, è necessario creare il file CSV rispettando gli standard. Fare riferimento alla tabella che segue per i valori accettati per i campi dei dati di sessione.
| Campo dati Docebo Learn |
Valori CSV accettati |
Note |
| username | stringa |
Elenco degli utenti da iscrivere, identificati dai loro username. Questo campo è obbligatorio. |
| level |
learner tutor instructor (solo per i corsi e-learning) |
Livello dell'utente nel corso. Questo campo è obbligatorio. |
| course_id |
numerico |
Identificativo interno del corso nel database della piattaforma; è determinato dalla piattaforma e non può essere modificato o rimosso. È necessario includere il valore course_id o il valore course_code nel file CSV per un import corretto. |
| course_code |
stringa |
Codice del corso definito in piattaforma. È necessario includere il valore course_id o il valore course_code nel file CSV per un import corretto. |
| session_id |
numerico |
Identificativo interno della sessione nel database della piattaforma. È determinato dalla piattaforma e non può essere modificato o rimosso. È necessario includere il valore session_id o il valore session_code nel file CSV per un import corretto. Non includere il valore session_id quando si iscrivono gli utenti a un corso e non a una sessione. |
| session_code |
stringa |
Codice sessione definito in piattaforma. È necessario includere il valoresession_id o il valore session_code nel file CSV per un import corretto. Non includere il valore session_id quando si iscrivono gli utenti a un corso e non a una sessione. |
| active_from |
YYYY-MM-DD HH:MM:SS Esempio: 2022-12-25 00:30:45 |
Data di inizio validità dell'iscrizione Questo campo NON è obbligatorio. |
| active_untill |
YYYY-MM-DD HH:MM:SS Esempio: 2022-12-25 00:30:45 |
Data di fine validità dell'iscrizione Questo campo NON è obbligatorio. |
| timezone |
|
Fuso orario espresso secondo il formato indicato nel database dei fusi orari IANA (Europa/Roma, ecc…). Se non specificato, il formato predefinito è UTC. Questo campo NON è obbligatorio. |
| field_<id> |
Il valore del campo dipende dal tipo di campo aggiuntivo per l'iscrizione:
|
Identifica i campi aggiuntivi per l'iscrizione attraverso il loro ID, se configurati sulla piattaforma. Questo campo è facoltativo o obbligatorio in base della configurazione del campo.
|
Per visualizzare un esempio di file CSV formattato correttamente, cliccare Scarica il file CSV di esempio. Ricorda che il file di esempio include sempre tutti i campi disponibili. In base al caso d'uso, potrebbero non essere necessarie tutte le colonne.
Quando il file CSV è pronto, seguire le istruzioni del capitolo Caricare il File CSV e Mappare i Campi di questo articolo per procedere.
Al termine dell'elaborazione del file CSV, gli utenti iscritti sono elencati nella tab Iscrizioni del corso, dove è possibile modificare i dettagli delle iscrizioni.
Iscrivere Utenti a un Solo Corso o Sessione Utilizzando File CSV
Per iscrivere utenti ad un solo corso, o alle sessioni di un corso tramite file CSV, connettesi come Superadmin, accedere al Menu Amministrazione cliccando sull'icona ingranaggio in alto a destra, individuare la sezione E-Learning e cliccare Gestione Corsi.
Individuare il corso nella pagina Gestione Corsi, cliccare sulla descrizione per accedere al corso e cliccare Gestisci Iscrizioni in alto a destra. Selezionare Gestione Iscrizioni via CSV.
Sul lato destro si aprirà il pannello Gestione Iscrizioni via CSV. Selezionare l'opzione Iscrivi Utenti.
Per un corretto caricamento del file, è necessario creare il file CSV rispettando gli standard. Fare riferimento alla tabella che segue per i valori accettati per i campi dei dati di sessione.
| Campo dati Docebo Learn | Valori CSV accettati | Note |
| username |
stringa |
Elenco degli utenti da iscrivere, identificati dai loro username. Questo campo è obbligatorio. |
| level |
learner tutor instructor (solo per i corsi e-learning) |
Livello dell'utente nel corso. Questo campo è obbligatorio. |
| session_id |
numerico |
Identificativo interno della sessione nel database della piattaforma. È determinato dalla piattaforma e non può essere modificato o rimosso. È necessario includere il valoresession_id o il valore session_code nel file CSV per un import corretto. Non includere il valore session_id quando si iscrivono gli utenti a un corso e non a una sessione. |
| session_code |
stringa |
Codice sessione definito in piattaforma. È necessario includere il valoresession_id o il valore session_code nel file CSV per un import corretto. Non includere il valore session_id quando si iscrivono gli utenti a un corso e non a una sessione. |
| active_from |
YYYY-MM-DD HH:MM:SS Esempio: 2022-12-25 00:30:45 |
Data di inizio validità dell'iscrizione Questo campo NON è obbligatorio. |
| active_untill |
YYYY-MM-DD HH:MM:SS Esempio: 2022-12-25 00:30:45 |
Data di fine validità dell'iscrizione Questo campo NON è obbligatorio. |
| timezone |
|
Fuso orario espresso secondo il formato indicato nel database dei fusi orari IANA (Europa/Roma, ecc…). Se non specificato, il formato predefinito è UTC. Questo campo NON è obbligatorio. |
| field_<id> |
Il valore del campo dipende dal tipo di campo aggiuntivo per l'iscrizione:
|
Identifica i campi aggiuntivi per l'iscrizione attraverso il loro ID, se configurati sulla piattaforma. Questo campo è facoltativo o obbligatorio in base della configurazione del campo. |
Per visualizzare un esempio di file CSV formattato correttamente, cliccare Scarica il file CSV di esempio. Ricorda che il file di esempio include sempre tutti i campi disponibili. In base al caso d'uso, potrebbero non essere necessarie tutte le colonne.
Quando il file CSV è pronto, seguire le istruzioni del capitolo Caricare il File CSV e Mappare i Campi di questo articolo per procedere.
Al termine dell'elaborazione del file CSV, gli utenti iscritti sono elencati nella tab Iscrizioni del corso, dove è possibile modificare i dettagli delle iscrizioni.
Assegnare gli Istruttori delle Sessioni Utilizzando File CSV
Per assegnare degli istruttori a delle sessioni tramite file CSV, connettesi come Superadmin, accedere al Menu Amministrazione cliccando sull'icona ingranaggio in alto a destra, individuare la sezione E-Learning e cliccare Gestione Corsi.
Individuare il corso nella pagina Gestione Corsi, cliccare sulla descrizione per accedere al corso e spostarsi alla tab Sessioni. Da qui, cliccare il pulsante più e selezionare l’opzione Assegnare Istruttori alla Sessione via CSV.
Nel pannello Importa Istruttori ILT, trascinare il file CSV nella sezione di caricamento o premere Sfoglia per caricare il file dal proprio dispositivo.
Per un corretto caricamento del file, è necessario creare il file CSV rispettando gli standard. Fare riferimento alla tabella che segue per i valori accettati per i campi dei dati di sessione.
| Campo dati Docebo Learn | Valori CSV accettati | Note |
| session_id |
numerico |
Identificativo interno della sessione nel database della piattaforma. È determinato dalla piattaforma e non può essere modificato o rimosso. Questo campo è obbligatorio. |
| instructor_user_id |
numerico |
ID utente dell'istruttore della sessione. Questo campo è obbligatorio. |
Per visualizzare un esempio di file CSV formattato correttamente, cliccare Scarica il file CSV di esempio. Ricorda che il file di esempio include sempre tutti i campi disponibili. In base al caso d'uso, potrebbero non essere necessarie tutte le colonne.
Quando il file CSV è pronto, seguire le istruzioni del capitolo Caricare il File CSV e Mappare i Campi di questo articolo per procedere.
Caricare il File CSV e Mappare i Campi
Quando il file CSV è pronto, trascinarlo nella sezione di caricamento del pannello o cliccare sull'area di caricamento per cercare il file sul proprio dispositivo.
</p
Dopo il caricamento, premere Configurazione Avanzata: il sistema è configurato per identificare automaticamente il Separatore, necessario per organizzare le informazioni in colonne. Le informazioni possono essere separate da virgola, punto e virgola, o manualmente, in base alle esigenze.
Definire se la prima riga è considerata intestazione (solo se rispecchia la formattazione del file CSV), e selezionare il Charset del File dal menu a tendina. Il charset consigliato è UTF-8, che è standard. Ricordarsi di utilizzare le virgolette per delimitare il contenuto del testo. Premere Conferma per caricare il file .csv.
ll sistema elaborerà il file CSV e ridirezionerà nella pagina di import. Nella sezione Profili è possibile selezionare un preset dal menu a tendina per associare la configurazione di una mappatura precedente all’import CSV in corso. I preset sono associati all'utente che si sta utilizzando per svolgere l'azione di import. La lista dei preset salvati è inoltre visibile in altre parti della piattaforma, come le iscrizioni degli utenti ai corsi tramite CSV.
Premere Sovrascrivi configurazione attuale per completare questa azione. È inoltre possibile mappare le colonne dei campi della piattaforma (ulteriori informazioni in seguito) e salvare la configurazione premendo Salva come nuova configurazione. Definire il nome della nuova configurazione del preset, e premere Salva.
Attenzione: una volta creato, non è possibile eliminare un preset, ma, se si vuole, è possibile sovrascriverlo.
La sezione Anteprima mostra l’anteprima del file CSV come letto dal sistema. Trascinare i campi della sezione Campi Docebo a sinistra e creare delle corrispondenze con i nomi delle colonne del file CSV.
Dopo aver creato le associazioni per tutte le colonne necessarie, controllare le informazioni nella pagina di import e premere Importa in fondo alla pagina. Confermare le informazioni nella finestra pop up e premere Iscrivi Utenti.
L’import è una procedura di background. In caso di problemi, sarà creato un file con gli errori che sarà possibile scaricare accedendo al Menu Amministrazione e selezionando Attività di Background. Individuare l’attività nell’elenco per scaricare il file.
Recuperare l'ID del Corso e l'ID della Sessione
È possibile recuperare sia l'ID del corso che l'ID della sessione dall'URL del corso. Accedere alla pagina I Miei Corsi e Piani Formativi dal Menu utente, cliccare sulla card di un corso e controllare l'URL.
L'ID del corso è il numero che segue course/
https://mylearningplatform.com/learn/course/181/summer-vibes
L'ID della sessione è il numero che segue session/
https://mylearningplatform.com/learn/course/175/session/158/how-to
Consigli d'Utilizzo
- La dimensione massima accettata per i file CSV è di 3 MB.
- I Power User possono iscrivere utenti e assegnare istruttori solo ai corsi a loro assegnati.
- Se un corso o una sessione hanno un limite di iscrizione, l'import rispetterà questo limite e solo i primi utenti del file CSV verranno importati fino al raggiungimento della capacità massima di iscrizione. Una volta raggiunto il limite, eventuali utenti aggiuntivi saranno inseriti nella lista d'attesa.
- Quando si scarica il file di esempio, il formato delle date è YYYY-MM-DD, ma il file potrebbe visualizzarle in modo diverso, in base al programma utilizzato per aprire il file.
- Questa procedura iscrive gli utenti ai corsi attraverso file CSV e non è possibile utilizzarla per gestire lo stato delle iscrizioni. Per questo motivo, quando si iscrivono degli utenti ai corsi via CSV, lo stato dell'iscrizione è sempre riportato a iscritto.