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 di formazione con istruttore (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 (formazione con istruttore)
- gestire le iscrizioni
- gestire le autoiscrizioni e la lista d'attesa
Iscrivere utenti a più corsi e sessioni utilizzando file CSV
Per iscrivere utenti a più di un corso o a più di una sessione alla volta utilizzando file CSV, accedere come Superadmin, accedere al Menu di navigazione > Contenuto e consegna (icona cartella) > Corsi. Cliccare su Gestione iscrizioni nell'angolo in alto a destra e selezionare Gestisci iscrizioni tramite CSV.
Si aprirà sulla destra della piattaforma il pannello a scomparsa Gestione iscrizioni da CSV. Selezionare l'opzione Iscrivi utenti.
Per un corretto caricamento del file, è importante creare un file CSV formattato correttamente. Fare riferimento alla tabella seguente per i valori accettati per i campi dei dati di sessione.
| Campo dati Docebo Learn | Valori CSV accettabili per il campo | Note |
|---|---|---|
username |
Stringa |
L'elenco degli utenti da iscrivere, identificati dai loro nomi utente. Questo campo è obbligatorio. |
level |
Valori possibili:
|
Il livello dell'utente nel corso. Suggerimento: Questo campo è obbligatorio quando si iscrivono utenti tramite file CSV, ma opzionale quando si annulla l'iscrizione. |
course_id |
Valore numerico |
L'identificatore interno del corso nel database della piattaforma; è determinato dalla piattaforma e non può essere modificato o rimosso.
Devi includere nel file CSV o il
|
course_code |
Stringa |
Codice del corso definito nella piattaforma.
Devi includere nel file CSV o il
|
session_id |
Valore numerico |
L'identificatore interno della sessione nel database della piattaforma. È determinato dalla piattaforma e non può essere modificato o rimosso. Devi includere nel file CSV o il
Non includere un valore
|
session_code |
Stringa |
Codice della sessione definito nella piattaforma. Devi includere nel file CSV o il
Non includere un valore
|
active_from |
Esempio: |
Data di inizio validità dell'iscrizione. Il formato predefinito della data è UTC. Questo campo NON è obbligatorio. |
active_until |
Esempio: |
Data di fine validità dell'iscrizione. Il formato predefinito della data è UTC. Questo campo NON è obbligatorio. |
timezone |
Espresso secondo il database dei fusi orari IANA (Europe/Rome, ecc.). Se non specificato, il formato predefinito è UTC. Questo campo è opzionale e solo a scopo informativo. Non influisce sulle date di inizio o fine iscrizione. |
|
enrollment_attribute |
Valori possibili:
|
Se l'opzione Mostra gli attributi di iscrizione è abilitata nel menu impostazioni avanzate della piattaforma, si può configurare la priorità di iscrizione per chiarire l'importanza del piano formativo o per gli utenti, indicando se è obbligatorio, richiesto, raccomandato o opzionale. |
field_{id} |
Il valore dipende dal tipo di campo aggiuntivo di iscrizione:
|
Identifica i campi aggiuntivi di iscrizione tramite il loro ID, se sono stati configurati sulla piattaforma. Questo campo può essere opzionale o obbligatorio, a seconda della configurazione di ogni campo. Quando il campo è obbligatorio e richiesto solo per una categoria di corsi, bisogna comunque mappare il campo per tutti i corsi, ma sarà importato solo per le iscrizioni ai corsi all'interno di quella categoria. Le iscrizioni ai corsi appartenenti ad altre categorie saranno importate senza il campo aggiuntivo obbligatorio. |
Cliccare su Scarica il file CSV di esempio per visualizzare un esempio di file CSV formattato correttamente. 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 fornite nel 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 scheda Iscrizioni del corso, dove è possibile modificare i dettagli delle iscrizioni.
Iscrivere utenti a un solo corso o sessione utilizzando file CSV
Per iscrivere utenti a un singolo corso o alle sessioni di un corso utilizzando file CSV, accedere come Superadmin, accedere al Menu di navigazione > Contenuto e consegna (icona cartella) > Corsi.
Individuare il corso nella pagina Gestione Corsi, cliccare sulla descrizione per accedere all'area del corso e cliccare su Gestione iscrizioni in alto a destra. Selezionare Gestione iscrizioni via CSV.
Sul lato destro della piattaforma si aprirà il pannello a scomparsa Gestione Iscrizioni via CSV. Selezionare l'opzione Iscrivi utenti.
Per un corretto caricamento del file, è importante creare un file CSV formattato correttamente. Fare riferimento alla tabella seguente per i valori accettati per i campi dei dati di sessione.
| Campo dati Docebo Learn | Valori CSV accettabili per il campo | Note |
|---|---|---|
username |
Stringa |
L'elenco degli utenti da iscrivere, identificati dai loro nomi utente. Questo campo è obbligatorio. |
level |
Valori possibili:
|
Il livello dell'utente nel corso. Questo campo è obbligatorio. |
session_id |
Valore numerico |
L'identificatore interno della sessione nel database della piattaforma. È determinato dalla piattaforma e non può essere modificato o rimosso. Devi includere nel file CSV o il
Non includere un valore
|
session_code |
Stringa |
Codice della sessione definito nella piattaforma. Devi includere nel file CSV o il
Non includere un valore
|
active_from |
Esempio: |
Data di inizio validità dell'iscrizione. Il formato predefinito della data è UTC. Questo campo NON è obbligatorio. |
active_until |
Esempio: |
Data di fine validità dell'iscrizione. Il formato predefinito della data è UTC. Questo campo NON è obbligatorio. |
timezone |
Espresso secondo il database dei fusi orari IANA (Europe/Rome, ecc.). Se non specificato, il formato predefinito è UTC. Questo campo è opzionale e solo a scopo informativo. Non influisce sulle date di inizio o fine iscrizione. |
|
enrollment_attribute |
Valori possibili:
|
Se l'opzione Mostra gli attributi di iscrizione è abilitata nel menu delle impostazioni avanzate della piattaforma, si può configurare la priorità dell'iscrizione per chiarire l'importanza del piano formativo o per gli utenti, indicando se è obbligatorio, richiesto, raccomandato o opzionale. |
field_{id} |
Il valore dipende dal tipo di campo aggiuntivo di iscrizione:
|
Identifica un campo aggiuntivo di iscrizione tramite il suo ID, se sono stati configurati sulla piattaforma. Questo campo può essere opzionale o obbligatorio, a seconda della configurazione di ciascun campo. |
Cliccare su Scarica il file CSV di esempio per visualizzare un esempio di file CSV formattato correttamente. 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 fornite nel 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 scheda Iscrizioni del corso, dove è possibile modificare i dettagli delle iscrizioni.
Assegnare gli istruttori delle sessioni utilizzando file CSV
Per assegnare istruttori alle sessioni tramite CSV, accedere come Superadmin, accedere al Menu di navigazione > Contenuto e consegna (icona cartella) > Corsi.
Individuare il corso nella pagina Gestione corsi, cliccare sulla descrizione per accedere all'area del corso, spostarsi alla scheda Sessioni e cliccare sul pulsante più in alto a destra, quindi selezionare l’opzione Assegnare istruttori alla sessione via CSV.
Nel pannello Importa istruttori ILT, trascinare il file CSV nella sezione di caricamento, o premere il pulsante Sfoglia per caricare il file dal proprio dispositivo.
Per un corretto caricamento del file, è importante creare un file CSV formattato correttamente. Fare riferimento alla tabella seguente per i valori accettati per i campi dei dati di sessione.
| Campo dati Docebo Learn | Valori CSV accettabili per il campo | Note |
|---|---|---|
session_id |
Valore numerico |
L'identificatore interno della sessione nel database della piattaforma. È determinato dalla piattaforma e non può essere modificato o rimosso. Questo campo è obbligatorio. |
instructor_user_id |
Valore numerico |
ID utente dell'istruttore della sessione. Questo campo è obbligatorio. |
Cliccare su Scarica il file CSV di esempio per visualizzare un esempio di file CSV formattato correttamente. 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.
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.
Dopo il caricamento del file, premere Configurazione avanzata per configurare ulteriori opzioni.
Attenzione! Quando si carica il file CSV, selezionare manualmente il separatore di campo utilizzato per organizzare le informazioni in colonne. Selezionare il delimitatore appropriato dal menu a tendina (ad esempio: virgola, punto e virgola o un altro carattere) in base al formato del file CSV.
Le informazioni possono essere separate da una virgola, un punto e virgola o manualmente, a seconda delle 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.
Il sistema elaborerà il file CSV. Una volta pronto, sarai reindirizzato alla 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 il pulsante Sovrascrivi configurazione attuale se si desidera salvare le modifiche al preset corrente. È inoltre possibile mappare manualmente le colonne dei campi della piattaforma (ulteriori informazioni in seguito), quindi salvare la configurazione premendo il pulsante Salva come nuova configurazione. Nella finestra pop-up, definire il nome 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 per 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 il pulsante Importa in fondo alla pagina. Confermare le informazioni nel messaggio pop-up che verrà visualizzato, quindi premere Iscrivi utenti.
L'attività di importazione avviene tramite un' attività di background. In caso di errori, un file di errore sarà reso disponibile per il download. Per trovare questo file, accedere alla voce Menu di navigazione > Dati e analisi (icona grafico) > Attività di background. Trovare 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. Per farlo, 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-vibesL'ID della sessione è il numero che segue session/
https://mylearningplatform.com/learn/course/175/session/158/how-toConsigli 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 file CSV, lo stato dell'iscrizione al corso dell'utente è sempre riportato a iscritto.
- Per le importazioni CSV che specificano una Fine validità iscrizione (campo
active_until), se si verifica un cambio di orario stagionale di un'ora nel periodo compreso tra il momento in cui viene effettuata l'importazione CSV e la “fine della validità” specificata, la “fine della validità” verrà conseguentemente spostata di un'ora.
Suggerimenti
- È possibile utilizzare i file CSV per cancellare le iscrizioni degli utenti da corsi (e di conseguenza dalle loro sessioni) seguendo la stessa procedura. Annullare l'iscrizione di utenti solo dalle sessioni tramite CSV non è attualmente supportato.