Introduzione
I corsi ILT (formazione con istruttore e VILT (formazione virtuale con istruttore) permettono di importare sessioni ed eventi utilizzando file CSV, velocizzando il processo di creazione delle sessioni e degli eventi in piattaforma.
Requisiti e limitazioni
- Alcuni sistemi esterni, come Zoom (si apre in una nuova scheda), potrebbero applicare limitazioni al numero di eventi creati in un determinato periodo. Ricordarsi di verificare se queste limitazioni sono presenti prima dell'import.
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 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.
- 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 scheda 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 Docebo Learn | Note |
|---|---|
course_id |
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 ma entrambi i campi non possono coesistere nella stessa riga, altrimenti la procedura di import restituirà un errore. Valori accettati: |
course_uuid |
Identificativo alfanumerico univoco del corso, calcolato dalla piattaforma al momento della creazione del corso. Non può essere modificato o rimosso. Per un import corretto, è necessario includere nel file CSV l'ID del corso o l'UUID del corso, ma entrambi i campi non possono coesistere nella stessa riga, o si riceverà un errore di import. Valori accettati: |
instructors_username |
L'elenco degli istruttori della sessione identificati dai loro username. I campi Instructor ID e Instructor Username sono facoltativi e non possono coesistere nella stessa riga, o si riceverà un errore di import. Questo campo è case sensitive. Valori accettati: Esempio: |
instructors_id |
L'elenco degli istruttori della sessione, identificati dal loro ID utente. I campi Instructors ID e Instuctors Username sono facoltativi e non possono coesistere nella stessa riga, o si riceverà un errore di import. Valori accettati: Esempio: |
id_session |
L'identificatore interno della sessione in un database specifico della piattaforma. È determinato dalla piattaforma e non può essere modificato o rimosso. Per un import corretto è necessario includere nel file CSV l'ID di sessione o l'UUID di sessione, ma i due campi non possono coesistere nella stessa riga, o si riceverà un errore di import. Valori accettati: |
session_uuid |
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 nel file CSV l'ID sessione o l'UUID sessione, ma i due campi non possono coesistere nella stessa riga, o si riceverà un errore di import. Questo campo è case sensitive. Valori accettati: |
name |
Nome della sessione. Valori accettati: |
code |
Codice della sessione. Valori accettati: |
description |
Descrizione della sessione. Valori accettati: |
min_enroll |
Il numero minimo di studenti che devono essere iscritti alla sessione. Valori accettati: |
max_enroll |
Il numero massimo di studenti che possono essere iscritti alla sessione. Valori accettati: |
score_base |
Il punteggio massimo per la valutazione della sessione. Deve essere maggiore o uguale a Valori accettati: |
enrollment_deadline |
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. Per ulteriori informazioni, vedere Gestire l'Auto Iscrizione e le Liste d'Attesa. Formato: Valori accettati: Esempio: |
custom_deadline_days |
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. Per ulteriori informazioni, vedere Gestire l'Auto Iscrizione e le Liste d'Attesa. Valori accettati: |
evaluation_type |
Tipo di valutazione della sessione. I possibili valori sono:
Valori accettati: |
min_attended_dates_for_completion |
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 valore del campo con un numero maggiore o uguale a Questo campo può essere utilizzato solo quando il Tipo di valutazione della sessione è impostato su Valori accettati: |
|
Non definito |
Campo aggiuntivo obbligatorio per la sessione. Se non compilato, non sarà possibile importare la sessione. Valori accettati: |
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 scheda 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 scheda Sessioni. Da qui, cliccare sul nome della sessione e spostarsi alla scheda Eventi e presenze. 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 | Note |
|---|---|
id_session |
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 ma i due campi non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. Valori accettati: |
session_uuid |
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 ma i due campi non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. Questo campo è case sensitive. Valori accettati: |
instructors_username |
Elenco degli istruttori dell'evento, identificati dal loro username. I campi Instructor ID e Instructor Username sono facoltativi, ma non possono coesistere nella stessa riga del file CSV, o genereranno un errore di import. Questo campo è case sensitive. Valori accettati: |
instructors_id |
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. Valori accettati: Esempio: |
event_id |
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. Valori accettati: |
name |
Nome dell'evento. Valori accettati: |
description |
Descrizione dell'evento. Valori accettati: |
day |
Data dell'evento. Formato: Valori accettati: Esempio: |
time_begin |
Ora di inizio dell'evento. Formato: Valori accettati: Esempio: |
time_end |
Ora di fine dell'evento. Formato: Valori accettati: Esempio: |
break_begin |
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. Formato: Valori accettati: Esempio: |
break_end |
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. Formato: Valori accettati: Esempio: |
timezone |
Questo campo deve corrispondere al formato del fuso orario della piattaforma, senza GMT + XX:XX. Per esempio, il formato del fuso orario di Gerusalemme è Maggiori dettagli sulla gestione del fuso orario in piattaforma. Valori accettati: |
id_location |
Identificativo della sede determinato dalla piattaforma. Non è modificabile e non può essere rimosso. Ogni evento deve avere un Location ID, o un Video Conference Tool o entrambi. Maggiori dettagli sulla gestione delle aule e delle sedi dei corsi. Valori accettati: |
id_classroom |
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. Maggiori dettagli sulla gestione delle aule e delle sedi dei corsi. Valori accettati: |
collaboration_tool |
Testo facoltativo che indica uno strumento di collaborazione esterno che permette agli studenti di entrare in contatto e interagire relativamente all'argomento del corso. Valori accettati: |
webinar_tool |
Utilizzare questo campo per definire lo strumento per videoconferenza utilizzato dall'evento VILT. I valori accettati sono:
Se non si utilizza uno strumento webinar supportato, impostare questo campo a Valori accettati: |
id_tool_account |
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 Valori accettati: |
password |
Password di accesso al webinar. Diventa obbligatoria quando il campo Video Conference Tool è valorizzato e non definito come Se non valorizzato, il sistema genera automaticamente una password per l'evento VILT. Valori accettati: Attenzione! Se si utilizza questa riga per importare un evento Zoom V3, il valore del campo password deve corrispondere ai requisiti per il passcode di Zoom. Per ulteriori informazioni, consultare Docebo VILT for Zoom Version 3. |
custom_url |
Questo campo è obbligatorio quando il campo Video Conference Tool è non è definito come Valori accettati: |
allow_recording_completion |
Se definito a Questo campo è obbligatorio quando il campo Video Conference Tool è valorizzato. Valori accettati: Esempio: ( |
allow_join_completion |
Questo campo è obbligatorio quando il campo Video Conference Tool è valorizzato. Valori accettati: Esempio: ( |
join_in_advance_time_user |
Indica quanto prima dell'orario di inizio previsto gli studenti possono connettersi a una videoconferenza. 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. Formato: Valori accettati: Esempio: Il valore di |
join_in_advance_time_teacher |
Indica quanto prima dell'orario di inizio previsto gli istruttori possono connettersi a una videoconferenza. 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. Formato: Valori accettati: Esempio: Il valore di |
xapi_oauth_account |
L'account OAuth xAPI (TinCan). Maggiori dettagli riguardo xAPI (ex TinCan API). Valori accettati: |
xapi_url |
L'URL del contenuto esterno xAPI (TinCan). Maggiori dettagli riguardo xAPI (ex TinCan API). Valori accettati: |
required_completion_percentage |
Questo campo è facoltativo e può essere utilizzato solo quando il campo Video Conference Tool è Maggiori dettagli riguardo Docebo per Adobe Connect Versione 2. Valori accettati: |
adobe_connect_v2_template |
Questo campo è facoltativo, e può essere vuoto. Rappresenta lo SCO-ID del template dell'account di Adobe Connect V2. Maggiori dettagli riguardo Docebo per Adobe Connect Versione 2. Valori accettati: |
adobe_connect_v2_folder |
Questo campo è facoltativo, e può essere vuoto. Rappresenta lo SCO-ID della cartella dell'account di Adobe Connect V2. Maggiori dettagli riguardo Docebo per Adobe Connect Versione 2. Valori accettati: |
adobe_connect_v2_room |
Questo campo è facoltativo ma diventa obbligatorio solo quando il campo Video Conference Tool è Rappresenta lo SCO-ID della room dell'account di Adobe Connect V2. Valori accettati: |
zoom_v3_account_id |
Questo campo rappresenta l'ID dell'account Zoom versione 3 associato all'integrazione. Maggiori dettagli riguarso Docebo VILT per Zoom Versione 3. Valori accettati: |
zoom_v3_host |
Questo campo rappresenta l'host Zoom V3. Accetta l'ID utente dell'utente host. Maggiori dettagli riguarso Docebo VILT per Zoom Versione 3. Valori accettati: |
zoom_v3_settings_template |
L'ID associato al template di Zoom. Maggiori dettagli riguarso Docebo VILT per Zoom Versione 3. Valori accettati: |
zoom_v3_percentage |
La percentuale di tempo che lo studente deve trascorrere nell'evento Zoom per essere contrassegnato come presente all'evento. Può essere un valore da Maggiori dettagli riguarso Docebo VILT per Zoom Versione 3. Valori accettati: |
zoom_v3_registration_enabled |
Abilita la registrazione obbligatoria per tutti gli utenti. Impostata a Deve essere impostato su
Attenzione: Docebo può tracciare l'avanzamento e la presenza di uno studente solo se è connesso a Zoom mentre partecipa a una riunione. Se uno studente non è connesso a Zoom, impostando questo valore a
Se non valorizzato, indica Maggiori dettagli riguarso Docebo VILT per Zoom Versione 3. Valori accettati: Esempio: ( |
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 scheda Events & Attendance della sessione.
I Power User possono importare eventi solo per i corsi a loro assegnati.