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 oikeutta
- Esimerkki:
Ei oikeuksia organisaatioon 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, väärä diaarinumero:
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
- Esimerkki, tutkinnon osan tiedoissa tulee sama diaarinumero kuin päätason suorituksella :
Tutkinnon osalle tutkinnonosat/100168 on merkitty tutkinto, jossa on sama tutkintokoodi koulutus/381304 kuin tutkinnon suorituksessa
- Korjaus: Poistetaan tutkinnon osalta diaarinumero
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": [
{
"path": "opiskeluoikeudet.0.suoritukset.0.osasuoritukset.0.osasuoritukset.1.koulutusmoduuli.tunniste",
"value": {
"koodiarvo": "VEB31",
"koodistoUri": "lukionkurssit"
},
"error": {
"message": "Koodia lukionkurssit/VEB31 ei löydy koodistosta",
"errorType": "tuntematonKoodi"
}
}
]
- 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", lisätään tieto oppiaineessa opiskeltavasta kielestä
- Esimerkki, jokin osio sisältää kentän tai jonkun muun elementin, jota siellä ei pitäisi olla:
{
"key": "badRequest.validation.jsonSchema",
"message": [
{
"path": "opiskeluoikeudet.0.pakollinen",
"value": false,
"error": {
"errorType": "unexpectedProperty"
}
}
]
- Korjaus: Poistetaan osioon kuulumaton kenttä tai muu elementti.
Joissain tilanteissa tilannetta ei pystytä korjaamaan oppilaitoksessa, olkaa tällöin yhteydessä opintohallintojärjestelmätoimittajaanne ja tarvittaessa KOSKI-palveluosoitteeseen (koski(at)opintopolku.fi).
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.