L'intégration Moodle LTI relie votre site Moodle à l'environnement Uptale de votre organisation grâce à LTI 1.3 (Learning Tools Interoperability, le standard qui permet à un LMS d'ouvrir des outils externes). Les enseignants ajoutent des expériences Uptale (des contenus de formation immersifs) à leurs cours comme n'importe quelle activité, les apprenants les ouvrent depuis Moodle sans mot de passe Uptale à part, et leur score remonte dans le carnet de notes Moodle. L'intégration est en libre-service : votre Administrateur d'environnement la configure dans Uptale, avec l'administrateur de votre Moodle, et le support Uptale peut l'aider.
Administration du site›Plugins›Outil externe›Gérer les outils (Moodle)
À propos de cette intégration
Ce qu'elle fait
- Les enseignants choisissent les contenus Uptale depuis Moodle. Quand ils ajoutent l'activité Uptale à un cours, une fenêtre de sélection liste les expériences publiées des espaces de travail Uptale (des regroupements d'expériences) ouverts à Moodle. Le nom, la description et la note maximale de l'activité se remplissent automatiquement.
- Les apprenants ne se connectent qu'une fois. Ils ouvrent l'activité depuis Moodle et arrivent sur la page de lancement de l'expérience, déjà identifiés. Leur compte Uptale est créé à leur premier lancement, avec le rôle Apprenant sur les espaces de travail choisis lors de la mise en place.
- Toujours à jour. Moodle pointe vers l'expérience dans Uptale : quand un créateur publie une nouvelle version, les apprenants la reçoivent sans rien réimporter.
Ce qui remonte dans Moodle
À la fin de la session d'un apprenant (il termine ou ferme l'expérience), Uptale envoie à Moodle un score pour l'activité, avec l'activité marquée comme terminée. Le score correspond au nombre d'étoiles gagnées par l'apprenant, sur le nombre d'étoiles disponibles dans l'expérience : son créateur les définit avec les objectifs de l'expérience (voir Objectifs, étoiles et score de réussite).
Avec l'option Envoyer uniquement le score de succès, une session qui ne remplit pas les critères de réussite de l'expérience n'envoie rien à Moodle.
Moodle ne reçoit que ce résumé. Les résultats détaillés (parcours, réponses, rapports de session) restent dans les rapports Uptale : voir Données suivies et données LMS.
Ce qu'il vous faut
- Un site Moodle dont vous êtes administrateur, avec le plugin Outil externe (mod_lti) activé.
- Une personne qui a le rôle Administrateur d'environnement dans votre environnement Uptale : elle voit la carte Moodle LTI dans l'onglet Intégration de l'environnement.
- Au moins un espace de travail Uptale avec des expériences publiées à proposer dans Moodle.
Si la carte Moodle LTI n'apparaît pas dans votre onglet Intégration, ou si vous préférez qu'Uptale termine la mise en place pour vous, écrivez à support@uptale.io.
La mettre en place
La mise en place fait un aller-retour entre les deux plateformes : Uptale fournit les adresses à saisir dans Moodle, puis Moodle fournit les identifiants à saisir dans Uptale.
Avant de commencer : le plugin Outil externe
- Dans Moodle, allez dans Administration du site › Plugins › Vue d'ensemble des plugins et cherchez Outil externe (mod_lti).
- S'il est désactivé, ouvrez Gestion des activités depuis la page Plugins et activez Outil externe.
Étape 1 : créer la configuration dans Uptale
- Dans Uptale, ouvrez votre environnement, cliquez sur l'onglet Intégration, puis sur Ouvrir le détail sur la carte Moodle LTI.
- Cliquez sur Configurer cette intégration. La zone Configuration s'affiche, avec les URL de l'outil Uptale à copier dans Moodle : URL d'initiation OIDC, URL de redirection / rappel, URL JWKS publique et URL de sélection de contenu (deep linking).
Remarque : l'URL de redirection / rappel est propre à votre configuration. Copiez-la toujours depuis la carte. Si vous supprimez la configuration et en créez une nouvelle, mettez-la à jour dans Moodle.
Étape 2 : déclarer Uptale dans Moodle
- Dans Moodle, allez dans Administration du site › Plugins et, sous Outil externe, ouvrez Gérer les outils.
- Cliquez sur Configurer manuellement un outil.
- Remplissez les champs comme ci-dessous, puis cliquez sur Enregistrer.
| Champ Moodle | Valeur |
|---|---|
| Nom de l'outil | Uptale, ou le nom de votre choix |
| URL de l'outil | https://my.uptale.io |
| LTI version | LTI 1.3 |
| Public key type | URL jeu de clefs |
| Jeu de clefs public | L'URL JWKS publique de la carte (https://my.uptale.io/.well-known/lti-jwks.json) |
| URL d'initiation de connexion | L'URL d'initiation OIDC de la carte (https://my.uptale.io/lti/authenticate) |
| URIs de redirection | L'URL de redirection / rappel de la carte |
| Utilisation de la configuration de l'outil | Recommandé : Afficher dans le sélecteur d'activité et comme outil préconfiguré |
| Conteneur par défaut | Nouvelle fenêtre, ou selon votre préférence |
| Prend en charge les liens profonds | Oui |
| URL de sélection de contenu | L'URL de sélection de contenu (deep linking) de la carte (https://my.uptale.io/lti/deeplinkselect) |
| Services de devoirs et de notes IMS LTI | Utiliser ce service pour la synchronisation des notes et la gestion des colonnes |
| Provisionnement des noms et rôles IMS LTI | Ne pas utiliser ce service |
| Réglages de l'outil | Ne pas utiliser ce service |
| Partager le nom de l'utilisateur avec l'outil | Recommandé : Toujours (nécessaire pour afficher le nom des apprenants dans Uptale) |
| Partager le courriel de l'utilisateur avec l'outil | Recommandé : Toujours (nécessaire pour afficher l'e-mail des apprenants dans Uptale) |
| Accepter les notes de l'outil | Recommandé : Toujours. Au minimum : Comme spécifié dans la définition de Liens profonds, ou Déléguer à l'enseignant |
Les adresses ci-dessus sont celles de l'instance UE d'Uptale. Si votre environnement est sur l'instance US, elles commencent par https://my.us.uptale.io : la carte affiche toujours les bonnes. Voir Hébergement : instances UE et US.
Étape 3 : terminer la configuration dans Uptale
- Dans Moodle, sur la page Gérer les outils, affichez les détails de configuration de l'outil. Moodle y indique les identifiants qu'il a générés pour Uptale.
- Dans Uptale, sur la carte Moodle LTI, cliquez sur Editer et recopiez chaque valeur depuis Moodle :
Champ Uptale Valeur Moodle Nom d'affichage Un nom de votre choix, par exemple le nom de votre site Moodle ID de la plateforme ID de la plateforme (Platform ID) ID de l'application ID client (Client ID) Keyset URL URL du jeu de clés publique (Public keyset URL) Token endpoint URL du jeton d'accès (Access token URL) Endpoint d'autorisation URL de requête d'authentification (Authentication request URL) - Sous Attribution des rôles, ajoutez les espaces de travail dont Moodle peut proposer les expériences. Les personnes qui viennent de Moodle y reçoivent le rôle Apprenant.
- Si besoin, activez Envoyer uniquement le score de succès.
- Cliquez sur Sauvegarder et activer. L'état indique Active.
Vous préférez qu'Uptale termine la mise en place ? Après l'étape 2, envoyez les détails de configuration de l'outil dans Moodle (ID de la plateforme, ID client et URL) à support@uptale.io, avec les espaces de travail à ouvrir à Moodle. Uptale vous confirme quand la configuration est active.
L'utiliser
Ajouter une expérience à un cours
- Dans le cours Moodle, activez le mode édition et cliquez sur Ajouter une activité ou ressource.
- Sélectionnez l'outil externe préconfiguré Uptale (ou le nom que vous lui avez donné).
- Dans les paramètres de l'activité, cliquez sur Sélectionner un contenu. La fenêtre de sélection Uptale s'ouvre.
- Choisissez un espace de travail sous Espaces disponibles, choisissez l'expérience, puis cliquez sur Sélectionner.
- De retour dans Moodle, le nom et la description de l'activité sont remplis, et sa note maximale correspond au nombre d'étoiles disponibles dans l'expérience. Réglez la Note pour passer et les Conditions d'achèvement selon vos besoins, puis enregistrez.
Remarque : seules les expériences publiées sont listées. Définissez les objectifs et les étoiles de l'expérience avant de l'ajouter : une expérience sans étoile à gagner ne donne pas de note maximale à Moodle.
Comment les apprenants lancent une expérience
Les apprenants cliquent sur l'activité dans leur cours Moodle. La page de lancement de l'expérience s'ouvre dans une nouvelle fenêtre (ou selon le conteneur choisi pour l'outil), avec l'apprenant déjà connecté à Uptale. De là, il joue dans son navigateur web, ou sur un casque VR avec le code de lancement affiché sur la page : voir Toutes les façons de jouer.
Limites
- Seules les expériences publiées des espaces de travail listés sous Attribution des rôles peuvent être ajoutées et jouées. Voir Publier une expérience.
- L'attribution des rôles ne s'applique qu'aux nouvelles connexions. Les personnes déjà venues de Moodle avant l'ajout d'un espace de travail n'y ont pas accès automatiquement : donnez-leur accès depuis l'onglet Gestion des accès de l'espace de travail.
- Un seul site Moodle par environnement sur cette carte.
- Les sessions lancées depuis Moodle ne comptent pas dans les programmes Uptale : un programme ne compte que les sessions lancées depuis le programme lui-même.
Problèmes courants
La carte Moodle LTI n'apparaît pas dans l'onglet Intégration, ou indique de contacter le support
Seuls les Administrateurs d'environnement voient l'onglet Intégration. Si la carte manque, ou affiche Pour configurer cette intégration, veuillez contacter support@uptale.io., écrivez à support@uptale.io.
Uptale n'enregistre pas la configuration
Vous voyez Les champs de configuration requis sont manquants. Remplissez tous les champs de Données de connexion LTI, et vérifiez que chaque adresse est complète, commence par https:// et vient des détails de configuration de l'outil dans Moodle.
La fenêtre de sélection ne liste aucun espace de travail ou aucune expérience
Ajoutez l'espace de travail sous Attribution des rôles sur la carte Moodle LTI, et vérifiez que ses expériences sont publiées. Les enseignants déjà venus de Moodle avant le changement peuvent avoir besoin d'un accès donné depuis l'onglet Gestion des accès de l'espace de travail.
« La session a expiré ou n'a pas été correctement lancée »
Vous voyez La session a expirée ou n'a pas été correctement lancée. Réessayer. La fenêtre de sélection reste valable une heure après son ouverture depuis Moodle. Fermez-la et cliquez à nouveau sur Sélectionner un contenu.
« Votre plateforme ne supporte pas le lancement LTI d'Uptale »
Vous voyez Votre plateforme ne supporte pas le lancement LTI d'Uptale (ltiResourceLink, window). Veuillez contacter votre administrateur. Uptale ajoute chaque expérience sous forme de lien qui s'ouvre dans une fenêtre. Vérifiez les réglages de l'outil dans Moodle par rapport à l'étape 2, surtout Prend en charge les liens profonds et URL de sélection de contenu.
Un apprenant voit « Oups, accès non autorisé »
L'expérience n'est pas publiée, ou l'apprenant n'a pas accès à son espace de travail. Publiez l'expérience, ajoutez son espace de travail sous Attribution des rôles, ou donnez accès à l'apprenant depuis l'onglet Gestion des accès de l'espace de travail s'il était déjà venu de Moodle auparavant.
Aucune note n'apparaît dans Moodle
La note est envoyée à la fin de la session. Vérifiez que Services de devoirs et de notes IMS LTI et Accepter les notes de l'outil sont réglés comme à l'étape 2, que l'expérience a des étoiles à gagner, et que l'option Envoyer uniquement le score de succès ne retient pas une session échouée.
Les apprenants apparaissent sans leur nom dans Uptale
Réglez Partager le nom de l'utilisateur avec l'outil et Partager le courriel de l'utilisateur avec l'outil sur Toujours dans les réglages de l'outil dans Moodle. Le changement s'applique au prochain lancement des apprenants.