LTI 1.3 | Leveranciers aansluiten & e-learning modules aanmaken

LTI 1.3-modules aanbieden in het Leerplatform

Met LTI 1.3 bied je e-learning van een externe leverancier rechtstreeks aan in het Leerplatform. Je medewerkers starten de module vanuit de catalogus, zonder apart in te loggen bij de leverancier. Het resultaat komt automatisch terug in het Leerplatform. In dit artikel lees je hoe je een leverancier aansluit en daarna modules van die leverancier aanmaakt en publiceert.

Voordat je begint

Je bent beheerder in het Leerplatform. Je vindt de functionaliteit via Beheer > E-learning > LTI 1.3.
Je hebt contact met de leverancier van de e-learning. De leverancier moet de koppeling aan zijn kant ook inrichten.
Wil je dat resultaten (zoals afgerond of een score) automatisch in het Leerplatform komen? Vraag dan aan de leverancier of hij resultaten via LTI 1.3 terugstuurt. Doet de leverancier dat niet, dan kan de e-learning wel worden gestart, maar ziet het Leerplatform niet of iemand klaar is.
De leverancier ondersteunt LTI 1.3 (ook wel LTI Advantage genoemd). Gebruikt de leverancier nog LTI 1.1? Gebruik dan Beheer > E-learning > LTI 1.1.

Werkwijze in het kort

Houd altijd deze volgorde aan:

Leverancier aansluiten – je legt eenmalig de verbinding tussen het Leerplatform en de leverancier.
Module aanmaken – per e-learning maak je een module aan die gebruikmaakt van die aansluiting.
Module instellen en testen – je bepaalt hoe de module start en wanneer een medewerker voldaan heeft.
Module publiceren – de module komt in de catalogus en kan worden toegewezen.

Let op: zonder aansluiting kun je geen module aanmaken. Begin dus altijd met stap 1.

Stap 1: Leverancier aansluiten

Een aansluiting sluit je één keer per leverancier aan. Alle modules van die leverancier gebruiken daarna dezelfde aansluiting.

Keuzescherm Automatisch registreren of Handmatig invoeren

Ga naar Beheer > E-learning > LTI 1.3.

Klik rechtsboven op Leveranciers. Je kunt ook op de plusknop rechtsonder klikken en Leverancier kiezen.

Klik op Aansluiting toevoegen.
Kies hoe je de leverancier wilt aansluiten:

Automatisch registreren – als de leverancier een registratie-URL aanlevert. Dit is de snelste manier (zie 1A).
Handmatig invoeren – als je de gegevens zelf met de leverancier uitwisselt (zie 1B).

1A. Automatisch registreren

Bij automatisch registreren wisselen het Leerplatform en de leverancier de gegevens zelf uit.

Vraag de leverancier om de registratie-URL.
Plak deze URL in het veld Registratie-URL van de leverancier.
Klik op Registratie starten. De pagina van de leverancier opent in een nieuw venster.
Rond de registratie af in dat venster. Het Leerplatform wacht ondertussen op de leverancier.
Is de registratie gelukt? Dan verschijnt de melding Aansluiting opgeslagen en is de aansluiting volledig ingericht.

Tip: zie je de melding De browser heeft het venster geblokkeerd? Klik dan op Open de pagina van de leverancier, of sta pop-ups toe voor het Leerplatform.

1B. Handmatig invoeren

Bij handmatig invoeren kies je eerst waar de gegevens vandaan komen:

Leverancier selecteren – voor een bekende leverancier. Kies de leverancier in de lijst; de gegevens worden dan vooraf ingevuld.
Zelf invoeren – voor een leverancier die niet in de lijst staat. Vul de Naam van de leverancier in.

Vul daarna de gegevens in die je van de leverancier krijgt:

Veld	Toelichting
URL openbare sleutelset (JWKS)	Adres waar het Leerplatform de sleutels van de leverancier ophaalt.
Initieer login URL	Adres waar het starten van een module begint.
Tool URL / redirect URL	Standaardadres van de leverancier waar de module opent.
Deep linking URL	Optioneel. Hiermee kies je modules rechtstreeks uit het aanbod van de leverancier. Vul je dit niet in? Dan voer je de modules zelf in (zie stap 2).

Aansluiting handmatig toevoegen met Zelf invoeren

Klik op Opslaan.

Heb je nog niet alle URL's? Sla de aansluiting dan toch op. Deze krijgt de status nog niet ingericht. Je maakt de aansluiting later compleet via Aansluiting bewerken.

Gegevens doorgeven aan de leverancier

Na het opslaan toont het Leerplatform het scherm Gegevens voor de leverancier. Deze gegevens heeft de leverancier nodig om de aansluiting aan zijn kant in te richten:

Platform issuer
Client ID
Deployment ID
Authenticatie (OIDC auth) URL
Access token URL
URL sleutelset (JWKS) van het platform
OpenID-configuratie URL

Klik op Alles kopiëren en stuur de gegevens naar de leverancier. Je kunt ook per veld op het kopieer-icoon klikken.

Tip: je kunt dit scherm later altijd terugvinden. Klik op Leveranciers, klik bij de aansluiting op de drie puntjes en kies Gegevens voor de leverancier.

Aansluitingen beheren

Via de knop Leveranciers zie je alle aansluitingen van je portaal. Per aansluiting zie je:

de naam van de leverancier;
de Tool URL, of de status nog niet ingericht;
het aantal modules (koppelingen) dat de aansluiting gebruikt.

