Hur man korrigerar fel i uppgiftsöverföringarna (på svenska)

Tälle sivulle on koottu Vardan tiedonsiirtojen yleisimpiä virheitä, niiden kuvaukset sekä korjaustavat. Kaikki Vardan virheviestit löydät täältä.

HUOM! Kun tiedot tuodaan Vardaan integraatiolla tulee tarvittavat korjaukset tehdä omassa lähdejärjestelmässä. Tiedonsiirron ongelmissa on hyvä olla ensisijaisesti yhteydessä omaan järjestelmätoimittajaan.

Tutustu Tiedonsiirrot -raportin kuvalliseen käyttöohjeeseen täällä. Tiedonsiirrot-raportti on käytettävissäsi Varda-pääkäyttäjän käyttöoikeudella.

Virhekoodi	Virheen kuvaus	Milloin virhe syntyy?	Korjaus/esimerkki
MI013	Tällä lähdejärjestelmä ja tunniste -parilla löytyy jo objekti. Tarkista, että syötetyn tiedon lähdejärjestelmän tuottama tunniste on uniikki.	Lähdejärjestelmätunnistetta voi käyttää Vardassa Varda-IDn tai oppijanumeron tavoin tieto-objektin yksilöimiseen. Tämä virhe syntyy, kun uutta tietoa yritetään luoda jo käytössä olevalla lähdejärjestelmätunnisteella.	Esim. työntekijän lähdejärjestelmätunnisteen pitää olla uniikki per tallentava lähdejärjestelmä. Samaa tunnistetta voi kyllä käyttää kunhan lähdejärjestelmä on eri, mutta saman lähdejärjestelmän sisällä ei voi käyttää eri vaka-järjestäjillä samaa työntekijän lähdejärjestelmätunnistetta, vaan tunnisteen pitää olla uniikki lähdejärjestelmässä. Virhe on hyvä selvittää järjestelmätoimittajan kanssa, sillä kyseessä on lähdejärjestelmätason virhe.
MI015	Kohdetta ei löydy.	Yleisimpiä tiedonsiirron virheitä. Virhe syntyy, kun haetaan tietoja, joihin ei ole oikeutta tai tietoa, jota ei ole olemassa.	Tarkasta tiedonsiirrossa käytetyt tunnisteet ja niiden oikeellisuus. Virhe voi näyttää Tiedonsiirrot -raportilla esimerkiksi seuraavalta: eli toimipaikkaa ei ole Vardassa tai toimipaikkaan ei ole oikeutta (toimipaikka on esimerkiksi toisen varhaiskasvatustoimijan).
MI007	Organisaatio-OIDin tai oppijanumero-OIDin muoto on virheellinen.	Virhe syntyy, kun tietokentän (organisaatio-OID/oppijanumero-OID) sisältö on virheellinen.	Tarkasta organisaatio-OID/oppijanumeron muoto, esim. mahdolliset ylimääräiset/puuttuvat välilyönnit tai merkit.
1) GE008 2) RF003	1) Epäkelpo hyperlinkki, objektia ei löydy. 2) Vastaavaa objektia ei löydy.	GE008 ja RF003 -virheet ovat samantyyppisiä virheitä. Vardassa on mahdollista viitata objekteihin ID:llä tai sitten OID:n tai tunnisteen avulla, esim. lasta luodessa rajapintakutsu voi näyttää suunnilleen tältä: `{ "henkilo": "/api/v1/henkilot/1/", "henkilo_oid": "1.24....", ... }` GE008 viittaa siihen, että tällasta henkilöä ei löydy tai käyttäjällä ei ole henkilöön oikeuksia. RF003 taas kertoo siitä, että on käytetty henkilo_oid-kenttää ja sitäkään kautta ei ole löytynyt henkilöä tai henkilöön ei ole oikeuksia. Käytännössä molemmat siis tarkoittavat sitä, että on yritetty viitata johonkin objektiin, jota ei ole olemassa tai siihen ei ole käyttäjällä oikeuksia. Objekti voi olla henkilö, lapsi, varhaiskasvatuksenjärjestäjä, toimipaikka, varhaiskasvatuspäätös jne.	Varmista, että rajapintakutsussa on viitattu siihen objektiin, johon on tarkoitettu. Tarkasta viitatun objektin ID:n/OID:n/tunnisteen oikeellisuus ja että kyseinen objekti, johon on viitattu löytyy Vardasta.
MA003	Väestötietojärjestelmästä ei löydy lapsen ilmoitettua huoltajaa.	Virhe syntyy, mikäli Varda ei saa haettua Oppijanumerorekisterin kautta VTJ:sta tulevaa tietoa lapsen huoltajasta/huoltajista.	Lapsen tiedot on tallennettu Vardaan samana päivänä kuin huoltaja- ja maksutietoja on yritetty tallentaa. Varda hakee huoltajatiedot lapselle vuorokauden viiveellä. Tallenna maksutieto aikaisintaan seuraavana päivänä lapsen tietojen tallentamisesta. Lapsen tiedoissa on virhe, jonka vuoksi hän ei ole yksilöitynyt, joten lapselle ei ole voitu hakea huoltajatietoja. Ole yhteydessä Vardan asiakaspalveluun varda@opintopolku.fi Varda hakee tiedon huoltajista Oppijanumerorekisterin kautta, joka saa tietonsa VTJ:sta. Joskus näiden kahden järjestelmän välisessä tietojen päivittymisessä on ongelmaa. Ole yhteydessä Vardan asiakaspalveluun varda@opintopolku.fi, niin päivitämme lapsen huoltajatiedot tarvittaessa. Kyseessä ei ole lapsen virallinen huoltaja. Lapsi on tallennettu oppijanumerolla Vardaan, jolloin lapselle ei voida hakea huoltajatietoja. Maksutietoa ei voida tallentaa.
PE006	Käyttöoikeudet eivät riitä.	Virhe syntyy, jos toimenpiteen tekemiseksi ei ole tarvittavia käyttöoikeuksia.	Tarkista, että palvelukäyttäjälle on myönnetty siirrettävään tietokokonaisuuteen liittyvät käyttöoikeudet. Jos virhe tulee PAOS-tietoihin liittyen: tarkista, että Vardan PAOS-hallinnassa on tehty molemminpuolinen linkitys. Jos linkitystä ei ole tai vain toinen osapuoli on tehnyt sen, tietoja ei voi tallentaa. Jos virhe liittyy PAOS-tietoihin, palvelukäyttäjän käyttöoikeudet ovat kunnossa ja PAOS-linkitys on tehty molemminpuolisesti, virhe voi johtua siitä, että kyseiseen PAOS-toimijaan liittyvät käyttöoikeudet ovat jostain syystä vialliset. Ratkaisuksi kannattaa kokeilla ensin PAOS-hallinnassa tietojen tallentajan muuttamista hetkeksi. Tällöin tähän toimijaan liittyvät käyttöoikeudet alustetaan. Eli kunnan Varda-pääkäyttäjä vaihtaa PAOS-hallinnassa kyseisen toimijan kohdalla tietojen tallentajan ja tallentaa muutoksen. Sitten odotetaan noin 5 minuuttia ja vaihdetaan tallentajaksi uudelleen kunta. Jos tämä toimenpide ei auta, ota yhteys Vardan asiakaspalveluun varda@opintopolku.fi
PE007	Käyttöoikeuksien tarkistaminen epäonnistui.	Virhe syntyy yleensä silloin, kun autentikointi on epäonnistunut / palvelukäyttäjä ei ole päässyt onnistuneeseen sisäänkirjautumiseen.	Tarkasta palvelukäyttäjälle myönnetyt käyttöoikeudet. Palvelukäyttäjälle kuuluvat käyttöoikeudet tunnistaa "ei henkilöille" -maininnasta. Kunnan Varda-pääkäyttäjä voi tarvittaessa lisätä palvelukäyttäjälle puuttuvat käyttöoikeudet. Esimerkiksi jos integraatiolla siirretään Vardaan työntekijä- ja täydennyskoulutustiedot tulee palvelukäyttäjällä olla seuraavat käyttöoikeudet: Varda-henkilöstö-työntekijätietojen palvelukäyttäjä (ei henkilöille) & Varda-henkilöstö-täydennyskoulutustietojen palvelukäyttäjä (ei henkilöille). Tarkasta, että palvelukäyttäjätunnus ja salasana ovat asetettuna oikein lähdejärjestelmään. Tarvittaessa kunnan pääkäyttäjä voi vaihtaa salasanan palvelukäyttäjän tiedoissa. Varmista, että palomuuriavaus on ip-osoitteesta tehty. Varmista haetaanko api-avain tuotantoympäristöstä: https://backend.varda-db.csc.fi/api/user/apikey/
DY010	Syntaksivirhe lähetetyssä JSON-sanomassa: {{}}	Virhe syntyy, kun Vardaan lähetetty rajapintakutsu on ollut jollain tapaa virheellinen.	Tarkasta lähetetty rajapintakutsu ja korjaa kutsussa olevat mahdolliset virheet. Esimerkiksi rajapintakutsussa saattaa olla ylimääräsiä rivinvaihtoja tai puuttuvia pilkkuja.
1) VP012 2) VS014	1) Lapsella pitää olla vähintään yksi varhaiskasvatuspäätös. 2) Varhaiskasvatuspäätöksellä on oltava vähintään yksi varhaiskasvatussuhde.	1) Virhe syntyy, kun lapsen perustiedot on tallentunut Vardaan, mutta häneltä puuttuu pakollinen varhaiskasvatuspäätös. 2) Virhe syntyy, kun lapsi on tallennettu Vardaan ja hänelle on lisätty varhaiskasvatuspäätös, mutta häneltä puuttuu varhaiskasvatussuhde.	1) Lisää lapselle vähintään yksi varhaiskasvatuspäätös ja päätökselle varhaiskasvatussuhde. 2) Jos näyttää, että lähdejärjestelmässä lapsella on tarvittavat tiedot (varhaiskasvatuspäätös ja -suhde) oikein, kyseessä on luultavasti tiedonsiirroissa syntynyt duplikaatti (tupla), joka tulee poistaa Vardasta. Katsele tietoja -näkymässä näkee jokaisen tiedon ID:n. Alla olevassa esimerkissä näet Katsele tietoja -näkymässä lapsen Varda-IDn sekä varhaiskasvatuspäätöksen ID:n. ID:n perusteella tuplana siirtyneisiin lapsiin (tai muihin duplikaattitietoihin) pitäisi päästä käsiksi lähdejärjestelmässä. Suosittelemme olemaan yhteydessä järjestelmätoimittajaan, jotta voidaan varmistaa, että Vardasta poistetaan oikea tieto.
KO003	Koodiarvo on virheellinen.	Virhe syntyy, kun rajapintakutsussa on jonkin koodin kohdalla käytetty virheellistä koodiarvoa. Toisin sanoen käytetty koodi ei ole Vardan koodistojen mukainen. Vardan koodistot löytyvät täältä.	Epäonnistuneissa tiedonsiirroissa voi näkyä esimerkiksi seuraavanlainen virhe: Virhe on tällöin käytetyssä tutkintokoodissa. Tarkasta käytetty koodiarvo ja varmista, että siinä ei ole virhettä ja se on Vardan tutkintokoodiston mukainen https://virkailija.opintopolku.fi/varda/julkinen/koodistot/vardatutkinto eli esimerkiksi jos työntekijällä ei ole varhaiskasvatusalan tutkintoa, koodiarvo on 003 ei varhaiskasvatusalan tutkintoa tai koulutusta.

