Ammatillisen koulutuksen järjestäjille mahdollistetaan Arvon rajapintojen käyttöönotto vuoden 2024 aikana. Koska ammatillisen koulutuksen järjestäjiä on paljon, Arvo-tiimi porrastaa käyttöönottoja. Tutustu porrastettuun käyttöönottoon: Ammatillisen rajapinnan porrastettu käyttöönotto. Lue myös Opetushallituksen tiedote valtakunnallisten opiskelija- ja työelämäpalautteiden rajapintojen avaamisesta koulutuksen järjestäjien käyttöön: Tiedote OPH-3839-2024 suomeksi.pdf.

Mitä Arvon rajapintakäytöllä tarkoitetaan?

Arvon rajapintojen eli Arvo-API:n käytöllä tarkoitetaan sitä, että ammatillisen koulutuksen järjestäjät saavat rajapintojen kautta käyttöönsä omalle koulutuksen järjestäjälleen Arvoon tallennetut datat. Rajapintojen käytössä koulutuksen järjestäjän järjestelmä pyytää tietoja Arvosta, joka siirtää ne koulutuksen järjestäjän Arvoon rakentaman teknisen yhteyden kautta koulutuksen järjestäjän käytössä olevaan järjestelmään. Lue lisää Arvon rajapinnoista: Arvon rajapinnat

Mitä tietoja ammatillisen koulutuksen järjestäjä voi saada rajapintojen kautta?

Ammatillisen koulutuksen järjestäjä voi saada rajapintojen kautta käyttöönsä ammatillisen opiskelijatiedonkeruussa (aloittaneet, tutkinnon osia suorittaneet ja tutkinnon suorittaneet) sekä työelämäpalautteessa (työpaikkakysely, työpaikkaohjaajakysely) Arvoon tallennettua oman koulutuksen järjestäjänsä kysely- ja vastausdataa taustatietoineen. Tutustu opiskelijatiedonkeruuseen (Ammatillisen opiskelijapalaute) sekä työelämäpalautteeseen (Työelämäpalaute). 

Millaisia ympäristöjä Arvon ammatillisen koulutuksen rajapinnoista on käytössä?

Ammatillisen koulutuksen rajapinnoista toteutetaan pelkästään tuotantoympäristö. Erillistä testiympäristöä ei ole toteutettu. Koulutuksen järjestäjä voi halutessaan hyödyntää omassa testiympäristössään Arvon tuotantoympäristön datoja.

Mihin rajapintojen kautta saatuja datoja voi hyödyntää?

Ammatillisen koulutuksen järjestäjä voi hyödyntää Arvon rajapintojen kautta siirrettyjä datoja esimerkiksi oman toimintansa kehittämiseen.

Mitä ammatillisen koulutuksen järjestäjän tulee tehdä ennen Arvo-API:n käyttöönottoa?

Toimi seuraavasti ennen käyttöönottoa:

  • Keskustele Arvon rajapintojen käyttömahdollisuudesta organisaatiossasi
  • Tee päätös rajapintojen käyttöönotosta
  • Sovi järjestelmä, jonne tiedot Arvosta rajapintatoteutuksen kautta siirretään
  • Sovi rajapintakokonaisuuden vastuuhenkilöt organisaatiossasi sekä henkilöt, joille Arvoon on tarpeen myöntää rajapintojen hallinnointiin käyttöoikeudet
  • Sovi rajapintatoteutuksen teknisen toteutuksen tekijät
  • Tutustu toteutuksen tekijöiden kanssa Arvon rajapintaohjeistuksiin: Arvo-API v. 2.0 kuvaukset
  • Käy Arvon tiedonkeruiden sisältöjä ja termistöä läpi koulutuksen järjestäjän koulutustoimijan vastuukäyttäjän (käyttöoikeus: Arvo-koulutustoimijan vastuukäyttäjä) kanssa, jotta kaikilla on yhtäläinen ymmärrys rajapintojen kautta liikkuvasta datasta
  • Tee tekninen toteutus
  • Ilmoittaudu ammatillisen koulutuksen rajapintojen käyttöönottoon ohjeistuksen mukaan: Arvo-API:n porrastettu käyttöönotto

Miten Arvo-API:n käyttöönotto tapahtuu?

