Tälle sivulle kerätään kuvaukset tyypillisimmistä virheistä KOSKI-tiedonsiirroissa. Jos et löydä virhettä tältä sivulta tai et pysty päättelemään sitä KOSKI-tietomallista, ota yhteyttä opintohallintojärjestelmätoimittajaasi ja/tai KOSKI-palveluosoitteeseen (koski(at)opintopolku.fi).
1. Ei oikeutta organisaatioon
- KOSKI-palveluun yritetään viedä opiskeluoikeutta organisaatioon johon siirroissa käytettävällä tunnuksella ei ole oikeuttaEsimerkki:
"Ei oikeuksia organisatioon 1.2.246.562.10.87603128528"
- Korjaus: Mikäli tiedonsiirto-oikeudet tulisi olla organisaatioon, ottakaa yhteys KOSKI-palveluosoitteeseen: koski[at]opintopolku.fi
2. Virheellinen diaarinumeroviittaus perusteisiin tai puuttuu kokonaan
- Opiskeluoikeuden pääsuorituksen tasolla perusteen diaarinumero on pakollinen tieto kaikilla koulutusmuodoilla, joten diaarinumeron puuttuessa tai sen ollessa virheellinen, tulee virheilmoitus.
- Ammatillisen tutkinnon osan suorituksella diaarinumero ja tutkintotieto välitetään vain jos tutkinnon osa on toisesta tutkinnosta, joten jos tutkinnon osan tiedoissa tulee sama diaarinumero kuin päätason suorituksella, tulee virheilmoitus.
- Esimerkki:
"Tutkinnon perustetta ei löydy diaarinumerolla 11/011/2016"
- Korjaus: Varmistetaan että diaarinumero on oikein. Mikäli numero on mielestänne oikein ja saatte edelleen virheviestin, ottakaa yhteys KOSKI-palveluosoiteeseen: koski[at]opintopolku.fi
3. Siirtotiedosto on rakenteellisesti virheellinen (esimerkiksi "viesti ei ole skeeman mukainen", "badRequest.validation.jsonSchema")
- Johtuu tilanteesta, jossa opintohallintojärjestelmän muodostama tiedonsiirtotiedosto on rakenteeltaan viallinen. Kyseessä voi olla esimerkiksi puuttuva pakollinen kenttä tai väärä koodiarvo.
- Esimerkki, väärä koodiarvo:
"message": "Koodia lukionkurssit/VEB31 ei löydy koodistosta",
"errorType": "tuntematonKoodi"
},
"value": {
"koodiarvo": "VEB31",
"koodistoUri": "lukionkurssit"
- Korjaus: Tarkista oikea koodi tai koodistoUri
- Esimerkki (virhe perusopetuksen vuosiluokan tietojen siirrossa), puuttuva pakollinen kenttä:
"message": [
{ "path": "opiskeluoikeudet.0.suoritukset.0.osasuoritukset.0.koulutusmoduuli.kieli",
"error": {
"errorType": "missingProperty"
}
}
- Korjaus: Mikäli perusopetuksen oppiaine on "äidinkieli ja kirjallisuus" tai "vieras tai toinen kotimainen kieli", on kieli-tieto pakollinen
- Unwanted property esimerkki tähän
Joissain tilanteissa tilannetta ei pystytä korjaamaan oppilaitoksessa, olkaa tällöin yhteydessä opintohallintojärjestelmätoimittajaanne ja tarvittaessa KOSKI-tukeen koski[a]opintopolku.fi Esimerkki (virhe perusopetuksen vuosiluokan tietojen siirrossa), puuttuva pakollinen kenttä :
4. Kirjautumisongelma ("unauthorized.notAuthenticated", "unauthorized.loginFail")
- Integraatiotunnus tai salasana on väärin
- esimerkki: 401 unauthorized.loginFail, message: Sisäänkirjautuminen epäonnistui)
- esimerkki: 401 unauthorized.loginFail, message: Sisäänkirjautuminen epäonnistui)
- Integraatiotunnus on syötetty väärään kohtaan
- esimerkki: Yhteysvirhe 401 Unauthorized unauthorized.notAuthenticated, message: Käyttäjä ei ole tunnistautunut.