Moodle (LTI)

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 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

1. Dans Moodle, allez dans Administration du site › Plugins › Vue d'ensemble des plugins et cherchez Outil externe (mod_lti).
2. 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

1. Dans Uptale, ouvrez votre environnement, cliquez sur l'onglet Intégration, puis sur Ouvrir le détail sur la carte Moodle LTI.
2. 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

1. Dans Moodle, allez dans Administration du site › Plugins et, sous Outil externe, ouvrez Gérer les outils.
2. Cliquez sur Configurer manuellement un outil.
3. Remplissez les champs comme ci-dessous, puis cliquez sur Enregistrer.

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

1. 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.
2. 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)

3. 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.
4. Si besoin, activez Envoyer uniquement le score de succès.
5. 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.

Ajouter une expérience à un cours

1. Dans le cours Moodle, activez le mode édition et cliquez sur Ajouter une activité ou ressource.
2. Sélectionnez l'outil externe préconfiguré Uptale (ou le nom que vous lui avez donné).
3. Dans les paramètres de l'activité, cliquez sur Sélectionner un contenu. La fenêtre de sélection Uptale s'ouvre.
4. Choisissez un espace de travail sous Espaces disponibles, choisissez l'expérience, puis cliquez sur Sélectionner.
5. 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.