Le plugin local (local_corolair) enregistre votre site Moodle auprès de Raison, crée un service web dédié et synchronise le contexte de cours dont les assistants et les évaluations ont besoin.
Le lancement LTI est une étape distincte. Après la configuration du plugin, consultez Configuration de Moodle : enregistrement dynamique LTI 1.3.
Installez toujours la dernière version depuis le Moodle Plugins Directory.
Prérequis
Moodle 4.4 ou version ultérieure
Un administrateur du site disposant de
moodle/site:configpour terminer la page de configurationLe cron Moodle configuré et actif. L'enregistrement et la maintenance du jeton utilisent des tâches planifiées et ad hoc.
Le module d'activité Outil externe / LTI disponible
Un accès HTTPS sortant de Moodle vers Raison, et des navigateurs du personnel et des apprenants capables d'accéder à
*.raison.isLes enseignants qui publient des évaluations ont besoin de
moodle/course:manageactivitiesetmod/lti:addinstancedans le cours cible, ainsi que du rôle Raison Manager pour gérer les assistants
Vous n'avez pas besoin d'un compte Raison au préalable. L'enregistrement crée votre organisation pour l'administrateur qui termine la configuration.
Installer le plugin
Utilisez l'une des deux méthodes :
Depuis Moodle : allez dans Administration du site → Plugins → Installer des plugins, puis installez depuis l'annuaire (recherchez raison) ou téléversez le fichier ZIP.
En ligne de commande ou via un script de déploiement : placez le plugin dans
local/corolairet lancez la mise à niveau de Moodle (admin/cli/upgrade.php).
L'installation ajoute seulement le plugin et crée le rôle Raison Manager. Rien ne se connecte à Raison tant qu'un administrateur du site n'a pas terminé la configuration ci-dessous.
Terminer la configuration
Cette étape est obligatoire après chaque installation, y compris en ligne de commande ou par script.
Allez dans Administration du site → Plugins → Plugins locaux → Raison Local Plugin et sélectionnez Open Raison setup.
Examinez la divulgation d'intégration, puis sélectionnez I acknowledge this integration disclosure.
Si les services web Moodle ou le protocole REST sont désactivés, la page liste les modifications. Sélectionnez Enable web services and REST pour les approuver. S'ils sont déjà activés tous les deux, sélectionnez Start Raison registration. Les protocoles déjà activés le restent.
Laissez Do not rotate the web-service token décoché, sauf si le cron ou l'accès sortant vers Raison ne sont pas fiables. Voir Jeton du service web ci-dessous.
Moodle met l'enregistrement en file d'attente. Une fois le cron exécuté, la clé API Raison est enregistrée et l'Integration status de la page des paramètres du plugin indique Connected.
Ouvrez Raison depuis la page d'accueil du site (Plus → Raison) pour terminer la prise en main dans Raison.
Après une installation en ligne de commande, l'invitation à ouvrir la page de configuration ne s'affiche que pendant l'installation : elle passe donc facilement inaperçue. Tant que la configuration n'est pas terminée, Moodle le rappelle aux administrateurs du site (trois fois au maximum, à une semaine d'intervalle), et les enseignants qui ouvrent Raison voient un message indiquant que la configuration manque.
Si la configuration n'aboutit pas, consultez Dépannage Moodle.
Essai gratuit et offre
Un nouvel enregistrement démarre avec un essai gratuit soumis à des limites d'utilisation. Tant que votre offre n'est pas en place, l'ouverture de Raison depuis Moodle vous invite à réserver un appel de découverte avec l'équipe Raison.
Si votre organisation a déjà un accord avec Raison, prévenez votre contact Raison dès que la configuration est terminée. Il applique votre offre et vos limites, et vous pouvez accéder directement à Raison sans appel. Sinon, consultez Passer à l'offre Premium et Comprendre vos limites d'utilisation.
Donner accès aux enseignants
Invitez les enseignants et les gestionnaires de cours depuis Raison, et assurez-vous que chacun accepte l'invitation : c'est l'acceptation qui leur donne le rôle Raison Manager dans Moodle. Consultez Donner accès à Raison aux enseignants Moodle.
Pour ajuster l'affichage de l'assistant dans Moodle, consultez Paramètres du plugin Moodle.
Périmètre du service web
Le plugin crée un service dédié nommé Corolair REST Service (l'ancien nom du produit), de nom court corolair_rest. Seul le compte de service Raison peut l'utiliser. La liste des fonctions autorisées est fixe. Elle couvre :
Identité du site et recherche d'utilisateurs
Lecture des cours, catégories, sections et ressources prises en charge
Contexte des inscriptions, participants, rôles et capacités
Lecture de l'achèvement des cours et des activités lorsqu'il est disponible
Attribution du rôle Raison Manager, et de ce rôle uniquement
Création et gestion des placements d'évaluations LTI
Le service n'ajoute pas de fonctions au cas par cas selon les clients. Moodle vérifie à la fois la liste des fonctions autorisées et les capacités du propriétaire du jeton. Le téléchargement de fichiers est activé pour que Raison puisse lire les ressources des cours. Le téléversement de fichiers est désactivé.
Jeton du service web
Le jeton :
Est détenu par un compte dédié,
corolair_webservice, créé par le plugin. Ce compte n'est pas administrateur du site, n'a pas de mot de passe et ne peut pas se connecter.Est envoyé à Raison en HTTPS lors de l'enregistrement
Est limité aux fonctions de
corolair_restExpire au bout de 15 jours
Entre en rotation automatique lorsqu'il reste sept jours
Déclenche un avertissement à l'administrateur, à fréquence limitée, si la rotation n'est toujours pas résolue lorsqu'il reste cinq jours
Conserve l'ancien jeton seulement pendant un court chevauchement après la vérification du nouveau
Le cron doit être actif pour que la rotation réussisse. En cas d'échec de la rotation automatique, l'administrateur peut programmer une nouvelle tentative immédiate depuis les paramètres du plugin. Les sites dont le cron ou l'accès sortant ne sont pas fiables peuvent désactiver la rotation. Consultez Paramètres du plugin Moodle.
Articles liés
Besoin d'aide ? Écrivez à [email protected].