Face Up integreren in Moodle is geen ingewikkelde klus. Het is een kwestie van de externe tool één keer op siteniveau registreren en daarna per cursus een paar keer klikken. De moeilijkheid is nooit technisch: het probleem is dat beide platforms verschillende termen gebruiken voor dezelfde zaken, waardoor een verkeerd geplaatste ID kan leiden tot een leeg scherm zonder foutmelding.
Deze handleiding beschrijft het volledige proces in de juiste volgorde. Face Up registreren als LTI 1.3-tool op siteniveau, de inloggegevens uitwisselen tussen beide platforms, de activiteit toevoegen aan een cursus, het scenario kiezen via Deep Linking, controleren of de kolom in het cijferoverzicht verschijnt en vervolgens testen in de leerlingweergave. Het laatste deel behandelt de drie meest voorkomende fouten.
Het algemene principe en de gebruikte LTI-services worden uitgelegd in de integratiehandleiding van Face Up voor een LMS. Hier gaan we direct aan de slag in de interface.
Het registreren van een externe tool gebeurt op siteniveau, niet op cursusniveau. U heeft dus een Moodle-beheerdersaccount nodig, of iemand die daarover beschikt. Dit is het enige struikelblok in het proces: al het overige kan worden gedaan door een trainer met de rol van docent in de betreffende cursus.
Controleer dit als eerste. Bij organisaties waar Moodle wordt beheerd door een externe partij, verloopt de toegang voor beheerders via een dienstverlener, en die wachttijd is de enige factor die echt meetelt in de planning.
De uitwisseling werkt in twee richtingen. Face Up verstrekt u drie adressen: de URL voor het starten van de tool, de URL voor het initialiseren van de verbinding en de URL voor de publieke sleutelset. Moodle geeft u vervolgens zijn eigen inloggegevens, die u invoert aan de kant van Face Up.
Bereid ook het antwoord voor op een vraag over het interne beleid: welke identiteitsgegevens deelt het LMS met de tool? De naam en het e-mailadres van de leerling zijn nuttig voor het bijhouden van resultaten in het cijferoverzicht. Deze beslissing moet vooraf worden genomen, niet pas tijdens de configuratie.
Moodle noemt een LTI-tool een "externe tool". Een registratie op siteniveau die in alle cursussen herbruikbaar is, noemt Moodle een "vooraf geconfigureerde tool". En de manier waarop de activiteit wordt weergegeven – in de pagina zelf of in een nieuw venster – noemt Moodle een "startcontainer".
Deze laatste instelling is belangrijker dan het lijkt. Om ervoor te zorgen dat de leerling in zijn LMS blijft en niet opnieuw hoeft in te loggen, moet de simulatie geïntegreerd in de pagina worden geopend via een iframe. Dit is hetzelfde principe als beschreven voor iframe-integratie bij Genially.
Ga naar het sitebeheer, sectie plugins, activiteitsmodules, externe tool, tools beheren. Dit is het scherm waar de reeds aangemelde tools worden vermeld en waar u er een kunt toevoegen.
Kies voor handmatige configuratie in plaats van toevoegen via URL. Automatisch toevoegen werkt, maar bij handmatige invoer loopt u elk veld na, wat precies is wat u de eerste keer wilt doen.
Geef de tool een duidelijke naam — de naam die docenten in de lijst zullen zien. Selecteer LTI 1.3 als versie. Vul vervolgens de tool-URL, de URL voor het starten van de verbinding en de omleidings-URI in met de waarden die door Face Up zijn verstrekt. Kies voor de publieke sleutel de modus via URL van de sleutelset en plak het bijbehorende adres: dit is de aanbevolen methode, omdat hiermee sleutels kunnen worden geroteerd zonder dat u opnieuw hoeft in te grijpen.
Let op een detail dat tijd kan kosten: de URL's moeten exact worden overgenomen, zonder extra spaties aan het einde van de reeks door kopiëren en plakken, en met strikte inachtneming van de aanwezigheid of afwezigheid van een afsluitende slash.
Drie instellingen bepalen het verdere verloop. Vink de ondersteuning voor Deep Linking aan, anders kan de docent zijn scenario niet vanuit de cursus kiezen. Activeer de service voor opdrachten en cijfers (AGS), anders wordt er geen kolom aangemaakt in het cijferboek. Activeer tot slot de service voor het verstrekken van namen en rollen (NRPS) als u wilt dat de cursisten bekend zijn in de tool.
Stel ook het delen van identiteitsgegevens in volgens de eerder genomen beslissing. Deze drie services maken het verschil tussen een simpele link en een echte integratie; hun respectievelijke rol wordt gedetailleerd in onze uitleg over LTI 1.3.
Zodra de tool is geregistreerd, genereert Moodle eigen identificatiegegevens en toont deze in een detailoverzicht dat toegankelijk is vanuit de lijst met tools. Hier vindt u de platform-ID, client-ID, implementatie-ID, evenals de adressen van de publieke sleutelset, het toegangstoken en het authenticatieverzoek.
Deze zes waarden moeten aan de kant van Face Up worden ingevoerd. Dit is de meest mechanische handeling van het proces en de stap waar de meeste fouten worden gemaakt: voer ze één voor één in en controleer elke plakactie, in plaats van ze uit het hoofd in te vullen.
De koppeling is correct wanneer een testlancering leidt naar een Face Up-pagina en niet naar een foutmelding. Zoek niet naar een testknop in Moodle: de echte test is het toevoegen van de activiteit aan een cursus in de volgende stap.
Als u deze stap veilig wilt doorlopen, doe dit dan eerst in een zandbakcursus met slechts één testaccount ingeschreven. Dit is wat H3 Campus heeft gedaan, wiens Moodle-integratie werd uitgevoerd met integrator eLearning Touch', die de nieuwe versie van hun platform heeft gerealiseerd.
Schakel in de cursus de bewerkingsmodus in en voeg in de gewenste sectie een activiteit van het type extern hulpmiddel toe. Selecteer in het veld voor het vooraf geconfigureerde hulpmiddel de Face Up-tool die u zojuist heeft aangemaakt: deze verschijnt in de lijst zonder dat u opnieuw een URL hoeft in te voeren.
Geef de activiteit een naam die duidelijk is voor de cursist. "Rollenspel — ontevreden klant" is nuttiger dan "Face Up". Deze naam wordt ook gebruikt voor de kolom in het cijferoverzicht.
Dit is het prettige deel van het proces. De knop voor inhoudselectie opent de Face Up-catalogus in een venster, direct vanuit Moodle. De trainer kiest het scenario, bevestigt, en Moodle haalt automatisch het adres en de bijbehorende parameters op.
Geen links om aan te vragen, geen bestanden om te importeren, geen tickets om te openen. Deze autonomie maakt het verschil in het dagelijks gebruik, en we leggen de werking ervan in detail uit in uw scenario kiezen vanuit het LMS.
Controleer in de sectie voor cijfers of het cijfertype numeriek is en of het maximale cijfer overeenkomt met de score op 100 die door Face Up wordt doorgegeven. Als het maximale cijfer op nul blijft staan, wordt er geen regel aangemaakt in het cijferoverzicht: dit is de meest voorkomende oorzaak van problemen.
Stel tot slot de container voor het starten in op een weergave in de pagina zelf, zodat het rollenspel in een iframe opent en de cursist in Moodle blijft. Voeg indien gewenst een voorwaarde voor voltooiing toe, wat handig is voor trajecten waarbij de afronding moet worden aangetoond.
Open het cijferoverzicht van de cursus in de configuratieweergave. Er moet een regel met de naam van de activiteit staan, zelfs als er nog geen cursist heeft deelgenomen. De aanwezigheid hiervan bewijst dat de cijferregel correct is aangemaakt door de AGS-service.
Als u meerdere cijferregels voor dezelfde activiteit heeft geconfigureerd, controleer dan of ze allemaal verschijnen. Deze opsplitsing per dimensie maakt de voortgang inzichtelijk, zoals we uitleggen in AGS en het doorgeven van cijfers voor soft skills.
Gebruik de functie 'rol aannemen als cursist', of beter nog, een echt testaccount dat is ingeschreven voor de cursus. De rol aannemen is voldoende om de weergave te controleren, maar kan soms misleidende resultaten geven bij het doorgeven van cijfers: een echt testaccount neemt alle twijfel weg.
De controle omvat vier punten: het rollenspel opent in de pagina zonder opnieuw om inloggegevens te vragen, het gesprek start, de debriefing verschijnt aan het einde en de score verschijnt binnen enkele ogenblikken in het cijferoverzicht.
Vanuit zijn perspectief is er niets veranderd. Hij klikt op een activiteit in zijn cursus, net zoals hij bij een opdracht zou doen, en de simulatie start direct in de pagina. Hij hoeft geen account aan te maken, geen app te installeren en geen extra tabbladen te beheren.
Deze naadloze ervaring is niet slechts cosmetisch: elke onderbreking in het traject kost deelnemers. Dit is een van de punten waarop een LMS alleen zijn beperkingen toont wat betreft soft skills, zoals we toelichten in waarom een LMS alleen niet volstaat.
In negen van de tien gevallen is de URL verkeerd overgenomen. Controleer de start-URL, de URL voor het initialiseren van de verbinding en de omleidings-URI, en vergelijk ze teken voor teken met de verstrekte waarden: een onbedoelde spatie aan het einde van de reeks, een extra of ontbrekende slash, of het adres van een testomgeving dat per ongeluk is gebruikt in plaats van de productieomgeving.
Controleer ook of u daadwerkelijk LTI 1.3 gebruikt en niet een oudere versie: beide worden op een andere manier geconfigureerd en een gemengde configuratie zal stilletjes falen.
LTI 1.3 ondertekent berichten en voorziet ze van een tijdstempel. Als de klok van de Moodle-server meer dan enkele minuten afwijkt, wordt de handtekening als verlopen of nog niet geldig beschouwd, en mislukt het opstarten met een melding over een ongeldig token.
De oplossing is eenvoudig: laat uw infrastructuurteam de tijdsynchronisatie van de server controleren. Dit symptoom is verwarrend omdat het optreedt bij een verder perfecte configuratie, en vaak ook nog eens onregelmatig.
Er zijn drie mogelijke oorzaken, die u in deze volgorde moet onderzoeken. De AGS-service is niet geactiveerd bij de configuratie van de tool: open de instellingen opnieuw en vink deze aan. Het cijfertype van de activiteit staat op 'geen cijfer', of het maximale cijfer staat op nul: pas dit aan in de activiteitsinstellingen. Tot slot: er heeft nog geen enkele cursist een sessie afgerond; de regel bestaat dan wel, maar is leeg, en dat is normaal.
Als de regel bestaat en leeg blijft terwijl er wel een sessie is doorlopen, ligt het probleem bij de gegevensdoorgifte en niet bij de Moodle-configuratie: dit is het moment om contact op te nemen met de supportafdeling in plaats van de instellingen te blijven wijzigen.
Het proces bestaat uit vier stappen: de tool eenmalig op siteniveau configureren, de inloggegevens uitwisselen, de activiteit toevoegen en het scenario kiezen via Deep Linking, het cijferoverzicht controleren en testen in de cursistweergave. Eerlijk gezegd gaat de meeste tijd zitten in het verkrijgen van beheerdersrechten, niet in de configuratie zelf.
Twee instellingen verdienen extra aandacht omdat ze de meeste problemen veroorzaken: de overgenomen URL's en het maximale cijfer van de activiteit. Controleer deze twee punten voordat u om hulp vraagt; hiermee lost u de meeste gevallen op.
Zodra de tool is geconfigureerd, is het toevoegen van een simulatie aan een nieuwe cursus voor een docent een kwestie van twee minuten, zonder technische tussenkomst. Dit maakt het systeem schaalbaar voor een hele instelling, en dat is precies hoe H3 Campus en de CCI's het gebruiken, zoals beschreven in onze Moodle-klantcase. Voor het andere veelgebruikte platform, zie de Rise Up-integratie.
