○ Content uit een ander systeem afspelen in aNewSpring middels LTI 1.3 (Platform)
Introductie
Dit artikel gaat over het afspelen van content uit een ander systeem binnen aNewSpring via LTI 1.3 en over hoe je hiervoor een LTI 1.3 configuratie aanmaakt en de template inricht om de koppeling met het externe systeem succesvol tot stand te brengen.
Wil je eerst een introductie lezen over koppelen via LTI 1.3? Lees dan eerst onderstaand artikel:
○ Een introductie over het gebruik van LTI 1.3
Wil je externe content afspelen via LTI 1.1 lees dan onderstaand artikel:
○ Content uit een ander systeem afspelen in aNewSpring middels LTI 1.1 (Consumer)
Welke rollen heb je nodig?
Omgevingsbeheerder: voor het aanmaken en beheren van de LTI 1.3 configuratie.
Ontwerper: voor het aanmaken en inrichten van de externe activiteit in de template.
Het maken van een LTI 1.3 configuratie vereist acties vanuit aNewSpring (Platform kant) én het externe systeem waarvan je content gaat afspelen (Tool kant).
1) Maak een LTI 1.3 configuratie aan
Deze stap moet in aNewSpring worden gedaan, waarbij het externe systeem benodige gegevens moet aanleveren.
Om een koppeling te kunnen maken met een extern systeem en om externe content in aNewSpring af te kunnen spelen, moet eerst een LTI 1.3 configuratie worden aangemaakt.
Hiervoor moet eerst een connectie tussen aNewsSpring en het externe systeem worden gemaakt. Het externe systeem is het systeem waarvan je straks content gaat afspelen in je template/uitvoering en waar deelnemers vanuit aNewSpring naartoe worden gelinkt.
aNewSpring is in dit geval de Platform kant en het externe systeem is de Tool kant.
Het externe systeem moet als eerst informatie geven om de connectie te kunnen maken met beide platforms.
Welke informatie moet het externe systeem doorgeven en waar moet ik deze informatie invullen?
Onderstaande gegevens moet het externe systeem delen.
Je hebt de volgende informatie nodig vanuit het externe systeem:
- Openbare sleutelset-URL (van externe platform)
- Aanmeldings-URL initiëren
- Omleidings-URL
Wanneer je deze informatie gekregen hebt, kun je in aNewSpring aan de slag.
Onderstaande stappen moeten in aNewSpring worden gedaan.
Met de gekregen informatie kun je nu in aNewSpring een LTI 1.3 configuratie aan gaan maken.
Ga hiervoor naar depagina en scrol naar het kopje LTI 1.3 configuraties:
Klik op de knop
en open hierna het tabje LTI Platform.
Klik hierna op de knop om een nieuwe configuratie aan te maken:
Geef de LTI configuratie een naam (bijvoorbeeld de naam van de klant van het externe systeem waarvoor je de configuratie aanmaakt) en vul de Openbare sleutelset-URL en Aanmeldings-URL initiëren velden in:
Klik vervolgens op
:
Je krijgt nu toegang tot de verdere Platforminstellingen. Deze gegevens worden automatisch aangemaakt en verschijnen onderaan in de pop up. Deze gegevens deel je vervolgens met het externe systeem waarmee je de LTI configuratie tot stand gaat brengen.
Onderstaande stap moet in het externe systeem worden gedaan.
De gegevens die beschikbaar zijn gekomen na het aanmaken van de nieuwe configuratie zoals hierboven beschreven, deel je met het externe systeem.
Zij moeten deze gegevens aan hun kant in hun systeem verwerken zodat het aanmaken van de LTI configuratie kan worden afgerond.
De volgende gegevens deel je met het externe systeem en kun je vanuit de pop up kopiëren en plakken:
- Client ID
- Deployment ID
- Issuer
- Toegangstoken-URL
- Verificatie-URL
- Openbare sleutelset-URL
De terminologie van deze URL's hoort kan in andere systemen verschillen van hoe deze in aNewSpring heten. Onderaan dit artikel vind je een lijst van URL's en termen van andere gegevens voor het maken van een LTI 1.3 configuratie die in veel gebruikte externe systemen anders zijn dan in aNewSpring.
Zodra de configuratie is aangemaakt met de juiste data, kan er een beveiligde verbinding worden gemaakt tussen beide platforms.
Je kunt nu verder aan de slag met het inrichten van een externe activiteit in de template waarin je de externe content gaat afspelen. Daarover meer in de volgende stap.
2) Voeg een externe activiteit toe aan de template
Deze stap moet in aNewSpring worden gedaan.
Nu de LTI configuratie is aangemaakt, is het tijd om de template verder in te richten met een externe activiteit waar straks de link naar de cursus in het externe systeem kan worden toegevoegd.
Klik via de pagina op
achter de template waar je een externe activiteit aan toe wil voegen om content uit een ander systeem af te spelen in aNewSpring.
Klik in de template bij één van de blokken open kies hier voor de Externe activiteit. Geef de activiteit een naam en klik vervolgens op
.
3) Stel de LTI link en configuratie in in de externe activiteit
Deze stap moet in aNewSpring worden gedaan, met behulp van aanvullende gegevens van het externe systeem.
Vul de LTI link in onder het kopje Standaard instellingen. Deze LTI link kan het externe systeem jou geven en is de link die deelnemers straks zullen openen die naar de content in het externe systeem leidt.
Zet het vinkje aan bij Deze link wijst naar een LTI Tool provider.
Hierna kun je kiezen of de koppeling met het externe systeem via een LTI 1.1 of LTI 1.3 configuratie verloopt. Hier kies je LTI 1.3.
Na het selecteren van de LTI 1.3 optie, verschijnen er twee velden die je kunt invullen: LTI tool configuratie en Custom parameters:
Bij LTI tool configuratie selecteer je de LTI configuratie die je wilt gebruiken voor deze activiteit. Je vindt hier alle configuraties die de Omgevingsbeheerder eerder via de Instellingen pagina heeft aangemaakt.
Bij het tonen van de LTI configuraties in het drop-down menu, worden alleen de LTI configuraties getoond van de subomgeving waar de template aan is gekoppeld.
Wil je gebruik maken van custom parameters, dan voeg je deze toe bij het veld Custom parameters.
Heb je meerdere custom parameters? Plaats dan na elke custom parameter een enter, zodat ze onder elkaar worden weergegeven. Gebruik geen komma's om ze te scheiden, maar formuleer ze op deze manier:
CustomParameter1=CodeX
CustomParameter2=CodeY
4) Stel de externe activiteit verder in
Deze stap moet in aNewSpring worden gedaan.
Wat je vervolgens moet instellen is geheel afhankelijk van jouw situatie. Hieronder worden de overige instellingen één voor één toegelicht.
Verstuur de beheerder rol naar de tool provider
In de gegevens die via LTI verstuurd worden staan ook de rollen van de gebruiker. Als je wil dat ook de beheerderrol hierin wordt meegestuurd, vink dan deze optie aan.
Toon 'Verder' pas na afronden
Wanneer deelnemers starten met een activiteit, staat rechtsonder in beeld een 'Verder' knop. Dit kan afleiding geven wanneer de deelnemer bezig is met de activiteit, zeker wanneer dit op een mobiel apparaat gebeurt. Met dit vinkje kun je de 'Verder' knop verbergen tot de LTI activiteit afgerond is.
Maak je gebruik van GoodHabitz?
Het vinkje 'Het afronden van de activiteit is gebaseerd op de voortgang' is speciaal gemaakt voor GoodHabitz gebruikers. Normaal gesproken stuurt de LTI provider alleen een score door. GoodHabitz kan zo ingesteld worden dat ze een voortgang doorsturen.
Wanneer de deelnemer dan halverwege stopt, zal er een voortgang van 50% getoond worden in de knop. Zet de grens op een percentage waarop aNewSpring de activiteit als afgerond ziet.
Zet het vinkje Het afronden van de activiteit is gebaseerd op de voortgang niet aan als je in GoodHabitz gebruik maakt van de link die speciaal bedoelt is voor een toets. Dan wordt er namelijk wel een score doorgegeven en geen voortgang. Bij een geslaagde toets stuurt GoodHabitz een score van 1.0 door, bij gezakt 0.0.
Speel af in pop-up
Wanneer je deze optie uitzet, zal de LTI Tool zich binnen de activiteit afspelen. Je kunt dan de grootte van het Frame bepalen waarin het wordt afgespeeld. Wanneer je voor percentages kiest, past het zich aan het scherm van de deelnemer aan.
Een consequentie is wel dat LTI die niet in een pop-up afgespeeld wordt, na afronden niet opnieuw gedaan kan worden. Zodra er een score wordt doorgegeven, komt de deelnemer terecht in een resultatenpagina waar de score getoond wordt.
Zet dit vinkje dus aan wanneer de deelnemer ook na het behalen van een score de LTI activiteit nog mag afspelen.
Wanneer het afronden gebaseerd is op de voortgang, dus wanneer je GoodHabitz gebruikt, blijft het mogelijk om de activiteit af te spelen, ook wanneer de activiteit niet in een pop-up afspeelt.
Het is ook mogelijk om een learning journey middels LTI af te spelen die in een andere aNewSpring omgeving is gemaakt. In dat geval raden we aan om de optie 'Speel af in een pop-up' aan te zetten, zodat deelnemers niet verward raken met de dubbele navigatie die ze dan zien.
5) Het tonen van een score en het instellen van een slagingsgrens
In de LTI standaard is bepaald dat er na afronden een score doorgegeven kan worden tussen de 0 en de 1. Komt er een score terug van 0.8, dan interpreteren wij dat als 80%.
Zodra er een score wordt doorgegeven, wordt dit altijd getoond in het resultatenoverzicht.
Wanneer je ook een slagingsgrens wilt instellen, zet dan het vinkje Beoordeling toegestaan aan in combinatie met Eindcijfer wordt los ingevoerd. In het onderstaande voorbeeld staat de slagingsgrens op 80% en krijgt de activiteit de status 'Geslaagd' wanneer er een score van 0.8 wordt doorgestuurd.
Stel dat de deelnemer de LTI activiteit nogmaals doorloopt en een nieuwe score behaalt, dan wordt de vorige score geüpdatet naar de nieuwe score. Hierdoor kan een activiteit die eerst de status 'Gezakt' had, ook veranderen naar 'Geslaagd' en andersom.
Het vinkje Activiteit kan herbeoordeeld worden heeft hier verder geen invloed op.
6) De externe activiteit is klaar voor gebruik!
Nu de activiteit helemaal is ingericht, is deze klaar voor gebruik. Wanneer je de template publiceert en een uitvoering aanmaakt, zullen deelnemers de externe activiteit te zien krijgen die doorlinkt naar het externe systeem.
Terminologie in aNewSpring en andere systemen
De terminologie van de URL's en de andere gegevens die in aNewSpring worden gehanteerd bij het maken van de LTI configuratie, kunnen in externe systemen net wat anders zijn. Hieronder vind je een lijstje met de termen die in externe systemen worden gehanteerd waarmee vaker een LTI koppeling wordt gemaakt en hoe deze in de externe systemen worden genoemd en in aNewSpring.
Deze termen komen terug in Stap 1 van dit artikel.
Plusport
aNewSpring | Plusport |
Openbare sleutelset-URL | JWKS URL |
Aanmeldings-URL initiëren | Login URL |
Omleidings-URL | URL en Omleidings URLs |
Issuer | Platform ID |
Verificatie-URL | Authenticatie-URL |
Moodle
aNewSpring | Moodle |
Openbare sleutelset-URL | Publieke sleutelset URL |
Client ID | Client ID |
Deployment ID | Implementatie ID |
Issuer | Platform ID |
Toegangstoken-URL | Toegang token URL |
Verificatie-URL | Verificatie-aanvraag URL |