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 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 accettabili per il campo | Note |
|---|---|---|
username |
Valore 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. |
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 |
Valore stringa |
Codice del corso definito nella piattaforma. Bisogna 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. Bisogna includere nel file CSV o il Non includere un valore |
session_code |
Valore stringa |
Codice della sessione definito nella piattaforma. Bisogna 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 possono 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. |
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 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 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 accettabili per il campo | Note |
|---|---|---|
username |
Valore 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. Bisogna includere nel file CSV o il Non includere un valore |
session_code |
Valore stringa |
Codice della sessione definito nella piattaforma. Bisogna 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 possono 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. |
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 scheda 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 scheda 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.
Dopo il caricamento del file, premere Configurazione avanzata per configurare ulteriori opzioni.
Importante: 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.
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-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 CSV, lo stato dell'iscrizione è sempre riportato a iscritto.
Suggerimenti
- È possibile utilizzare i file CSV per cancellare le iscrizioni degli utenti da corsi e sessioni seguendo la stessa procedura.