Hur man korrigerar fel i uppgiftsöverföringarna

På den här sidan beskrivs de vanligaste felen som förekommer i samband med uppgiftsöverföringar till Varda, samt hur de kan åtgärdas. Du hittar alla felmeddelanden som används i Varda här.

OBS! När uppgifterna överförs till Varda med en systemintegration ska eventuella korrigeringar göras i det egna källsystemet. Om det förekommer problem med uppgiftsöverföringen som genomförs med en systemintegration är det bra att i första hand vara i kontakt med den egna systemleverantören.

Ta del av de illustrerade anvisningarna för hur du använder rapporten över uppgiftsöverföringar här. Rapporten över uppgiftsöverföringar kan granskas med användarrättigheten som Varda-huvudanvändare.

Felkod	Beskrivning av felet	När uppstår felet?	Hur felet åtgärdas/exempel
MI013	Det finns redan ett objekt med den här kombinationen av källsystem och identifikationskod. Kontrollera att identifikationskoden som generas av källsystemet för den sparade uppgiften är unik.	Koden för källsystemet kan precis som Varda-ID eller studentnummer användas i Varda för att identifiera ett objekt. Felet uppstår när man försöker skapa en ny uppgift med en sådan kod för källsystemet som redan är i användning.	Till exempel ska källsystemskoden för arbetstagare vara unik för varje källsystem. Det är möjligt att använda samma kod så länge det är frågan om ett annat källsystem, men inom ett och samma källsystem kan man inte för olika anordnare av småbarnspedagogik använda samma källsystemkod för arbetstagaren, utan koden ska vara unik i källsystemet. Det är bra att reda ut felet tillsammans med systemleverantören, eftersom det är frågan om ett fel på källsystemnivå.
MI015	Objektet kan inte hittas.	Ett av de vanligaste felen i uppgiftsöverföringarna. Felet uppstår då man söker efter uppgifter som man inte har rättigheter till eller som inte finns.	Granska koderna som använts i uppgiftsöverföringen och att de är korrekta. Felet kan synas till exempel på följande sätt på rapporten över uppgiftsöverföringar: Verksamhetsstället finns alltså inte eller så har man inte rättigheter till verksamhetsstället (verksamhetsstället kan t.ex. höra till en annan aktör inom småbarnspedagogik.
MI007	Organisationens oid-kod eller studentnumrets oid-kod har fel form.	Felet uppstår då innehållet i uppgiftsfältet (organisationens OID-kod/ studentnumrets OID-kod) är felaktigt.	Granska formen på organisationens eller studentnumrets OID-kod, till exempel eventuella mellanslag eller tecken som är överflödiga eller som saknas.
1) GE008 2) RF003	1) Hyperlänken är inte användbar, objektet kan inte hittas. 2) Det gick inte att hitta ett motsvarande objekt.	Felen GE008 och RF003 motsvarar varandra. I Varda kan man hänvisa till objekt med en ID-kod eller OID-kod. Till exempel kan det se ut ungefär så här i gränssnittsanropet då uppgifter skapas om ett barn. { "henkilo": "/api/v1/henkilot/1/", "henkilo_oid": "1.24....", ... } GE008 avser att en sådan här person inte kan hittas eller att användaren inte har rättigheter till personens uppgifter. RF003 berättar i sin tur att man har använt fältet person_oid (henkilö_oid) och att personen inte heller då kan hittas eller så har användaren inte rättigheter till personens uppgifter. I praktiken betyder bägge felen alltså att man har försökt hänvisa till ett objekt som inte finns eller som användaren inte har rättigheter till. Objektet kan vara en person, ett barn, en anordnare av småbarnspedagogik, ett verksamhetsställe, ett beslut om småbarnspedagogik osv.	Kontrollera att man i gränssnittet har hänvisat till det objekt som avsetts. Kontrollera att objektets ID- eller OID-kod är korrekt.
MA003	Det gick inte att hitta vårdnadshavaren till barnet i Befolkningsdatasystemet.	Felet uppstår om Varda inte lyckas hämta uppgifterna om barnets vårdnadshavare som kommer från Studentnummerregistret via Befolknings-datasystemet.	Barnets uppgifter har sparats i Varda samma dag som man har försökt spara uppgifterna om vårdnadshavare och avgifter. Varda hämtar uppgifterna om barnets vårdnadshavare med en fördröjning på ett dygn. Spara uppgiften om avgifter tidigast dagen efter att barnets uppgifter har sparats. Det förekommer fel i barnets uppgifter som medför att barnet inte har identifierats och därför har det inte varit möjligt att hämta uppgifterna om barnets vårdnadshavare. I problemsituationer vänligen kontakta Vardas kundtjänst på adressen varda@opintopolku.fi Varda hämtar uppgifter om vårdnadshavarna via Studentnummerregistret. Studentnummerregistrets uppgifter kommer från Befolkningsdatasystemet. Ibland förekommer det problem när uppgifterna ska uppdateras mellan de två systemen. Var i kontakt med Vardas kundtjänst på adressen varda@opintopolku.fi, så uppdaterar vi vid behov uppgifterna om barnets vårdnadshavare. Personen är inte barnets officiella vårdnadshavare. Barnets uppgifter har sparats i Varda med hens studentnummer, och då är det inte möjligt att hämta uppgifterna om vårdnadshavaren. Det går inte att spara uppgifterna om avgifter.
PE007	Det gick inte att kontrollera användarrättigheterna.	Felet uppkommer i allmänhet då autentiseringen har misslyckats / tjänsteanvändaren har inte lyckats logga in.	Kontrollera användarrättigheterna som har tilldelats tjänsteanvändaren. Användarrättigheter som hör till en tjänsteanvändare kännetecknas av beskrivningen ”inte för personer”. Kommunens Varda-huvudanvändare kan vid behov lägga till användarrättigheter som saknas för tjänsteanvändaren. Till exempel då uppgifter om arbetstagare och fortbildningar överförs till Varda med en integration ska tjänsteanvändaren ha följande användarrättigheter: Varda-tjänsteanvändare-personal-uppgifter om arbetstagare (inte för personer) & Varda-tjänsteanvändare -personal-uppgifter om fortbildning (inte för personer). Kontrollera att tjänsteanvändarnamnet och lösenordet har angetts korrekt i källsystemet. Vid behov kan kommunens huvudanvändare byta ut lösenordet i tjänsteanvändarens uppgifter. Kontrollera att brandväggen har öppnats via en ip-adress. Kontrollera om det behövs en api-nyckel från produktionsmiljön: https://backend.varda-db.csc.fi/api/user/apikey/
DY010	Ett syntaxfel i det skickade JSON-meddelandet: {{}}	Felet uppstår då gränssnittsanropet som skickats till Varda på något sätt har varit felaktigt.	Kontrollera gränssnittsanropet och korrigera eventuella fel. Det kan till exempel finnas överflödiga mellanslag eller tecken som saknas.
1) VP012 2) VS014	1) Barnet ska ha minst ett beslut om småbarnspedagogik. 2) Minst en uppgift om deltagande i småbarnspedagogik ska vara kopplad till beslutet om småbarnspedagogik.	1) Felet uppkommer då barnets basuppgifter har sparats i Varda men hen saknar ett obligatoriskt beslut om småbarnspedagogik. 2) Felet uppkommer då barnets uppgifter har sparats i Varda och hen har ett beslut om småbarnspedagogik men det har inte sparats några uppgifter om deltagande i småbarnspedagogik	1) Lägg till minst ett beslut om småbarnspedagogik för barnet och lägg till uppgifter om deltagande i småbarnspedagogik i anslutning till beslutet. 2) Om det ser ut som att alla uppgifter som krävs om barnet (beslut om småbarnspedagogik och deltagande i småbarnspedagogik) är korrekta i källsystemet, är det troligtvis frågan om att uppgifterna har överförts två gånger till Varda, och de dubbla uppgifterna behöver då raderas från Varda. I vyn Granska uppgifter hittar du det Varda-ID som hör till respektive uppgift. I exemplet nedan ser du barnets Varda-ID och ID-koden för beslut om småbarnspedagogik (i vyn Granska uppgifter). Med hjälp av ID-koden ska det vara möjligt att få fram uppgifterna som har överförts dubbelt. Vi rekommenderar att vara i kontakt med systemleverantören för att försäkra att rätt uppgift tas bort från Varda.
KO003	Kodvärdet stämmer inte.	Felet uppstår då fel kodvärde har använts för någon kod i gränssnittsanropet. Koden som har använts är alltså inte i linje med Vardas kodvärden. Koderna som används i Varda hittar du här.	Till exempel följande fel kan synas bland de misslyckade uppgiftsöverföringarna: Felet beror då på examenskoden som använts. Kontrollera kodvärdet och se till att det inte innehåller några fel samt stämmer överens med Vardas examenskoder https://virkailija.opintopolku.fi/varda/julkinen/koodistot/vardatutkinto Om till exempel en arbetstagare inte har en examen inom småbarnspedagogik, ska kodvärdet vara 003 ingen examen eller utbildning inom småbarnspedagogik.