Lue ensin:
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. Rajapintojen autentikaatio. Tutustu myös CAS-integraatioon.
- Opintohallintojä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 kaikki käytössä olevat ominaisuudet.
Rajapintaan toteutetut ominaisuudet
Oppijoiden tuonti
Kuvan kohta 1
- Hetullisia henkilöitä voi tuoda opintohallintojärjestelmästä rest-rajapinnan yli batch-muotoisesti. Samaa rajapintaa käytetään alkulatauksessa (tuodaan isompi massa), kuin yksittäisten pienempien erien tuonnissa.
- Rajapinta:
- Pakolliset tiedot
- Joku näistä: 1. OID/oppijanumero, 2. hetu, 3. passinumero tai 4. oppijan hakemukselle annettu sähköpostiosoite.
- Näitä tietoja käytetään oppijan kohdistamiseen ONR-kantaan
- Mitä kattavammat tiedot, sitä luotettavammin henkilön voi yksilöidä oppijanumerorekisterissä.
- Voi lähettää kaikki, käytetään luotetuinta tietoa.
- Oppilasjärjestelmän tunniste oppijalle
- Palautuvan vastausdatan kohdistamiseen, mihin oppijaan liittyy
- etunimi
- 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ä.
- kansalaisuus
- jos kansalaisuus on suomi, hetu vaaditaan
- Joku näistä: 1. OID/oppijanumero, 2. hetu, 3. passinumero tai 4. oppijan hakemukselle annettu sähköpostiosoite.
- Vapaaehtoiset tiedot
- sähköpostisoite
- Mihin voidaan lähettää batch-ajon lopputuloksen tieto.
- sähköpostisoite
Kuvan kohta 2
- Kutsuva järjestelmä saa vastaukseksi batchId tunnisteen.
- Kutsuva järjestelmä voi kysellä tuonnin edistymistä batchId-rajapinnalla.
Kuvan kohta 3
- Perustietojen lisäksi palauttaa tuontiin liittyvät oppijat
- Rajapinta:
- Palautetaan jokaiselle oppijariville:
- Mihin opintohallintojärjestelmän tunnisteeseen henkilö liittyy
- Jos henkilö löytyy jo
- palautetaan henkilön oppijanumero ja muut 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 tilapäinen henkilö-oid ja/tai oppijanumero 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)
- Nimenmuutos
- Osoitteenmuutos
- Oppijan linkitys toiseen oppijaan (kuka on master)
- Hetun muuttuminen
- Passiivinen -tieto, joka indikoi, ettei henkilö ole enää aktiivinen VTJ:ssä
- Rajapinta:
- testiympäristössä: https://virkailija.testiopintopolku.fi/oppijanumerorekisteri-service/swagger-ui/#/oppija-controller/getMuuttuneetUsingGET
- tuotantoympäristössä: https://virkailija.opintopolku.fi/oppijanumerorekisteri-service/swagger-ui/#/oppija-controller/getMuuttuneetUsingGET
- Huomioi rajapinnan sivutustuki suuria muutosmääriä varten!
- Muutosrajapinta tarjoaa vastauksen aina organisaatiokohtaisesti:
- Listan joka sisältää oppijoiden henkilö-oideja ja oidiin liittyvän masterin tiedot.
- ONR palauttaa aina myös kaikki masteriin linkiteyt 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, kyseessä on yksilöity oppija
- Masterin tiedoista voi päätellä esimerkiksi hetun vaihtumiset, mahdollisen henkilö-oid-linkityksen ja osoitemuutokset.
- Listan joka sisältää oppijoiden henkilö-oideja ja oidiin liittyvän masterin tiedot.
Käyttöliittymällä suoritettavat toiminnot
Virkailija tarkastelee henkilötietojen siirron tilaa ja korjaa virheitä
Pääsy käyttöliittymään vaatii käyttöoikeusryhmän nimeltä Oppijan tuonti, joka lisätään pääkäyttäjälle (kk) tai vastaavalle roolille, joka saa käsitellä oman organisaationsa henkilötietoja. Käyttöliittymä löytyy navigaatiosta kohdasta Käytönhallinta --> Oppijoiden tuonti. Käyttöliittymässä voi tarkistaa tiedonsiirron edistymistä 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 virheiden käsittelyyn: Oppijoiden tuonnin virheiden käsittely
- Ohje VTJ-yksilöitävien ongelmien ratkaisuun: VTJ-yksilöitävien ongelmien ratkaisu
- Ohje hetuttomien henkilöiden linkitykseen ja yksilöintiin: Oppijan mahdolliset duplikaatit, henkilöiden linkitys ja yksilöinti
- Ohje henkilötietojen muokkaamiseen: Hetuttoman henkilötietojen muokkaus
Virkailija tallentaa hetuttomia henkilöitä käyttöliittymässä
- Oppijanumeron haku/luonti henkilötunnuksettomalle henkilölle käyttöliittymän kautta
- Henkilötunnuksettoman henkilön yksilöinti
Vaihtoehtoinen tapa: hetuttomat tuodaan järjestelmästä samassa batchissa kuin muutkin oppijat. Hetuttomat täytyy aina yksilöidä manuaalisesti virkailijan toimesta. Hetuttomat päätyvät tuonnissa virhelistalle, josta pääsee nimeä klikkaamalla yksilöimään henkilöt. Ennen yksilöintiä tulee tarkistaa mahdolliset duplikaatit.
Sähköpostin lähettäminen virkailijalle
Kuvan kohta 4a&b.
- Lähetetään email oppilaitosjärjestelmän virkailijalle batch importin tuloksesta (jos sähköpostiosoite on ilmoitettu, ks. kohta 1). Hetuttomia ja vääriä hetuja, duplikaatteja jne käsitellään käsin organisaation virkailijoiden toimesta opintopolun käyttöliittymässä. Suosittelemme käyttämään yhteiskäyttöistä sähköpostiosoitetta tähän tarkoitukseen.
- Katso kohta Käyttöliittymällä suoritettavat toiminnot.
- Jos henkilön tiedoilla löytyy ennestään oppija, virkailija voi yhdistää oppijan omaan organisaatioonsa.
Rajapinnan käyttöönotto
Rajapinnan käyttöönotto edellyttää aina yhteydenottoa Opetushallitukseen. Rajapinnasta vastaa yleiskäyttöisten palveluiden palvelutiimi (yhteisetpalvelut@opintopolku.fi).
Rajapinnan käyttö edellyttää:
- integraation toteutusta opintohallinto-ohjelmasta Opintopolkuun (oppijanumerorekisteriin)
- integraation testausta Opintopolun testiswaggerissa/testiympäristössä
- CAS-integraation toteuttamista (ml. caller-id, CSRF-token)
- palvelukäyttäjän oikeutta tiedonsiirtoihin: Oppijoiden tuonti
- virkailijan oikeutta tiedon laadun hallinnointiin: Oppijoiden tuonti, joka lisätään roolille Pääkäyttäjä (kk)
- korkeakoulun virkailijan vastuulla on huolehtia Oppijanumerorekisteriin tuotavan datan laadusta. Tämä tarkoittaa, että kk-virkailija yksilöi yksilöimättömät henkilöt manuaalisesti ja päivittää oppijoille henkilötunnukset, silloin kun se on mahdollista. Mikäli henkilötunnus on ehditty lisätä oppijanumerorekisteriin eri identiteetille, tulee oppijat yhdistää. OPH (yhteisetpalvelut(a)opintopolku.fi) purkaa tarvittaessa yksilöinnin.
- korkeakoulu vastaa myös rekisteröityjen informoinnista hakiessaan oppijanumeron henkilörekistereihinsä.