Introduzione

Lo standard xAPI (noto in precedenza come Tin Can API) è una specifica software e-learning. Questo tipo di software permette la comunicazione tra contenuti formativi e sistemi e-learning, in modo da registrare  qualsiasi progresso di qualsiasi forma di esperienza nella formazione e-learning in un Learning Record Store (LRS). Gli LRS sono file indipendenti, non dipendono dai tradizionali Learning Management System. 

Requisiti e limitazioni

• Docebo supporta lo Standard Tin Can 1.0.
• La dimensione massima del file è di 1024 MB.
• I contenuti xAPI (Tin Can API) devono essere importati come pacchetti ZIP.
• Docebo LRS lavora allineandosi con la piattaforma Docebo: per collegare le attività completate dagli utenti ai progressi del corso è necessario identificare l'ID dell'attività nella dichiarazione xAPI. Per fare in modo che LRS riconosca queste attività, è necessario caricare pacchetti xAPI che contengano il descrittore tincan.xml.
• È possibile caricare contenuti xAPI come materiale didattico sia all’interno di corsi e-learning che all'interno di corsi Instructor-Led Training (ILT) e Virtual Instructor-Led Training (VILT).

Caricare pacchetti xAPI

È possibile caricare pacchetti xAPI dal proprio dispositivo o da un link esterno. Connettersi alla piattaforma come Superadmin o come istruttore.  Dal Menu amministrazione (icona ingranaggio in alto a destra), selezionare Gestione corsi nella sezione E-learning. Individuare il corso per cui si desidera caricare materiali didattici nell'elenco, cliccare sulla descrizione del corso, e spostarsi alla scheda Materiali didattici. 

Premere Aggiungi materiali didattici in alto a destra per caricare i contenuti. Dal menu a tendina, selezionare xAPI (Tin Can).

La pagina di caricamento è composta da tre schede: xAPI (Tin Can), Informazioni aggiuntive e Protezione avanzata. Nella scheda Tin Can, selezionare Carica File per scegliere il file xAPI (Tin Can API) dal proprio dispositivo. Nell'area sottostante, selezionare se si desidera tracciare tutte le attività del pacchetto. Se questa opzione è selezionata (come da default), la piattaforma traccerà tutte le attività e le sotto-attività. In questo modo, al completamento del primo modulo del contenuto Tin Can (un materiale didattico Tin Can può essere composto da più moduli), l'intero Tin Can viene contrassegnato come completato. In caso contrario, se l'opzione Traccia tutte le attività non è selezionata, saranno tracciate solo le attività principali del pacchetto, e dovranno essere completati tutti i moduli affinché il materiale didattico Tin Can venga contrassegnato come completato.

La piattaforma identifica i contenuti Tin Can come completati quando lo studente preme il pulsante Chiudi (potrebbe essere Esci o Invia). Se l'utente non preme il pulsante, l’avanzamento potrebbe non essere inviato correttamente dal pacchetto Tin Can alla piattaforma, e il contenuto potrebbe essere identificato come incompleto. Per questo motivo, è consigliato includere una schermata per la conferma di completamento nei pacchetti Tin Can che sarà visualizzata quando il pacchetto Tin Can conferma che i dati di tracciamento sono stati trasferiti, e di mostrare il pulsante Chiudi in questa schermata.

Durante il caricamento del file, spostarsi alla scheda Informazioni aggiuntive per inserire una breve descrizione del file e selezionare una thumbnail. Il titolo e la thumbnail possono essere modificati in qualsiasi momento, se necessario.

È possibile inserire dei tag relativi al materiale didattico, in modo che sia più semplice trovarlo attraverso la ricerca globale della piattaforma. Se la funzionalità di auto-tagging è abilitata in piattaforma, è possibile che alcuni tag siano generati automaticamente dell'intelligenza artificiale in base al contenuto del materiale didattico, e solo nel caso in cui il contenuto sia in inglese, spagnolo, tedesco, francese, italiano o portoghese. I tag possono essere modificati o cancellati in qualsiasi momento, con un limite di 15 tag per materiale didattico e di 32 caratteri per ogni tag (elenco dei tipi di contenuti che permettono l'auto-tagging). Per questioni di sicurezza, l'intelligenza artificiale della piattaforma non accede ai contenuti privati (quelli che richiedono un'autenticazione per accedervi), e può generare tag automaticamente solo per i contenuti pubblici. Quando si caricano contenuti privati, consigliamo di aggiungere i tag manualmente.

Attenzione! La funzionalità di auto-tagging potrebbe avere problemi nell'elaborazione dei materiali didattici di tipo xAPI creati da alcuni strumenti di authoring che inseriscono testi direttamente nei file di programmazione e comprimono le immagini impedendo l'utilizzo dell'Optical Character Recognition (OCR). Stiamo attualmente lavorando per gestire questa limitazione collaborando con alcuni dei principali fornitori di strumenti di authoring.

Premere Salva le Modifiche per terminare. Se il formato è corretto, il pacchetto xAPI sarà caricato fra i materiali del corso, e sarà visualizzato un messaggio di conferma nella parte superiore della pagina.

Collegare contenuti xAPI come materiale didattici

