Lecteur Fluidic intégrable

En tant qu’entreprise, vous pouvez désormais proposer une expérience personnalisée à vos élèves même en dehors de Learning Manager. En utilisant l’API publique, vous pouvez récupérer toutes les informations relatives aux objets d’apprentissage, aux inscriptions des élèves et aux progrès de l’apprentissage et les afficher sur votre site Web. Vous pouvez même intégrer le lecteur Fluidic de Learning Manager à votre site Web afin que l’élève puisse utiliser le contenu directement sur votre site Web. Le lecteur Fluidic vous permet de lire n’importe quel contenu pris en charge par Learning Manager. Il possède les mêmes fonctionnalités qu’il soit intégré à votre site Web ou utilisé dans Learning Manager.

Lire n’importe quel contenu d’apprentissage en ligne

Le lecteur Fluidic lit pratiquement n’importe quel type de contenu d’apprentissage en ligne d’une manière également cohérente et intuitive sans nécessiter de plug-ins ou de téléchargements. L’élève peut lancer le contenu, dont la lecture commence quel que soit le type de fichier de contenu.

Notes et marquage de signets

Vous pouvez prendre des notes et mettre en signet n’importe quel contenu quel que soit son type de fichier. Si vous souhaitez effectuer une sélection à partir d’un long fichier ou d’une longue vidéo, vous pouvez mettre en signet les endroits précis où vous avez trouvé les informations correspondant à vos besoins. Les notes et les signets peuvent être utilisés pour effectuer une recherche ou envoyés par courrier électronique. Le fait de cliquer dessus vous redirige vers l’emplacement concerné exact de la vidéo, de la page ou du document.

Pour plus d’informations sur le lecteur Fluidic, voir Lecteur Fluidic.

Voici quelques exemples d’utilisation du lecteur Fluidic intégrable.

• Vous pouvez utiliser le lecteur Fluidic intégrable sur votre site Web pour répertorier les cours auxquels votre employé est inscrit et également fournir un lien permettant de lancer une formation sur la même page. Cela signifie que vos élèves peuvent suivre des formations sur votre site intranet.
• Si vous êtes dans le domaine de la formation, vous disposez peut-être d’un site Web sur lequel vos clients achètent des cours. Vous pouvez intégrer le lecteur à ce site Web afin que vos clients puissent utiliser le contenu qu’ils ont acheté sur votre site Web.
  

Construire une application personnalisée pour intégrer un lecteur Fluidic dans votre site Web implique trois étapes de base :

1. Créez une application dans l’application d’administration d’intégration de Learning Manager.
2. Récupérez le jeton d’accès.
3. Utilisez le jeton d’accès pour récupérer des ressources de Learning Manager à l’aide de l’API publique.
   

1. Création d’une application dans l’administration d’intégration

Cette étape est requise pour créer un identifiant d’application/client et un secret d’application/client qui sont utilisés pour récupérer le jeton d’actualisation et le jeton d’accès. Pour plus d’informations sur la création d’une application, voir Processus de développement d’une application.

2. Récupération du jeton d’accès

Comme Learning Manager utilise OAUTH2.0, le jeton d’accès est requis pour récupérer des ressources en utilisant l’API publique. Le jeton d’accès peut être récupéré à l’aide du jeton d’actualisation, de l’ID client ou du secret client.

2.1 Jeton d’actualisation

• Récupération du code OAuth

Le code OAuth est requis pour récupérer le jeton d’actualisation. Learning Manager redirige l’utilisateur vers l’URL de redirection avec le code OAuth lorsqu’il est connecté à l’aide de l’URL ci-dessous (l’extraction de code OAuth est illustrée dans le fichier « oauthredirect.html » de l’exemple d’application) :

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>

Ici, client id est l’identifiant de l’application obtenu à l’étape 1.
redirect_url est l’élément redirect_url défini à l’étape 1.
state est une donnée fictive basée sur laquelle nous devons filtrer l’URL de redirection pour obtenir le code OAuth. Scope est le rôle d’élève défini à l’étape 1.
response_type a toujours pour valeur « CODE ».
account est un champ facultatif
email est un champ facultatif
* Si l’ID de compte et l’adresse électronique sont fournis, l’URL ci-dessus permettra à l’utilisateur de se connecter au même compte. Cet exemple de point de terminaison est représenté dans le fichier « index.html » de l’exemple d’application.

• Récupération du jeton d’actualisation

Une fois le code OAuth reçu, le jeton d’actualisation peut être récupéré à l’aide du code OAuth reçu, de l’ID client et du secret client à partir du point de terminaison ci-dessous :

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

En réponse à votre requête de publication, vous recevrez ce qui suit :

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

2.2 Récupération du jeton d’accès à partir du jeton d’actualisation

Pour récupérer votre jeton d’accès, envoyez une autre requête avec vos paramètres refresh_token, client_id et client_secret en tant que corps de message à l’URL ci-dessous :

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

En réponse à votre requête de publication, vous recevrez ce qui suit :
i. refresh_token
ii. access_token
iii. user_id
iv. expires_in
v. user_role
vi. account_id

3. Récupération des ressources en utilisant l’API publique

Comme troisième étape, vous devez utiliser le jeton d’accès pour récupérer des ressources de Learning Manager à l’aide de l’API publique .  Le jeton d’accès est nécessaire pour effectuer un appel d’API publique et doit être ajouté dans l’en-tête comme illustré dans l’exemple d’application.

Lecteur intégrable

Les applications tierces peuvent utiliser un lecteur intégrable pour lire le contenu d’un objet d’apprentissage.

Ouverture d’un cours dans un lecteur intégrable

1. Créer une URL intégrable

Pour ouvrir un cours à l’aide d’un lecteur intégrable, vous devez créer une URL intégrable comme indiqué ci-dessous :

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

Ici, lo_id doit respecter le format d’ID de cours de l’API V2.

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

Les certifications, les programmes d'apprentissage et les assistances à la tâche peuvent également être lus dans le lecteur intégrable.

Exemples : 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. Définissez cette URL dans l’attribut « src » d’iframe.

Fermeture du lecteur intégrable

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

Exemple de didacticiel d’application

Le document pdf ci-joint contient un exemple de didacticiel d’application.