Avvertenza sulla versione sandbox: Alcuni contenuti in questo articolo descrivono come utilizzare funzionalità che saranno rilasciate pubblicamente a tutti i clienti alla fine di aprile 2026. Se si notano differenze tra questo articolo e la piattaforma, controllare nuovamente in quel momento. Scopri di più sul ciclo di rilascio.

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 2 GB.
• 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

Si consiglia di caricare i pacchetti xAPI dalla pagina del materiale didattico, che consente il loro riutilizzo in più corsi. È inoltre possibile caricare i pacchetti xAPI direttamente all'interno di un corso: consultare Caricare contenuti xAPI (ex Tin Can API).

Caricare file xAPI dalla pagina del materiale didattico

Per accedere alla pagina del materiale didattico, è necessario effettuare l'accesso come Superadmin o Power User, aprire il menu Admin tramite l'icona dell'ingranaggio situata nell'angolo in alto a destra della piattaforma e, nella sezione E-learning, selezionare Materiale didattico (ex archivio centrale).

Nel pannello a sinistra, selezionare la cartella in cui si desidera caricare i file, quindi cliccare sul pulsante + Nuovo. Il menu a tendina offre due opzioni per xAPI:

• xAPI dal file: consente di caricare uno o più pacchetti xAPI dal dispositivo locale, seguendo le istruzioni riportate di seguito.
• xAPI dall'URL: permette di collegare un pacchetto xAPI tramite un URL esterno. Si rimanda a Caricare file xAPI dall'interno di un corso per ulteriori dettagli.

È inoltre possibile avviare il caricamento dal Centro dei contenuti: aprire il menu amministrazione tramite l'icona dell'ingranaggio nell'angolo in alto a destra della piattaforma e, nella sezione E-learning, selezionare Centro dei contenuti. Cliccare sul pulsante + Nuovo e scegliere xAPI dal file.

Per caricare file xAPI dal dispositivo locale:

1. Selezionare fino a 20 file ZIP da caricare. Ogni file può avere una dimensione massima di 2 GB.
2. Se il caricamento avviene dal Centro dei contenuti, selezionare la cartella di destinazione nel pannello a destra.
3. Al momento dell'avvio del caricamento, verrà visualizzato un pannello nell'angolo in alto a destra dello schermo. In caso di chiusura, è possibile riaprirlo cliccando sull'icona a forma di nuvola (Caricamenti) in alto a destra. Il pannello fornisce lo stato in tempo reale di ciascun file.
4. È possibile navigare liberamente all'interno della piattaforma durante il processo di caricamento. Si segnala che aggiornare la pagina o chiudere la scheda interromperà tutti i caricamenti in corso. Il browser mostrerà un pop-up di conferma prima di lasciare la pagina.
5. Per annullare un caricamento specifico, cliccare sulla X accanto al file interessato nel pannello. Per annullare tutti i caricamenti in corso, cliccare Annulla nel pannello.
6. Al termine del caricamento, è possibile cliccare sul nome del file per accedere alla pagina di modifica del materiale di formazione oppure fare clic sull'icona della cartella per navigare nella cartella in cui il file è stato salvato.

Caricare file xAPI dall'interno di un corso

Sebbene sia possibile caricare pacchetti xAPI direttamente all'interno di un corso, si raccomanda di utilizzare la pagina del materiale didattico, in quanto supporta il caricamento in blocco e consente il riutilizzo dei materiali in più corsi. 

Dal menu amministrazione (l'icona a forma di ingranaggio nell'angolo in alto a destra della piattaforma), trovare la voce Gestione corsi nella sezione E-Learning. Cercare il corso per il quale si desidera caricare il materiale didattico xAPI e cliccare sulla sua descrizione, quindi spostarsi alla scheda Materiale didattico.

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.

Dopo il completamento del caricamento, verrà visualizzata la scheda Materiale didattico. Si prega di cliccare sull'icona del menu posizionata alla fine della riga corrispondente al materiale didattico xAPI, quindi selezionare Impostazioni per procedere con la configurazione del materiale didattico. Nel momento in cui si imposta la Modalità anteprima, è importante considerare che la Modalità Teatro disabilita l'utilizzo dei microfoni da parte degli utenti. Qualora il contenuto xAPI richieda l'accesso al microfono, si raccomanda di optare per Mostra in una nuova finestra.

Collegare contenuti xAPI come materiale didattici

È possibile caricare contenuti xAPI dal proprio dispositivo 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.

Una volta configurati gli URL di origine, accedere alla pagina Materiale didattico. Nel pannello laterale sinistro, selezionare la cartella in cui desidera aggiungere il contenuto, quindi cliccare sul pulsante + Nuovo e scelga l'opzione xAPI da URL. Tale operazione può essere effettuata anche dal Centro dei contenuti; in questo caso, sarà necessario selezionare la cartella di destinazione nel pannello laterale.

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.

È inoltre possibile integrare contenuti xAPI all'interno di un corso: accedere alla scheda Materiale didattico del corso interessato, cliccare su Aggiungi materiale didattico, selezionare xAPI (Tin Can), quindi scegliere l'opzione Da URL e procedere seguendo le medesime istruzioni a partire dalla selezione di un URL.

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.
• Consigliamo di caricare e gestire i materiali didattici xAPI dalla pagina Materiale didattico, dove è possibile caricare più file contemporaneamente e riutilizzarli in più corsi.