5.1 Liittymät
Seuraavaan taulukkoon on koottu ylätason kuvaukset liittymistä ja niissä liikkuvista tiedoista. Liittymä on loogisen tason yhteys eri toimijoiden välillä. Taulukkoon on tuotu Kansallisen opintohallinnon viitearkkitehtuurin, Oppijan verkkopalvelut Tarkennetun viitearkkitehtuurin ja Todennetun osaamisen rekisterin ja hakeutujan palveluiden kohdearkkitehtuurin yhteydessä tunnistetut liittymät. Lisäksi taulukkoon on lisätty liittymän nykytilanne.
TOR = Todennetun osaamisen rekisterin ja hakeutujan palveluiden kohdearkkitehtuuri, v0.91, 2011
OV = Oppijan verkkopalvelut Tarkennettu viitearkkitehtuuri, v1.93, 2011
KOHVI= Kansallinen opintohallinnon viitearkkitehtuuri, v1.0, 2012
| Ryhmä | Nimi | Kuvaus | Lähde | Nykytilanne |
|---|---|---|---|---|
| KOHVI rajapinnat | 0: Koodistot | OPH->Org: Koulutuksen koodistot, Kansalliset koulutuksen koodistot | KOHVI: liittymät, rajapinnat | Koodistopalvelun rajapinta |
| 1: Tutkintorakenne | OPH->Org: Kansallisen tutkintorakenteen tiedot eOPS. Opetussuunnitelmien ja tutkintojen perusteet rakenteisessa ja sähköisessä muodossa paikalliselle koulutuksen järjestä-jälle, joka tarkentaa tämän omalta osaltaan | KOHVI: liittymät, rajapinnat | ePerusteissa opetussuunnitelmien perusteet, mahdollisuus tuoda paikalliset OPSit | |
| 2: Koulutustarjonta, valintaperusteet | Org → OPH: Koulutustarjontatiedon ja näiden valintaperusteiden siirto Hakeutujan palveluihin Viedään kansallisen avoimen rajapinnan kautta Hakeutujan palveluihin (Opintopolku). Huom. Voidaan toteuttaa myös suoraan kan-salliseen palveluun, sen välineillä. | KOHVI: liittymät, rajapinnat | ei perusopetuksessa | |
| 3: Valintaesitys | OPH -> Org: Yhteishaun ja muun hakeutumisen valintaesityslista paikal-lisesti päätettäväksi. Opiskelijat identi-fioitu kansallisella opiskelijatunnuksel-la (oppijanumero). Koulutuksen järjestäjä, koulutusohjelma, tutkinto, opiskelija (ID:nä kansallinen oppija-numero), tiedot oppijoiden valintaperusteissa arvioiduista tiedoista (esim. aikaisempi to-dennettu osaaminen) järjestettynä valintaesi-tyksen mukaiseen järjestykseen. | KOHVI: liittymät, rajapinnat | perusopetuksen jälkeen | |
| 4: Opiskelijavalinta-tiedot | Org -> OPH: Päätökset oppilaitok-seen valituista uusista opiskelijoista Koulutuksen järjestäjä tekee itsenäisesti pää-töksen, jonka se kirjaa kansallisessa palve-lussa. Tämä tieto siirretään sen jälkeen pai-kalliseen opintohallintojärjestelmään. | KOHVI: liittymät, rajapinnat | perusopetuksen jälkeen | |
| 4b: Paikan vastaanotto | OPH -> Org: Opiskelupaikan vas-taanoton vahvistaminen tai hylkäys Opiskelija ottaa kansallisessa palvelussa opiskelupaikan vastaan tai ilmoittaa, ettei otakaan paikkaa vastaan. Tämä tieto välite-tään koulutuksen järjestäjälle: Opiskelija_id, koulutus/linja_id; koulutuksen järjestäjä | KOHVI: liittymät, rajapinnat | perusopetuksessa oppilaaksiotto tiedot Koskeen? | |
| 5: Lukuvuosi-ilmoittautumistieto | Org -> OPH: Kansalliseen palveluun siirretään tieto lukuvuosi-ilmoittautuneista Opiskelijatunnus, lukuvuosi-johon-ilmoittauduttu, aikaleima, oppilaitos | KOHVI: liittymät, rajapinnat | perusopetuksessa oppilaaksiotto tiedot Koskeen? | |
| 10: Läsnäolotieto | Org → OPH: Oppilaitos lähettää tie-don opiskelijan läsnäolosta kansalli-seen palveluun Opiskelijatunnus, läsnäolokoodi, (voimassa-olo), oppilaitostunnus, aikaleima | KOHVI: liittymät, rajapinnat | perusopetuksessa suorituskirjaus Koskeen? | |
| 11: Opintosuoritukset | Org ->OPH: Oppilaitos lähettää tie-don opiskelijan hyväksytystä opinto-suorituksesta ja arvosanasta TORiin Opiskelijatunnus, opintosuoritustieto, arvo-sana, aikaleima, myöntäjäoppilaitos, myöntä-jä (henkilö) | KOHVI: liittymät, rajapinnat | Opintohallintojärjestelmä->KOSKI | |
| 14: Tilastotiedot | Org ->OPH; Org ->Tilastokeskus; Org ->Kela: Koulutustilastot OKM:n ja Tilastokeskuksen edellyttämät tiedot. Tätä liittymää voidaan hyödyntää myös koulutusastekohtaisissa benchmarking-tietojen vaihdossa | KOHVI: liittymät, rajapinnat | Tilastotiedot Vipusessa, osa Kosken kautta, TK tiedonkeruut, Kuntatieto taloustietojen osalta. | |
Liittymät julkisen hallinnon yhteisiin palveluihin | Julkisen hallinnon asiointipalvelut | Suomi.fi ja asiointitili | OV 4.4.2 Tavoitetilan integraatioratkaisu | ? |
| Liittymät kansallisiin integraatio- ja tietojärjestelmäpalveluihin | VETUMA-liittymä | OV 4.4.2 Tavoitetilan integraatioratkaisu | Olemassa | |
| VIRTU-luottamusverkostoliittymä | OV 4.4.2 Tavoitetilan integraatioratkaisu | Olemassa | ||
| KATSO-liittymä organisaatioiden edustajien tunnistamineen | OV 4.4.2 Tavoitetilan integraatioratkaisu | Poistunut | ||
| Liittymät kansallisiin perustietovarantoihin | Liittymä VTJ:ään – oppijan perustiedot, huoltajatiedot, huoltajien perustiedot, kuntakoodit tms. | OV 4.4.2 Tavoitetilan integraatioratkaisu | VTJ->Oppijanumerorekisteri | |
| YTJ – yritysten ja organisaatioiden perustiedot | OV 4.4.2 Tavoitetilan integraatioratkaisu | YTJ->org.palvelu | ||
| Paikkatiedot – keskeiset kansalliset paikkatiedot keskitettyjen oppijan palveluiden rikastamiseksi | OV 4.4.2 Tavoitetilan integraatioratkaisu | paikallisia ratkaisuja | ||
| Opetustoimen liittymät | OV 4.4.2 Tavoitetilan integraatioratkaisu | |||
| Koulutuksen järjestäjien palvelut | Liittymä koulutuksen järjestäjän opintohallintojärjestelmään | OV 4.4.2 Tavoitetilan integraatioratkaisu | Opintohallintojärjestelmä->KOSKI | |
| Liittymä koulutustietopalveluihin | OV 4.4.2 Tavoitetilan integraatioratkaisu | Vipunen? | ||
| Liittymä koulutuksen järjestäjän omaan asiointipalveluun | OV 4.4.2 Tavoitetilan integraatioratkaisu | ? | ||
| Opetustoimen tietopalveluliittymät | OPH: oppimistulosten arviointitoiminto | OV 4.4.2 Tavoitetilan integraatioratkaisu | ? | |
| OKM:n tutkimustietokanta | OV 4.4.2 Tavoitetilan integraatioratkaisu | Vipunen? | ||
| Sidosryhmien liittymät | OV 4.4.2 Tavoitetilan integraatioratkaisu | |||
| Tilastointi | Liittymä Tilastokeskuksen tilastopalveluihin (tilastot ja seuranta) | OV 4.4.2 Tavoitetilan integraatioratkaisu | KOSKI->Tilastokeskus | |
| Muut liittymät | Sähköisen arkistoinnin liittymä Arkistolaitokseen ja Vapa-palveluun | OV 4.4.2 Tavoitetilan integraatioratkaisu | ? | |
| Taloushallintoliittymä (esim. ulkomaalaisten maksullinen haku tulevaisuudessa) | OV 4.4.2 Tavoitetilan integraatioratkaisu | ? | ||
| Keskeiset hakeutujan liittymät | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | |||
| TOR | Tutkinto, suoritus ja opinto-oikeustiedot | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | KOSKI->suoritusrekisteri | |
| Opintohallinto-ohjelmat | Opintohallinto-ohjelmista: Koulutustarjonta, valintaperusteet, koetulokset, pistetykset(jos tekevät pistelaskennan omassa järjestelmässään). Opintohallinto-ohjelmiin:Koodistot, valinnan tulokset. | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | ||
| Vapa | Koulutustarjonta, valintaperusteet, hakijatiedot, hakemustiedot, vastaanottotiedot, koetulokset, valinnan tulokset | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | ? | |
| Asianhallintajärjestelmä (SALAMA) | Koulutustarjonta, valintaperusteet, hakijatiedot, hakemustiedot, vastaanottotiedot, koetulokset, valinnan tulokset | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | ? | |
| OKM:n tilastotietovaranto | Koulutustarjonta, hakijatiedot, hakemustiedot, vastaanottotiedot, valinnan tulokset | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | Vipuseen? | |
| Tilastokeskus | Koulutustarjonta, hakijatiedot, hakemustiedot, vastaanottotiedot, valinnan tulokset | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | Kosken kautta? | |
| TEM | Koulutustarjonta, hakijatiedot, hakemustiedot, vastaanottotiedot, valinnan tulokset | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | ? | |
| Vetuma | Tunnistetiedot | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | ? | |
| VTJ | Henkilön perustiedot | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | Oppijanumerorekisterin kautta | |
| YTJ | Organisaation perustiedot | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | Org.palvelun kautta | |
| HAKA | Tunnistetiedot | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | ei perusopetus? | |
| VIRTU | Tunnistetiedot | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | toteutettu | |
| Koulutuslupajärjestelmä | Koulutusluvat | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | Oivassa, mutta liittymää ei ole toteutettu? | |
| Suomi.fi | Päätökset | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | ei ole toteutettu? | |
| KELA | hakijatiedot, hakemustiedot, vastaanottotiedot, valinnan tulokset | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | Kosken kautta? | |
| CIMO | Koulutustarjonta | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | ? | |
| Valos | Koulutustarjonta | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | Kosken kautta Valosiin | |
| n. määrä OPH:n omia palveluita/järjestelmiä, jotka käyttävät tietovarantojen tietoja. | Esim. Organisaatiotiedot, yhteystiedot, koodistot | TOR: 6.2.2 Hakeutujan palveluiden keskeisimmät liittymät | toteutettu tarvittavin osin | |
Taulukko 7. Liittymät
5.2 Loogiset rajapinnat
Seuraavaan taulukkoon on listattu tunnistettuja olemassa olevia teknisiä rajapintoja. Nykytilan kuvauksessa tarkkuustaso on enemmän fyysisen tason toteutusarkkitehtuuria. Lisäksi on nostettu esille aiemmissa arkkitehtuuritöissä tunnistetut liittymät, joita ei ole kuitenkaan toteutettu.
| Rajapinnan tuottaja | Nimi | Kuvaus | Ryhmä | Lisätietoja | Kommentti |
|---|---|---|---|---|---|
| OPH | ePerusteet REST API | Perusteiden sovellusrajapinta | Julkinen , caller-id | ePerusteet julkiset rajapinnat (poistetaan, piilotettu) | |
| OPH | Hakemus REST API | Hakemuspalvelu tarjoaa eri koulutustoimijoille ja muille toimijoille mahdollisuuden hakulomakkeen luontiin koulutukseen hakeutumista varten. Hakemuspalvelu tarjoaa lisäksi toimintoja tukemaan hakemusten käsittelyä ja opiskelijoiden valintaa. | (ks. rajapinnat) | ||
| OPH | Koodisto REST API | Opetushallituksen koodistojen sovellusrajapinta | Julkinen , caller-id | Koodistopalvelu (ks. rajapinnat) | |
| OPH | Koski REST API | Opetuksen ja koulutuksen tietovarannot sovellusrajapinta | Rajattu pääsy | TORssa "todennetun osaamisen rekisteri" | |
| OPH | Käyttöoikeus REST API | Käyttöoikeuspalvelu (ks. rajapinnat) | |||
| OPH | Liiteri REST API | Liitteiden sovellusrajapinta. | OPH sisäinen | (ks. rajapinnat) | Dokumenttien / tiedostojen välittäminen organisaatioiden välillä turvallisesti? |
| OPH | Localisation REST API | Käyttöliittymien käännösten sovellusrajapinta. | OPH sisäinen | Lokalisointipalvelu | Kansalliset käännökset? |
| OPH | Logger API | Audit log sovellusrajapinta | OPH sisäinen | Audit log palveluekosysteemissä? | |
| OPH | Lomake-editori REST API | (ks. rajapinnat) | |||
| OPH | Maksatus REST API | Toteutuksessa. | OPH sisäinen | Yleiskäyttöisyys julkishallinnossa? | |
| OPH | Oppijanumerorekisteri REST API | Oppijanumerorekisterin sovellusrajapinta | Rajattu pääsy | Oppijanumero | OV: Kansallinen opiskelijatunnusrekisteri |
| OPH | Organisaatio REST API | Opetushallituksen organisaatiopalvelun sovellusrajapinta | Julkinen , caller-id | Organisaatiopalvelu | OV, TOR: Toimijarekisteri |
| OPH | Osoitepalvelu REST API | Osoitepalvelu | Julkinen? | ||
| OPH | Seuranta REST API | Rajattu pääsy | Sijoittelu | ||
| OPH | Sijoittelu REST API | Rajattu pääsy | Sijoittelu | ||
| OPH | Valintalaskenta REST API | Rajattu pääsy | Valintojen toteuttaminen | ||
| OPH | Valintalaskentakooste REST API | Rajattu pääsy | |||
| OPH | Valintaperusteet REST API | Rajattu pääsy | Valintaperusteiden mallinnus | ||
| OPH | Valintatulos REST API | Rajattu pääsy | Valintarekisteri | ||
| OPH | Viestintä REST API | OPH sisäinen | Viestintäpalvelu | ||
| OKM | Oiva API | Opetushallinnon ohjaus- ja säätelypalvelun rajapinta. Perusopetuksen järjestämisluvat | Rajattu pääsy | Laajenee perusopetukseen 2021 aikana, TOR nimellä koulutusluparekisteri ja -palvelu | |
| OKM/OPH | Vipunen API | Vipunen.fi sovellusrajapinta | Julkinen | https://vipunen.fi/fi-fi/Sivut/Vipunen-API.aspx | |
| Valtiokonttori | Kuntatieto API | Kuntien taloustietojen sovellusrajapinta | Julkinen | https://www.tutkihallintoa.fi/avoimet-rajapinnat/ | |
| Tilastokeskus | Tilastokeskus API | Tilastokeskuksen avoin data | https://www.stat.fi/org/avoindata/pxweb.html | ||
| Valtioneuvoston kanslia | VAHVA REST API | Vahva järjestelmän sovellusrajapinta | ei tarvita tässä? | ||
| DVV | VTJ API | Väestötietojärjestelmän sovellusrajapinta. OV: Henkilön perustietojen päivitys, VTJ, kunnan väestörekisteri | Rajattu pääsy | ||
| PRH ja Vero | YTJ API | yritys- ja yhteisötietojärjestelmään (YTJ) rajapinta | Rajattu pääsy | https://www.ytj.fi/index/avoindata.html | Perusopetuksen osalta YTJ-tiedot organisaatiopalvelussa rikastettuna tietona |
| Arkistolaitos | VAPA API | Arkistoitavien tietojen siirto | ? | ? | Onko tarpeen mainita? |
| Paikkatieto API | Paikkatietojen hyödyntäminen koulutustietojen visualisoimisessa kartalla | Toteuttamatta | Lähde: TOR, 6.2 liittymät | Paikkatietopalveluja on olemassa mutta esim. koulutustilastoja ei ole yleisesti saatavilla karttanäkymänä | |
| Sähköinen CV API | Sähköistä CV:tä oli tarkoitus hyödyntää Kelan palveluissa sekä työnhakupalveluissa sekä työvoimatoimistoissa että muissa, myös kaupallisissa rekrytointipalveluissa | Toteuttamatta | Lähde: TOR, 6.2 liittymät | ||
| Koulutustietopalvelu API | Tieto opintoa tukevista palveluista tallennetaan suoraan keskitettyjen palvelujen koulutustietopalveluun | Toteuttamatta | Lähde: TOR, 6.2 liittymät | ||
| Hakuratkaisu API | Hakuratkaisu tarjoaa rajapinnan (usein HTTP-protokollaa käyttävä XML-rajapinta), jonka kautta hakukoneen tarjoamia hakutoimintoa voidaan käyttää muista järjestelmistä tai tietojärjestelmäpalveluista | Toteuttamatta? | Lähde: OV 4.2.4.3 Tekniset tukipalvelut / Hakupalvelut | ||
| eAMS-SOA-palvelu | eAMS-SOA-palvelu tarjoaa sähköisen asioinnin palveluille niiden tarvitsemat metatiedot ja rakenteet suoraan koulutuksen järjestäjän eAMS-määrityksistä. Tämä dynaaminen palvelu varmistaa sähköisten lomakkeiden ja käyttöliittymien joustavan yhteensopivuuden asianhallinnan mahdollisesti muuttuviin eAMS-määrityksiin. | tässä muodossa toteuttamatta? | Lähde: OV 4.2.2 Sähköinen asianhallinta ja arkistointi | ||
| SOA-palvelukatalogi | SOA-palvelukatalogin tavoitteena on hallita, organisoida ja uudelleenkäyttää määritettyjä ja toteutettuja SOA-palveluita | toteuttamatta | Lähde: OV 4.2.3 Palvelujen ohjauskerros | ||
| Automatisoitu prosessi SOA palvelu | Automatisoitu prosessi voidaan myös julkaista integraatiokerroksen SOA-palveluna, mikä mahdollistaa prosessiorkestraatioiden koostamisen toisista automatisoiduista prosesseista | toteuttamatta | Lähde: OV 4.2.3 Palvelujen ohjauskerros | ||
| Suoritusten ja osasuoritusten hallinta SOA palvelu | KOSKI-rajapinnassa? | Lähde: OV 4.2.4 Palvelukerros | |||
| Tutkinto- ja suoritustiedon käyttö SOA palvelu | KOSKI-luovutuspalvelu? | Lähde: OV 4.2.4 Palvelukerros | |||
| Hakeminen ja sähköinen hakijapalvelu |
Taulukko 8. Loogiset rajapinnat
5.3 Tietojärjestelmien väliset tietovirrat
Diagrammissa on kuvattu opetuksen ja koulutuksen kansallisen tietovarannon (KOSKI) näkökulmasta tietojen tuottamisen ja hyödyntämisen tietovirrat.
