Introduzione
Quando si utilizzano corsi ILT (Instructor-Led Training) e VILT (Virtual Instructor-Led Training), è possibile importare sessioni ed eventi utilizzando file CSV, velocizzando il processo di creazione delle sessioni e degli eventi in piattaforma.
Cosa sono i file CSV (.csv)?
I file Comma-Separated Values (CSV) contengono dati in in formato testo. Ogni riga dei file CSV identifica un dato. Ogni riga/dato è composto da più campi/colonne separati da un delimitatore.
I file CSV possono essere generati da diversi software (es. Excel, Google Sheets, Notepad, TextEdit, Emacs). Il contenuto del file deve utilizzare il formato standard CSV, ed deve avere estensione ".csv".
Come sono formattati i file CSV?
I file CSV hanno un formato standard:
- I campi/colonne sono separati da un carattere singolo che funge da delimitatore, solitamente virgola o punto e virgola
- Ogni dato/riga termina con una nuova riga
- Tutti i dati/righe hanno lo stesso numero di campi/colonne, nello stesso ordine
- Il primo dato/riga deve essere l'intestazione e contenere i nomi dei campi/colonne di ogni campo/colonna
- I dati di ogni campo sono interpretati come sequenza di caratteri, o testo semplice
- I campi devono essere identificati da virgolette
- I campi devono essere quotati nel caso in cui contengano uno o più caratteri speciali. Elenco completo di caratteri speciali.
- Gli spazi iniziali e finali sono considerati parti del campo
Importare Sessioni via CSV
Per importare più sessioni utilizzando file CSV, connettersi alla piattaforma come Superadmin. Accedere al Menu Amministrazione dall'icona ingranaggio in alto a destra. Nella sezione E-Learning, selezionare Gestione Corsi.
Dalla pagina Gestione Corsi identificare il corso ILT / VILT per il quale si desidera importare le sessioni via CSV, cliccare sulla descrizione e, una volta nell’area del corso, spostarsi alla tab Sessioni. Da qui, cliccare sul pulsante più e selezionare l’opzione Nuove Sessioni via CSV.
Nel pannello Importa Session ILT, trascinare il file CSV nella sezione di caricamento o premere Sfoglia per caricare il file dal proprio dispositivo.
Per un corretto caricamento, è importante che il file CSV sia formattato correttamente. Fare riferimento alla tabella che segue per ulteriori dettagli sui valori accettati per i campi relativi alle sessioni.
| Campo dati di Docebo Learn |
Valori Accettati
|
Note |
|---|---|---|
| Course ID | Numerico |
Identificativo interno del corso nel database di ogni piattaforma determinato dalla piattaforma. Non è modificabile e non può essere rimosso. Per un import corretto, è necessario includere il campo Course ID o il campo Course UUID nel file CSV. Ricorda che questi due campi non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. |
| Course UUID | Stringa |
Identificativo alfanumerico univoco del corso, calcolato dalla piattaforma al momento della creazione del corso. Non è modificabile e non può essere rimosso. Per un import corretto, è necessario includere il campo Course ID o il campo Course UUID nel file CSV. Ricorda che questi due campi non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. Questo campo è case sensitive. |
| Session ID | Numerico |
Identificativo interno della sessione nel database di ogni piattaforma determinato dalla piattaforma. Non è modificabile e non può essere rimosso. Quando questo campo è valorizzato, il processo di import aggiornerà la sessione con i dati definiti nel file CSV. Ricorda che il campo Session ID e il campo Session UUID non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. |
| Session UUID | Stringa |
Identificativo alfanumerico univoco della sessione, calcolato dalla piattaforma al momento della creazione del corso. Non è modificabile e non può essere rimosso. Quando questo campo è valorizzato, il processo di import aggiornerà la sessione con i dati definiti nel file CSV. Ricorda che il campo Session ID e il campo Session UUID non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. Questo campo è case sensitive. |
| Session Name | Stringa | |
| Session Code | Stringa | |
| Description | Stringa | |
| Instructor User ID(s) | Numerico (array) Esempio: 1104,3478,7231 |
Elenco degli istruttori della sessione, identificati dallo User ID. I campi Instructo User ID e Instructor Username sono facoltativi, ma non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. |
| Instructor Username(s) | Stringa (array) |
Elenco degli istruttori della sessione, identificati dallo Username. Questo campo è case sensitive. |
| Minimum Enrollments | Numerico | |
| Maximum Enrollments | Numerico | Questo campo è obbligatorio. |
| Self-Enrollment Deadline |
YYYY-MM-DD Example: 2022-03-17 |
Data ultima per lo studente per autoiscriversi alla sessione. I campi Self Enrollment Deadline e Self Enrollment Dynamic Deadline non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. |
| Self Enrollment Dynamic Deadline Days |
Numerico |
Il numero di giorni prima della data di inizio. della sessione durante i quali lo studente per autoiscriversi alla sessione. La data di inizio della sessione è il primo giorno del primo evento della sessione, in ordine cronologico. I campi Self Enrollment Deadline e Self Enrollment Dynamic Deadline non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. |
| Evaluation Type | Numerico |
Tipo di valutazione della sessione. I possibili valori sono:
|
| Evaluation Score Base | Numerico |
Punteggio massimo per la valutazione della sessione. Deve essere maggiore o uguale a 0. Questo campo è obbligatorio quanto il campo Evaluation Type è definito a 0 (In Base alla Valutazione). Non è richiesto per gli altri tipi di valutazione. |
| Minimum Events Attendance | Numerico |
Numero minimo di eventi che gli utenti devono frequentare in una sessione affinché sia identificata come completata. Se questo campo non è definito, il tipo di completamento è definito come All Events. Definire il campo Custom Number of Events come un numero maggiore o uguale a 0. Questo campo può essere utilizzato solo quando il il campo Evaluation Type è definito a 2 (In Base alla Frequenza) o la procedura di import restituirà un errore. |
|
Mandatory Session Additional Field 1 |
Valore del Campo Aggiuntivo |
Campo aggiuntivo obbligatorio per la sessione. Se non compilato, non sarà possibile importare la sessione. |
|
Mandatory Session Additional Field 2 |
Valore del Campo Aggiuntivo |
Campo aggiuntivo obbligatorio per la sessione. Se non compilato, non sarà possibile importare la sessione. |
Premere Scarica il file CSV di esempio per visualizzare un esempio di formattazione corretta. Le date devono essere formattate come aaaa-gg-mm, ma la visualizzazione potrebbe variare in base al programma utilizzato per aprire il file CSV di esempio.
La dimensione massima consentita per il file CSV importabili in piattaforma è di 3 MB.
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 presente nel file CSV), e selezionare il Charset del File dal menu a tendina. Il charset consigliato è UTF-8, che è uno 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, e aprirà la pagina per la mappatura dei campi inclusi nel file CSV con i campi disponibili in Docebo.
La sezione Anteprima mostra come il file CSV è stato letto dal sistema. Trascinare i campi del CSV nella sezione di sinistra in modo da far combaciare i campi presenti nel file con i nomi dei campi accettati dalla piattaforma.
Al termine della mappatura, controllare le informazioni. Prima di procedere, decidere se salvare la mappatura corrente come un preset, in modo che possa essere utilizzata anche per gli import futuri. Per procedere in questa direzione, nell’area Preset del pannello di sinistra, premere Salva come nuova configurazione. Nel pop-up, definire un nome per il preset e premere Salva. Una volta creato il preset, non è possibile cancellarlo, ma è possibile sovrascriverlo cliccando Sovrascrivi la configurazione attuale.
Premere quindi Importa in fondo alla pagina. Il pulsante Importa è attivo solo quando tutti i campi obbligatori (Course ID, Session Name, Maximum Enrollments Evaluation Type, Maximum Score se il tipo di valutazione è Evaluation Based) sono stati mappati. Leggere le informazioni nella finestra pop-up e premere Importa Session ILT.
L’import avviene in background. In caso di errori, sarà reso disponibile un file di log nella sezione Attività di Background della piattaforma, accessibile dal Menu Amministrazione.
Tutte le sessioni importate in piattaforma sono elencate nella tab Sessioni del corso.
I Power User possono importare sessioni solo per i corsi a loro assegnati.
Importare Eventi via CSV
Per importare più sessioni ILT / VILT attraverso file CSV, dalla pagina Gestione Corsi identificare il corso ILT / VILT per il quale si desidera importare le sessioni via CSV, cliccare sulla descrizione e, una volta nell’area del corso, spostarsi alla tab Sessioni. Da qui, cliccare sul nome della sessione e spostarsi alla tab Events & Attendance. Cliccare il pulsante più in alto a destra e selezionare l’opzione Nuovi Eventi via CSV.
Nel pannello Importa Eventi ILT, trascinare il file CSV nella sezione di caricamento o premere Sfoglia per caricare il file dal proprio dispositivo.
Per un corretto caricamento, è importante che il file CSV sia formattato correttamente. Ulteriori informazioni sui valori accettati per i campi relativi agli eventi.
| Campo dati di Docebo Learn | Valori Accettati | Note |
|---|---|---|
| Session ID | Numerico |
Identificativo interno della sessione nel database di ogni piattaforma determinato dalla piattaforma. Non è modificabile e non può essere rimosso. Per un import corretto, è necessario includere il campo Session ID o il campo Session UUID nel file CSV. Ricorda che questi due campi non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. |
| Session UUID | Stringa |
Identificativo alfanumerico univoco della sessione, calcolato dalla piattaforma al momento della creazione del corso. Non è modificabile e non può essere rimosso. Per un import corretto, è necessario includere il campo Session ID o il campo Session UUID nel file CSV. Ricorda che questi due campi non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. Questo campo è case sensitive. |
| Event ID | Numerico |
Identificativo alfanumerico univoco dell'evento, calcolato dalla piattaforma al momento della creazione del corso. Non è modificabile e non può essere rimosso. Quando questo campo è valorizzato, il processo di import aggiornerà la sessione con i dati definiti nel file CSV. |
| Event Name | Stringa | |
| Event Description | Stringa | |
| Event Date |
YYYY-MM-DD Esempio: 2022-03-17 |
|
| Event Start Time |
HH:mm:ss Esempio: 14:24:35 |
Questo campo è obbligatorio. |
| Event End Time |
HH:mm:ss Esempio: 14:24:35 |
Questo campo è obbligatorio. |
| Break Start Time |
HH:mm:ss Esempio: 14:24:35 |
La durata della pausa è facoltativa ma, quando usata, è necessario valorizzare sia il campo Break Start Time che il campo Break End Time. Il valore del campo Break End Time deve essere successivo al valore del campo Break Start Time. |
| Break End Time |
HH:mm:ss Esempio: 14:24:35 |
La durata della pausa è facoltativa ma, quando usata, è necessario valorizzare sia il campo Break Start Time che il campo Break End Time. Il valore del campo Break End Time deve essere successivo al valore del campo Break Start Time. |
| Time Zone |
Region/Local Esempio: Europe/Rome |
Questo campo deve corrispondere al formato del fuso orario della piattaforma, senza GMT + XX:XX. Maggiori dettagli sulla gestione del fuso orario in piattaforma. Per esempio, il formato del fuso orario di Gerusalemme è "Asia/Jerusalem", mentre il formato di Praga è "Europe/Prague". Questo campo è case sensitive. |
| Instructor User ID(s) |
Numerico (array) Esempio: 1105, 2347, 7321 |
Elenco degli istruttori dell'evento, identificati dallo User ID. I campi Instructo User ID e Instructor Username sono facoltativi, ma non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. |
| Instructor Username(s) | Stringa o numerico (array) |
Elenco degli istruttori dell'evento, identificati dallo Username. Questo campo è case sensitive. |
| Location ID | Numerico |
Identificativo della sede determinato dalla piattaforma. Non è modificabile e non può essere rimosso. Ogni evento deve avere un Location ID, o un Webinar Tool o entrambi. |
| Classroom ID | Numerico |
Identificativo dell'aula determinato dalla piattaforma. Non è modificabile e non può essere rimosso. Questo campo è facoltativo e può essere indicato quando si definisce il campo Location ID. |
| Collaboration Tool | Stringa |
Testo facoltativo che indica uno strumento di collaborazione esterno che permette agli studenti di entrare in contatto e interagire relativamente all'argomento del corso. |
| Video Conference Tool | Stringa |
Utilizzare questo campo per definire lo strumento per videoconferenza utilizzato dall'evento VILT. I valori accettati sono:
|
| Video Conference Account ID | Numerico |
Identificativo dell'account webinar determinato dalla piattaforma. Non è modificabile e non può essere rimosso. Diventa obbligatorio quando il campo Video Conference Tool è valorizzato e non definito come "custom". Non deve essere utilizzato in altre circostanze. |
| Passcode / Meeting Password | Stringa |
Password di accesso al webinar. Diventa obbligatorio quando il campo Video Conference Tool è valorizzato e non definito come "custom". Non deve essere utilizzato in altre circostanze. Se non valorizzato, il sistema genera automaticamente una password per l'evento VILT. |
| Video Conference Custom URL | Stringa |
Questo campo è obbligatorio quando il campo Video Conference Tool è definito come "custom". Non deve essere utilizzato in altre circostanze. |
| Mark the event as attended if the user accesses the recordings |
Booleano true/false |
Questo campo è obbligatorio quando il campo Video Conference Tool è valorizzato. |
| Mark the event as attended if the user joins the webinar |
Booleano true/false |
Questo campo è obbligatorio quando il campo Video Conference Tool è valorizzato. |
| Join in Advance Time for Learner |
HH:mm Esempio: 16:03 |
Questo campo è facoltativo e può essere utilizzato solo quando il campo Video Conference Tool è valorizzato e quando si configurano le Opzioni Pulsante Partecipa per studenti e istruttori. Il Tempo in Anticipo Partecipazione Studente non deve essere prima del valore degli istruttori. |
| Join in Advance Time for Instructor |
HH:mm Esempio: 18:46 |
Questo campo è facoltativo e può essere utilizzato solo quando il campo Video Conference Tool è valorizzato e quando si configurano le Opzioni Pulsante Partecipa per studenti e istruttori. Il Tempo in Anticipo Partecipazione Istruttore non deve essere successivo al valore degli studenti. |
| Adobe Connect % for Completion | Numerico |
Questo campo è facoltativo e può essere utilizzato solo quando il campo Video Conference Tool è Adobe Connect V2 Meeting o Adobe Connect V2 Webinar. |
| Adobe Connect v2 Template | Stringa |
Questo campo è facoltativo, e può essere vuoto. Rappresenta lo SCO-ID del template dell'account di Adobe Connect V2. |
| Adobe Connect v2 Folder | Stringa |
Questo campo è facoltativo, e può essere vuoto. Rappresenta lo SCO-ID della cartella dell'account di Adobe Connect V2. |
| Adobe Connect v2 Room | Stringa |
Questo campo è facoltativo e può essere utilizzato solo quando il campo Video Conference Tool è Adobe Connect V2 Seminar. Rappresenta lo SCO-ID della room dell'account di Adobe Connect V2. |
Premere Scarica il file CSV di esempio per visualizzare un esempio di formattazione corretta. Le date devono essere formattate come aaaa-gg-mm, ma la visualizzazione potrebbe variare in base al programma utilizzato per aprire il file CSV di esempio.
La dimensione massima consentita per il file CSV importabili in piattaforma è di 3 MB.
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 presente nel file CSV), e selezionare il Charset del File dal menu a tendina. Il charset consigliato è UTF-8, che è uno 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, e aprirà la pagina per la mappatura dei campi inclusi nel file CSV con i campi disponibili in Docebo.
Al termine della mappatura, controllare le informazioni. Prima di procedere, decidere se salvare la mappatura corrente come un preset, in modo che possa essere utilizzata anche per gli import futuri. Per procedere in questa direzione, nell’area Preset del pannello di sinistra, premere Salva come nuova configurazione. Nel pop-up, definire un nome per il preset e premere Salva. Una volta creato il preset, non è possibile cancellarlo, ma è possibile sovrascriverlo cliccando Sovrascrivi la configurazione attuale.
Premere quindi Importa in fondo alla pagina. Il pulsante Importa è attivo solo quando tutti i campi obbligatori (Session ID, Date Name, Day, Start Time, Time End, Time Zone e i campi obbligatori in base al tipo di evento) sono stati mappati. Leggere le informazioni nella finestra pop-up e premere Importa Eventi ILT.
L’import avviene in background. In caso di errori, sarà reso disponibile un file di log nella sezione Attività di Background della piattaforma, accessibile dal Menu Amministrazione.
Tutti gli eventi importati sono elencati nella tab Events & Attendance della sessione.
I Power User possono importare eventi solo per i corsi a loro assegnati.