Les API Brightspace exposent des fonctionnalités permettant aux utilisateurs de migrer des liens Legacy 1.1 vers Advantage 1.3. Cette API migre un lien à la fois, ce qui est le plus utile pour les liens au niveau de l’organisation qui sont partagés vers plusieurs cours.
Les liens au niveau de l’organisation LTI 1.1 sont effectués sur la page d’accueil de l’instance. Accédez à Outils d’administration (l’icône de rouage) > Outils d’apprentissage externes > Gérer les liens d’outils (hérité)
Figure : Accédez à Gérer les liens d’outil (hérité) pour commencer le processus de migration.
Les liens au niveau de l’organisation partagés avec les cours se trouvent dans le cours. Accédez à Administrateur du cours > Outils d’apprentissage externes > Gérer les liens d’outil (hérité). Ceux-ci apparaissent dans le Titre en tant qu’éléments d’interface utilisateur non interactifs.
Figure : Vous pouvez afficher les liens au niveau de l’organisation dans le tableau. Ceux-ci apparaissent dans le Titre .
Pour migrer le lien, vous avez besoin de l’ID de déploiement, de l’ID de lien et éventuellement de l’ID du fournisseur d’outil. Ces informations se trouvent dans des ensembles de données et les API suivantes :
Cette API GET renvoie une liste de tous les liens LTI 1.1 appartenant à une unité d’organisation :
- GET /d2l/api/le/(version)/lti/link/(orgUnitId)/
Copiez le LtiLinkId pour le lien que vous devez migrer.
Figure : Sélectionnez et copiez la valeur du LtiLinkId.
Utilisez cette API GET pour obtenir l’ID de déploiement du déploiement LTI 1.3 Advantage où vous souhaitez migrer ce lien 1.1 :
- GET /d2l/api/le/(version)/ltiadvantage/déploiement/
Figure : Sélectionnez et copiez le DeploymentID et le nom du déploiement LTI 1.3 Advantage.
Vous pouvez maintenant démarrer le processus de migration. Utilisez cette API :
https ://docs.valence.desire2learn.com/res/ltiadvantage.html#post--d2l-api-le-(version)-ltiadvantage-migration-links-(linkId) (en)
- POST /d2l/api/le/(version)/ltiadvantage/migration/liens/(linkId)
Le corps de cette API doit avoir les informations suivantes :
{
« DeploymentId » : « GUID from deployment »,
« ToolProviderId » : <strong>null</strong>
<strong>}</strong>
Pour vérifier que cette API a réussi, exécutez à nouveau l’API get Links, le lien migré ne doit pas apparaître dans cette liste. Ce lien migré apparaît maintenant dans l’interface utilisateur ; cela peut être trouvé en naviguant vers Outils d’administration (l’icône de rouage) > Outils d’apprentissage externes > Déploiement de LTI Advantage, puis sélectionnez votre déploiement, puis cliquez sur Voir les liens.
Il est important de vérifier que le lien migré fonctionne après la migration. Placez ce lien dans le contenu et effectuez un lancement de ce lien. Cela nécessite de connaître le fonctionnement de l’outil pour s’assurer que le lancement a réussi.
