Taustaa
Laki valtakunnallisista opinto- ja tutkintorekistereistä https://www.finlex.fi/fi/laki/alkup/2017/20170884 astui voimaan 1.1.2018. Lain mukaan ".....oppijanumero voidaan opetuksen tai koulutuksen järjestäjän taikka korkeakoulun pyynnöstä antaa oppilaalle tai opiskelijalle, joka on oppilaana tai opiskelijana 1 päivänä lokakuuta 2017 tai sen jälkeen. Oppijanumero voidaan rekisterinpitäjän pyynnöstä antaa myös henkilölle, jota koskevia tietoja on tallennettu 31 §:n 2 momentissa tarkoitettuun rekisteriin tai tietovarantoon ennen tämän lain voimaantuloa, ja jolla ei vielä ole oppijanumeroa." Opetushallitus on toteuttanut rajapinnan, jonka avulla opiskelijoiden tiedot voidaan tuoda opintohallintojärjestelmästä oppijanumerorekisteriin ja rajapinnan kautta oppilashallintojärjestelmään voidaan tallentaa oppijanumero ja muita henkilötietoja.
Pähkinänkuoressa:
- Jokaiselle oppijalle voidaan luoda Opetushallituksen Oppijanumerorekisterin tuottama oppijanumero.
- Oppijanumeron luomiseen on olemassa batch-muotoinen rajapinta jolla voi tuoda yhden tai useita oppijoita.
- Tuontirajapinnat ovat autentikoituja rest-rajapintoja.
- Oppilaitosjärjestelmä käyttää annettua palvelukäyttäjätunnusta tunnistautumiseen. Palvelukäyttäjätunnukseen liitetty organisaatio määrittää minkä organisaation oppijaksi tieto liitetään.
- Kun oppija on liitetty organisaatioon, oppijalle ruvetaan tuottamaan muutostietorajapinnasta muutostietoja, (esim nimi ja osoitemuutokset).
Alla olevassa kuvassa kuvataan koko prosessin tavoitetila, eli kaikki kuvassa kuvatut ominaisuudet eivät ole vielä käytössä. Kuvan alla kuvataan tarkemmin jo toteutettuja ja käytössä olevia ominaisuuksia ja lisäksi kerrotaan mitä on vielä suunnittelussa.
Rajapintaan toteutetut ominaisuudet
Oppijoiden tuonti
Kuvan kohta 1
- Hetullisia henkilöitä voi tuoda oppilashallintojärjestelmästä rest-rajapinnan yli batch-muotoisesti. Samaa rajapintaa käytetään alkulatauksessa (tuodaan isompi massa), kuin yksittäisten pienempien erien tuonnissa.
- Rajapinta:https://virkailija.testiopintopolku.fi/oppijanumerorekisteri-service/swagger-ui.html#!/oppija45controller/createUsingPUT
- Pakolliset tiedot
- Joku näistä: Hetu, passinnumero, oppijanumero tai oppijan hakemukselle annettu sähköpostiosoite.
- Näitä tietoja käytetään oppijan kohdistamiseen ONR kantaan
- Voi lähettää kaikki, käytetään luotetuinta tietoa.
- Oppilasjärjestelmän tunniste oppijalle
- Palautuvan vastausdatan kohdistamiseen, mihin oppijaan liittyy
- Palautuvan vastausdatan kohdistamiseen, mihin oppijaan liittyy
- etunimi
- hetuttomien ja ongelmatapausten selvittämiseen opintopolun päässä
- hetuttomien ja ongelmatapausten selvittämiseen opintopolun päässä
- sukunimi
- hetuttomien ja ongelmatapausten selvittämiseen opintopolun päässä
- hetuttomien ja ongelmatapausten selvittämiseen opintopolun päässä
- kutsumanimi
- Kutsumanimen on oltava yksi etunimistä.
- Kutsumanimen on oltava yksi etunimistä.
- sähköpostisoite
- Mihin voidaan lähettää batch-ajon lopputuloksen tieto.
- Joku näistä: Hetu, passinnumero, oppijanumero tai oppijan hakemukselle annettu sähköpostiosoite.
Kuvan kohta 2
- Kutsuva järjestelmä saa vastaukseksi batchId tunnisteen.
- Kutsuva järjestelmä voi kysellä tuloksia batchId rajapinnalla.
- Rajapinta: https://virkailija.testiopintopolku.fi/oppijanumerorekisteri-service/swagger-ui.html#!/oppija45controller/getOppijatByTuontiIdUsingGET
Kuvan kohta 3
- Palautetaan jokaiselle oppijariville:
- Mihin oppilaitosjärjestelmän tunnisteeseen henkilö liittyy
- Jos henkilö löytyy jo
- palautetaan henkilön oppijanumero ja tiedot.
- Muussa tapauksessa palautetaan luotu henkilöoid.
- Oppijoiden sisäänluku on asynkroninen, kun tila "kasitelty": true. Oppijat on luettu sisään ja pitäisi palautua henkilooid kaikille.
- Henkilöoid on "alustava oppijanumero". Henkilöoidista tulee oppijanumero kun oppija on merkitty yksilöilöidyksi.
- Tämän jälkeen jatketaan pollaamista muutosrajapinnan kautta (kohta 5). Jolloin tulee esimerkiksi VTJ-yksilöinnin tulos (joka on myös asynkroninen toiminto, voi kestää kauemmin).
ONR-muutostietorajapinta
Kuvan kohta 5
- ONR-muutostietorajapinta tarjoaa oppijaan kohdistuvia muutostietoja joita saadaan joko a) virkailijan tekemistä operaatioista b) VTJ:n muutos tai yksilöintitietojen perusteella.
- Esimerkkejä muutoksista:
- Oppijanumeron vahvistuminen. (Oppijan yksilöinti, esim onnistunut vtj yksilöinti)
- Nimen muutos
- Osoitteen muutos
- Oppijan linkitys toiseen oppijaan (kuka on masteri)
- Hetun muuttuminen
- Rajapinta: https://virkailija.testiopintopolku.fi/oppijanumerorekisteri-service/swagger-ui.html#!/oppija45controller/getMuuttuneetUsingGET
- Muutosrajapinta tarjoaa vastauksen aina organisaatiokohtaisesti:
- Listan joka sisältää oppijoiden oideja ja oidiin liittyvän masterin tiedot.
- ONR palauttaa aina myös kaikki slave oidit jotka liittyvät yhteen oppijaan omina tietoinaan. Eli muutoksen kohdistaminen onnistuu näin aina alkuperäisellä oidilla mikä on saatu oppijan tuonti vaiheessa.
- Jos "oppijanumero"-kenttä löytyy masterista niin kyseessä on vtj-yksilöity
- Masterin tiedoista voi päätellä esimerkiksi hetun vaihtumiset, mahdollisen oidi linkityksen, tai osoitemuutokset.
- Listan joka sisältää oppijoiden oideja ja oidiin liittyvän masterin tiedot.
Käyttöliittymällä suoritettavat toiminnot
Virkailija tarkastelee henkilötietojen siirron tilaa ja korjaa virheitä
Käyttöliittymässä voi tarkistaa tiedonsiirron edistymistä, siirrettyjen henkilöiden yksilöinnin tilaa ja mahdollisia virheitä. Jos oppijan tiedoissa on jokin muuttunut ja yksilöinti ei mene VTJ-rajapinnasta läpi, virkailija voi korjata tiedot. Tiedot pääsee korjaamaan klikkaamalla henkilön nimeä.
Ohje VTJ-yksilöitävien ongelmien ratkaisuun: VTJ-yksilöitävien ongelmien ratkaisu (tähän tulee ohje mahdollisimman pian)
Ohje hetuttomien henkilöiden linkitykseen ja yksilöintiin: Oppijan mahdolliset duplikaatit, henkilöiden linkitys ja yksilöinti
Tarvitaan virkailijan tai korkeakoulun sähköposti, jolla voi tilata hälytyksiä, kun virkailijalta tarvitaan toimenpiteitä.
Pääsy käyttöliittymään vaatii käyttöoikeusryhmän nimeltä Oppijoiden tuonti. Käyttöliittymä löytyy navigaatiosta kohdasta Käytönhallinta --> Oppijoiden tuonti.
Virkailija tallentaa hetuttomia henkilöitä käyttöliittymässä
- virkailija painaa nappia lisätäkseen uuden henkilön
- Virkailija syöttää tarvittavat tiedot
- pakollisia tietoja:
- Etunimet
- Kutsumanimi
- Sukunimi
- Syntymäaika
- Sukupuoli
- Äidinkieli
- Kansalaisuus
- Muut tiedot ovat sähköposti ja passinnumero
- Virkailija painaa "Lisää henkilö"
- Käynnistetään haku mahdollisista duplikaateista.
- Jos löytyy duplikaatteja, tulee ilmoitus, että duplikaatteja löytyi ja virkailija ohjataan samanlaiseen näkymään kuin olemassaoleva duplikaattihaun hallinta. Näkymä on tarkoitettu ainoastaan katseluun. VIrkailija voi kopioida näkymästä sen henkilön OID:n, jonka uskoo samaksi henkilöksi ja painaa näkymässä "peru"-nappia ja prosessi keskeytyy. Jos taas virkailija on varma, että yksikään näytettävistä mahdollisista duplikaateista ei ole sama henkilö, virkailija painaa samassa näkymässä "Lisää henkilö", jolloin henkilö lisätään virkailijan organisaatioon ja henkilö yksilöityy automaattisesti.
- Jos ei löydy duplikaatteja, henkilö lisätään virkailijan organisaatioon ja henkilö yksilöityy automaattisesti.
Vaihtoehtoinen tapa: hetuttomat tuodaan samassa batchissa kuin muutkin oppijat. Hetuttomille pitää hakea mahdolliset dublikaatit omassa hakukäyttöliittymässään. Tiedonsiirron sivulta oltava pääsy ONR-palvelun duplikaattihakuun.
Suunnittelussa olevat toiminnallisuudet
Sähköpostin lähettäminen virkailijalle
Kuvan kohta 4a&b.
- Lähetetään email oppilaitosjärjestelmän virkailijalle batch importin tuloksesta. Hetuttomia ja vääriä hetuja, duplikaatteja jne joudutaan luultavasti käsittelemään käsin organisaation virkailijoiden toimesta opintopolun käyttöliittymässä.
- Katso kohta Käyttöliittymällä suoritettavat toiminnot.
- Jos henkilön tiedoilla löytyy ennestään oppija, virkailija voi yhdistää oppijan omaan organisaatioonsa.