WWM:Wikiwijs arrangement toets afspelen via LTI
Wikiwijs Maken: Wikiwijs arrangement toets afspelen via LTI
Wat kun je met een LTI koppeling met Wikiwijs Maken doen?
Bij gebruik van LTI kunnen toetsen/oefeningen worden gestart vanuit ELO of LMS. Deze blijven afspelen in Wikiwijs Maken en kan zelfs als een embed in eigen omgeving worden geïmplementeerd. Aan het eind van de toets/oefening wordt het resultaat teruggekoppeld. Het voordeel hiervan is dat leveranciers geen QTI-speler hoeven te ontwikkelen, de toets draait immers bij Wikiwijs. Het nadeel ten opzichte van QTI is dat het resultaat puur een eindscore is in de vorm van een getal tussen de 0 en de 1. Ook is het niet mogelijk de vragen op een andere manier vorm te geven.
De koppeling is dus geschikt voor het afspelen toetsen en ophalen van resultaten. Het is mogelijk om een heel arrangement af te spelen op LTI, maar vanwege de beperking van de LTI standaard kan er maar 1 score worden doorgegeven per 'Launch request' (het afvuren van een leerling naar een specifiek onderdeel van een Wikiwijs arrangement). Wikiwijs Maken geeft in dit geval de score van de laatste toets in het arrangement door. Deze implementatie raden we niet aan, je mist namelijk als ELO de resultaten van mogelijk meerdere toetsen in het arrangement.
Wil je als ELO het 'platte' materiaal in eigen omgeving tonen, maar de interactieve toetsen in Wikiwijs tonen? Dan zal je de content via de IMSCP bestanden in eigen omgeving importeren. In plaats van de QTI bestanden afspelen met een eigen gemaakt QTI afspeelomgeving kan je dan een uitstap maken naar de afspeelomgeving van Wikiwijs Maken via LTI. De toetsresultaten krijg je direct terug, hiervoor dien je een LTI Outcome Service op te leveren waar Wikiwijs Maken mee kan communiceren.
Hoe kom je aan de LTI URL's van oefeningen/toetsen?
Handmatig per toets
Als een arrangement interactieve oefeningen en toetsen bevat dan zijn deze handmatig te downloaden door in het linker nagivatiemenu van het arrangement op de "Downloaden" knop te drukken. Vervolgens krijg je de oefeningen en toetsen als LTI download aangebonden onder het kopje LTI (mits er natuurlijk toetsen of oefeningen in het arrangement aanwezig zijn).
Als onderdelen uit een IMS Common Cartridge (IMSCC) export
De LTI links van oefeningen en toetsen worden gebundeld meegeleverd in een IMS Common Cartridge (IMSCC) export van een Wikiwijs Arrangement. Dit bestand, met extensie .imscc, is in feite een zip bestand met hierin een manifest, die alleen de structuur van het arrangement weergeeft in de vorm van de sectieheaders en de verwijzingen naar de toetsen. Een verwijzing naar een toets is in de vorm van een referentie naar een xml bestand in het manifest. In de folder 'files' bevindt zich vervolgens per toets, oefening of losse vraag een xml bestand. Dit xml bestand bevat de volgende gegevens over de oefening/toets/vraag:
- Titel (blti:title)
- Wikiwijs Maken LTI Launch URL (beginnend met: http:)
- Wikiwijs Maken LTI Secure Launch URL (beginnend met: https)
De keuze voor het gebruik van de normale als de Secure Launch URL is aan de afnemende ELO. Als bijvoorbeeld de toets als embed in de ELO gepresenteerd wordt en de ELO draait onder https, dan moet men de secure versie gebruiken om browser waarschuwingen rondom wisselen van beveiligde en niet beveiligde content te voorkomen.
Pro tip:
De naam van dit XML bestand (bijvoorbeeld: 20945a06c0de167800b15ee03554447413995d23.xml) bevat de unieke ID van de toets. Deze zelfde ID wordt ook gebruikt voor de QTI bestanden uit de IMS Content Package. Hiermee is het mogelijk een implementatie van Wikiwijs die eerst op basis van QTI was te migreren naar een LTI implementatie of visa versa. Een ander voordeel van het combineren van de data uit de IMSCC export bestanden de de IMSCP export bestanden is dat de laatste ook alle overige content van het arrangement bevat. Met deze data zou je de volgende implementatie van materiaal in eigen omgeving kunnen realiseren:
- De content uit een IMS Content Package wordt in eigen omgeving geïmporteerd, inclusief de beschikbare (fijnmazige) metadata van het materiaal. De data in de QTI bestanden kan buiten beschouwing worden gehouden.
- Voor de implementatie van de interactieve oefeningen en toetsen worden de leerlingen naar de specifieke URLs van de LTI toetsen gestuurd. De individuele scores van leerlingen worden teruggegeven aan de LTI Outcome Management Service van aanroepende omgeving.
LTI standaard
Wikiwijs maakt gebruik van een door de UWLR 2.1 afspraak toegestane LTI standaard om toetsscores door te geven. Aangezien Wikiwijs een open systeem is, waarbij leerlingen niet hoeven in te loggen om het materiaal te zien, is veel uit de UWLR afspraak niet van toepassing omdat deze zich voornamelijk richt op de uitwisseling van leerlinggegevens.
Wikiwijs Maken maakt gebruik van LTI standaard versie 1.1. Er is na een marktonderzoek door Kennisnet voor deze versie gekozen omdat dit de meest breed ondersteunde versie is van LTI is die door ELO’s wereldwijd wordt ondersteund.
Meer informatie over de LTI is te vinden in de LTI v1.1 implementation guide van IMS Global.
Globale werking
In LTI termen is Wikiwijs Maken een Tool Provider en een ELO een Tool Consumer. De daadwerkelijke 'Tool' die bij Wikiwijs Maken wordt afgenomen zijn de individuele toetsen die bij Wikiwijs Maken worden afgespeeld en de teruggave van de score aan de ELO. Hieronder wordt de samenhang weergegeven.
De complete vertaling van de LTI terminologie naar de dienstverlening die Wikiwijs Maken aanbied met behulp van deze interfacing is:
| LTI term |
Vertaling naar de Wikiwijs Maken situatie |
|---|---|
|
Tool Provider |
Wikiwijs Maken<br\> Wikiwijs Maken is een Tool Provider, deze biedt aan ELO’s de mogelijkheid om de<br\> toetsen bij Wikiwijs Maken af te spelen en de resultaten terug te krijgen. |
|
Tool Consumer |
Een ELO<br\> Een tool consumer is een applicatie die een tool gebruikt. Een ELO zoals bijvoorbeeld<br\> Moodle of ItsLearning kan een tool consumer zijn. Die kunnen leerlingen uit eigen<br\> omgeving naar de toetsen in Wikiwijs Maken sturen. |
|
Tool |
Wikiwijs Maken LTI toetsen<br\> Een tool is een applicatie onderdeel die door een andere applicatie kan worden gebruikt.<br\> De Wikiwijs Maken toets afneem functionaliteit over LTI is zo’n tool. Deze levert<br\> namelijk toetsen die op Wikiwijs Maken gemaakt kunnen worden. |
|
Resource |
Wikiwijs Maken toets<br\> Een individuele oefening of toets die een gebruiker kan doen bij Wikiwijs Maken. |
|
Launch Request |
Wanneer een gebruiker van een ELO (als tool consumer) gebruik wil maken van een<br\> toets uit Wikiwijs Maken in de LTI vorm, dan stuurt de ELO een zogenaamde Launch<br\> Request naar Wikiwijs Maken (als tool provider). Wikiwijs Maken start dan de toets<br\> voor de gebruiker. |
|
Outcome of Result |
Toets score<br\> De Wikiwijs Maken LTI toets levert een resultaat in de vorm van een score. |
|
Outcome Management Service |
Resultaat teruggave service<br\> ELO’s die gebruik willen maken van de LTI toetsen moeten een Outcome Management<br\> Service aanbieden aan Wikiwijs Maken. Wikiwijs Maken geeft hieraan de toetsresultaten<br\> terug afkomstig van de toetsen die gebruikers van deze ELO via Launch Requests hebben<br\> gemaakt. |
Authorisatie voor gebruik van LTI koppeling
Voor het gebruik van de LTI toetsen van Wikiwijs Maken moet de afnemende ELO geautoriseerd zijn. Wil je gebruik maken van deze service, meld je dan aan bij info@wikiwijs.nl met het verzoek om een LTI koppeling aan te gaan. Zodra de aanvraag goedgekeurd wordt door Kennisnet worden de volgende aansluitgegevens teruggestuurd:
- Key
- Naam
- Secret
Authenticatie bij LTI werkt via OAuth 1, oauth.net bevat de specificatie en implementatie voorbeelden en libraries in verschillende talen.
- Specificatie OAuth 1 authenticatie: http://oauth.net/core/1.0/
- Bestaande code en libs: http://oauth.net/code/
LTI Launch Request
Een Wikiwijs LTI Launch URL kan er als volgt uitzien:
|
Lanceren van individuele toets of oefening |
http(s)://maken.wikiwijs.nl/lti/questionnaire/[toetsnummer]
|
|
Lanceren van een heel arrangement.<br\> Alleen resultaat van laatste toets of oefening uit arrangement wordt doorgegeven |
http(s)://maken.wikiwijs.nl/lti/arrangement/[arrangementnummer]
|
Een voorbeeld in de vorm van een HTML formulier voor het uitvoeren van een LTI basic launch request is hier te vinden: https://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-24 Echter, dit voorbeeld bevat meer data dan Wikiwijs Maken nodig heeft. De leerling details zijn niet nodig (en ook niet gewenst) in het bericht naar Wikiwijs Maken. Wikiwijs Maken heeft enkel de volgende parameters nodig in een LTI Basic Launch request:
| Type | Parameter | Betekenis |
|---|---|---|
|
OAuth authenticatie |
oauth_consumer_key |
Key verkregen van Kennisnet |
|
OAuth authenticatie |
oauth_signature_method |
|
|
OAuth authenticatie |
oauth_timestamp |
Datum tijd |
|
OAuth authenticatie |
oauth_nonce |
Tijdelijke sleutel, aangemaakt op basis van tijdstip en van Kennisnet verkregen Secret |
|
OAuth authenticatie |
oauth_version |
V1.0 |
|
LTI |
lti_version |
V1.0 |
|
LTI |
resource_link_id |
Unieke, anonieme ID van leerling |
LTI Outcome Service
Om met de LTI interfacing van Wikiwijs Maken te werken wordt vereist dat de ELO de Outcomes Management Service v1.0 implementeert. Aan deze resultaat teruggave service kan Wikiwijs Maken de behaalde score doorgeven van een leerling op het moment dat deze behaald is.
- Specificatie voor de outcome service v1: https://www.imsglobal.org/specs/ltiomv1p0/specification
- Specificatie Outcome service v1 berichten: https://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-17