Deze pagina's beschrijven de mogelijkheid om een onderwijs applicatie te koppelen met de Edubadges backend. Omdat de meest voor de hand liggende toepassing het koppelen van de instellings-SIS is, noemen we dit de Edubadges SIS-koppeling, maar deze techniek is in principe ook toepassbaar voor andere onderwijsapplicaties die via een REST API koppelen met de API van Edubadges.
Deze Edubadges SIS-koppeling is nog werk in uitvoering en op dit moment wordt alleen de eerste usecase tbv het uitgeven van Edubadges (zie hieronder) gesupport.
Algemene Usecases
- SIS-koppeling tbv het uitgeven van edubadges.
Instellingen willen edubadges uitgeven vanuit de SIS. Wanneer een leerling een bepaald vak/module/leereenheid heeft afgerond, dan kan vanuit de SIS aangegeven worden dat hiervoor een edubadge, vanuit een gekoppelde badgeclass, kan worden uitgereikt via de Direct Award optie. Vooralsnog zijn zowel het koppelen van een badgeclass aan een vak/module/leereenheid, alsmede het aangeven welke leerlingen een edubadge moeten krijgen, handmatige acties die vanuit de SIS kunnen worden uitgevoerd.
→ Dit is de belangrijkste usecase waarmee in de MVP zal worden begonnen. - SIS-koppeling tbv het aanmaken van badgeclasses.
Instellingen willen badgeclasses kunnen aanmaken waarbij de badgeclass metadata aangeleverd wordt vanuit de SIS of vanuit een ander instellingsbronsysteem.
→ Dit is meer iets voor later. Eventueel in combinatie met een bulk-aanmaak functie van badgeclasses.
→ Deze usecase wordt verder uitgewerkt op: API definitie voor badgeclasses - Lerenden kunnen in SIS zien welke edubadges behaald zijn.
Instellingen hebben aangegeven dat lerenden de SIS gebruiken om hun voortgang te kunnen inzien. Het is wenselijk dat de status van behaalde edubadges hierin is meegenomen.
Dit vereist feitelijk een terugkoppeling vanuit het Edubadges platform naar de SIS voor wat betreft de geclaimde edubadges die vanuit de SIS zijn uitgereikt.
→ Dit is ook meer iets voor later.
Uitwerking usecase 1 (MVP):
- Vanuit de SIS wil ik de mogelijkheid hebben om aan een vak/module/cursus/leereenheid een edubadges badgeclass te kunnen koppelen.
In eerste instantie is het prima dat ik hier een badgeclass-ID of de URL naar de badgeclass handmatig kan invoeren.
In een latere fase zou aan de SIS-interface een zoek- en select functie toegevoegd kunnen worden die mij de badgeclasses laat zien die ik zou kunnen koppelen.
Wanneer een badgeclass al eerder met een ander vak/module/cursus/leereenheid is gekoppeld, dan krijg ik daar een melding van. Ik kan dan zelf bepalen of ik de koppeling wil vastleggen of niet. - Vanuit de SIS wil ik de mogelijkheid hebben om van een aan een badgeclass gekoppelde vak/module/cursus/leereenheid aan te kunnen geven welke lerenden een edubadge moeten krijgen.
Hierbij kan ik een selectie maken (individueel of select all) van de lerenden waardoor, na een druk op de knop 'Reik edubadge' uit, deze vanuit het edubadges platform worden uitgegeven aan de geselecteerde lerenden.
Ik krijg direct feedback over de (technische) status van de verwerking door het edubadges platform: Succes: #, Failed: #.
In een latere fase zou ik hier ook functieonele status informatie willen zien. - Achteraf kan ik in de SIS zien wat de status is geweest van een eerder gedane uitreiking. Dit status overzicht laat me zien hoeveel er succesvol zijn verwerkt en of er iets mis is gegaan.
In dit status overzicht vind ik ook een URL terug die mij naar de betreffende DA-bundle van het issuerportal van edubadges brengt. Hierbij dien ik apart in te loggen op het edubadges platform.