È possibile caricare contenuti xAPI in un corso utilizzando il link a un URL esterno. Per prima cosa è necessario creare un elenco predefinito di URL di origine in piattaforma per garantire che la piattaforma permetta agli studenti di riprodurre il contenuto. Accedere al Menu amministrazione e cliccare Configurazione dalla sezione Impostazioni. Spostarsi alla scheda E-learning.

Spostarsi all'area Contenuto esterno xAPI e inserire l'URL del materiale didattico nel campo di testo corrispondente. È possibile inserire fino a 20 URL.

Se è necessario supportare più di 20 URL, utilizzare un dominio wildcard. Per esempio, inserire http://www.domain.com/* senza specificare il nome del file del contenuto o l'estensione e includere un asterisco (*) alla fine dell'URL. Quando si aggiunge materiale didattico a un corso, sarà così possibile specificare il nome e l'estensione del singolo file (per esempio, file_name_1.zip dopo il dominio). I domini wildcard devono essere inseriti manualmente, non è possibile inserirli tramite API.

Utilizzando questo metodo, il dominio inserito conterà come uno dei 20 URL consentiti, ma sarà possibile aggiungere più di 20 contenuti esterni xAPI.

Cliccare Aggiungi per confermare il dominio, che sarà elencato sotto il campo di input.

Per aggiungere il salt secret a un URL, cliccare sull'icona del lucchetto in fondo alla riga dell'URL. Quindi, inserire e confermare il salt secret e premere il segno di spunta.

Se non si aggiunge un salt secret, la terza parte tratterà il contenuto come qualsiasi altro contenuto xAPI lanciato dalla piattaforma. L'aggiunta di un salt secret genera invece un checksum che convalida la visualizzazione del contenuto, consentendo alla terza parte di confermarne l'autenticità.

Al termine, premere Salva.

Dopo aver aggiunto gli URL, passare alla scheda Materiali didattici e selezionare Tin Can dal menu a tendina Aggiungi materiale didattico. Nella pagina di caricamento, scegliere l'opzione Da URL, quindi selezionare un URL dal menu a tendina Seleziona URL, che visualizzerà tutti gli URL aggiunti nel passaggio precedente.

Se si seleziona un dominio wildcard che non include il nome e l'estensione del file, sarà visualizzato il campo Percorso aggiuntivo sotto il campo Seleziona URL per permettere l'inserimento del nome e dell'estensione del materiale didattico.

Attenzione! È possibile aggiungere la cartella o la sottocartella in cui si trova il file nel campo Seleziona URL oppure nel campo Percorso aggiuntivo, dando quindi una grande flessibilità al caricamento di materiale didattico xAPI.

Definire un titolo e una descrizione per il contenuto nei campi di testo corrispondenti. Quindi, decidere se tracciare tutte le attività del pacchetto. Se si attiva questa opzione (che è l'impostazione di default), la piattaforma traccerà tutte le attività e le sottoattività. Se la si disattiva, saranno tracciate solo le attività principali del pacchetto.

Passare alla scheda Informazioni aggiuntive per inserire una breve descrizione del contenuto e selezionare una thumbnail. È possibile inserire dei tag relativi al materiale didattico, in modo che sia più semplice trovarlo attraverso la ricerca globale della piattaforma. Se la funzionalità di auto-tagging è abilitata in piattaforma, è possibile che alcuni tag siano generati automaticamente dell'intelligenza artificiale in base al contenuto del materiale didattico, e solo nel caso in cui il contenuto sia in inglese, spagnolo, tedesco, francese, italiano o portoghese. I tag possono essere modificati o cancellati in qualsiasi momento, con un limite di 15 tag per materiale didattico (elenco dei tipi di contenuti che permettono l'auto-tagging). Per questioni di sicurezza, l'intelligenza artificiale della piattaforma non accede ai contenuti privati (quelli che richiedono un'autenticazione per accedervi), e può generare tag automaticamente solo per i contenuti pubblici. Quando si caricano contenuti privati, consigliamo di aggiungere i tag manualmente.

Infine, spostarsi nella scheda Protezione avanzata, dove è possibile definire un codice OAuth per l'URL di avvio e selezionare il client OAuth dal menu a tendina corrispondente. Cliccare Salva le modifiche per creare il materiale didattico.

Configurare il materiale didattico

Una volta caricato il materiale didattico, è possibile gestirne le impostazioni come descritto nell'articolo Gestire la configurazione e i prerequisiti dei materiali didattici.

Consigli d'utilizzo

• Per tracciare un pacchetto xAPI (Tin Can) da remoto, caricare il pacchetto direttamente in piattaforma. Docebo non supporta il tracciamento completamente anonimo. Per inviare degli statement xAPI/Tin Can alla propria piattaforma, è necessario utilizzare link in formato: https://www.lmsaddress.com/tcapi/. Inoltre, gli utenti devono disporre di un indirizzo email valido associato al proprio account affinché la piattaforma possa salvare i dati dei tracciamenti dei materiali didattici xAPI. Sebbene sia possibile caricare i pacchetti xAPI (TinCan) direttamente nel Central repository, consigliamo di caricarli direttamente nei corsi. È possibile inviarli al Central repository dopo il caricamento nel corso, se necessario.
• I contenuti xAPI possono essere aggiornati solo dal Central repository.