Programska interakcija s Informacijskim sustavom evidencija u visokom obrazovanju (ISeVO) omogućena je nizom REST API resursa. Ti resursi grupirani su prema namjeni korištenja u API grupe na koje se mogu dobiti prava pristupa, a za pristup resursima potrebno je ispuniti zahtjev.
Modul Upravljanje resursima omogućuje unos zahtjeva za dodjelu API ključa za određenu API grupu, odobrenje i odbijanje zahtjeva, kao i pregled zahtjeva i dodijeljenih API ključeva. Pristup modulu imaju samo ovlašteni korisnici. Na vrhu prozora je maksimalno 5 tabova, u ovisnosti o ovlastima korisnika: Pregled neriješenih zahtjeva, Pregled zahtjeva, Pregled mojih zahtjeva, API ključevi, Moji API ključevi i API grupe.
Opis procesa
Modul je namijenjen visokim učilištima koji ne koriste ISVU te koriste REST API za upload podataka o završnim ispravama u Digitalni registar diploma. Za korištenje REST API-ja i dobivanje API ključa potrebno je formirati zahtjev, koji odobrava ili odbija MZOM.
Zahtjevi mogu imati 4 statusa: Podnesen, Storniran, Odobren i Odbijen. Statuse Podnesen i Storniran inicira korisnik na VU unosom ili storniranjem zahtjeva, a statuse Odobren i Odbijen inicira MZO_API_ADMIN odobravanjem ili odbijanjem zahtjeva.
Za početak korištenja modula Upravljanje resursima korisnik na VU treba imati ulogu ISEVO_KORISNIK, koja se automatski dobiva ulaskom u aplikaciju ISeVO uz AAI korisnički identitet. Korisnik na MZO treba imati ulogu MZO_API_ADMIN.
Postupak je sljedeći:
- Korisnik na VU prijavljuje se u ISeVO svojim AAI korisničkim identitetom.
- U modulu Upravljanje resursima, na tabu Pregled mojih zahtjeva, korisnik na VU unosi novi zahtjev (gumb Novi zahtjev), koji nakon unosa dobiva status Podnesen
- Kod unosa zahtjeva, potrebno je unijeti podatke o ustanovi, podatke o podnositelju zahtjeva te odabrati API grupe za koje podnosi zahtjev.
- Po podnošenju zahtjeva, generira se PDF datoteka koju je potrebno potpisati i poslati na e-mail adresu pisarnica@mzom.hr
- korisnik na VU može stornirati zahtjev na tabu Pregled mojih zahtjeva, prije nego je zahtjev odobren ili odbijen. (Odobravanje ili odbijanje zahtjeva radi korisnik s ulogom MZO_API_ADMIN.)
- Na Pregledu neriješenih zahtjeva, korisnik s ulogom MZO_API_ADMIN vidi zahtjeve u statusu Podnesen te odobrava ili odbija odgovarajući zahtjev.
- E-mail o odobravanju ili odbijanju zahtjeva automatski se šalje na e-mail naveden na zahtjevu u dijelu Podaci o podnositelju zahtjeva.
- Ako je zahtjev odobren, korisnik na VU, koji je podnio zahtjev, automatski dobiva ulogu API_POTROSAC.
- Na tabu Pregled mojih zahtjeva korisnik s ulogom API_POTROSAC vidi status svojih zahtjeva i klikom na gumb Detalji vidi detalje zahtjeva.
- Ako je zahtjev u statusu Odobren, korisnik s ulogom API_POTROSAC na ekranu Pregled detalja zahtjeva, klikom na gumb Detalji ključa, ulazi u detalje API ključa.
- Korisnik s ulogom API_POTROSAC klikom na gumb aktivira i deaktivira prikaz API ključa, a klikom na gumb kopira vrijednost API ključa.
Pregled neriješenih zahtjeva
Modul Pregled neriješenih zahtjeva vidljiv je za ulogu MZO_API_ADMIN, a nije vidljiv za ulogu API_POTROSAC.
Na Pregledu neriješenih zahtjeva, na osnovu naziva ili OIB ustanove može se dobiti lista neriješenih zahtjeva (zahtjeva u statusu Podnesen) sa sljedećim podacima:
datum zahtjeva, naziv ustanove, OIB ustanove, podnositelj zahtjeva.
Neriješene zahtjeve moguće je odobriti i odbiti.
Uz svaki zahtjev je gumb Detalji koji omogućava detaljni prikaz zahtjeva.
Na pregledu detalja zahtjeva može se preuzeti PDF zahtjeva (gumb Preuzmi PDF), odobriti (gumb Odobri zahtjev) i odbiti zahtjev (gumb Odbij zahtjev).
Pregled zahtjeva
Modul Pregled zahtjeva vidljiv je za ulogu MZO_API_ADMIN, a nije vidljiv za ulogu API_POTROSAC.
Na Pregledu zahtjeva postoji tražilica, koja omogućuje pretraživanje zahtjeva po nazivu i OIB-u ustanove, statusu zahtjeva, periodu kreiranja zahtjeva i periodu promjene statusa zahtjeva.
Uz svaki zahtjev je gumb Detalji koji omogućava detaljni prikaz zahtjeva.
Za zahtjeve u statusu Odobren, ulaskom u Detalje moguće je, uz ostalo, vidjeti i detalje API ključa.
Za zahtjeve u statusu Podnesen, ulaskom u Detalje moguće je, preuzeti PDF zahtjeva, odobriti i odbiti zahtjev.
Pregled mojih zahtjeva
Modul Pregled mojih zahtjeva vidljiv je za ulogu API_POTROSAC, a nije vidljiv za ulogu MZO_API_ADMIN.
Na Pregledu je omogućen unos novog zahtjeva, kao i pregled svih zahtjeva koje je korisnik podnio. Za unos novog zahtjeva korisniku na VU dovoljna je uloga ISEVO_KORISNIK. Ako MZOM odobri zahtjev, korisnik na VU automatski dobiva ulogu API_POTROSAC.
Klikom na gumb Novi zahtjev otvara se forma za unos novog zahtjeva.
Uz ostale obavezne podatke, obavezan je i unos svrhe pristupa, kao i e-mail adrese podnositelja zahtjeva jer će na njegovu adresu stići obavijest o tome da li je zahtjev odobren ili odbijen. Nužno je i unijeti API grupe za koje se traži pristup.
Nakon što su uneseni svi potrebni podaci, klikom na gumb Podnesi zahtjev, zahtjev se sprema i dobiva status Podnesen te postaje vidljiv korisnicima s ulogom MZO_API_ADMIN koja ga mogu odobriti ili odbiti. Prije odobravanja ili odbijanja zahtjeva, korisnik na VU (s ulogom ISEVO_KORISNIK ili API_POTROSAC) može stornirati zahtjev na ekranu Pregled mojih zahtjeva.
API ključevi
Modul API ključevi vidljiv je za ulogu MZO_API_ADMIN, a nije vidljiv za ulogu API_POTROSAC. Modul omogućava pregled API ključeva po kriterijima ustanove i statusa API ključeva (aktivan i neaktivan).
Ulaskom u Detalje pojedinog API ključa, dobiju se detaljni podaci o ključu te je omogućena deaktivacija ključa (gumb Deaktiviraj API ključ), dodavanje (gumb Dodaj nove API grupe) i uklanjanje API grupa (gumb Ukloni postojeće API grupe). Moguće je i unijeti ovlaštene osobe. Obavezna je minimalno jedna ovlaštena osoba za svaki API ključ. Na ovom ekranu se ovlaštene osobe mogu i deaktivirati.
Ukoliko nije unesena niti jedna ovlaštena osoba, prilikom ulaska u detalje API ključa, otvara se forma za unos ovlaštene osobe. Pregled detalja API ključ nije moguć ako nema niti jedne ovlaštene osobe.
Moji API ključevi
Modul Moji API ključevi vidljiv je za ulogu API_POTROSAC, a nije vidljiv za ulogu MZO_API_ADMIN. Modul omogućava pregled API ključeva za korisnika s ulogom API_POTROSAC.
API grupe
Modul API grupe omogućuje pregled grupa s opisom i listom resursa koje uključuje.