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).
Kaikki virhekoodit ja niiden selitteet löytyvät myös KOSKI-palvelun dokumentaatiosivulta sisään tulevan tiedonsiirtorajapinnan kuvauksesta. Katson tarkemmin ohjeet virhekoodien selitteiden löytämiseksi ohjeen Dokumentaatio-sivu kohdasta "3. REST-rajapinnat".
1. Ei oikeutta organisaatioon
- KOSKI-palveluun yritetään viedä opiskeluoikeutta organisaatioon johon siirroissa käytettävällä tunnuksella ei ole oikeutta
- KOSKI-palvelussa on käyttökatko
- 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
- KOSKI-palvelun suunnitelluista käyttökatkoista tiedotetaan etukäteen, ennakoimista käyttökatkoista lähetetään häiriötiedote. Käyttökatkot on listattu sivulle: KOSKI katko- ja vikailmoitukset
Kun käyttökatko on ohi, tiedonsiirrot onnistuvat normaalista.
2. Sisäänkirjautuminen epäonnistui ("unauthorized.notAuthenticated", "unauthorized.loginFail")
- KOSKI-palvelukäyttäjätunnus tai salasana on väärin opintohallintojärjestelmässä:
401 unauthorized.loginFail, message: "Sisäänkirjautuminen epäonnistui, väärä käyttäjätunnus tai salasana."
- Korjaus: Tallennetaan opintohallintojärjestelmään oikea integraatiotunnus ja -salasana.
- KOSKI-palvelukäyttäjätunnus on syötetty väärään kohtaan opintohallintojärjestelmässä:
401 unauthorized.loginFail, message: "Sisäänkirjautuminen epäonnistui, väärä käyttäjätunnus tai salasana."
- Korjaus: Tallennetaan integraatiotunnus oikeaan paikkaan.
- Korjaus: Tallennetaan integraatiotunnus oikeaan paikkaan.
- KOSKI-palvelukäyttäjätunnus on vanhentunut:
401 unauthorized.loginFail, message: "Sisäänkirjautuminen epäonnistui, väärä käyttäjätunnus tai salasana."
- Korjaus: Vanhentunut KOSKI-palvelukäyttäjätunnus on mennyt lukkoon liian monen automaattisen kirjautumisyrityksen seurauksena. Vanhentunutta tunnusta ei voida enää uusia,
vaan koulutustoimijan vastuukäyttäjän on luotava uusi KOSKI-palvelukäyttäjätunnus virkailijan opintopolussa.
Ohjeet tunnuksen luontiin löytyvät: KOSKI-palveluun liittyvä käyttäjähallinta kohdasta "2. Myönnettävät roolit ja niiden kuvaukset, a) KOSKI-palvelukäyttäjä".
Palvelukäyttäjätunnuksen luonnin jälkeen uusi tunnus ja salasana asetetaan opintohallintojärjestelmään niille varattuihin kenttiin ja tehdään siirto uudestaan.
- Korjaus: Vanhentunut KOSKI-palvelukäyttäjätunnus on mennyt lukkoon liian monen automaattisen kirjautumisyrityksen seurauksena. Vanhentunutta tunnusta ei voida enää uusia,
3. 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
4. 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 (virhe perusopetuksen opiskeluoikeuden lisätiedoissa), välitetty rakenne "pidennettyOppivelvollisuus" ilman aloituspäivämäärää:
"message": [ { "path": "opiskeluoikeudet.0
.lisätiedot.pidennettyOppivelvollisuus.alku",
"error": {
"errorType": "missingProperty"} } ]
- Korjaus: Lisätään pidennetyn oppivelvollisuuden aloituspäivä. Mikäli oppilaalla ei ole pidennettyä oppivelvollsuutta, ei tule välittää lainkaan rakennetta "pidennettyOppivelvollisuus",
- Esimerkki, jokin osio sisältää kentän tai jonkun muun elementin, jota siellä ei pitäisi olla:
"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")
- Esimerkkki, integraatiotunnus tai salasana on väärin:
401 unauthorized.loginFail, message: Sisäänkirjautuminen epäonnistui
- Korjaus: Tallennetaan opintohallintojärjestelmään oikea integraatiotunnus ja -salasana.
- Esimerkkki, integraatiotunnus on syötetty väärään kohtaan:
401 unauthorized.loginFail, message: Sisäänkirjautuminen epäonnistui
- Korjaus: Tallennetaan integraatiotunnus oikeaan paikkaan.