Koski toimii kattavana opetustoimialan tietovarantona, joka tarjoaa tutkintoon johtavat suoritustiedot eri koulutusasteilta. Yleinen Koski-dokumentaatio kootaan wikiin.
Tässä git-repositoriossa on Koski-järjestelmän ohjelmakoodi, tietokannan rakennuslausekkeet ja tekninen dokumentaatio ohjelmistokehitystä varten.
Koski on EUPL-lisensoitu sovellus, josta on mahdollista käynnistää kehitysinstanssi omalla työasemalla, alla olevien kehitysohjeiden mukaisesti. Koski-sovellus on alustariippumaton, sillä se pyörii Java-virtuaalikoneella. Kehitysympäristö toimii sellaisenaan ainakin Linux ja OSX-käyttöjärjestelmissä.
Kosken kanssa tässä samassa git-repositoriossa on myös Valpas-palvelun toteutus. Valpas on oppivelvollisuuden valvontapalvelu, joka käyttää mm. Koski-tietovarannon tietoja. Yleinen Valpas-dokumentaatio on wikissä. Valppaan käyttöliittymän toteutuksesta on erillinen README.md.
Keskeiset entiteetit, ja järjestelmät, joihin nämä tallennetaan.
| käsite | selite | tunniste | tallennuspaikka |
|---|---|---|---|
| Koodisto | Kooditus objekteille, esim tutkintonimikkeet | id (tekstiä) | Koodistopalvelu |
| Koodi | Yksittäisen objektin koodi koodistossa | id (tekstiä) | Koodistopalvelu |
| Oppija | Opiskelija, oppilas. | henkilöOid | Henkilöpalvelu |
| Organisaatio | Oppilaitos, kunta, eri rooleissa | organisaatioOid | Organisaatiopalvelu |
| Opiskeluoikeus | Oppijan suhde oppilaitokseen ja suoritettavaan tutkintoon (tutkinto, oppija, oppilaitos, voimassaoloaika, läsnäolotiedot...) | id (numeerinen) | Koski |
| Peruste | Tutkinnon tai tutkinnon osan peruste | diaarinumero | ePerusteet |
| Suoritus | Oppijan suoritus (tutkinto, oppija, oppilaitos, aika...) | id (numeerinen) | Koski |
| Tutkinto | Tutkinnon kuvaus (tutkintotunnus, nimi...) | tutkintotunnus | Koodisto |
Koski sallii käytön, jos
A CAS-palvelu sallii kirjautumisen käyttäjän syöttämällä käyttäjätunnuksella ja salasanalla, tai B Kosken REST-rajapintoja käytettäessä HTTP-pyynnössä on HTTP Basic Authentication -käyttäjätunnus ja salasana, jotka ovat validit Opintopolun käyttöoikeuspalvelussa.
Käyttäjä kuuluu käyttöoikeusryhmiin, joiden kautta hänelle määräytyvät hänen käyttöoikeutensa (roolit) Koskessa. Käyttäjän käyttöoikeudet haetaan Opintopolun käyttöoikeuspalvelusta. Käyttöoikeudet muodostuvat kolmesta osasta:
- Sovellus: joko KOSKI, LOKALISOINTI tai VALPAS,
- Rooli: kertoo käyttäjäoikeustyypin, ja
- Oid: organisaation oid-tunniste.
Esimerkki arvosta:
KOSKI READ_UPDATE 1.2.246.562.10.48002002061
Tämä määrittää Kosken käyttäjälle luku- ja kirjoitusoikeuden organisaatioon, jonka oid-tunnus on 1.2.246.562.10.48002002061.
Tuetut yhdistelmät sovellus, rooli ja oid -parametreille:
| sovellus | rooli | oid | selite |
|---|---|---|---|
| KOSKI | READ | (organisaation oid) | Organisaatiokohtainen lukuoikeus |
| KOSKI | READ_UPDATE | (organisaation oid) | Organisaatiokohtainen luku- ja kirjoitusoikeus. Kirjoittamiseen tarvitaan aina myös alla oleve LUOTTAMUKSELLINEN-rooli. |
| KOSKI | LUOTTAMUKSELLINEN | (organisaation oid) | Oikeus katsella luottamukselliseksi määriteltyjä tietoja (ks. @SensitiveData -annotaatio). Tämä rooli vaaditaan aina myös tiedon kirjoittamiseen. |
| KOSKI | TIEDONSIIRRON_MITATOINTI | (organisaation oid) | Oikeus mitätöidä myös tiedonsiirron kautta siirrettyjä tietoja (käsin syötettyjen tietojen mitätöintiin riitää READ_UPDATE). |
| KOSKI | TIEDONSIIRTO | (organisaation oid) | Organisaatiokohtainen Kosken API:n palvelukäyttö |
| KOSKI | OPHKATSELIJA | (OPH:n organisaation oid) | Globaali lukuoikeus kaikkiin organisaatioihin, jos oid on OPH:n organisaation oid |
| KOSKI | OPHPAAKAYTTAJA | (OPH:n organisaation oid) | Globaali luku- ja kirjoitusoikeus kaikkiin organisaatioihin, jos oid on OPH:n organisaation oid |
| KOSKI | GLOBAALI_LUKU_PERUSOPETUS | (Viranomaisen organisaation oid) | Globaali lukuoikeus kaikkien organisaatioiden perusopetuksen opiskeluoikeuksiin |
| KOSKI | GLOBAALI_LUKU_TOINEN_ASTE | (Viranomaisen organisaation oid) | Globaali lukuoikeus kaikkien organisaatioiden toisen asteen opiskeluoikeuksiin |
| KOSKI | GLOBAALI_LUKU_KORKEAKOULU | (Viranomaisen organisaation oid) | Globaali lukuoikeus kaikkien organisaatioiden korkeakoulutuksen opiskeluoikeuksiin |
| LOKALISOINTI | CRUD | (OPH:n organisaation oid) | Lokalisointitekstien lukeminen ja muuttaminen Kosken API:n kautta, jos oid on OPH:n organisaation oid |
| VALPAS | OPPILAITOS_HAKEUTUMINEN | (koulutustoimijan tai oppilaitoksen oid) | Oikeus valvoa oppilaitoksen oppijoiden hakeutumista jatko-opintoihin peruskoulun tai nivelvaiheen opintojen jälkeen ja tehdä tarvittaessa ilmoituksia kunnalle |
| VALPAS | OPPILAITOS_HAKEUTUMINEN | (OPH:n organisaation oid) | Oikeus valvoa kaikkien oppilaitosten peruskoulun ja nivelvaiheen oppijoiden hakeutumista |
| VALPAS | OPPILAITOS_SUORITTAMINEN | (koulutustoimijan tai oppilaitoksen oid) | Oikeus valvoa oppilaitoksen oppijoiden oppivelvollisuuden suorittamista nivelvaiheen ja toisen asteen opinnoissa ja tehdä tarvittaessa ilmoituksia kunnalle |
| VALPAS | OPPILAITOS_SUORITTAMINEN | (OPH:n organisaation oid) | Oikeus valvoa kaikkien oppilaitosten oppijoiden oppivelvollisuuden suorittamista |
| VALPAS | OPPILAITOS_MAKSUTTOMUUS | (organisaation oid) | Oikeus hakea tiedot sen päättämiseen, saako oppija suorittaa peruskoulun jälkeisiä opintoja maksuttomasti vai ei |
| VALPAS | KUNTA | (kuntaorganisaation oid) | Oikeus valvoa oppivelvollisia oppijoita oppilaitosten tekemien ilmoitusten tai oppijan henkilötunnuksen tai oppijanumeron perusteella ja hallita oppivelvollisuuden keskeytystietoja |
| VALPAS | KUNTA | (OPH:n organisaation oid) | Kunnan oikeudet kaikkiin kuntiin. |
Lähdekoodissa MockUsers on käyttäjät testitarkoituksia varten. Koski-palvelu käyttää niitä, jos Koski on käynnistetty konfiguraatiolla opintopolku.virkailija.url = "mock" (katso Konfigurointi). Tätä voi käyttää ajaessa Koskea lokaalisti.
Valppaan testikäyttäjistä on tietoa Valppaan käyttöliittymän README.md:ssä.
Nämä ovat keskeiset Koski-järjestelmässä käytettävät teknologiat. Lista kuvaa järjestelmän nykytilaa ja muuttuu matkan varrella tarpeen mukaan.
- PostgreSQL 12.5 -tietokanta
- OpenSearch -hakuindeksi
- Palvelinteknologiat
- Scala 2.12 -ohjelmointikieli ja kääntäjä
- Node.js 18.18.0 -runtime
- Scalatra-web-framework
- Slick-relaatiokantakirjasto
- Flyway-migraatiotyökalu kannan skeeman rakentamiseen ja päivittämiseen kehityksessä ja tuotannossa
- Maven-build-työkalu kehityskäyttöön ja asennettavan paketin rakentamiseen
- Maven-riippuvuuksien lataus Jitpackilla, jolloin voidaan viitata suoraan Github-repoihin, eikä tarvitse itse buildata jar-artifaktoja
- Integraatiot Opintopolku-palveluihin, kuten organisaatio- ja henkilöpalveluun REST-rajapinnoilla, käyttäen http4s-clienttiä
- Web-sovelluksen frontend-teknologiat
- npm-työkalu riippuvuuksien hakuun
- Webpack bundlaukseen
- TypeScript
- React
- Bacon.js
- LESS
- Selainyhteensopivuus IE11-selaimesta moderneihin selaimiin
- Koko järjestelmän buildaus Make-työkalulla, joka delegoi yksittäiset toiminnot eri työkaluille, kuten Maven ja npm
Minimissään tarvitset nämä:
- Git (osx, linux sisältää tämän, komentorivillä
git) - GNU Make (osx, linux sisältää tämän, komentorivillä
make) - JDK 11 (osx:
brew tap homebrew/cask-versionsbrew install temurin11 --cask)- Muista asettaa
JAVA_HOMEviittaamaan äsken asennetun Javan polkuun, että maven ja sbt osaavat käyttää oikeaa versiota.
- Muista asettaa
- Maven 3 (osx:
brew install maven) - Node.js (
.nvmrc-tiedoston mukainen versio) - Docker PostgreSQL:n ja OpenSearchin ajamiseen konteissa
- Tekstieditori (kehitystiimi käyttää IntelliJ IDEA)
Esim. IntelliJ IDEAn Scala-kääntäjän konfiguraatio kannattaa asettaa seuraavasti:
Kosken buildiin kuuluu frontin buildaus (npm ja webpack) ja serverin buildaus Mavenilla. Tätä helpottamaan on otettu käyttöön make, jonka avulla eri taskit on helppo suorittaa. Katso Makefile-tiedosto.
Buildaa koko systeemi
make buildBuildaa frontti, ja päivitä automaattisesti kun tiedostoja muokataan:
make watchStaattinen analyysi (ScalaStyle ja ESLint):
make lintKosken versioitu paketti tehdään kopioimalla versionhallinnassa olevat tiedostot hakemistoon target/dist ja buildaamalla applikaatio uudelleen siellä (dist.sh). War-pakettiin päätyy siis lopulta target/dist/target/webapp-hakemiston sisältö.
Aja JettyLauncher-luokka IDEAsta/Eclipsestä, tai käynnistä Koski vaihtoehtoisesti komentoriviltä
make build
make runAvaa selaimessa http://localhost:7021/koski/virkailija. Selaimeen avautuu login-sivu, josta pääset eteenpäin käyttäjätunnuksella "kalle". Salasana on sama kuin käyttäjätunnus.
Näin ajettuna sovellus käyttää paikallista PostgreSQL-kantaa ja OpenSearch-hakuindeksiä, jotka voi käynnistää docker-composella. Sovellus ei myöskään käytä mitään ulkoisia palveluja. Sillä on siis turvallista leikkiä.
Paikallisesti ajettaessa Jetty lataa resurssit hakemistosta target/webapp, jonka sisältö luodaan webpack-buildilla (webpack.config.js). Webpack-build muun muassa kopioi staattisia resursseja paikoilleen
hakemistosta web/ ja sen alihakemistoista.
Staattisista tiedostoista palvellaan vain web.xml -tiedostossa erikseen määritellyt polut.
Tietyt polut ohjataan palvelemaan etusivun sisältö, ks. ScalatraBootstrap ja IndexServlet.
Raporttien käyttö paikallisesti tarvitsee raportointikannan. Sen saa luotua komentoriviltä
make reset-raportointikantaIlman parametrejä ajettaessa Koski käyttää mockattuja versioita ulkoisista riippuvuuksista.
Ottaaksesi käyttöön ulkoiset integraatiot, kuten Oppijanumerorekisterin, voit antaa Koskelle käynnistysparametrinä käytettävän konfiguraatiotiedoston sijainnin. Esimerkiksi
-Dconfig.resource=qa.conf
Tällä asetuksella käytetään tiedostoa src/main/resources/qa.conf. Tämä tiedosto ei ole versionhallinnassa, koska se sisältää ei-julkista tietoa.
Uudemmat osat Kosken käyttöliittymistä on kirjoitettu Typescriptillä ja niissä hyödynnetään kansiosta web/app/types/fi/oph/koski/ löytyviä tyypityksiä,
jotka on generoitu Kosken tietomallista sekä useista rajapintojen palauttamista tietotyypeistä. Jos teet muutoksia tietomalliin, sinun on ajettava
komento make ts-types päivittääksesi ne. Älä editoi kyseisiä tiedostoja käsin, sillä muutokset menevät hukkaan seuraavan generoinnin myötä.
Jos tietomallin tyypityksistä puuttuu jokin trait tai luokka, jonka tarvitset frontendin puolelle, lisää se TsFileUpdater.scala -tiedostoon ja
aja make ts-types uudelleen. Samoin voit lisätä käyttämiesi rajapintojen palauttamat tietotyypit samaan tiedostoon.
Kehityskäyttöön tarvitaan PostgreSQL-tietokanta ja OpenSearch-hakuindeksi.
Kehitystietokannat käynnistetään docker-composella. Tämän voi tehdä seuraavalla komennolla:
make docker-dbsKehityksessä käytetään kolmea kantaa: koski, valpas ja raportointikanta.
Näiden lisäksi automaattisissa testeissä käytetään vastaavia koski_test,
valpas_test ja raportointikanta_test kantoja, jotka tyhjennetään aina
testiajon alussa.
Jos haluat tarkastella paikallisen kehityskannan tilaa SQL-työkalulla, se onnistuu esimerkiksi Postgren omalla komentorivityökalulla psql:
psql -h localhost koski oph
psql -h localhost koski_test ophPeruskomennot:
\dt- listaa taulut\q- poistu psql:stä
Näytä arviointi-taulun koko sisältö:
select * from arviointi;Tietokannan rakenne luodaan ja päivitetään Flywayn migraatioskripteillä, jotka ovat hakemistossa src/main/resources/db/migration.
Koski-sovellus ajaa migraatiot automaattisesti käynnistyessään.
OpenSearch-hakuindeksejä voidaan hallita Kosken API:n kautta. API sallii kutsut ainoastaan localhostista, joten pilviympäristöjen hallintaa varten on palvelimille konfiguroitava pääsy SSH:lla.
API tarjoaa seuraavat toiminnot:
- Indeksin luonti versioidulla nimellä koodissa määritellyn mappingin ja asetusten pohjalta
- Luku- ja kirjoitusaliasten luonti tai siirto indeksiversiosta toiseen
- Reindeksointi haluttujen versioiden välillä
- Indeksin koko sisällön uudelleenlataus lähdedatasta (reload)
Esimerkki kuvaa tilannetta jossa indeksin mappingia tai asetuksia halutaan päivittää katkottomasti.
Uuden perustiedot-indeksin luonti versiota 2 vastaavalla nimellä:
curl -N -u 'käyttäjätunnus:salasana' -X POST 'localhost:8080/koski/api/test/opensearch/perustiedot/create/2'
Kirjoitusaliaksen siirto versiosta 1 versioon 2:
curl -N -u 'käyttäjätunnus:salasana' -X POST 'localhost:8080/koski/api/test/opensearch/perustiedot/migrateAlias/write/1/2'
Reindeksointi versiosta 1 versioon 2:
curl -N -u 'käyttäjätunnus:salasana' -X POST 'localhost:8080/koski/api/test/opensearch/perustiedot/reindex/1/2'
Huomaa, että reindeksointi jää käyntiin taustalle. Tietoja sen edistymisestä kirjoitetaan Kosken lokiin INFO-tasolla. Prosessia voi seurata myös OpenSearchin task-apin avulla.
Kun reindeksointi on valmis, lukualiaksen siirto versiosta 1 versioon 2:
curl -N -u 'käyttäjätunnus:salasana' -X POST 'localhost:8080/koski/api/test/opensearch/perustiedot/migrateAlias/read/1/2'
Kosken indeksinhallinta-apin lisäksi ainakin OpenSearchin /_cat/indices?v
ja /_cat/aliases?v apit voivat olla avuksi:
curl 'https://vpc-koski-opensearch-h2qymngshxuiefd5lzmlpnpp5u.eu-west-1.es.amazonaws.com/_cat/indices?v'
Buildaa ja aja kaikki testit
make testKun applikaatio pyörii paikallisesti (katso ohjeet yllä), voi Mocha-testit ajaa selaimessa.
Mocha-testit voi ajaa myös nopeasti komentoriviltä:
make fronttestIntegraatiotestejä varten pitää Koski-backendin olla pystyssä (oletuksena localhost:7021) tai testit pitää käynnistää ajamalla KoskiFrontSpec.scala.
Jos backend on valmiiksi ajossa, voi testit ajaa komennolla npm run playwright:test.
Testit ajetaan headless-selaimessa. Jos haluat selainikkunan näkyviin, aja testit komennolla npm run playwright:test:debug
Koskessa on käytössä Github Actions, joka on konfiguroitu .github hakemistossa.
CI-palvelimella sovellus testataan jokaisen commitin yhteydessä. Paikallisten testien lisäksi ajetaan pieni määrä integraatiotestejä testiympäristön REST-rajapintoja vasten.
Myös staattinen analyysi ScalaStyle ja ESLint -työkaluilla ajetaan joka commitille.
Suorituskykytestit ajetaan joka aamuyö.
Integraatiotestit jätetään ajamatta, jos commit-viestissä on teksti [skip-tests]. Tämä ominaisuus on tarkoitettu kiireisten hotfixien viemiseen suoraan master-haaraan.
Github Actions asentaa kehitys- ja testiympäristöön automaattisesti kaikki master haaraan tulleet muutokset. Tuotantoasennus tapahtuu hyväksymällä tuotantoasennus Github Actionsin käyttöliittymästä. Lisäksi kaikkiin ympäristöihin voi viedä muutokset käyttämällä Github Actionsista löytyvää deploy jobia, joka vie annetun commit hashin mukaisen version valittuun ympäristöön.
Koski merkitsee tapahtumia erillisiin logitiedostoihin:
koski-audit.logeli Audit-logi sisältää kaikki tärkeät käyttäjätapahtumat, kuten login, tietojen haut hakuehtoineen, tietojen katselu, lisäys ja muokkaus. Logista ilmenee aina käyttäjän OID ja IP-osoite.koski-access.logeli Access-logi sisältää kaikki palvelimen käsittelemät HTTP-pyynnöt polkuineen, paluukoodeineen ja käsittelyaikoineen.koski-performance.logeli performanssilogi sisältää krittisten operaatioiden kuten tietokantakyselyiden ja rajapintakutsujen käsittelyaikoja.koski-ip-tracking.logeli IP-seurantalogi sisältää tiedonsiirtoon oikeutettujen käyttäjien IP-osoitteiden muutokset.koski.logeli "sovelluslogi" sisältää kehitys- ja diagnostiikkatietoa, kuten kaikki virheilmoitukset.
Kaikkien logien tapahtumat siirretään testiympäristön palvelimilta Filebeat-agentilla OpenSearch -tietokantaan, josta ne ovat katseltavissa Kibana-käyttöliittymän avulla.
Loggaus on konfiguroitu tiedostolla log4j2.xml, joka määrittää loggauksen kehitysympäristössä (tuotanto- ja kehitysympäristöjen lokitus määritellään docker-build -kansiossa konfiguraatiotiedostoilla). Tämän konfiguraatiotiedoston avulla määritellään esimerkiksi se, mitä logataan mihin tiedostoon. Kuten konfiguraatiotiedostosta ilmenee, tapahtuu access-loggaus ohjaamalla Jettyn RequestLog-luokan logitus koski-access.log -tiedostoon. Vastaavasti fi.vm.sade.auditlog.Audit-luokan loggaus ohjataan tiedostoon koski-audit.log, fi.oph.koski.tiedonsiirto.IPTracking-luokan loggaus tiedostoon koski-ip-tracking.log ja fi.oph.koski.util.Timer -luokan loggaus tiedostoon koski-performance.log. Kaikki muut logit menevät tiedostoon koski.log.
Koski-sovelluskoodissa audit-loggaus tehdään AuditLog-luokan kautta ja sovellusloggaus käyttäen Logging-luokkaa, jolta sovelluskoodi saa käyttöönsä loggerin, joka automaattisesti liittää logiviesteihin käyttäjä- ja IP-osoitetiedot.
| Kuvaus | URL | Muuta |
|---|---|---|
| Koski | hallinta-ui api pulssi-ui | |
| Valpas | palvelukuvaus käyttöliittymä UI-toteutus | Kosken yhteyteen toteutettu oppivelvollisuuden valvontapalvelu. |
| CAS | palvelukortti | Käyttäjän autentikointi Koskeen ja muihin OPH:n palveluihin. |
| Lokalisointipalvelu | palvelukortti | Palveluiden käyttöliittymien käännöksien hallinta. |
| ePerusteet | palvelukortti api api-dokumentaatio ui | ePerusteet-palvelu |
| Suoritusrekisteri | palvelukortti api | Suoritusrekisteri, jonka kautta Valpas hakee tietoja opiskelijahauista ja valinnoista |
Yleiskäyttöisten palveluiden dokumentaatio löytyy OPH yleiskäyttöiset palvelut wikisivulta, minkä kautta löytyvät myös API-linkit.
| Kuvaus | Muuta |
|---|---|
| Oppijanumerorekisteri | Oppijan haku oid:lla tai hetulla. Uuden oppijan luonti. |
| Käyttöoikeuspalvelu | Käyttäjän käyttöoikeusryhmien haku. |
| Organisaatiopalvelu | Organisaation tai -hierarkian haku. |
| Koodistopalvelu | Koodien ja metatietojen haku ja luonti. |
| Kuvaus | URL | Yhteystiedot |
|---|---|---|
| CSC Virta | kuvaus api-dokumentaatio | virta@csc.fi, Slack |
| Ylioppilastutkintorekisteri (YTR) | 0295 338 200, lautakunta@ylioppilastutkinto.fi, henkilökunta, Slack |
Sovelluksen asennus on rakennettu CI putkeen ja tapahtuu automaattisesti dev ja qa ympäristöihin masteriin tulevista muutoksista. Tarkempi kuvaus löytyy infra reposta.
Sovellus käyttää konfigurointiin Typesafe Config -kirjastoa. Sovelluksen oletusasetukset ovat tiedostossa reference.conf. Kun sovellus käynnistetään ilman ulkoisia parametrejä, käynnistyy se näillä asetuksilla ja toimii "kehitysmoodissa", eli käynnistää paikallisen tietokannan, eikä ota yhteyttä ulkoisiin järjestelmiin.
Tuotantokäytössä ja testiympäristössä käytetään asetuksia, joilla Koski saadaan ottamaan yhteys ulkoisiin järjestelmiin. Pilviympäristössä käytössä on AWS:n AppConfig.
Kehityskäytössä voit käyttää erilaisia asetuksia tekemällä asetustiedostoja, kuten vaikkapa src/main/resources/koskidev.conf (ei versionhallinnassa, koska sisältää luottamuksellista tietoa) ja antaa käytettävän tiedoston nimi käynnistysparametrina, esim. -Dconfig.resource=koskidev.conf. Valmiita asetustiedostoja voi pyytää kehitystiimiltä.
Koski ei tallenna henkilötietoja omaan tietokantaansa, vaan hakee ja tallentaa ne Opintopolun oppijanumerorekisteriin (toteutus).
Kun käyttäjä hakee henkilön tietoja esimerkiksi sukunimellä, hakee Koski listan mahdollisista henkilöistä ensin oppinumerorekisteristä, jonka jälkeen Koski suodattaa hakutuloksen Koskessa olevien opinto-oikeuksien perusteella (toteutus).
Käyttäjä voi nähdä vain ne opinto-oikeudet, jotka liittyvät oppilaitokseen, johon hänellä on käyttöoikeus. Koski hakee henkilön organisaatioliitokset organisaatiopalvelusta ja käyttöoikeudet käyttöoikeuspalvelusta.
Esimerkki organisaatiohierarkian hakemisesta:
curl -X GET --header 'Accept: application/json' 'https://virkailija.testiopintopolku.fi/organisaatio-service/rest/organisaatio/v2/hierarkia/hae?aktiiviset=true&suunnitellut=true&lakkautetut=false&oid=1.2.246.562.10.50822930082'Koski käyttää Koodistopalvelua mm. tutkintoihin liittyvien arviointiasteikkojen hakemiseen.
Testiurleja (api):
Koski osaa tarvittaessa luoda käytettävät koodistot ja koodistopalveluun. Käynnistä parametrillä -Dkoodisto.create=true.
Tällä hetkellä Koskeen voi tallentaa vain ePerusteista löytyvien tutkintojen tietoja. Opiskeluoikeutta lisättäessa lista mahdollisista tutkinnoista haetaan ePerusteista ja opiskeluoikeuden (toteutus) sisältämään tutkinto-osioon tallennetaan tieto ePerusteet-linkityksestä.
ePerusteista haetaan myös tutkinnon hierarkkinen rakenne (toteutus), joka kuvaa, mistä tutkinnon osista tutkinto koostuu.
Integraation toteutus.
Testiurleja (api):
https://eperusteet.opintopolku.fi/eperusteet-service/api/external/peruste/1013059
Koski osaa hakea oppijoiden tietoja kahdesta ulkoisesta järjestelmästä: CSC:n Virrasta (api-dokumentaatio) ja Ylioppilastutkintorekisteristä (YTR).
Koski-järjestelmän rajapinta-dokumentaatio generoidaan lähdekoodista sekä testidatasta.
JSON-scheman visualisointiin on käytetty json-schema-viewer nimistä kirjastoa, johon on tehty joitakin Koski-projektin vaatimia muutoksia.