Tässä dokumentissa on kuvattu tavanomaisimpia virhetilanteita joita KOSKI-tiedonsiirroissa on esiintynyt.
1. Ei oikeutta organisaatioon
- KOSKI-palveluun yritetään viedä opiskeluoikeutta organisaatioon johon siirroissa käytettävällä tunnuksella ei ole oikeutta
- Esimerkki:
"Ei oikeuksia organisatioon 1.2.246.562.10.87603128528" - Korjaus: Mikäli tiedonsiirto-oikeudet tulisi olla organisaatioon, ottakaa yhteys KOSKI-tukeen: koski[a]opintopolku.fi
2. Suoritus on merkitty tilaan VALMIS, vaikka siltä puuttuu pakollisia tietoja
- Esimerkkejä:
"Suoritukselta koskioppiaineetyleissivistava/KS puuttuu arviointi, vaikka suorituksen tila on VALMIS"
"Suorituksella koulutus/999901 on keskeneräinen osasuoritus tutkinnonosat/300002 vaikka suorituksen tila on VALMIS"
"Suorituksella koskioppiaineetyleissivistava/KE on keskeneräinen osasuoritus lukionkurssit/KE2 vaikka suorituksen tila on VALMIS" - Korjaus: Lisätään/korjataan puuttuvat tiedot
3. Virheellinen diaarinumeroviittaus perusteisiin
- Esimerkki:
"Tutkinnon perustetta ei löydy diaarinumerolla 11/011/2016" - Korjaus: Varmistetaan että diaarinumero on oikein. Mikäli numero on mielestänne oikein, ottakaa yhteys KOSKI-tukeen: koski[a]opintopolku.fi
4. Ammatillisen suorituksen arviointi- tai vahvistuspäivämäärä on tulevaisuudessa
- Esimerkkejä:
"Päivämäärä suoritus.arviointi.päivä (2017-12-31) on tulevaisuudessa"
"Päivämäärä suoritus.vahvistus.päivä (2017-12-31) on tulevaisuudessa" - Korjaus: Tiedot siirretään KOSKI-palveluun kun arviointi ja sen vahvistus on tehty, ei etukäteen
5. Siirtotiedosto on rakenteellisesti virheellinen, "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 koodistoUri
- Esimerkki, puuttuva pakollinen kenttä:
"message": [ { "path": "opiskeluoikeudet.0.suoritukset.0.osasuoritukset.0.koulutusmoduuli.kieli", "error": { "errorType": "missingProperty" } }
- Korjaus: Lisää kieli-tieto suoritukselle
- Joissain tilanteissa tilannetta ei pystytä korjaamaan oppilaitoksessa, olkaa tällöin yhteydessä opintohallintojärjestelmätoimittajaanne ja tarvittaessa KOSKI-tukeen koski[a]opintopolku.fi