Parasta DigiTukea-hankkeessa on toteutettu rajapintaratkaisu Opintopolun virkailijakäyttäjän kutsumiseksi ja käyttöoikeuksien myöntämiseksi. Ratkaisun ovat rakentaneet Koulutuskeskus Salpaus ja Opetushallitus yhteistyössä vuoden 2019 aikana.
Tehty rajapintatoteutus ja kuvausdokumentaatio vastaavat PDT-hankkeen tavoitteita. Ratkaisu sisältää rajapintakuvauksen, määritykset sekä ottaa huomioon kansallisten palvelujen kehitystyön. Siinä on varmistettu yhteentoimivuus koulutuksen järjestäjien paikallisten järjestelmien ja Opintopolun välillä. Ratkaisu tukee työpaikalla järjestettävän koulutuksen prosesseja lisäämällä HOKS-tiedon näkyvyyttä eHOKS-palvelun kautta.
Laaditun kuvauksen ja avoimen lähdekoodin avulla koulutuksen järjestäjät voivat toteuttaa oman ratkaisunsa niin halutessaan. Rajapintaratkaisun toteuttaminen ja käyttöönotto edellyttävät teknistä osaamista. Kyseessä ei ole valmis palvelu, jonka koulutuksen järjestäjä voi ostaa avaimet käteen –periaatteella.
Tarve ratkaisulle lähti liikkeelle eHOKS-käyttöoikeuksista, sillä niiden hallinnointi on työlästä käyttöliittymällä, mikäli kutsuttavia käyttäjiä ja myönnettäviä käyttöoikeuksia on satoja koulutuksen järjestäjä. Rajapinnan avulla kutsuminen on tehokkaampaa, kun lähtöjärjestelmän (opintohallintojärjestelmä tai HR-järjestelmä) tietoja voidaan hyödyntää, eikä jokaista kutsuttavaa tarvitse käsitellä yksitellen Opintopolun käyttöliittymällä. Tehty ratkaisu on käytettävissä myöhemmin myös yleisesti, eikä rajoitu pelkästään eHOKS-käyttäjäryhmiin.
Ratkaisu perustuu Opintopolussa olevaan JSON-rajapintaan, jota myös käyttöliittymällä tapahtuva virkailijakutsun lähettäminen käyttää. Käyttöliittymäkutsusta poiketen rajapintaratkaisussa palveluun tunnistautuminen, JSON-sanoman muodostaminen ja lähetys on toteutettu käyttöliittymästä irrallaan. Nämä vaiheet ovat automatisoitavissa ja ajastettavissa, jolloin käyttöliittymällä tapahtuva yksittäisen kutsun lähetys ei työllistä Opintopolun vastuukäyttäjää.
Paikallisessa lähtöjärjestelmässä olevan tiedon perusteella muodostetaan JSON-sanoma kutsun lähettämistä varten. Lähtöjärjestelmänä voi toimia esimerkiksi opintohallintojärjestelmä (OHJ) tai henkilöstöhallinnon järjestelmä (HR). Kutsupalvelu välittää tämän JSON-sanoman ajastetusti/automatisoidusti Opintopolun rajapinnalle. Kutsupalvelun täytyy tunnistautua Opintopolkuun palvelukäyttäjänä. Opintopolku käsittelee JSON-sanoman samalla tavalla kuin se olisi tullut Opintopolun käyttöliittymältä. Kutsuttava saa sähköpostin Opintopolusta, tunnistautuu palveluun ja saa määritellyt käyttöoikeudet.
Ratkaisu esitellään avoimessa webinaarissa 8.11.2019 klo 9-11 (ks.
Tapahtumat). Tallenne tulee myöhemmin jakoon Parasta DigiTukea -YouTube-kanavalle.
Kirjoittaja: Mikko Jänis, Salpaus