Je kunt leeractiviteiten die je gemaakt hebt in jouw online academy, beschikbaar maken in een ander LMS. Daarnaast kun je leeractiviteiten uit een ander LMS beschikbaar maken in jouw online academy. Dit werkt via LTI, een standaard protocol voor het delen van leeractiviteiten tussen online leeromgevingen.
LTI neemt de gehele koppeling, inclusief het aanmaken van een gebruiker, inschrijven van de gebruiker en de Single sign-on voor zijn rekening. Ook is het mogelijk om de voortgang van activiteiten in jouw online academy door te geven aan het andere LMS en andersom.
Wij ondersteunen deze versies van LTI:
LTI 1.2
LTI 1.3
Als het andere LMS ook LTI 1.3 ondersteunt, dan raden we aan om dit te gebruiken. Dit protocol werkt stabieler dan LTI 1.2.
Let op!
Om gebruik te kunnen maken van LTI 1.3 moet de integraties functionaliteit wel aan staan in jouw omgeving. Heb je deze functionaliteit niet? Neem dan contact op met support of met je Customer Success Manager.
Wat wil je doen?
LTI werkt twee kanten op. De eerste mogelijkheid om een leeractiviteit uit Rakoo beschikbaar te maken in een ander LMS. Het andere LMS is hier de 'Content consumer'. Gebruikers worden vanuit het andere LMS aangemaakt en ingelogd in Rakoo. Daarnaast worden ze ingeschreven voor de leeractiviteit, en kunnen ze deze in Rakoo direct starten. Dit werkt zowel via LTI 1.2 als 1.3. Voor beide opties worden de stappen uitgelegd in dit artikel.
De tweede mogelijkheid is om een leeractiviteit uit een ander LMS beschikbaar te maken vanuit Rakoo. Het andere LMS is hier de 'Content provider'. Gebruikers worden in het andere LMS aangemaakt en ingelogd. Daarnaast worden ze gekoppeld aan de leeractiviteit, en kunnen de deze direct starten in het andere LMS. Dit werkt zowel via LTI 1.2 als 1.3. Voor beide opties worden de stappen uitgelegd in dit artikel.
Ik wil een leeractiviteit uit Rakoo beschikbaar maken in een ander LMS
Heb je een leeractiviteit in Rakoo staan die je ook graag in een ander LMS beschikbaar wil maken? Dat is mogelijk met LTI. Met LTI wordt de gebruiker vanuit het andere LMS direct ingelogd in Rakoo en kan die daar de leeractiviteit starten. Lees hieronder hoe je via LTI 1.2 of LTI 1.3 een leeractiviteit uit Rakoo beschikbaar maakt in een ander LMS.
Voor het opzetten van de koppeling moeten er verschillende gegevens worden uitgewisseld tussen Rakoo en het andere LMS. Voor deze velden in Rakoo gebruiken we de naamgeving die vrij standaard is in het LTI protocol. Het kan zijn dat een overeenkomstig veld in een ander LMS net een andere naam heeft. Mocht je hier met de beschikbare informatie niet uitkomen, neem dan contact op met support.
LTI 1.2
Ga naar 'Content' via het menu links in beeld.
Zoek de betreffende activiteit op. Deze leeractiviteit soorten kunnen gedeeld worden:
E-learning
Microlearning
Learning Playlist
Ga bij de betreffende leeractiviteit naar 'Delen'-tab.
Ga naar 'Delen via LTI' en zet de optie ‘Beschikbaar voor LTI’ aan.
Je ziet nu de benodigde gegevens voor het andere LMS:
LTI 1.2 Key
LTI 1.2 Secret
LTI 1.2 Launch URL
LTI 1.3
Om via LTI 1.3 leeractiviteiten te delen, volg je twee stappen. Eerst maak je een LTI 1.3 integratie aan in Rakoo via de integraties-pagina. Daarna maak je de betreffende leeractiviteit geschikt om via LTI 1.3 te delen.
Stap 1: Integratie aanmaken
Ga naar 'Integraties' via het menu links in beeld.
Kies bij 'Trainingaanbieder' voor 'LTI 1.3'.
Kies voor 'Content consumer toevoegen'.
Vul alle gevraagde velden in. De gegevens verkrijg je vanuit het andere LMS.
Naam veld in Rakoo | Uitleg | Ook wel bekend als |
Naam | Een herkenbare naam voor de koppeling, zodat je weet welk extern systeem dit is. Deze mag je zelf verzinnen. | - |
Tool deployment ID | Een unieke code die aangeeft welke koppeling wordt gebruikt tussen de twee systemen. | Ook wel 'Deployment ID' genoemd. |
Access token URL | Het webadres dat wordt gebruikt om tijdelijk toegang te krijgen tot het andere systeem. | Ook wel 'OAuth2 Access Token URL' genoemd. |
JWKS URL | Het webadres waar het systeem controleert of berichten veilig en betrouwbaar zijn. | Ook wel 'Public keyset URL' genoemd. |
OIDC URL | Het webadres dat wordt gebruikt om gebruikers veilig in te laten loggen via het andere systeem. | Ook wel 'Authentication request URL' genoemd. |
Issuer | De unieke identifier die aangeeft van welk systeem de LTI-launch afkomstig is. | Ook wel 'Platform ID' genoemd. |
Tool client ID | Een unieke identificatie van het andere systeem binnen deze koppeling. | Ook wel 'Application ID' genoemd. |
5. Zet de integratie op 'Geactiveerd'.
6. Sla de wijzigingen op.
7. De informatie die onder 'Gegevens voor de andere partij' staat, kan in de LTI integratie in het andere LMS toegevoegd worden.
Naam veld in Rakoo | Uitleg | Ook wel bekend als |
OIDC URL | Het webadres dat wordt gebruikt om gebruikers veilig in te laten loggen via het andere systeem. | Ook wel 'Initiate login URL' genoemd. |
JWKS URL | Het webadres waar het systeem controleert of berichten veilig en betrouwbaar zijn. | Ook wel 'Public keyset URL' genoemd. |
Redirect URI's | De webadressen van Rakoo waar een gebruiker na het inloggen automatisch naartoe wordt gestuurd. | Ook wel 'Redirection URI(s)' genoemd. |
Issuer | https://lti13.rakoo.com - De unieke identifier die aangeeft van welk systeem de LTI-launch afkomstig is. | Ook wel 'Platform ID' genoemd. |
Stap 2: Leeractiviteit geschikt maken om de kunnen delen via LTI 1.3
Ga naar 'Content' via het menu links in beeld.
Zoek de betreffende activiteit op. Deze leeractiviteit soorten kunnen gedeeld worden:
E-learning
Microlearning
Learning Playlist
Ga bij de betreffende leeractiviteit naar 'Delen'-tab.
Ga naar 'Delen via LTI' en zet de optie ‘Beschikbaar voor LTI’ aan.
Je ziet nu de 'LTI 1.3 Resource URL'. Je kunt deze URL gebruiken in het andere LMS om de training te ontsluiten.
LTI 1.3 deeplinking
Voor het beschikbaar maken van leeractiviteiten die gemaakt zijn in Rakoo, in een ander LMS, ondersteunen we het LTI 1.3 deeplinking protocol. Hiermee kunnen de gegevens van meerdere leeractiviteiten uit Rakoo, in één keer ingeladen worden in het andere LMS. Hiervoor volg je de volgende stappen:
Zorg dat de LTI 1.3 integratie is aangemaakt via de stappen hierboven.
Open in Rakoo de leeractiviteiten die je wil delen en zet via de delen-tab het schuifje bij 'Beschikbaar voor LTI' aan.
Zorg dat je in Rakoo een beheerdersaccount hebt met een rol die ten minste het recht 'Leeractiviteiten bekijken' heeft. Het e-mailadres dat aan dit beheerdersaccount gekoppeld is, moet overeenkomen met het e-mailadres waarmee je bent ingelogd als beheerder in het andere LMS.
Open in het andere LMS de deeplinking functionaliteit.
Je wordt doorgestuurd naar Rakoo en krijgt een venster te zien waarin je de leeractiviteiten kunt selecteren die je beschikbaar wil maken in het andere LMS.
De gegevens worden doorgestuurd naar het andere LMS. Gebruik deze gegevens om de leeractiviteiten in het andere LMS te ontsluiten.
Ik wil een leeractiviteit uit een ander LMS beschikbaar maken in Rakoo
Heb je een leeractiviteit in een ander LMS staan die je ook graag vanuit Rakoo beschikbaar wil maken? Dat is mogelijk met LTI. Met LTI wordt de gebruiker vanuit Rakoo direct ingelogd in het andere LMS. De gebruiker kan onmiddellijk met de leeractiviteit in het andere LMS starten. Lees hieronder hoe je via LTI 1.2 of LTI 1.3 een leeractiviteit vanuit een ander LMS beschikbaar maakt in Rakoo.
Voor het opzetten van de koppeling moeten er verschillende gegevens worden uitgewisseld tussen Rakoo en het andere LMS. Voor deze velden in Rakoo gebruiken we de naamgeving die vrij standaard is in het LTI protocol. Het kan zijn dat een overeenkomstig veld in een ander LMS net een andere naam heeft. Mocht je hier met de beschikbare informatie niet uitkomen, neem dan contact op met support.
LTI 1.2
Kies bij het aanmaken van een nieuwe e-learning voor LTI.
Vul de details van de leeractiviteit in, zoals titel, studietijd en beschrijving.
Kies bij de 'Instellingen' bij LTI voor LTI 1.2.
Vul bij de instellingen de LTI-gegevens in. Deze gegevens moet je opvragen bij het andere LMS.
Key
Secret
Launch-URL
Resource-link: vul hier iets in, dit veld mag niet leeg zijn. Het maakt niet uit wat je invult.
Optioneel kun je extra parameters toevoegen (zie LTI parameters)
LTI score: bepaal hier hoe de score die wordt teruggegeven vanuit het andere LMS voor deze LTI leeractiviteit in Rakoo moet worden geïnterpreteerd. Wanneer je kiest voor voortgang wordt de score die ontvangen wordt getoond als voortgang. Wanneer je kiest voor eindscore dan wordt de score geïnterpreteerd als afrondingsscore. Dit betekent dat in Rakoo de registratie afgerond wordt zodra we iets van score doorkrijgen vanuit het andere LMS.
Sla de wijzigingen op.
LTI 1.3
Om via LTI 1.3 leeractiviteiten te delen, volg je twee stappen. Eerst maak je een LTI 1.3 integratie aan in Rakoo via de integraties-pagina. Daarna maak je in Rakoo een leeractiviteit aan waaraan je de gegevens van de leeractiviteit uit het andere LMS toevoegt.
Stap 1: Integratie aanmaken
Ga naar 'Integraties' via het menu links in beeld.
Kies bij 'Trainingaanbieder' voor 'LTI 1.3'.
Kies voor 'Content provider toevoegen'.
Vul alle gevraagde velden in. De gegevens verkrijg je vanuit het andere LMS.
Naam veld in Rakoo | Uitleg | Ook wel bekend als |
Naam | Een herkenbare naam voor de koppeling, zodat je weet welk extern systeem dit is. Deze mag je zelf verzinnen. | - |
OIDC URL | Het webadres dat wordt gebruikt om gebruikers veilig in te laten loggen via het andere systeem. | Ook wel 'Initiate login URL' genoemd. |
JWKS URL | Het webadres waar het systeem controleert of berichten veilig en betrouwbaar zijn. | Ook wel 'Public keyset URL' genoemd. |
Redirect URI's | De webadressen van het andere LMS waar een gebruiker na het inloggen automatisch naartoe wordt gestuurd. | Ook wel 'Redirection URI(s)' genoemd. |
5. Zet de integratie op 'Geactiveerd'.
6. Sla de wijzigingen op.
7. De informatie die onder 'Gegevens voor de andere partij' staat, kan in de LTI integratie in het andere LMS toegevoegd worden.
Naam veld in Rakoo | Uitleg | Ook wel bekend als |
Tool client ID | Een unieke identificatie van het andere systeem binnen deze koppeling. | Ook wel 'Application ID' genoemd. |
Tool deployment ID | Een unieke code die aangeeft welke koppeling wordt gebruikt tussen de twee systemen. | Ook wel 'Deployment ID' genoemd. |
Issuer | De unieke identifier die aangeeft van welk systeem de LTI-launch afkomstig is. | Ook wel 'Platform ID' genoemd. |
OIDC URL | Het webadres dat wordt gebruikt om gebruikers veilig in te laten loggen via het andere systeem. | Ook wel 'Authentication request URL' genoemd. |
Access Token URL | Het webadres dat wordt gebruikt om tijdelijk toegang te krijgen tot het andere systeem. | Ook wel 'OAuth2 Access Token URL' genoemd. |
JWKS URL | Het webadres waar het systeem controleert of berichten veilig en betrouwbaar zijn. | Ook wel 'Public keyset URL' genoemd. |
Stap 2: Leeractiviteit aanmaken in Rakoo
Kies bij het aanmaken van een nieuwe e-learning voor LTI.
Vul de details van de leeractiviteit in, zoals titel, studietijd en beschrijving.
Kies bij de 'Instellingen' bij LTI voor LTI 1.3.
Vul bij de instellingen de LTI-gegevens in. Deze gegevens moet je opvragen bij het andere LMS.
Selecteer de 'Tool' die je hebt aangemaakt in de stappen hiervoor.
Vul de Resource URL in.
Optioneel kun je extra parameters invullen (zie LTI parameters).
Sla de wijzigingen op.
LTI-examen
In Rakoo kan een externe e-learning via LTI beschikbaar gemaakt worden, daarnaast is het ook mogelijk om een externe activiteit als examen toe te voegen in Rakoo. Volg hiervoor onderstaande stappen.
Kies bij het aanmaken van een nieuwe leeractiviteit voor 'Examen' en vervolgens voor 'LTI'.
Volg de stappen zoals hierboven uitgelegd om een externe activiteit beschikbaar te maken vanuit Rakoo.
Stel bij de instellingen van de leeractiviteit een minimale score in. Deze moet liggen tussen 1 en 100.
Het resultaat van de leeractiviteit wordt in Rakoo weergegeven als 'gezakt' of 'geslaagd', in tegenstelling tot 'afgerond' bij een e-learning.
LTI parameters
Het is belangrijk dat het andere LMS een aantal gegevens meestuurt via de LTI-koppeling. Deze zijn nodig om de gebruiker succesvol gebruik te kunnen laten maken van de leeractiviteiten. Bij de meeste LTI-koppelingen met andere systemen staat dit standaard goed ingesteld. Zo hoef je bij systemen zoals bijvoorbeeld Moodle niks aan te passen; de juiste gegevens worden hier meegestuurd.
Werk je met een custom LTI-koppeling? Dan is het belangrijk om te controleren of de onderstaande gegevens (parameters) op de juiste manier worden meegestuurd.
Naam veld | LTI parameter key | Verplicht? | Gebruikt voor |
lis_person_contact_email_primary | Ja | Vinden van een bestaande gebruiker of het aanmaken van een nieuwe gebruiker. | |
First name | lis_person_name_given | Ja | Het aanmaken van een nieuwe gebruiker wanneer deze nog niet bestaat. |
Last name | lis_person_name_family | Ja | Het aanmaken van een nieuwe gebruiker wanneer deze nog niet bestaat. |
User id | user_id | Ja | Het aanmaken van een nieuwe gebruiker wanneer deze nog niet bestaat. Hiervoor wordt het externe ID als ID in jouw online academy aangemaakt. |
Bij het toevoegen van een custom parameter, vul je altijd een key en value in. Bij het toevoegen van een custom parameter, kun je ervoor kiezen om beide velden zelf in te vullen. Of ervoor te kiezen dat de key een zelf ingevulde waarde is, en de value altijd een variabele waarde die uit de academy komt. De key komt hier overeen met hoe deze parameter in het andere LMS heet, de value die hiervoor wordt meegestuurd kun je zelf selecteren. Als je hier voor de value 'afdeling' kiest, wordt voor deze parameter altijd de afdeling van de gebruiker meegestuurd naar het andere LMS.
Voorbeeld
Via de Resource URL (LTI 1.3) of Launch URL (LTI 1.2) geef je op welke specifieke training uit het andere LMS gekoppeld wordt. Sommige leeromgevingen gebruiken hiervoor een generieke URL en regelen de verwijzing naar de specifieke activiteit via parameters. Deze zul je dan ook in Rakoo toe moeten voegen. Bijvoorbeeld key = courseid, value = specifieke id.