In dit artikel lees je terug hoe je informatie naar uSis stuurt, en hoe je in TEC kunt zien wat er dan gebeurt.
De koppeling tussen TEC en uSis
Er bestaat een koppeling tussen TEC en uSis. Wanneer een vakproces is afgerond, wordt de vakinformatie doorgezet naar uSis. Dit doorzetten gaat vanzelf. Wanneer een vak in een vakproces op de status Goedgekeurd (bij Nieuw vak) of Afgerond (alle andere vak-processen) terechtkomt, wordt de informatie automatisch naar uSis verstuurd.
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 'Export data to uSis via the inQdo layer'.
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.
Je pusht het vak door zonder controle. Als er informatie in het vak ontbreekt die de koppeling wel eist, lukt het pushen van het vak naar uSis niet.
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 'Export data to uSis via the inQdo layer'. Je krijgt dan een bericht of het doorzetten succesvol is geweest. In dit bericht zit geen link naar de exportbestanden.
Je pusht vakken door zonder controle. Als er informatie in een vak ontbreekt die de koppeling wel eist, lukt het pushen van dat vak naar uSis niet.
Doorzetten in bulk
Wanneer een vak een vakproces tot en met het einde heeft doorlopen, dan is het al doorgezet naar uSis. Mocht je toch een keer een aantal vakken opnieuw naar uSis willen sturen, dan kun je via het procesbeheer meerdere vakken tegelijkertijd pushen naar uSis.
Via procesbeheer kun je ieder vak in ieder vakproces terugvinden. Daarom kan dit doorzetten in bulk in elk van de 4 vakprocessen.
Selecteer de vakken die je naar uSis wil pushen. Vervolgens heb je 2 mogelijkheden.
1. Klik op Overnemen en kies voor Goedgekeurd/Afgerond. De vakken komen nu in die status. Zodra een vak in die status terecht komt wordt de vakinformatie naar uSis gepusht.
2. Klik op </>Hook uitvoeren en kies voor 'Export data to uSis via the inQdo layer'. De vakinformatie wordt nu naar uSis gepusht. Het verschil met de vorige optie is dat de vakken niet van status veranderen.
Je pusht vakken door zonder controle. Als er informatie in een vak ontbreekt die de koppeling wel eist, lukt het pushen van dat vak naar uSis niet.