In dit artikel lees je terug hoe je informatie naar uSis stuurt, en hoe je in TEC kunt zien wat er dan gebeurt.
Op dit moment staat de koppeling slechts op de acceptatie-omgeving, nog niet op productie. Onderstaande beschrijft hoe het zal moeten gaan werken. Wanneer de koppeling op productie staat, pas ik de uitleg aan met de juiste knop-namen e.d.
De koppeling tussen TEC en uSis
Er bestaat een koppeling tussen TEC en uSis. Wanneer een vakproces is afgerond, staat de vakinformatie klaar om doorgezet te worden naar uSis. Dit doorzetten gaat vooralsnog niet vanzelf. Je moet TEC opdracht geven de informatie door te sturen.
Doorzetten van losse vakken
Je kunt een enkel vak doorzetten naar uSis. Dit kun je doen door in het vak naar Beheer - Beheer te gaan. Helemaal onderaan de pagina in de linkerhoek heb je de knoppen 'Exporteer' en '</> Hook uitvoeren'. Kies bij 'Exporteer' voor 'USIS'. Of klik op '</> Hook uitvoeren' en kies 'Publish module to uSis Acceptance'.
Wanneer je het vak doorzet, krijg je een pop-up.
De pop-up die je krijgt wanneer je voor '/> Hook uitvoeren' hebt gekozen, geeft alleen aan of de actie succesvol is geweest.
Heb je voor 'Exporteer' gekozen, dan geeft de pop-up een link naar het exportbericht.
Het exportbericht
Nadat je een vak hebt doorgezet, gaat er een bericht vanuit TEC naar inQdo. inQdo maakt er een bericht voor uSis van en biedt dat aan. Gaat het om een nieuw vak en gaat het aanbieden goed, dan komt er vanuit uSis het 'studiedeel-ID van Y' terug naar TEC. Ieder vak, iedere werkvorm en iedere toetsvorm krijgt een eigen studiedeel-ID.
FB-SOZ kan alle verzonden bericht terugzien via Administratie - Request-log en Administratie - Exports.
In het bericht zie je de volgende dingen:
1. De naam van het bericht: het bericht dat eindigt op /event, is het een bericht aan inQdo. Een bericht met de naam /api/import/v*/*** is een retourbericht.
2. Het is een PUT, POST of DELETE
3. In de Request body staat het hele bericht dat naar inQdo is verzonden. JSON is het beste leesbaar.
4. Response status is nu (22-04-2025) altijd 200 (success). TE is nog bezig dit kloppend te krijgen.
5. In de Response body staat het retourbericht van inQdo.
Doorzetten vanuit een vakkenoverzicht
Wanneer je in het vakkenoverzicht zit om te checken of alles allemaal wel (correct) is ingevuld, kun je meerdere vakken tegelijkertijd doorzetten naar uSis. Dit doe je als volgt: klik op 1 of meerdere vakken om ze te selecteren, klik vervolgens op </> Hook uitvoeren, en kies voor 'Publish module to uSis Acceptance'. Je krijgt dan een bericht of het doorzetten succesvol is geweest. In dit bericht zit geen link naar de exportbestanden.
Doorzetten in bulk aan het einde van een proces
De vakken die in Goedgekeurd staan, zijn klaar om doorgezet te worden naar uSis. Selecteer de vakken die je wilt doorzetten, klik op </> Hook uitvoeren, kies voor 'Publish module to uSis Acceptance. Ook hier krijg je dan een bericht of het doorzetten succesvol is geweest. In dit bericht zit geen link naar de exportbestanden.
We gaan nog iets bouwen met een extra status, zodat het makkelijk bijhouden is welke vakken je wel of niet hebt doorgezet.