Tyypillisiä virheitä KOSKI-tiedonsiirroissa

1. Ei oikeuksia organisaatioon

• KOSKI-palveluun yritetään viedä opiskeluoikeutta organisaatioon johon siirroissa käytettävällä tunnuksella ei ole oikeutta
• KOSKI-palvelussa on käyttökatko
• Yritetään siirtää ostopalveluna tai palvelusetelillä järjestettyä esiopetusta muuhun organisaatioon kuin koulutustoimijan omaan varhaiskasvatustoimipaikkaan
• 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 vikailmoituksetKun käyttökatko on ohi, tiedonsiirrot onnistuvat normaalista.
  • Mikäli yritetään siirtää ostopalveluna tai palvelusetelillä järjestettyä esiopetusta muuhun organisaatioon kuin koulutustoimijan omaan varhaiskasvatustoimipaikkaan, tulee varmistua että opintohallintojärjestelmään/varhaiskasvatusjärjestelmään on merkitty tieto ostopalvelusta tai palvelusetelistä sekä varmistuttu että oma järjestelmätoimittaja on mahdollistanut tiedonsiirron. Asiasta kannattaa olla ensisijaisesti yhteydessä omaan opintohallintojärjestelmän toimittajaan.

2. Sisäänkirjautuminen epäonnistui ("unauthorized.notAuthenticated", "unauthorized.loginFail", "Sisäänkirjautuminen epäonnistui, väärä käyttäjätunnus tai salasana.")

• 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.
    
    
• KOSKI-palvelukäyttäjätunnus on vanhentunut:

  401 unauthorized.loginFail, message: "Sisäänkirjautuminen epäonnistui, väärä käyttäjätunnus tai salasana."

• • Korjaus: Opintohallintojärjestelmään asetettava tunnus on vanhentunut. 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.

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. Diaarinumerot voi tarkistaa ePerusteet palvelusta (ePerusteet.opintopolku.fi)
    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).

5. Koulutuksenjärjestäjä yrittää siirtää opiskeluoikeutta joka on mitätöity tai se kuuluu toiselle koulutuksenjärjestäjälle ("Opiskeluoikeutta ei löydy tai käyttäjälle ei ole oikeutta sen katseluun")

• Koulutuksenjärjestäjä yrittää siirtää opiskeluoikeutta joka on mitätöity KOSKI-palvelusta tai opiskeluoikeus kuuluu toiselle koulutuksenjärjestäjälle.
  

  KOSKI-järjestelmän palauttama virheilmoitus: Opiskeluoikeutta 1.2.246.562.15.00000000000 ei löydy tai käyttäjällä ei ole oikeutta sen katseluun:
  {"key":"notFound.opiskeluoikeuttaEiLöydyTaiEiOikeuksia",
  "message":"Opiskeluoikeutta 1.2.246.562.15.00000000000 ei löydy tai käyttäjällä ei ole oikeutta sen katseluun"}

• Esimerkki: Koulutuksenjärjestäjä on siirtänyt opiskeluoikeuden KOSKI-palveluun niin, että yksilöivät tiedot (esim. opiskeluoikeuden tyyppi: Lukion oppimäärä vs. Luva) ovat väärin. Koulutuksenjärjestäjä mitätöi opiskeluoikeuden KOSKI-palvelusta joko suoraan KOSKI-käyttöliittymästä tai opintohallintojärjestelmän kautta. Koulutuksenjärjestäjä yrittää siirtää korjattuja tietoja uudestaan KOSKI-palveluun. KOSKI palauttaa virheilmoituksen
• Korjaus: Opintohallintojärjestelmästä pitää tyhjentää kenttä, johon KOSKI-palvelu on palauttanut alkuperäiden opiskeluoikeuden OID:n. Opiskeluoikeuden OID (opiskeluoikeuden tunniste) on muotoa 1.2.246.562.15.00000000000. Kun kenttä on tyhjennetty, siirretään tiedot uudestaan KOSKI-palveluun. KOSKI luo uuden opiskeluoikeuden ja palauttaa opintohallintojärjestelmään uuden numerosarjan.
  
  
• Esimerkki: Oppilaitoksen  opintohallintojärjestelmässä on lähetetty opiskeluoikeuden tietoja koulutuksenjärjestäjältä toiselle. Koulutuksenjärjestäjät eivät kuulu samaan organisaatioon tai oppilaitoksen tiedonsiirtoihin tarvittava palvelukäyttäjätunnus on tehty oppilaitoskohtaisesti.
• Korjaus: 
• Jos oppilaitos on saanut opiskeluoikeuden tiedot sellaiselta oppilaitokselta, joka kuuluu eri koulutuksenjärjestäjän alaisuuteen (esim. eri kunta / yksityinen toimija) tai oppilas vaihtaa eri opiskeluoikeuden tyypistä toiseen (esim. esiopetus/perusopetus/perusopetuksen lisäopetus/lukio) tai opiskeluoikeus on päätetty saman koulutustoimijan alaisessa edellisessä oppilaitoksessa tilaan eronnut, tulee koulutuksenjärjestäjän luoda uusi opiskeluoikeus KOSKI-palveluun. →  Opintohallintojärjestelmästä pitää tyhjentää kenttä, johon KOSKI-palvelu on palauttanut alkuperäiden opiskeluoikeuden OID:n. Opiskeluoikeuden OID (opiskeluoikeuden tunniste) on muotoa 1.2.246.562.15.00000000000. Kun kenttä on tyhjennetty, siirretään tiedot uudestaan KOSKI-palveluun. KOSKI luo uuden opiskeluoikeuden ja palauttaa opintohallintojärjestelmään uuden numerosarjan.
• Jos oppilaitos on saanut opiskeluoikeuden tiedot sellaiselta oppilaitokselta, joka kuuluu saman koulutuksenjärjestäjän alaisuuteen (sama kunta), oppilas jatkaa saman koulutusasteen opintoja (perusopetuksen vuosiluokalta vaihto) ja koulutuksenjärjestäjä haluaa jatkaa samalla opiskeluoikeudella KOSKI-palvelussa. → Tiedonsiirtovirheen korjaaminen vaatii muutoksia KOSKI-palvelukäyttäjätunnuksen oikeuksiin. Ole yhteydessä KOSKI-tiimin palveluosoitteeseen.