Näin otat koulutuksen järjestäjänä Arvo-API:n käyttöön ennen käyttöönottoa tapahtuneiden tehtävien (ks. edellinen kohta) jälkeen:

  • Hae rajapintaa hallinnoiville henkilöille käyttöoikeudet, tutustu ohjeistuksiin: Käyttöoikeuksien hallinta
  • Hae rajapintaa kutsuvalle järjestelmälle käyttöoikeudet ohjeistuksen mukaan: Arvo-API Arvon käyttöliittymässä 
  • Odota Arvo-tiimistä sähköpostitse kuittaus järjestelmälle myönnettävistä käyttöoikeuksista
  • Testaa teknistä toteutusta
  • Vertaa datoja 
    • eHOKSiin tallennettuihin tietoihin ja/tai sen järjestelmän tietoihin, joka siirtää tietoja eHOKSiin
    • Arvon virkailijakäyttöliittymästä saatavien CSV-raporttien ja Arvo-API:n datoja​
    • mahdollisesti myös Vipusen raporteilla näkyviä ja Arvo-API:n datoja
  • Aloita varsinainen tiedonsiirto Arvosta koulutuksen järjestäjän järjestelmään

Mistä saan teknistä toteutusta varten ohjeistusta?

Arvon rajapintojen kuvaus löytyy sivun Arvo-API v. 2.0 kuvaukset kautta. 

Onko rajapinnan tekniselle toteutukselle vaatimuksia?

Arvon rajapinnat ovat REST-rajapintoja, jossa formaattina on JSON.

Miten toimimme tilanteessa, jos yhteistyökumppanimme toteuttaa rajapintaa koulutuksen järjestäjän puolesta?

Kun koulutuksen järjestäjä ilmoittautuu mukaan porrastettuun Arvon ammatillisen koulutuksen järjestäjien rajapinnan käyttöönottoon, tulee koulutuksen järjestäjän ilmoittaa mahdollisesta yhteistyökumppanuudesta sekä siitä, tehdäänkö IP-avaus Arvon rajapintaan koulutuksen järjestäjälle vai yhteistyökumppanille. Koulutuksen järjestäjän tulee huolehtia tarvittavat sopimukset yhteistyökumppanin kanssa voimaan.

Mitä tietoja toimitamme rajapinnan avaamista varten Arvolle?

Porrastetettuun käyttöönottoon ilmoittauduttaessa ilmoitetaan koulutuksen järjestäjä sekä kuka toteutuksen tekee, tutustu sivun Ammatillisen rajapinnan porrastettu käyttöönotto ohjeistukseen. Rajapintasiirron käynnistämistä varten koulutuksen järjestäjä tallentaa Arvon käyttöliittymässä rajapintaa hallinnoivan henkilön tai tahon (esim. tietohallinto@koulutuksenjarjestaja.fi) sähköpostiosoitteen sekä IP-osoitteen tai -osoitteet.  IP-osoitteen on oltava kiinteä eli staattinen. Tutustu ohjeistukseen: Arvo-API Arvon käyttöliittymässä.

Tiedonsiirrossa käytettävä IP-osoitteemme vaihtuu, mitä teen?

Kun tiedonsiirrossa käytetty IP-osoite vaihtuu, tiedonsiirto lakkaa. Tällöin koulutuksen järjestäjän tulee ilmoittaa tilanteesta Arvon asiakaspalveluun arvo@csc.fi sekä päivittää IP-osoitteeseen liittyvät tiedot Arvon käyttöliittymässä. Tutustu käyttöliittymän käyttöohjeeseen: Arvo-API Arvon käyttöliittymässä

Miten hallinnoin Arvon rajapintakäyttäjiin liittyviä oikeuksia?

Ammatillisen koulutuksen Arvon rajapintakäyttöön liittyvät henkilöiden käyttöoikeudet (ARVO-rajapintakäyttäjä) myöntää Arvon ylläpitäjä, ei koulutuksen järjestäjän Arvo-pääkäyttäjä.

Tietoja Arvosta ammatillisen koulutuksen järjestäjän järjestelmään siirtävän järjestelmän käyttöoikeuksista hallinnoidaan Arvossa. Käyttöohjeet löydät sivulta Arvo-API Arvon käyttöliittymässä.

Kuinka kauan järjestelmälle annettu käyttöoikeus on voimassa?

Järjestelmälle annetussa käyttöoikeudessa ei erikseen ole vanhentumis-/päättymisaikaa. Suosittelemme vaihtamaan salasanan säännöllisesti Arvon käyttöliittymässä itsenäisesti. Muistathan tallentaa vaihtamasi salasanan myös koulutustoimijasi rajapintaa käyttävään järjestelmään.

Mitä tarkoittaa porrastettu käyttöönotto?

Ammatillisen koulutuksen järjestäjiä on paljon, joten hallitun ammatillisen koulutuksen rajapintojen käyttöönoton varmistamiseksi Arvo-tiimi porrastaa käyttöönottoja. Käyttöönotot tapahtuvat siten, että yhdellä kertaa käyttöönottoja mahdollistetaan alkuvaiheessa rajatulle joukolle rajapintaa toteuttaville koulutuksen järjestäjille. Tutustu porrastettujen käyttöönottojen aikatauluihin ja mukaan ilmoittautuneisiin koulutuksen järjestäjiin: Ammatillisen rajapinnan porrastettu käyttöönotto.

