Lettore Fluidic incorporato

In quanto azienda, è ora possibile offrire un’esperienza personalizzata agli Allievi anche al di fuori di Learning Manager. Utilizzando l’API pubblica, è possibile recuperare tutte le informazioni relative agli oggetti di apprendimento, alle iscrizioni degli Allievi e all’avanzamento dell’apprendimento e visualizzarle sul tuo sito Web. E cosa ancora più importante, è possibile incorporare il lettore Fluidic di Learning Manager nel sito Web, in modo che l’utente possa utilizzare il contenuto direttamente nel sito Web. Il lettore Fluidic consente di riprodurre qualsiasi contenuto supportato da Learning Manager. Quando viene incorporato nel tuo sito Web, ha le stesse funzionalità di quando viene utilizzato in Learning Manager.

Riprodurre qualsiasi contenuto di eLearning

Il lettore Fluidic riproduce praticamente qualsiasi tipo di contenuto di eLearning in modo coerente e intuitivo senza richiedere plug-in o download. L’Allievo può avviare il contenuto e, indipendentemente dal tipo di file contenuto, inizia la riproduzione.

Note e segnalibri

È possibile prendere appunti e contrassegnare qualsiasi contenuto indipendentemente dal relativo tipo di file. Se desideri effettuare una selezione da un file o video lungo, puoi aggiungere un segnalibro ai punti effettivi in cui hai trovato le informazioni per te utili. Le note e i segnalibri possono essere cercati o inviati tramite e-mail. Facendovi clic vieni reindirizzato al lettore Fluidic esattamente al punto del video o della pagina del documento.

Per ulteriori informazioni sul lettore Fluidic, vedi Lettore Fluidic.

Ecco alcuni esempi di come si può usare il lettore Fluidic incorporabile.

• Puoi utilizzare il lettore Fluidic incorporabile nel sito Web per elencare i corsi a cui sono iscritti i dipendenti e fornire anche un link per avviare una formazione nella stessa pagina. Ciò significa che gli Allievi possono usare la formazione  sul tuo sito Web intranet.
• Se sei impegnato nel settore della formazione, potresti avere un sito Web in cui i clienti possono acquistare corsi. È possibile integrare il lettore incorporabile nello stesso sito Web in modo che i clienti possano utilizzare i contenuti che acquistano all’interno del sito Web.
  

La creazione di un’applicazione personalizzata per incorporare un lettore Fluidic nel sito Web prevede tre passaggi fondamentali:

1. Creare un’applicazione nell’app Amministratore dell’integrazione di Learning Manager.
2. Recuperare il token di accesso.
3. Utilizzare il token di accesso per recuperare le risorse da Learning Manager utilizzando l’API pubblica.
   

1. Creare un’applicazione nell’Amministratore dell’integrazione

Questo passaggio è necessario per creare un ID applicazione/client e un segreto applicazione/client utilizzato per recuperare il token di aggiornamento e il token di accesso. Per ulteriori informazioni sulla creazione di un’applicazione, vedi Processo di sviluppo dell’applicazione.

2. Recuperare il token di accesso

Poiché Learning Manager utilizza OAUTH2.0, il token di accesso è necessario per recuperare le risorse utilizzando l’API pubblica. È possibile recuperare il token di accesso utilizzando il token di aggiornamento, l’ID client o il segreto del client.

2.1 Token di aggiornamento

• Recuperare il codice OAuth

Il codice OAuth è necessario per recuperare il token di aggiornamento. Learning Manager reindirizza l’utente all’URL di reindirizzamento con il codice OAuth quando viene eseguito l’accesso utilizzando l’URL seguente (l’estrazione del codice OAuth è esemplificata nel file “oauthredirect.html” nell’applicazione di esempio):

https://learningmanager.adobe.com/oauth/o/authorize
client_id= <application_id>
&redirect_uri=<redirect_uri>
&state=<dummy_data>
&scope=learner:read,learner:write
&response_type=CODE
&account=<account_id>
&email=<email_id>

Qui ID client è l’ID applicazione ottenuto al passaggio 1.
redirect_url è il redirect_url configurato nel passaggio 1.
state è qualsiasi dato fittizio in base al quale dobbiamo filtrare l’URL di reindirizzamento per ottenere il codice OAuth. L’ambito è l’ambito Allievo impostato nel passaggio 1.
response_type è sempre “CODE”.
account è un campo facoltativo
e-mail è un campo facoltativo
* Se vengono forniti sia ID sia e-mail, l’URL sopra consentirà all’utente di accedere allo stesso account. Questo esempio di endpoint viene rappresentato nel file “index.html” nell’applicazione di esempio.

• Recuperare il token di aggiornamento

Una volta ricevuto il codice OAuth, è possibile recuperare il token di aggiornamento utilizzando il codice OAuth ricevuto, l’ID client e il segreto client dall’endpoint seguente:

https://learningmanager.adobe.com/oauth/token

Come risposta alla tua richiesta post, riceverai quanto segue:

i. refresh_token
ii. access_token
iii. user_id
iv. expires_in
v. user_role
vi. account_id

2.2 Recuperare il token di accesso dal token di aggiornamento

Per recuperare il token di accesso, invia un’altra richiesta con refresh_token, client_id e client_secret come corpo del post all’URL seguente:

https://learningmanager.adobe.com/oauth/token/refresh

Come risposta alla tua richiesta post, riceverai quanto segue:
i. refresh_token
ii. access_token
iii. user_id
iv. expires_in
v. user_role
vi. account_id

3. Recuperare risorse utilizzando AP pubbliche

Come terzo passaggio, devi utilizzare il token di accesso per recuperare le risorse da Learning Manager utilizzando API pubbliche. .  Il token di accesso è obbligatorio per effettuare chiamate alle API pubbliche e deve essere aggiunto nell’intestazione come esemplificato nell’applicazione di esempio.

Lettore incorporabile

Le applicazioni di terze parti possono utilizzare un lettore incorporabile per riprodurre il contenuto di un oggetto di apprendimento.

Aprire un corso su un lettore incorporabile

1. Creare un URL incorporabile

Per aprire un corso utilizzando un lettore incorporabile, devi creare un URL incorporabile come illustrato di seguito:

https://learningmanager.adobe.com/app/player?lo_id=<v2-api course id>&access_token=<access_token>

In questo caso, lo_id deve essere conforme al formato ID corso API V2.

Esempio: https://learningmanager.adobe.com/app/player?lo_id=course:123456&access_token=45b269b75ac65d6696d53617f512450f

Le certificazioni, i programmi di apprendimento e le risorse formative possono essere riprodotti anche nel lettore incorporabile.

Esempi: https://learningmanager.adobe.com/app/player?lo_id=certification:12345&access_token=c1a4847dfbf4007826a027d481b93c1e

https://learningmanager.adobe.com/app/player?lo_id=learningProgram:12345&access_token=c1a4847dfbf4007826a027d481b93c1e

https://learningmanager.adobe.com/app/player?lo_id=jobAid:1234&access_token=c1a4847dfbf4007826a027d481b93c1e

     2. Impostare questo URL nell’attributo “src” di iframe.

Chiudere il lettore incorporabile

window.addEventListener("message", function closePlayer(){
   if(event.data === "status:close"){
     //handle closing event
   }
});

Esercitazione applicazione di esempio

Il documento PDF allegato contiene un’esercitazione dell’applicazione di esempio.