Accedi come amministratore dell’integrazione. Seleziona Applicazioni > Registra.
Ultimo aggiornamento il
24 gen 2024
Cosa si intende per xAPI?
L’API Experience (xAPI) è una specifica del software di e-learning che consente ai contenuti di apprendimento e ai sistemi di apprendimento di comunicare tra loro in modo da registrare e tenere traccia di tutti i tipi di esperienze di apprendimento. Le esperienze di apprendimento sono registrate in un Learning Record Store (LRS). I Learning Record Store possono essere autonomi o esistere all’interno di sistemi LMS (Learning Management System) tradizionali.
Per ulteriori informazioni su xAPI, consulta: https://github.com/adlnet/xAPI-Spec.
In che modo Learning Manager supporta xAPI?
Learning Manager dispone di un Learning Record Store integrato. Questo LRS è perfettamente compatibile con le istruzioni xAPI provenienti da contenuti ospitati all’interno di Learning Manager. Accetta anche istruzioni xAPI create da terze parti. Queste istruzioni xAPI vengono archiviate in Learning Manager, da dove poi possono essere esportate per essere visualizzate in qualsiasi sistema di data warehouse di terze parti.
Quando si usa xAPI?
Vi è la crescente esigenza di acquisire le esperienze di apprendimento dell’utente finale che si svolgono su più sistemi. Inoltre, occorre monitorare l’esatto coinvolgimento dell’utente con i contenuti di formazione. Non si tratta solo di Inizio, In corso e Completamento (che sono gli unici attributi acquisiti da SCORM).
Utilizzo di xAPI in Learning Manager
Configurare l’applicazione
-
Registrazione dell’app Registrazione dell’app -
Registra una nuova applicazione.
Creazione dell’applicazione Creazione dell’applicazione -
Definisci l’ambito dell’applicazione.
- Se l’opzione Accesso in lettura e scrittura xAPI del ruolo amministratore è abilitata, l’amministratore può pubblicare e ottenere documenti e istruzioni xAPI.
- Se l’opzione Accesso in lettura e scrittura xAPI del ruolo utente in formazione è abilitata, l’amministratore può pubblicare e ottenere documenti e istruzioni xAPI.
-
Salva le modifiche. Ottieni segreto e ID sviluppatore.
End point :
Fai clic sul collegamento di seguito per visualizzare il documento swagger xAPI:
https://learningmanagereu.adobe.com/docs/learningmanagerapi/xapi/
Nota: la versione xAPI supportata in Learning Manager è 1.0.3.
Autenticazione API
Le xAPI di Learning Manager utilizzano il framework OAuth 2.0 per autenticare e autorizzare le applicazioni client. Dopo aver registrato l’applicazione, puoi ottenere clientId e clientSecret. Get URL si usa nel browser perché autentica gli utenti di Learning Manager che usano i loro account preconfigurati, ad esempio SSO, Adobe ID.
GET https://learningmanager.adobe.com/oauth/o/authorize?client_id=<Enter your clientId>&redirect_uri=<Enter a url to redirect to>&state=<Any String data>&scope=<admin:xapi or learner:xapi>&response_type=CODE.
Tracciamento delle istruzioni xAPI come oggetto di apprendimento di Learning Manager
Come autore, ora puoi scegliere il modulo xAPI durante la creazione di corsi per monitorare l’esperienza degli utenti al di fuori di Learning Manager. Ad esempio, è possibile utilizzare questa funzione per valutare le attività degli utenti su una piattaforma di terze parti utilizzata per usufruire del corso.
-
Durante la creazione di un Modulo attività, nell’opzione Tipo, usa il menu a comparsa per selezionare Modulo basato su xAPI.
Creazione del modulo basato su xAPI Creazione del modulo basato su xAPI -
Devi fornire un IRI. Se non viene fornito, Learning Manager ne genera uno automaticamente.
Nota:L’IRI per un’attività è univoco in un account. Questo significa che due moduli in Learning Manager non possono avere lo stesso IRI. Viene creato un nuovo IRI nei seguenti casi:
- Quando un corso con un modulo xAPI viene condiviso tra più account.
- Quando una certificazione con un modulo xAPI si ripete
Qualsiasi istruzione xAPI con l’IRI menzionato viene tracciata nel modulo precedente e riflessa nei rapporti di Learning Manager.
-
Per copiare l’IRI creato automaticamente, rivisita la pagina Modulo attività.
-
Pubblica il modulo.
Nota:
- Learning Manager attualmente supporta solo mbox come identificatore. Gli altri identificatori, inclusi mboz_sha1, openid e account non sono supportati.
- L’elemento stateId e profileId è un UUID se utilizzato con Learning Manager.
- La richiesta PUT non sovrascrive il documento per agenti/profilo, attività/profilo e attività/stato di xAPI.
- Un gruppo non identificato non è supportato in Actor.
- Il parametro “related_activities” non è supportato nell’istruzione GET.
- I parametri “format=ids” e “format=canonical” non sono supportati nelle istruzioni GET.
- L’annullamento dell’istruzione L’istruzione non annulla le azioni avvenute in Learning Manager quando è stata pubblicata l’istruzione.
Creazione di rapporti
È possibile creare rapporti xAPI come report Excel. Come amministratore, apri Rapporti > Report Excel > Report di attività xAPI.
Il report scaricato recupera tutte le informazioni pubblicate dall’utente in formazione e dall’amministratore per qualsiasi istruzione.
È possibile creare /pianificare gli stessi report utilizzando i connettori FTP e Box per qualsiasi integrazione di terze parti. Procedi come segue:
Accedi come amministratore dell’integrazione > apri il connettore FTP/Box > seleziona il Report di attività xAPI dal riquadro a sinistra > scegli di pianificare/creare un report.
Nota:
- Quando viene inviato solo il punteggio non elaborato nell’istruzione xAPI senza il punteggio massimo, il punteggio del quiz non viene visualizzato in LT.
- Per ottenere il punteggio percentuale in Learning Manager, i punteggi normalizzati vengono inviati tramite xAPI.
Report di esempio
Scarica
