Brightspace-API's bieden functionaliteit om gebruikers in staat te stellen verouderde 1.1-koppelingen te migreren naar Advantage 1.3. Deze API migreert één koppeling tegelijk, wat het handigst is voor koppelingen op organisatieniveau die met meerdere cursussen worden gedeeld.
LTI 1.1 koppelingen op organisatieniveau worden gemaakt op de startpagina van de instantie. Navigeer naar Hulpmiddelen voor beheerders (het tandwielpictogram) > Externe leermiddelen > Toolkoppelingen beheren (verouderd)
Afbeelding: Navigeer naar Toolkoppelingen beheren (verouderd) om het migratieproces te starten.
Koppelingen op organisatieniveau die met cursussen worden gedeeld, zijn te vinden in de cursus. Navigeer naar Cursus Admin > Externe leermiddelen > Toolkoppelingen beheren (verouderd). Deze verschijnen in de Titel kolom als niet-interactieve UI-elementen.
Afbeelding: U kunt koppelingen op organisatieniveau in de tabel bekijken. Deze verschijnen in de Titel kolom.
Als u de koppeling wilt migreren, hebt u de DeploymentID, LinkID en optioneel de ID van de toolprovider nodig. Deze informatie is te vinden in gegevenssets en de volgende API's:
Deze GET-API retourneert een lijst met alle LTI 1.1-koppelingen die bij een organisatie-eenheid horen:
- GET /d2l/api/le/(Versie)/lti/koppeling/(orgUnitId)/
Kopieer de LtiLinkId voor de link die u moet migreren.
Afbeelding: Selecteer en kopieer de waarde van de LtiLinkId.
Gebruik deze GET-API om de DeploymentID op te halen van de LTI 1.3 Advantage-implementatie waar u deze 1.1-koppeling wilt migreren:
- GET /d2l/api/le/(Versie)/ltiadvantage/implementatie/
Afbeelding: Selecteer en kopieer de DeploymentID en naam van de LTI 1.3 Advantage-implementatie.
Nu kunt u het migratieproces starten. Gebruik deze API:
https://docs.valence.desire2learn.com/res/ltiadvantage.html#post--d2l-api-le-(version)-ltiadvantage-migration-links-(linkId)
- POST /d2l/api/le/(Versie)/ltiadvantage/migratie/koppelingen/(linkId)
De hoofdtekst van deze API moet de volgende informatie bevatten:
{
"DeploymentId": "GUID van implementatie",
"ToolProviderId": <strong>nul</strong>
<strong>}</strong>
Als u wilt controleren of deze API is geslaagd, voert u de API voor het ophalen van koppelingen opnieuw uit. De gemigreerde koppeling mag niet in deze lijst worden weergegeven. Deze gemigreerde link verschijnt nu in de gebruikersinterface; Deze is te vinden door te navigeren naar Hulpmiddelen voor beheerders (het tandwielpictogram) > Externe leermiddelen > Implementatie van LTI Advantage, selecteer vervolgens uw implementatie en klik op Bekijk links.
Het is belangrijk om te controleren of de gemigreerde link werkt na de migratie. Plaats deze link in de inhoud en voer een lancering van die link uit. Dit vereist kennis van hoe de tool werkt om ervoor te zorgen dat de lancering succesvol was.