Miten ammatillisen koulutuksen Arvon rajapintakokonaisuuden käyttöönottoa testataan?

Porrastetussa käyttöönotossa ensimmäiseen ryhmään (Ryhmä 1) ilmoittautuneet koulutuksen järjestäjät pilotoivat toteutusta. Lue lisää: Arvo-API:n porrastettu käyttöönotto

Koulutuksen järjestäjän kannattaa käyttöönottovaiheessa testata rajapintojen kautta hakemansa datat.

Miten ilmoittaudumme porrastettuun käyttöönottoon mukaan?

Jos ammatillisen koulutuksen järjestäjäsi haluaa ottaa Arvon rajapinnat käyttöön, ota yhteyttä Arvon asiakaspalveluun osoitteella arvo@csc.fi. Yhteyttä tulee ottaa siinä vaiheessa, kun

  1. koulutuksen järjestäjä on omissa valmisteluissaan tilanteessa, että tarvitsee tietoja siirtävälle järjestelmälle käyttöoikeudet Arvon rajapintoihin ja on valmis testaamaan toteutusta TAI
  2. koulutuksen järjestäjällä on rajapintatoteutuksen kanssa sellaisia haasteita, joihin ei Arvon ohjeistuksen pohjalta löydy vastausta

Mihin kellonaikaan datoja voi hakea Arvon rajapinnoista?

Suurten yhtäaikaisten hakujen välttämiseksi datojen hakua Arvon rajapinnoista hajautetaan. Arvo-tiimi ohjeistaa käyttöönoton yhteydessä kutakin koulutuksen järjestäjää hakemaan datoja tiettyyn kellonaikaan, ks. sivu Arvo-API:n porrastettu käyttöönotto.

Onko rajapintahakujen määrää rajoitettu?

Palvelunestohyökkäyksiä ja muuta häirintää varten hakujen määrä on rajoitettu IP-osoitekohtaisesti 100 hakuun/minuutti. Lue lisää: Arvo-API v. 2.0 kuvaukset - Yleisiä huomioita

Mitä Arvon rajapintojen käyttö maksaa ammatilliselle koulutuksen järjestäjälle?

Rekisterinpitäjänä Opetushallitus on linjannut, että Arvon rajapintojen käyttöönotto ja käyttö on ammatillisille koulutuksen järjestäjille maksutonta. Koulutuksen järjestäjä huolehtii omista käyttöönottoon ja käyttöön liittyvistä kustannuksista.

Miten tiedän, onko koulutuksen järjestäjälläni rajapinta käytössä?

Näet sivulta Ammatillisen rajapinnan porrastettu käyttöönotto ne ammatillisen koulutuksen järjestäjät, jotka ovat ilmoittautuneet mukaan porrastettuihin käyttöönottoihin ja ne, joille käyttöoikeudet rajapintakäyttöön on myönnetty. Tiedonsiirron aloittamista ja käyttöä rajapintojen kautta koulutuksen järjestäjän järjestelmiin voit tiedustella koulutuksen järjestäjäsi rajapintoja toteuttavalta yksiköltä/osastolta tai yhteistyökumppanilta.

Rajapintakäyttömme päättyy, mitä teemme?

Kun koulutuksen järjestäjä päättää Arvon rajapintojen käytön, ilmoitathan tästä Arvon asiakaspalveluun arvo@csc.fi. Käytön päättyessä estämme pääsyn Arvon rajapintoihin.

Koulutuksen järjestäjäni ei halua rajapintaa käyttöön, mitä teemme?

Rajapintojen käyttöönottoa ja käyttöä ei ole pakko tehdä. Ne virkailijakäyttäjät, joilla on Arvossa Raportit-osioon käyttöoikeudet, voivat aina tarkastella koulutuksen järjestäjän tiedonkeruiden kautta kerättyjä tietoja Arvon käyttöliittymän raporteilla ja/tai ladata CSV-tiedoston Arvosta. Tutustu raportoinnin käyttöohjeisiin: Raportointi Arvon käyttöliittymässä.

Mitä eroja Arvon tietojen rajapintakäytön ja käyttöliittymäkäytön välillä on?

Käyttöliittymäkäytössä käyttäjä kirjautuu Arvoon ja etsii tarvitsemansa tiedot Raportit-osiosta tai lataa tiedot CSV:llä sekä huolehtii tiedot tarvittaessa manuaalisesti niitä käsitteleville henkilöille ja/tai järjestelmiin. Rajapintatoteutuksen kautta koulutuksen järjestäjä saa Arvoon tallennetut koulutuksen järjestäjän datat suoraan omaan järjestelmäänsä käyttöön.

