Introduzione
A partire dal 26 Gennaio 2021, i corsi in aula e i webinar sono considerati una sola entità in piattaforma, e identificati come corsi ILT (Instructor-Led Training). Il miglioramento della gestione di questa funzionalità così centrale per vita della piattaforma è accompagnata da modifiche importanti, allo scopo di rendere più flessibile la definizione e la gestione dei webinar e dei corsi in aula.
Questo articolo elenca le modifiche introdotte dalla nuova gestione e offre una panoramica sulle API che sono state modificate, create e che saranno dismesse.
Per ulteriori informazioni sulla migrazione dei corsi webinar come corsi ILT, fare riferimento all'articolo dedicato della Knowledge Base e all'articolo della Knowledge Base che raccoglie le domande più frequenti al riguardo.
Sessioni Webinar e In Aula nello Stesso Corso
La vecchia gestione dei webinar e dei corsi in aula non permette di combinare sessioni webinar e in aula per lo stesso corso. È possibile definire corsi webinar o corsi in aula. La conversione di un corso in aula in un webinar richiede molti passaggi: la creazione di un nuovo corso, la duplicazione di tutte le sessioni del corso originario nel nuovo corso e infine l’iscrizione degli utenti alle sessioni del nuovo corso.
Grazie alla nuova gestione dei webinar e dei corsi in aula è possibile definire se ogni evento che compone la sessione (attualmente chiamato data della sessione) è un evento webinar oppure in aula. Grazie a questa flessibilità è possibile creare sessioni che includono entrambe le tipologie di evento e di modificare il tipo di evento (per esempio, trasformare un evento in aula in un evento webinar) senza creare la sessione da zero, e senza iscrivere nuovamente tutti gli studenti.
Iscrizioni degli Istruttori
Con la vecchia gestione dei corsi in aula e dei webinar, gli istruttori devono iscriversi o essere iscritti al corso con il livello di Istruttore. L’iscrizione dell’istruttore conta come l’iscrizione degli studenti (anche per il calcolo del numero massimo di istruzioni), ed è quindi necessario che ogni istruttore abbia un posto nel corso.
Con la nuova gestione dei webinar e dei corsi in aula, gli istruttori sono assegnati alla sessione, o all’evento della sessione senza essere iscritti, lasciano posto agli studenti. È quindi possibile assegnare gli istruttori alla sessione o all’evento di una sessione:
- Istruttore per una Sessione. Quando si assegna un istruttore ad una sessione, sarà automaticamente assegnato a tutti gli eventi che compongono la sessione. Potrà confermare o meno la presenza degli studenti per tutti gli eventi della sessione e approvare o meno il completamento della sessione. In questo scenario, l’istruttore potrà creare e gestire i materiali didattici del corso. Stiamo lavorando sulla possibilità di associare i materiali didattici alle sessioni, controlla regolarmente la pagina degli Aggiornamenti di Prodotto per sapere quando rilasceremo questa funzionalità.
- Istruttore per un Evento. Se si assegna un istruttore ad un solo evento all’interno di una sessione, potrà confermare o meno la presenza degli studenti per quell’evento, ma non avrà controllo sugli altri eventi della sessione. In questo scenario, l’istruttore non potrà caricare o gestire i materiali didattici assegnati al corso.
Report
La nuova gestione delle iscrizioni degli istruttori per i corsi in aula e per i webinar ha un impatto sui report, poiché gli istruttori assegnati a questo tipo di corsi sono attualmente conteggiati come utenti iscritti al corso, e queste iscrizioni non sono considerate tali nella nuova gestione. Ecco come Docebo conteggia le iscrizioni, in diversi scenari:
- Nuovi Report Personalizzati. Per chi utilizza i nuovi report personalizzati, al fine di garantire coerenza con i dati della vecchia gestione dei corsi, i report conteggiano di default gli istruttori assegnati al corso come utenti iscritti al corso, ma è possibile utilizzare un’opzione dedicata per mostrare o meno gli istruttori nel report (opzione Mostra solo gli utenti il cui livello utente nei corsi è "studente" nella sottosezione Opzioni Utente della tab Filtri). Di default, questa opzione non è abilitata, e gli utenti sono conteggiati tra gli utenti iscritti. Se invece si abilita l’opzione, gli istruttori non verranno conteggiati tra gli utenti iscritti e non verranno mostrati nel report. I nuovi report personalizzati impattati da queste modifiche sono:
- Utenti - Corsi
- Utenti - Tempistiche di Completamento
- Utenti - Sessioni Webinar
- Utenti - Sessioni ILT
- Gruppi/Rami - Corsi
- Utenti - Materiali Didattici
Nel report di tipo Corsi - Utenti, l’opzione Mostra solo gli utenti il cui livello utente nei corsi è "studente" è abilitata di default (e gli istruttori non vengono mostrati nel report), ma è possibile disabilitarla quando serve che gli istruttori siano inclusi nel proprio report.
Più in dettaglio, i report Utenti - Corsi, Utenti - Sessioni ILT e Utenti - Sessioni Webinar hanno subito le seguenti modifiche:
-
- Utenti - Corsi:
- Tab Filtri > Area Iscrizioni > la sezione è stata rinominata da Stato Iscrizione a Stato Iscrizione Corso
- Tab Opzioni di Visualizzazione > Area Campi Report > Sezione Campi di Iscrizione > Il campo Stato Iscrizione è stato rinominato come Stato Iscrizione Corso
- In Anteprima e in Download (sia in formato CSV che in formato XLS), il campo Stato Iscrizione è stato rinominato come Stato Iscrizione Corso e rappresenta solo le iscrizioni al corso, non includendo le iscrizioni alle sessioni.
- Utenti - Corsi:
-
- Utenti - Sessioni ILT e Utenti - Sessioni Webinar
- Tab Filtri:
- Nell'area Iscrizione, la sezione è stata rinominata da Stato Iscrizione a Stato Iscrizione Sessione
- L'opzione Non Iniziato è stata rinominata come Iscritto
- L'opzione Lista d'Attesa è stata rinominata come Utenti in Attesa
- Tab Opzioni di Visualizzazione
- Nell'area Campi Report, sezione Campi di Iscrizione, l'opzione Stato Iscrizione è stata rinominata come Stato Iscrizione Corso
- Ci sono quattro nuove opzioni disponibili: Stato Iscrizione Sessione, Data Iscrizione Sessione, Data Completamento e Data Completamento Sessione
- In Anteprima e in Download (sia in formato CSV che in formato XLS)
- Il campo Stato Iscrizione è stato rinominato come Stato Iscrizione Corso e rappresenta solo le iscrizioni ai corsi, escludendo le iscrizioni alle sessioni
- La nuova colonna Stato Iscrizione Sessione mostra lo stato delle iscrizioni alle sessioni come nella gestione del corso nell'area Gestione Corsi.
- Tab Filtri:
- Utenti - Sessioni ILT e Utenti - Sessioni Webinar
- Vecchi Report Personalizzati e Dashboard. Poiché l’attuale gestione dei report personalizzati è in via di dismissione, Docebo non apporterà modifiche in questa area, così come nelle dashboard di piattaforma per gestire il nuovo metodo di conteggio delle iscrizioni degli istruttori. Per esempio, se il Corso A ha 20 utenti iscritti, inclusi 2 istruttori, dopo il rilascio della nuova gestione dei corsi in aula e dei webinar, il numero delle iscrizioni mostrato in questi report sarà di 18. I vecchi report personalizzati impattati sono:
- Utenti - Corsi
- Utente - Sessione
- Utenti - Tempistiche di Completamento
- Corsi - Utenti
- Gruppi - Corsi
Le dashboard impattate sono:
-
- Report Attività Utente, tab Statistiche, tab Corsi, tab In Aula, tab Piani Formativi
- Panoramica Corsi
- Dashboard dei Rami dell'Organigramma
Consigliamo di migrare ai nuovi report personalizzati per usufruire del nuovo metodo di calcolo, così come delle altre funzionalità incluse nella nuova esperienza. Scopri di più.
La nuova gestione delle iscrizione è attualmente disponibile solo per i corsi ILT, non per i corsi e-learning. Gli istruttori dei corsi e-learning continueranno ad essere conteggiati come utenti iscritti al corso. Tuttavia, per i nuovi report personalizzati, l’opzione Mostra solo gli utenti il cui livello utente nei corsi è "studente" è disponibile per tutti i tipi di corso, ILT e e-learning.
Campi Aggiunti per i Corsi
A partire dal 26 Gennaio 2021, e fino al termine della migrazione dei corsi webinar, i campi aggiuntivi per i corsi creati con l’opzione Sessioni Webinar saranno disponibili solo per le sessioni webinar dei corsi di tipo Webinar (Deprecated Soon). I campi aggiuntivi per i corsi creati con l’opzione Sessioni ILT saranno disponibili sia per le sessioni in aula che per le sessioni webinar create per i corsi di tipo ILT ( Instructor-Led Training). I campi aggiuntivi per i corsi creati con l’opzione Sessioni Webinar saranno dismessi con il rilascio mensile del febbraio 2022, in piano per il 23 febbraio 2022.
Nuova Interfaccia Utente
Con la vecchia gestione dei webinar e dei corsi in aula, l’area dei corsi dedicata alle sessioni e alle iscrizioni è concentrata in una sola tab.
Con la nuova gestione dei webinar e dei corsi in aula, l’interfaccia utente dedicata alla gestione di sessioni ed iscrizioni è stata ridisegnata e divisa in due tab dedicate. Grazie a questa nuova visualizzazione, i dati di queste due aree sono chiaramente suddivisi, offrendo una migliore leggibilità.
Migrazione
Maggiori informazioni sulla migrazione dei corsi webinar sono disponibili nell'articolo Migrazione dei Corsi Webinar come Corsi VILT della Knowledge Base.
Glossario
Segue un piccolo glossario dei termini utilizzati nella nuova gestione di webinar e corsi in aula:
- Evento: è il nuovo nome della data della sessione. Un evento può essere di tipo webinar o in aula.
- ILT (Instructor-Led Training): questo termine, attualmente identifica i corsi in aula in piattaforma. Nella nuova gestione dei webinar e dei corsi in aula, identificherà sia i corsi in aula che i webinar, poiché entrambe le tipologie di corso sono gestite da istruttori.
- Webinar (Obsoleto a Breve): questo termine identifica i corsi di tipo webinar dopo la prima fase della migrazione. Non preoccuparti, tutto funziona come sempre, ma consigliamo di iniziare ad utilizzare il tipo di corso ILT (Instructor-Led Training) anche per i webinar il prima possibile.
API
Questa sezione elenca le API impattate dalla transizione, e come saranno gestite.
API Dismesse il 26 Gennaio 2021
Le API elencate nella tabella che segue sono state dismesse il 26 Gennaio 2021, al rilascio della nuova gestione di webinar e corsi in aula.
Descrizione API | Verbo API | URL API |
---|---|---|
Delete a session enrollment | DELETE | /learn/v1/enrollment/{id_course}/{id_user}/ilt/session/{id_session} |
Retrieve a session enrollment | GET | /learn/v1/enrollment/{id_course}/{id_user}/ilt/session/{id_session} |
Create a session enrollment | POST | /learn/v1/enrollment/{id_course}/{id_user}/ilt/session/{id_session} |
Update a session enrollment | PUT | /learn/v1/enrollment/{id_course}/{id_user}/ilt/session/{id_session} |
Evaluate users within a session | PUT | /learn/v1/enrollment/{id_course}/{id_user}/ilt/session/{id_session}/evaluation |
Delete attendance of users within a session | DELETE | /learn/v1/enrollment/{id_course}/{id_user}/ilt/session/{id_session}/attendance |
Mark attendance of users within a session | POST | /learn/v1/enrollment/{id_course}/{id_user}/ilt/session/{id_session}/attendance |
API Completamente o Parzialmente Dismesse a Fine Febbraio 2022
Le API elencate nella tabella che segue sono da considerarsi delle API di transizione, e saranno utilizzate dal 26 Gennaio 2021 (dal rilascio della nuova gestione di webinar e corsi in aula) fino al rilascio mensile del febbraio 2022, in piano per il 23 febbraio 2022 (quando il tipo di corso Webinar sarà dismesso). Alla fine di questo periodo, saranno dismesse.
Descrizione API | Verbo API | URL API | Note |
---|---|---|---|
List classroom sessions | GET | /learn/v1/courses/{course_id}/classroom/session | La struttura dell’API non sarà modificata. L’API sarà aggiornata per essere conforme alla nuova gestione di webinar e corsi in aula, ma non mostrerà i dati relativi ai webinar. Sarà dismessa alla fine di febbraio 2022. |
Create classroom sessions | POST | /learn/v1/courses/{course_id}/classroom/session | La struttura dell’API non sarà modificata. L’API sarà aggiornata per essere conforme alla nuova gestione di webinar e corsi in aula, ma non interagirà con i dati relativi ai webinar. Sarà dismessa alla fine di febbraio 2022. |
Update classroom sessions | PUT | /learn/v1/courses/{course_id}/classroom/session/{session_id} | La struttura dell’API non sarà modificata. L’API sarà aggiornata per essere conforme alla nuova gestione di webinar e corsi in aula, ma non interagirà con i dati relativi ai webinar. Sarà dismessa alla fine di febbraio 2022. |
Delete classroom sessions | DELETE | /learn/v1/courses/{course_id}/classroom/session/{session_id} | La struttura dell’API non sarà modificata. L’API sarà aggiornata per essere conforme alla nuova gestione di webinar e corsi in aula, ma non interagirà con i dati relativi ai webinar. Sarà dismessa alla fine di febbraio 2022. |
Retrieve session details | GET | /learn/v1/courses/{course_id}/ilt/session/{session_id} | La struttura dell’API non sarà modificata. L’API sarà aggiornata per essere conforme alla nuova gestione di webinar e corsi in aula, ma non interagirà con i dati relativi ai webinar. Sarà dismessa alla fine di febbraio 2022. Se la sessione non include eventi, l’API non restituirà risultati. |
Enroll single user into course | POST | /learn/v1/enrollments/{course_id}/{user_id} | L’API sarà modificata per essere retrocompatibile. L’API permetterà di iscrivere gli istruttori anche a webinar e corsi in aula. La modifica dell’API sarà dismessa alla fine di febbraio 2022, ma l’API rimarrà operativa. |
Delete a user’ session enrollment | DELETE | /learn/v1/enrollment/{id_course}/{id_user}/session/{id_session} | L’API sarà modificata per essere retrocompatibile. L’API permetterà di cancellare l’iscrizione degli istruttori sia che siano stati iscritti al corso, che assegnati con il nuovo metodo. La modifica dell’API sarà dismessa alla fine di febbraio 2022, ma l’API rimarrà operativa. |
Joining or starting a webinar session's date | GET | /learn/v1/courses/{course_id}/session/{id_session}/date/{date}/join | Dismessa, non più necessaria. |
API Aggiornate
Le API elencate in questa tabella sono state modificate a causa di modifiche strutturali o di comportamento.
Descrizione API | Verbo API | URL API | Note |
---|---|---|---|
Return enrollments list | GET | /learn/v1/enrollments | L’API sarà modificata per essere retrocompatibile. L’API mostrerà gli istruttori come iscritti, anche se l’iscrizione non è più necessaria per gli istruttori. |
Create enrollment | POST | /learn/v1/enrollments | Questa API non permetterà più di iscrivere gli istruttori ai webinar e ai corsi in aula, in quando l’iscrizione non è più necessaria. |
Update enrollment | PUT | /learn/v1/enrollments | Questa API non permetterà più di aggiornare le iscrizioni degli istruttori ai webinar e ai corsi in aula, in quando l’iscrizione non è più necessaria. |
Update single enrollment into course | PUT | /learn/v1/enrollments/{course_id}/{user_id} | Questa API sarà modificata per bloccare le iscrizioni ai corsi in aula e ai webinar per gli utenti con livello istruttore. Tutte le altre combinazioni corso/livello utente funzioneranno come prima. |
Delete enrollment in batch mode | DELETE | /learn/v1/enrollment/batch | Questa API non permetterà più di cancellare le iscrizioni degli istruttori ai webinar e ai corsi in aula, in quando l’iscrizione non è più necessaria. |
Create enrollment in batch mode | POST | /learn/v1/enrollment/batch | Questa API non permetterà più di aggiornare le iscrizioni degli istruttori ai webinar e ai corsi in aula, in quando l’iscrizione non è più necessaria. |
Duplicate enrollment | PUT | /learn/v1/enrollments/duplicate | Questa API non permetterà più di duplicare le iscrizioni degli istruttori ai webinar e ai corsi in aula, in quando l’iscrizione non è più necessaria. |
Retrieve course detail | GET | /learn/v1/courses/{course_id} | La struttura dell’API sarà aggiornata per essere conforme alla nuova gestione di webinar e corsi in aula. |
Retrieve sessions within a course | GET | /learn/v1/courses/{id}/sessions | La struttura dell’API sarà aggiornata per essere conforme alla nuova gestione di webinar e corsi in aula. |
Nuove API
La tabella Nuove API mostra le nuove API disponibili per la nuova gestione di webinar e corsi in aula. Queste API sono operative dal 26 Gennaio 2021.
Le API che seguono includeranno un riferimento al vecchio ID della sessione (per le sessioni migrate) grazie al campo migrated_webinar_session_id:
- GET/course/v1/sessions/{session_id}
- GET/course/v1/courses/{course_id}/sessions
- GET/learn/v1/courses/{id}/sessions
- GET /learn/v1/courses{course_id}?get_all_sessions=1
Descrizione API | Verbo API | URL API |
---|---|---|
Get all sessions | GET | course/v1/courses/{course_id}/sessions |
Create a new session | POST | course/v1/courses/{course_id}/sessions |
Get a session | GET | course/v1/sessions/{session_id} |
Update a session | PUT | course/v1/sessions/{session_id} |
Duplicate a session | POST | course/v1/sessions/{session_id}/duplicate |
Delete a session | DELETE | course/v1/sessions/{session_id} |
Get session's enrollments | GET | course/v1/sessions/{session_id}/enrollments |
Get all events | GET | course/v1/sessions/{session_id}/events |
Create a new event | POST | course/v1/sessions/{session_id}/events |
Evaluate users | PUT | course/v1/sessions/{session_id}/evaluate |
Get an event | GET | course/v1/events/{event_id} |
Update an event | PUT | course/v1/events/{event_id} |
Duplicate an event | POST | course/v1/events/{event_id}/duplicate |
Delete an event | DELETE | course/v1/events/{event_id} |
Get event's attendance | GET | course/v1/events/{event_id}/attendance |
Set user attendance | PUT | course/v1/events/{event_id}/attendance |
List all webinar tools configured in platform | GET | course/v1/tools |
Delete sessions enrollments in batch mode | DELETE | learn/v1/enrollments/sessions/batch |
Add instructors to session and events in batch mode | POST | course/v1/instructors/add |
Evaluate users in batch mode | PUT | course/v1/sessions/evaluate/batch |
Duplicate events in sessions in batch mode | POST | course/v1/events/duplicate/batch |
Mark users’ attendance in batch mode | POST | course/v1/events/attendance/batch |
Delete events in batch mode | DELETE | course/v1/events/batch |
Delete sessions in batch mode | DELETE | course/v1/sessions/batch |
Delete recording | DELETE | course/v1/events/{event_id}/recording |
Upload recording | POST | course/v1/events/{event_id}/recording |
Get recording status | GET | course/v1/events/{event_id}/recording |
Get recording | GET | course/v1/events/{event_id}/watch_recording |
Get Join URL | GET | course/v1/events/{event_id}/join_webtool |
Per ogni nuova API, l’elenco dei parametri disponibili sarà dettagliato nell’API browser di Docebo.