Enregistrer un outil d’apprentissage externe pour LTI Advantage
L'enregistrement est la première étape de l'intégration d'un outil à une plateforme et finalise le processus de sécurité et d'authentification (SGA) de l'intégration.
|
Important : un outil d'apprentissage externe ne peut avoir qu'un seul domaine fonctionnel enregistré au sein d’une plateforme.
|
Les informations suivantes sont pertinentes pour l’enregistrement de l’outil :
- Id du client : Identifiant utilisé dans l'authentification OAuth2 pour faire les demandes de services (noms et rôles, travaux et notes)
- URL du clavier de Brightspace : Où les clés de Brightspace sont stockées. Les outils ont besoin de cet identifiant lors de l'inscription et du lancement (D2L signe le message de lancement et l'outil s'en sert pour valider la signature de D2L).
- URL de OAuth2 Access Token de Brightspace : Là où les outils récupèrent les nouveaux jetons d'accès pour les demandes de service OAuth2.
- Point d’extrémité d’authentification de session OpenID : Le point d’extrémité vers lequel Brightspace envoie une réponse d’ouverture de session
- Auditoire OAuth2 de Brightspace : Le destinataire prévu du jeton.
- Émetteur : L’URL de l’instance Brightspace.
|
Remarque : Pour inscrire un outil, assurez-vous que les autorisations Gérer les inscriptions d'outils de LTI Advantage et Gérer les déploiements d'outils de LTI Advantage sont définies au niveau de l'organisation. |
Pour enregistrer un outil
- Dans le menu Outils d’administration, cliquez sur Gérer la capacité d’extension.
- Dans l’onglet LTI Advantage, cliquez sur Enregistrer un outil.
Figure : Cliquez sur Enregistrer un outil pour commencer le processus d'enregistrement d'un nouvel outil.
- Choisissez l’inscription dynamique ou standard, puis cliquez sur Enregistrer.
- Pour un enregistrement régulier, remplissez les champs suivants (* indique un champ obligatoire) :
- Nom*
- Description
- Domaine* : Les domaines peuvent seulement être utilisés dans un seul enregistrement activé à la fois. Si vous tentez d'enregistrer un outil avec un domaine qui est déjà utilisé, vous serez invité à désactiver l'enregistrement existant.
- URL de renvoi* : Il ne devrait y avoir que quelques URL de renvoi. Les URL de renvoi doivent avoir une correspondance exacte. Les caractères génériques ne sont pas pris en charge.
- URL de l’ouverture de session OpenID*
- URL de lien cible
- URL du clavier : Vous devez entrer une URL de clavier pour ajouter des extensions.
- Extensions : Vous pouvez choisir parmi les extensions suivantes :
- Services des travaux et des notes
- Liaison profonde
- Services de provisionnement des noms et des rôles
- Service de notification de la plateforme : Vous pouvez activer le Service de notification de la plateforme pendant le processus enregistrement. Cela permet aux outils d'apprentissage externes de s'abonner aux avis d'événement de point d'ancrage Web. Lorsqu'il est activé, le Service de notification de la plateforme permet aux outils d'apprentissage externes d'enregistrer, de mettre à jour et de supprimer des gestionnaires d'outils pour recevoir des avis.
Figure : Sélectionnez Service de notification de la plateforme pour permettre aux outils d'apprentissage externes de s'abonner aux avis de points d'ancrage Web.
- Profil de l’élément d’activité
- Examen de la soumission
- Pour une inscription dynamique, remplissez les champs obligatoires suivants :
- Saisissez l’URL d’inscription dynamique fournie par l’outil. Vous pouvez également permettre à l'outil en option de créer le déploiement avec des liens. Une fois le flux de travail d’inscription dynamique terminé, l’inscription est désactivée par défaut conformément aux spécifications.
- Il est recommandé de revoir les extensions, les paramètres et les réglages de sécurité (dans le déploiement, s’il y a lieu) demandés par l’outil pour s’assurer qu’ils répondent aux cas d’utilisation de votre organisation. L’inscription dynamique redirige l’utilisateur vers le point d’extrémité de l’outil dans un nouvel onglet. Cette fonctionnalité prévient les problèmes de témoins intersites et de sites identiques.
- Sous rôles, choisissez d’envoyer les données du rôle d’IMS pour les rôles de contexte et d’établissement ou seulement le rôle de contexte. Si la case Envoyer le rôle d’établissement est cochée, les rôles de contexte et d’établissement sont inclus dans la mise en correspondance depuis la configuration d’IMS lorsque l’outil est lancé. Le rôle de contexte des utilisateurs est aussi inclus, à moins que les réglages de sécurité au moment du déploiement aient été réglés à Anonyme. Si la case Envoyer le rôle d'établissement n’est pas sélectionnée, seuls les rôles de contexte sont inclus.
- Paramètres de substitution : Les utilisateurs peuvent sélectionner des paramètres dans une liste prédéfinie; ces paramètres seront ensuite substitués de façon dynamique avec une valeur du SGA au moment du lancement. Brightspace prend actuellement en charge les réglages suivants :
- $Context.id.history
- $CourseOffering.sourcedId
- $CourseOffering.title
- $CourseSection.label
- $CourseSection.sourcedId
- $CourseSection.title
- $CourseSection.timeFrame.begin
- $CourseSection.timeFrame.end
- $CourseTemplate.sourcedId
- $CourseTemplate.title
- $Person.address.timezone
- $Person.email.primary
- $Person.name.family
- $Person.name.full
- $Person.name.given
- $Person.sourcedId
- $ResourceLink.available.startDateTime
- $ResourceLink.available.endDateTime
- $ResourceLink.description
- $ResourceLink.id.history
- $ResourceLink.submission.endDateTime
- $ResourceLink.title
- $User.id
- $User.username
- Paramètres personnalisés : Dans les instances où les outils doivent définir le nom et la valeur d’un paramètre personnalisé, ils peuvent être définis ici. Ces paramètres ne seront pas remplacés de façon dynamique et ils sont restreints à l’envoi d’une valeur statique pour chaque lancement.
- Cliquez sur Inscrire.
|
Remarque : Les paramètres personnalisés et de substitution créés au niveau de l’inscription se répercutent aux niveaux du déploiement et des liens. |
Déployer un outil d’apprentissage externe pour LTI Advantage
Les déploiements permettent le partage des outils inscrits dans Brightspace avec des unités organisationnelles précises ou avec les éléments secondaires des unités organisationnelles primaires. Lors du déploiement d’un outil, vous précisez les extensions offertes, de même que tous les réglages de sécurité. Une case à cocher est offerte pour permettre aux administrateurs d’IOA de définir si tous les liens sous ce niveau sont automatiquement définis à Ouvrir comme ressource externe.
|
Remarque : Pour déployer un outil d’apprentissage externe, assurez-vous que les autorisations Gérer les inscriptions d'outils de Avantage LTI et Gérer les déploiements d'outils de Avantage LTI sont octroyées à l'organisation et que l'outil a été enregistré. |
Pour déployer un outil d'apprentissage externe
- Dans le menu Outils d’administration, cliquez sur Outils d’apprentissage externes.
- Dans l'onglet LTI Advantage, cliquez sur Nouveau déploiement.
Figure : Cliquez surl’option Nouveau déploiement de l'onglet Avantage LTI.
- Sélectionnez l'option Inscription dans la liste déroulante Outil.
- Saisissez les valeurs des champs Nom et Description.
- Sélectionnez une extension :
- Service de notification de la plateforme : Vous pouvez également activer le Service de notification de la plateforme dans le cadre de votre déploiement, ce qui permet aux outils d'apprentissage externes d'enregistrer, de mettre à jour et de supprimer des gestionnaires d'outils pour recevoir des avis et active l’option Avis de copie de contexte pour informer les outils lorsqu'une copie de cours est effectuée.
Figure : Sélectionnez les options Service de notification de la plateforme et Avis de copie de contexte si vous souhaitez activer le Service de notification de la plateforme pour votre déploiement.
- Sélectionnez les Paramètres de sécurité et les Paramètres de configuration désirés.
- Définir les paramètres de substitution requis. Les utilisateurs peuvent sélectionner des paramètres dans une liste prédéfinie; ces paramètres seront ensuite substitués de façon dynamique avec une valeur de Brightspace au moment du lancement. Brightspace prend actuellement en charge les réglages suivants :
- $CourseSection.timeFrame.begin
- $CourseSection.timeFrame.end
- $ResourceLink.available.startDateTime
- $ResourceLink.available.endDateTime
- $ResourceLink.submission.endDateTime
- Configurez tout Paramètre personnalisé : Dans les instances où les outils doivent définir le nom et la valeur d’un paramètre personnalisé, ils peuvent être définis ici. Ces paramètres ne seront pas remplacés de façon dynamique et ils sont restreints à l’envoi d’une valeur statique pour chaque lancement.
- Sélectionnez Ajouter des unités organisationnelles pour autoriser le partage de l’outil.
- Cliquez sur Créer un déploiement.
|
Remarques : Les paramètres personnalisés et de substitution que vous créez au niveau de l'inscription se répercutent au niveau du déploiement et des liens. Après la création d'un déploiement pour cet outil, l'outil de ce déploiement ne peut plus être modifié. |
Lorsque l’outil aura été déployé avec succès, vous recevrez un ID de déploiement. C’est un identifiant fondé sur un GUID pour ce déploiement spécifique. Il est utilisé pour service de référence unique à ce déploiement spécifique d’un outil inscrit, et il peut être requis par l’outil durant la configuration.
Les outils inscrits peuvent avoir plusieurs déploiements. Chaque déploiement individuel peut être unique, soutenant la capacité pour différents délais LTI (IOA) et paramètres de sécurité par déploiement. Le déploiement est ce qui permet de partager l’outil d’apprentissage avec les cours. Le bouton de partage Ajouter des unités organisationnelles pour les déploiements permet d’offrir votre nouvel outil dans vos cours.
Les paramètres personnalisés et de substitution peuvent également être créés au niveau du déploiement et se répercuter jusqu'au niveau des liens. Si les paramètres sont créés au niveau de l'inscription, ils sont visibles aux niveaux du déploiement et des liens, mais ils sont grisés et ne peuvent pas être modifiés. Si un paramètre est créé au niveau de l'inscription ET au niveau du déploiement, le paramètre de déploiement est utilisé dans le lancement de LTI (IOA).
Créer un lien d’apprentissage externe pour LTI Advantage
Une fois que vous avez réussi à créer le déploiement d’un outil, vous devez créer les liens LTI (IOA). Des liens peuvent être créés pour être utilisés dans les unités organisationnelles à partir du déploiement, ou les utilisateurs avec une autorisation peuvent créer des liens individuels au niveau de l'organisation où l'outil est déployé. Dans les cas où un outil nécessite la création de plusieurs liens LTI (IOA) par cours ou pour plusieurs cours, l'outil pourrait fournir un flux de travail de lien profond pour permettre aux utilisateurs de créer rapidement et facilement les liens.
La plupart des intégrations créent les liens IOA au moyen de la liaison profonde pour vous. Mais vous pourriez avoir besoin à l’occasion de créer un lien IOA manuellement. Vous pouvez les créer ainsi :
- À la page de déploiement d’un outil récemment déployé, cliquez sur Afficher les liens.
- Directement à partir de la page Outil d’apprentissage externe dans un cours, sous LTI Advantage, vous pouvez ajouter de nouveaux liens. Les éléments cliquables surlignés en bleu sont des liens que vous pouvez modifier qui ont été créés au niveau du cours. Les noms de liens grisés sont des liens créés au niveau du déploiement et ils ne peuvent pas être modifiés au niveau du cours. Remarque : les liens créés à l’unité organisationnelle ne seront pas visibles à partir du niveau de déploiement.
|
Remarque : Les liens créés pour un déploiement apparaissent dans tous les cours où le déploiement est partagé. Les paramètres personnalisés et de substitution peuvent également être créés au niveau des liens. Si les paramètres sont créés au niveau de l'inscription ou du déploiement, ils sont visibles au niveau des liens, mais ils sont grisés et ne peuvent pas être modifiés. Si un même paramètre est créé aux niveaux de l'inscription, du déploiement et des liens, le paramètre de lien est utilisé dans le lancement de LTI (IOA). |
<![CDATA[ ]]>
Pour créer un lien LTI (IOA)
- Dans le menu Outils d’administration, cliquez sur Outils d’apprentissage externes.
- Dans l’onglet LTI Advantage, sélectionnez un déploiement existant.
- Faites défiler jusqu’en bas et cliquez sur Afficher les liens.
- Cliquez sur Nouveau lien.
- Précisez les champs suivants de la section Créer un lien :
- Nom : Le nom que vous désirez attribuer à votre sélecteur de contenu. Le nom précisé ici est le nom qui s’affiche dans d’autres zones de l’IU.
- URL : L’URL du point de lancement auquel l’utilisateur accède lorsqu’il clique sur le sélecteur du contenu.
- Description : Une description facultative qui aide les utilisateurs à comprendre l’outil.
- Type : Le type défini dicte comment le lien peut être utilisé. La valeur par défaut est Lancement de base, qui signifie que le lien n’effectuera que le lancement habituel de LTI (IOA). Pour utiliser les liaisons profondes, sélectionnez l’un des types de sélecteur de liaison profonde suivants pris en charge par Brightspace :
- Lien profond Lien rapide : Expose le lien en tant que sélecteur de contenu dans nos menu de liens rapides.
- Lien profond Inclure quelque chose : Expose le lien en tant que sélecteur de contenu dans la boîte de dialogue Inclure quelque chose de l’Éditeur Brightspace.
Remarque : Le plugiciel utilisé devrait être spécifié par le fournisseur d’outils.
- Largeur et hauteur : Lors de la sélection du contenu, Brightspace ouvre une image iFrame affichant l’IU de l’outil pour découvrir le contenu. Ces réglages dictent la taille de l’image iFrame.
- Paramètres de substitution : Vous pouvez sélectionner des paramètres dans une liste prédéfinie; ces paramètres seront ensuite substitués de façon dynamique avec une valeur de Brightspace au moment du lancement. Brightspace prend actuellement en charge les réglages suivants :
- $CourseSection.timeFrame.begin
- $CourseSection.timeFrame.end
- $ResourceLink.available.startDateTime
- $ResourceLink.available.endDateTime
- $ResourceLink.submission.endDateTime
- Paramètres personnalisés : Dans les instances où les outils doivent définir le nom et la valeur d’un paramètre personnalisé, ils peuvent être définis ici. Ces paramètres ne seront pas remplacés de façon dynamique et ils sont restreints à l’envoi d’une valeur statique pour chaque lancement.
-
Cliquez sur Enregistrer et fermer.
|
Remarque : Les flux de travail suivants entraînent la définition par défaut d'un lien Ouvrir comme ressource externe, quelle que soit la configuration du Déploiement : - Expérience Leçons : si un lien est ajouté à partir de l’outil Contenu > Activités existantes > Outils d’apprentissage externes
- Éditeur Brightspace : liens rapides créés via CIM
Les paramètres personnalisés et de substitution partagés au niveau de l’inscription ou du déploiement sont grisés au niveau du lien et ne peuvent pas être modifiés. Si un paramètre doublon est créé au niveau du lien, les détails du paramètre de lien seront inclus dans le lancement. |