Arvon käyttöliittymän raportteja ja CSV-raportteja ladataan Arvon käyttöliittymästä henkilökohtaisiin käyttäjätunnuksiin liitetyillä käyttäjärooleilla. Tämä tarkoittaa, että CSV-latauksia käyttöliittymästä voi tehdä vain käyttäjä itse omalla käyttäjätunnuksellaan, eikä henkilökohtaisia käyttäjätunnuksia saa käyttää automatisoituun CSV-raporttien lataamiseen Arvosta. Jos koulutuksen järjestäjällä on tarvetta ladata automatisoidusti dataa Arvosta (esimerkiksi kerran vuorokaudessa), tulee koulutuksen järjestäjän ottaa Arvon rajapinnat käyttöönsä. Rajapintakäytössä koulutuksen järjestäjän järjestelmälle myönnetään konekäyttöön tarkoitettu pääsy- ja käyttöoikeus Arvon rajapintoihin.

Miksi rajapinnoista ei saa tietoja samassa muodossa kuin CSV-raporteilla?

Arvo-API:ssa tiedot haetaan tiedonkeruittain, myös CSV:lle tulee aina yhden tiedonkeruun datat. Työpaikkakyselyssä tutkintotiedot yhdistetään työpaikkaohjaajakyselyyn ja tämä yhdistäminen täytyy koulutuksen järjestäjän itse tehdä, koska tietojen yhdistäminen rajapinnassa tehtynä hidastaisi API-hakuja liikaa, ks. tarvittaessa ohjeistus Arvo-API v. 2.0 kuvaukset#Työpaikkajaksojen yhdistäminen työpaikkakyselyn tunnuksille. Tietojen muodon voi toteuttaa omaan tietovarastoon haluamassaan muodossa eli tarvittaessa samaan muotoon kuin CSV-tiedostolla.

Kuinka pitkään ammatillisen koulutuksen opiskelijapalautteiden ja työelämäpalautteiden datat voivat muuttua?

Rahoituskauden eli tiedonkeruiden aikana

Rahoituskauden eli tiedonkeruiden päättymisen jälkeen

  • Opetushallitus toteuttaa päättyneen rahoituskauden opiskelija- ja työelämäpalautteiden datoihin laadullista tarkistusta koulutuksen järjestäjien vaikuttavuusrahoituksen laskentaa varten. Palautedatoihin tehdään tarvittaessa korjauksia tällä hetkellä ajanjaksolla lokakuu-marraskuu. Tämän jälkeen datoihin ei tehdä muutoksia.

Mistä saan tarvittaessa rajapintakäytöstä lisätietoja?

Tutustu ensimmäiseksi Arvon rajapinnat -osion sisältöihin. Ota sen jälkeen tarvittaessa Arvoon liittyvissä rajapinta-asioissa yhteys Arvon asiakaspalveluun osoitteella arvo@csc.fi.

Jos asiasi liittyy Opetushallituksessa tallennettuihin tietoihin, joita hyödynnetään ammatillisen opiskelija- ja työelämäpalautteiden muodostamisessa, ota yhteyttä Opetushallitukseen osoitteella arvokyselyt@oph.fi.

Miten Arvosta tiedotetaan rajapintoihin liittyvistä asioista?

Opetushallitus huolehtii ammatillisen koulutuksen järjestäjien tiedottamisesta. Tiedotteet löydät sivuilta Tiedotteet työelämäpalautteeseen liittyen.

Arvo-tiimi tiedottaa Arvoon liittyvistä ajankohtaista asioista Arvon käyttöliittymässä, sivulla Ajankohtaista, uutiskirjeessä Arvon uutiskirje sekä tarvittaessa Opintopolun työpöytäviestinnän kautta suoraan henkilöille, joilla on Arvon rajapintoihin liittyvät käyttöoikeudet.

Mitkä Arvo-API -kokonaisuuden tehtävät kuuluvat Arvo-tiimille ja mitkä koulutuksen järjestäjälle?

Arvo-tiimi huolehtii rajapintakokonaisuuden ylläpidosta ja kehittämisestä, versiopäivityksistä, porttiavauksista IP-osoitteita varten ja rajapintojen kautta välitettävien datojen rajauksesta rekisterinpitäjän ohjeistuksen mukaan. Lisäksi Arvo-tiimi ohjeistaa Arvo-API -käyttäjiä sekä tukee tarvittaessa käyttäjiä asiakaspalvelun palveluaikoina.

Koulutuksen järjestäjä huolehtii Arvo-API -käyttöoikeuksien tietoturvallisesta käytöstä ja säilyttämisestä, datojen hakemisesta Arvo-API:n kautta ja datojen tallentamisesta oman organisaation tietovarastoon sekä rajapinnan kautta tallennetun datan käsittelystä organisaation henkilötietojen käsittelyohjeen mukaisesti.

  • No labels