Via de drie puntjes kies je Aansluiting bewerken of Gegevens voor de leverancier.

Let op: een bekende leverancier uit de lijst sluit je één keer per portaal aan. Probeer je deze opnieuw toe te voegen? Dan krijg je een melding. Bewerk in dat geval de bestaande aansluiting.

Stap 2: Module aanmaken

Is de leverancier aangesloten? Dan maak je per e-learning een module aan.

Ga naar Beheer > E-learning > LTI 1.3.
Klik op de plusknop rechtsonder en kies E-learning module.

Plus-knop met keuze leverancier en e-learning module

Vul de Naam van de module in.
Kies bij Leverancier aansluiting de leverancier van deze module.
Klik op Aanmaken.

De module staat nu in de lijst LTI 1.3 Modules. Zie je de melding Dit portaal heeft nog geen aansluitingen? Voer dan eerst stap 1 uit. Je kunt vanuit dit venster ook direct een aansluiting toevoegen via het stekker-icoon.

Stap 3: Module instellen en testen

Klik in de lijst op de module om de instellingen te openen.

Algemeen

Veld	Toelichting
Naam	Verplicht. De naam die medewerkers zien.
Omschrijving	Optioneel. Korte toelichting op de module.
Opstart type	Hoe de module opent: In het huidige scherm (standaard) In een nieuw scherm/tabblad In een nieuw venster zonder browserknoppen Sommige leveranciers werken niet binnen het Leerplatform-scherm. Kies dan een nieuw scherm.

LTI 1.3 instellingen

Veld	Toelichting
Leverancier aansluiting	Verplicht. De aansluiting die deze module gebruikt.
Unieke Launch URL	Standaard gebruikt de module de Tool URL van de leverancier. Heeft deze module een eigen startadres? Zet de schakelaar dan aan en vul de Launch URL in. De leverancier geeft aan of dit nodig is.
Extra parameters	Extra gegevens die de leverancier bij elke start meekrijgt, bijvoorbeeld course_identifier = 587122CD. Vaak bepaalt de leverancier hiermee welke cursus opent. De leverancier geeft aan welke parameters nodig zijn.

Geavanceerde instellingen

Veld	Toelichting
Cesuur	De score (0–100) die een medewerker minimaal moet halen om te slagen. Laat je dit leeg? Dan kijkt het Leerplatform alleen of de medewerker de module heeft afgerond.
Maximaal aantal pogingen	Aantal pogingen waarna het resultaat definitief is. Werkt alleen in combinatie met een cesuur. Gebruik dit als de leverancier zelf geen herkansing kent.

Klik op Opslaan.

Hoe komt het resultaat in het Leerplatform?

Een medewerker maakt de e-learning bij de leverancier. Is de medewerker klaar? Dan stuurt de leverancier het resultaat terug naar het Leerplatform. Dat gaat vanzelf; de medewerker hoeft niets te doen.

Geen cesuur ingesteld: de module telt als afgerond zodra de leverancier laat weten dat de medewerker klaar is.
Wel een cesuur ingesteld: de medewerker heeft voldaan als de score gelijk is aan of hoger is dan de cesuur.

Let op: dit werkt alleen als de leverancier resultaten terugstuurt. Controleer dit vooraf bij de leverancier.

Testen

Klik op Afspelen om de module te testen. Opent de module correct bij de leverancier? Dan is de koppeling goed ingericht.

Let op: de knop Afspelen werkt pas als je de wijzigingen hebt opgeslagen.

Stap 4: Module publiceren

Werkt de module goed? Publiceer hem dan naar de catalogus.

Ga naar Beheer > E-learning > LTI 1.3.
Klik bij de module op de drie puntjes en kies Publiceren.
Bevestig met Publiceren.

Menu met publiceren, terugdraaien publicatie en afspelen

De module krijgt het label catalogus en staat in de catalogus. Vanaf nu kun je de module toewijzen aan medewerkers, net als andere catalogusitems.

Wil je de module uit de catalogus halen? Klik dan op de drie puntjes en kies Terugdraaien publicatie.

Veelgestelde vragen

De automatische registratie is verlopen of mislukt

De registratie moet binnen een bepaalde tijd worden afgerond. Klik op Opnieuw proberen. Krijg je de melding dat de leverancier een registratie stuurde die niet geaccepteerd kan worden? Neem dan contact op met de leverancier. De leverancier kan het probleem oplossen, daarna start je de registratie opnieuw.

Mijn leverancier staat niet in de lijst

Kies bij handmatig invoeren voor Zelf invoeren en vul de gegevens van de leverancier zelf in. Staat een leverancier niet meer in de lijst? Dan is deze waarschijnlijk al aangesloten op je portaal.

De module start niet

Controleer het volgende:

Staat de aansluiting niet meer op nog niet ingericht?
Heeft de leverancier de Gegevens voor de leverancier ontvangen en verwerkt?
Kloppen de Extra parameters en eventueel de Unieke Launch URL?
Opent de module in het huidige scherm? Probeer dan een ander Opstart type.

Er komt geen resultaat terug in het Leerplatform

Vraag de leverancier of hij resultaten via LTI 1.3 terugstuurt. Heb je een cesuur ingesteld? Controleer dan ook of de leverancier een score meestuurt.

Kan ik meerdere modules van dezelfde leverancier aanbieden?

Ja. Je sluit de leverancier één keer aan. Daarna maak je zoveel modules aan als je nodig hebt. Elke module gebruikt dezelfde aansluiting.

Kom je er niet uit? Neem dan contact op met de servicedesk van SDB.