Brightspace®-gebruikers kunnen oudere LTI-implementaties in Brightspace® blijven gebruiken.
D2L ondersteunt echter de volgende methoden voor het migreren van bestaande LTI-koppelingen (1.1.x) naar LTI Advantage (1.3):
- API's voor toewijzing van migratiedomeinen
- Handmatige migratie van koppelingen door te klikken op de knop Migreren op het tabblad Toolkoppelingen beheren (oud).
- Migratie via een Brightspace-API.
- Cursus importeren.
- Cursuskopie.
Opmerking: Voor het importeren van cursussen, het kopiëren van cursussen en het handmatig migreren van koppelingen kunt u de API voor de toewijzing van migratiedomeinen gebruiken om naar een ander domein te migreren.
Registratie van LTI-tools en -implementaties is een gecentraliseerde beheerworkflow in LTI Advantage, in tegenstelling tot oudere LTI 1.1 of 1.2. De machtigingen en interfaces voor LTI Advantage verschillen van oude LTI 1.1. Zorg ervoor dat uw aangewezen beheerders LTI Advantage-machtigingen hebben om migratieactiviteiten te openen, te controleren en problemen op te lossen.
Als een koppeling is gemigreerd, wordt deze niet langer weergegeven onder het oude gedeelte Koppelingen externe cursustool en is deze gekoppeld aan de LTI Advantage-implementatie. De start bevat ook een migratie-claim, die de tool informeert dat de koppeling is gemigreerd.
API's voor toewijzing van migratiedomeinen
Met de reeks API's voor het toewijzen van migratiedomeinen kunt u een of meer verouderde koppelings-URL's naar een ander Advantage-registratiedomein migreren. Voorbeelden van gebruiksscenario's zijn het toevoegen, verwijderen of bijwerken van verouderde domeinen en het migreren van meerdere verouderde koppelings-URL's naar een ander Advantage-registratiedomein. Raadpleeg de documentatie van Valence voor meer informatie.
U moet Verouderde domeinen als eindpunt hebben.
Nadat de migraties zijn voltooid, raadt D2L u aan de toewijzing van deze domeinen ongedaan te maken. Wanneer een verouderd domein wordt toegewezen, kunnen geen nieuwe registraties worden gemaakt met dat verouderde domein. Als bijvoorbeeld de verouderde koppelings-URL verouderd.com is toegewezen aan het nieuwe registratiedomein advantage.com, kunt u pas een nieuwe 1.3-registratie met het domein verouderd.com maken nadat de toewijzing is verwijderd.
Met de migratiefunctie kan het pad niet worden bijgewerkt of kunnen aangepaste parameters niet worden bijgewerkt via het migratieproces.
Zoals in de onderstaande tabel wordt weergegeven, verloopt het pad vanaf de verouderde koppelings-URL via de koppelings-URL na de migratie.
| Voorbeeld van een gebruikersscenario |
Verouderde koppelings-URL |
Advantage-registratiedomein |
Toegewezen domein |
Koppelings-URL na migratie |
|---|
| Wijziging van subdomein |
subdomain1.primary.com/path1 |
domain3.com |
domain1.com |
domain3.com/path1 |
| Wijziging van subdomein en domein |
subdomain1.domain2.com/path1 |
domain3.com |
domain2.com |
domain3.com/path1 |
| Verwijdering van subdomein en wijziging van domein |
domain2.com/path1 |
domain3.com |
domain2.com |
domain3.com/path1 |
| Toewijzing van meerdere verouderde koppelings-URL's |
domain2.com; subdomain1.domain2.com |
domain3.com |
domain2.com |
domain3.com |
In deze tabel:
- De verouderde koppelings-URL kan op cursusniveau worden gevonden door te navigeren naar Cursusbeheer > Externe cursustools > Koppelingen naar tools beheren (verouderd).
-
Advantage-registratiedomein is toegankelijk via Beheertools > Uitbreidbaarheid beheren > LTI Advantage. Kies vervolgens uw registratie. Klik op Implementaties weergeven en selecteer uw implementatie. Als u zeker wilt weten dat de implementatie wordt gedeeld waar een migratie vereist is, voeg dan in het gedeelte Tool beschikbaar maken voor organisatie-eenheden toe en klik op Organisatie-eenheden toevoegen.
- Koppelings-URL na migratie kunt u vinden op cursusniveau door naar Cursusbeheer > Externe cursustools > LTI Advantage te gaan.
Migratie na domeintoewijzing maakt gebruik van het huidige migratieproces. Hiervoor moet de tool Advantage 1.3 worden geregistreerd en geïmplementeerd voor de cursussen of organisatie-eenheden die moeten worden gemigreerd. Voor elke migratietaak wordt een item in het migratielogboek vastgelegd onder Cursusbeheer > Externe cursustools > Migratielogboek.
Migratietaken voor mislukte migratie vanwege vereisten voor domeinafstemming worden aangegeven in de kolom Geen overeenkomend domein van het migratielogboek. Raadpleeg het gedeelte Migratielogboek van dit onderwerp voor meer informatie.
Voor meer informatie over hoe deze API's worden gebruikt, raadpleegt u de API-boeken in onze categorie Ontwikkeling van community en de bijbehorende documentatie van Valence.
Zodra deze toewijzing is voltooid, kunnen de migraties met behulp van de knop Migreren worden voortgezet via standaardprocessen zoals Cursus importeren, Cursus kopiëren en handmatige migratie van koppelingen. Als er koppelingen zijn die in aanmerking komen voor de toegewezen domeinen, worden deze gemigreerd naar versie 1.3. De migratie-API, waarmee koppelingen een voor een worden gemigreerd, werkt niet met toegewezen verouderde domeinen.
Handmatige migratie van LTI-koppelingen
U kunt LTI 1.1-koppelingen handmatig migreren naar LTI 1.3 met de knop Migreren op het tabblad Koppelingen naar tools beheren (verouderd) van de pagina Externe cursustools op cursusniveau.
U moet de machtiging LTI-migraties beheren hebben ingeschakeld voor uw rol om LTI-koppelingen handmatig te kunnen migreren. Voor alle tools moet u de schakelaar Automatisch koppelingen migreren inschakelen. Meer informatie: LTI 1.3-machtigingen.
Opmerking: De volgende koppelingen worden gemigreerd: Cijfers gekoppeld aan een koppeling die is gemaakt met Basic Outcomes.
De volgende koppelingen worden niet gemigreerd: Regels voor delen van de bestaande tool naar de LTI 1.3-tool; scores die zijn gemaakt met de Valence API.
De migratie slaagt alleen als er een exacte overeenkomst is tussen de URL van de koppeling en het registratiedomein. Als u wilt voorkomen dat koppelingen worden gemigreerd, verwijdert u de deelregel voor de cursus of schakelt u de implementatie uit.
LTI-koppelingen handmatig migreren
- Klik op de navigatiebalk op Cursusbeheer.
- Klik op Externe cursustools.
-
Navigeer naar het tabblad Koppelingen naar tools beheren (verouderd).
-
Klik op Migreren.
Afbeelding: De knop Migreren op het tabblad Toolkoppelingen beheren (oud).
Er wordt een migratielogboek geopend waarin uw migratie wordt weergegeven als in de wachtrij, in uitvoering en vervolgens als voltooid.
Migratie via een Brightspace®-API
Met behulp van de API kan een afzonderlijke LTI-koppeling worden gemigreerd. De volgende LTI-typen komen in aanmerking voor migratie van een verouderde tool naar een LTI Advantage-tool:
- Basisstartversies
- Externe plug-ins: QuickLink CIM, Insert Stuff® CIM en Widgets
De API vereist de oude LTI 1.1-koppelings-id, met de LTI Advantage-implementatie-id en de toolprovider-id, die D2L in staat stelt de oude LTI-koppeling te koppelen aan een LTI Advantage-implementatie.
Opmerking: De toolprovider-id kan null zijn. Dit zou alleen het geval moeten zijn als de koppeling zelf een eigen sleutel/geheim heeft.
Migratie via Cursus importeren of kopiëren
Wanneer een IMS Common Cartridge- of Brightspace® Cursuspakket met LTI-koppelingen wordt geïmporteerd, maakt Brightspace® deze koppelingen standaard als LTI Advantage als een overeenkomende LTI Advantage-tool is ingesteld met registratie-, implementatie- en deelregels voor die cursus. Als er geen overeenkomende LTI Advantage-tool is ingesteld voor de cursus, maakt Brightspace® deze koppelingen als oude LTI 1.1.
Op dezelfde manier kunnen gebruikers tijdens het kopiëren van de cursus LTI 1.1-koppelingen migreren naar LTI Advantage-koppelingen. Deze migratieworkflow wordt automatisch ingeschakeld, maar de controle over deze workflow kan gedetailleerd zijn. Cursuskoppelingen worden tijdens het kopiëren alleen gemigreerd wanneer:
- De LTI Advantage-tool overeenkomt met het domein van een vorige LTI 1.1-tool
- De LTI Advantage-tool een implementatie heeft die wordt gedeeld met de doelcursus voordat deze wordt gekopieerd
- De LTI Advantage-tool heeft een implementatie waarbij Automatisch koppelingen migreren is ingeschakeld
Als er geen bijbehorende LTI Advantage-tool of -implementatie is, blijft de LTI 1.1-koppeling werken zoals verwacht. Hierdoor kan de migratie worden getest voordat deze volledig wordt uitgevoerd. Nadat een koppeling naar 1.3 is gemigreerd, kunt u deze niet terugdraaien naar LTI 1.1
Wanneer een koppeling is gemigreerd, wordt deze niet langer weergegeven onder het oude gedeelte Koppelingen externe cursustool en wordt deze getoond onder het LTI Advantage-gedeelte. De link bevat ook een migratie-claim, die de tool informeert dat de koppeling is gemigreerd.
Migratielogboek
Gebruikers met de machtiging Logboek voor LTI-migratie weergeven hebben toegang tot het migratielogboek op de juiste niveaus van de organisatie-eenheid. Het logboek is te vinden in de interface Externe cursustools.
Om klanten met meerdere eenheden binnen één organisatie betere controle te bieden, worden de migratiegegevens vergrendeld op basis van inschrijvingen en machtigingen op het niveau van de cursuseditie.
Het migratielogboek houdt alle cursuskopieën bij waar LTI-migraties bij betrokken zijn en identificeert het volgende:
- Het aantal oude LTI-koppelingen dat is gemigreerd naar LTI Advantage
- Het aantal oude LTI-koppelingen met fouten (er is bijvoorbeeld een overeenkomend tooldomein gevonden, maar er zijn geen implementaties voor die cursus)
- Het aantal oude LTI-koppelingen dat is genegeerd (geen domeinovereenkomst gevonden)
Opmerking: Migraties die worden uitgevoerd via API of Cursusimport worden niet vermeld in het migratielogboek.
U kunt de resultaten van het migratielogboek doorzoeken en filteren voor meer gedetailleerde informatie.
Afbeelding: De pagina en tabel Migratielogboek in Externe cursustools. Klik op het vervolgkeuzemenu Status om de tabelresultaten te filteren.
Als u het migratielogboek opent vanaf de pagina Externe cursustools op cursusniveau, worden alle taken voor die cursus weergegeven en krijgt u toegang tot het gedetailleerde migratielogboek wanneer u op een koppeling in de kolom Taak-id klikt.
U moet beschikken over de machtiging voor LTI-migraties beheren of Logboek voor LTI-migratie weergeven op het niveau van de cursuseditie en organisatie om de gegevens van de cursusmigratie te controleren.
Figuur: Klik op de link Taak-ID om de Migratiedetails te bekijken.
Voor het oplossen van problemen bevat de sectie Migratiedetails op de pagina Rapport voor migratietaak snelkoppelingen en de koppeling Ontwikkelingen weergeven, waarmee u overeenkomende implementaties kunt vinden. Via deze koppeling gaan gebruikers rechtstreeks naar de pagina voor implementaties, gefilterd op registratie. Het veld Resultaat geeft een overzicht van de migratieresultaten.
Afbeelding: Gebruik het gedeelte Migratiedetails van de pagina Rapport voor migratietaak, met snelkoppelingen naar de pagina voor implementatie van tools voor probleemoplossing.
Voor succesvolle migraties bevat de informatie in het gedeelte Migratiedetails het volgende:
- Implementatie
- Registratie
- Domein
- Koppelings-URL
- Verouderd domein (als een oude koppeling afwijkt van een 1.3-registratiedomein)
Afbeelding: Navigeer naar Migratiedetails van de pagina Rapport voor migratietaak om informatie over migraties weer te geven.
De informatie in de sectie Migratiedetails is momenteel beperkt tot de afgelopen 90 dagen en tot relevante gegevens die beschikbaar zijn tijdens het oplossen van problemen met migraties.
Als u gegevens wilt openen die ouder zijn dan 90 dagen, kunt u de Brightspace®-gegevensreeks LTI-linkmigratie-audit of Gegevenshub gebruiken.
Overwegingen voor migratie
Overwegingen voor de migratie via een Brightspace API
De volgende overwegingen zijn alleen van toepassing op de migratie-API:
- API-gebruikers moeten de machtiging LTI-migraties beheren hebben. Deze machtiging is niet vereist voor het importeren van cursussen of het kopiëren van cursussen om koppelingsmigraties uit te voeren. D2L raadt aan om een machtiging aan beheerders toe te kennen.
- Als de oude koppeling een CIM is, moet voor de LTI Advantage-tool de uitbreiding Diepe Koppeling zijn ingeschakeld. Anders reageert de API met een bericht.
- Als de oude koppeling is gekoppeld aan een score, moeten voor de LTI Advantage-tool de Services voor opdrachten en scores zijn ingeschakeld. Anders reageert de API met een bericht.
- Als bij gebruik van de API de koppeling is gemaakt door een externe plug-in, wordt aanbevolen om zo mogelijk ToolProviderId niet op te nemen. Als de ToolProviderId wordt meegeleverd, moet deze overeenkomen met de leverancier van de tool die is gekoppeld aan de externe plug-in.
- Bij gebruik van de API moet de oude koppeling of de toolprovider een sleutel en geheim hebben.
- Als bij gebruik van de API de oude koppeling werd gedeeld met een cursus, moet de LTI Advantage-implementatie worden gedeeld met die cursus.
Algemene overwegingen
De volgende lijst met overwegingen is van toepassing op alle migratiemethoden:
- De LTI Advantage-tool moet een implementatie hebben.
- Aangepaste en/of vervangende parameternamen voor een oudere koppeling moeten uniek zijn.
- HTML is verwijderd uit de beschrijving van een oudere koppeling na de migratie.
- Migraties werken in één richting, van de oude LTI 1.1 naar LTI Advantage, en kunnen niet worden teruggedraaid.
- Als de tool LTI 1.1 gebruikt voor verificatie en Brightspace®-API's om scoreonderdelen in Brightspace® te maken en bij te werken, raadt D2L® u aan eerst met uw toolprovider te spreken voordat u de LTI Advantage-migratie uitvoert om ervoor te zorgen dat er een plan is voor door API gemaakte scoreonderdelen.
- Het migratieproces negeert het pad van het registratiedomein 1.3.
Raadpleeg LTI Advantage-registratie voor meer informatie over het instellen van een LTI Advantage-tool.
Problemen met migraties oplossen
U kunt de volgende opties gebruiken om mislukte migraties te vinden en problemen op te lossen:
-
Als u snel wilt zoeken naar de benodigde implementatie als u grote aantallen hebt, selecteert u een registratie en filtert u de resultaten op hun Registratienamen op het tabblad LTI Advantage.
Afbeelding: Gebruik het filter Registratienamen op het tabblad LTI Advantage.
- Voor meer informatie over mislukte migraties opent u het tabblad Migratielogboek > Migratiedetails en controleert u de snelkoppelingen. U kunt de koppeling Ontwikkelingen weergeven gebruiken om overeenkomende implementaties te vinden. Via deze koppeling gaat u rechtstreeks naar de pagina voor implementaties, gefilterd op registratie. Het veld Resultaat geeft een overzicht van de migratieresultaten.
Afbeelding: Gebruik het gedeelte Migratiedetails van de pagina Rapport voor migratietaak, met snelkoppelingen naar de pagina voor implementatie van tools voor probleemoplossing.
-
Als u de migratiestatus wilt begrijpen en koppelingen wilt controleren, opent u de pagina Koppelingen (LTI Advantage > LTI-tool > Koppelingen weergeven) en filtert u de resultaten op Type, Status en Naam.
Afbeelding: de optie Filteren op type op de pagina Koppelingen.
