Tijdens de vorige stimuleringsregeling in 2019 hebben een aantal instellingen, in samenwerking met CACI, een OOAPI v3 endpoint gerealiseerd. Hieronder vindt je een samenvatting van de relevante documentatie.
De Osiris applicatie wordt door meerdere opleidings instituten gebruikt en is in de loop van het traject door Caci voorzien van een endpoint, die op zichzelf volledig aansluit op de OOAPI specificatie. De Osiris oplossing van de TUe kan hiermee in feite ook direct aangesloten worden op de OOAPI gateway van Surf.
|
High level beschrijving van de high level componenten:
Voor resource institution dienen de parameters in onderstaande tabel ingevoerd te worden. In Osiris zijn ze te vinden in Scherm 3.8.03 onder Rubriek OOAPI vanaf OSIRIS release 19.44.
Ze zijn allemaal nodig voor de SurfPortal behalve "AcademicCalendar – Year/ URL".
Veld | Toelichting OSIRIS |
InstitutionId | Een unieke id van de institution. Wordt nergens voor gebruikt, daarom gelijk gehouden met de brincode |
Brin | De brincode van de instelling, ligt al vast in ost_brincode met muterende_instelling = ‘J’ |
Name (verplicht) | De naam van de instelling, opgegeven via een configuratieparameter (OOAPI/INSTITUTION-NAME) |
Description (verplicht) | De beschrijving van de instelling, opgegeven via een configuratieparameter (OOAPI/INSTITUTION-DESCRIPTION) |
AcademicCalendar – Year/ URL | Het collegejaar en URL waarvoor de link naar de academische kalender opgenomen is. Opgehaald via configuratieparameters OOAPI/INSTITUTION-CALENDAR-YEAR en OOAPI/INSTITUTION-CALENDAR-URL |
Address | Het adres van de instelling, opgegeven in 5 configuratieparameters: - OOAPI/INSTITUTION-ADDRESS-STREET - OOAPI/INSTITUTION-ADDRESS-ADDITION - OOAPI/INSTITUTION-ADDRESS-CITY - OOAPI/INSTITUTION-ADDRESS-ZIP - OOAPI/INSTITUTION-ADDRESS-COUNTRY Let op: Indien een adres opgegeven is dan zijn alle velden (muv ADDITION) verplicht. Het object address zal alleen opgenomen worden als de vier verplichte velden ingevuld zijn bij de configuratieparameters. |
Logo | De url naar een logo van de instelling opgehaald via configuratieparameter OOAPI/URL-LOGO-INSTELLING. |
Daarnaast zijn er nog een aantal parameters die de mapping aansturen. Deze zijn bij oplevering ingesteld door Caci.
De architectuur regels van de TUe laten een directe koppeling naar een externe partij als SURF met de Osiris omgeving van de TUe niet toe. Alle externe afnemers en leveranciers van gegevens dienen aan te sluiten op de middleware oplossing van de TUe (Microsoft BizTalk met WCF koppelingen). Meer informatie over die koppeling is hier te vinden: https://github.com/InformationServicesDevTue/TUe-OOAPI
Wil je meer informatie dan hierboven te vinden is? Neem dan contact met ons op, we overleggen dan met de TU/e of UU of we de volledige documentatie mogen doorspelen.