Varda kehitysohjeet

Varda integraation toteutus on VardaUpdateService -luokassa joka päivittää yksiköiden ja lapsen tiedot Vardaan vardan rajapintaa vasten.

Perusasetukset

Ympäristömuuttujiin evaka.oph.organizer_oid, evaka.oph.municipality_code ja evaka.oph.organizer_id lisätään Vardalta saadut kunnan varda-organisoijatunnisteet.

Vardaan viedään niiden lasten tiedot, jotka on sijoitettuina yksiköihin joiden asetuksista on valittu "Yksikön lasten tiedot lähetetään Vardaan". Vardaan viedään niiden yksiköiden tiedot joiden asetuksista on valittu "Yksikön tiedot viedään vardaan".

Vaadittavat käyttöönoton esitoimet jos Vardasta löytyy muualta vietyä dataa

Jos kunta tai kunnassa toimivat yksityiset palveluntuottajat ovat vieneet Vardaan tietoja eVakan käyttöönottoa edeltävältä ajalta, eVakaan pitää asettaa päivämäärä jota aiempaan Varda-dataan ei saa koskea. Tämä asetus luetaan VardaEnv -luokan kautta ympäristömuuttujasta evaka.integration.varda.start_date.

Jos eVakan käyttöä ollaan lopettamassa ja ollaan siirrytään toiseen varhaiskasvatusjärjestelmään voidaan asettaa evaka.integration.varda.end_date joka kertoo eVakalla ettei sen jälkeisiä tietoja viedä enää eVakasta Vardaan.

Mahdollisille jo Vardaan viedyille yksiköille pitää asettaa eVakan yksikkötietoihin Vardasta löytyvä toimipaikan OID ja palveluntarjoajan OID (joko kunta itse tai yksityinen palveluntarjoaja).

Ajastus

Kun esitiedot on asetettu,varsinainen päivittäinen vardan tietojen päivitys tapahtuu ajastetulla ScheduledJob.vardaUpdate -operaatiolla.

Peruslogiikka

Jokaisella vardapäivityksellä

• Haetaan kaikki eVakan lapset jotka eivät löydy vielä varda_state -taulusta joilla on vakasijoitus ja lisätään ne sinne
• Käydään läpi kaikki varda_state-taulusta löytyvät lapset. Jokaiselle lapselle haetaan vardaan vietävä data ja jos varda_state-taulusta löytyy jo olemassaoleva tila verrataan tähän. Jos tila on muuttunut tai sitä ei löydy viedään muutokset vardaan. Onnistuneen operaation lopuksi tila talletetaan varda_state -tauluun

Varda virhetiedot

Varhan virheet löytyvät pääkäyttäjän Vardavirheet -raportista. Raportista voi myös valita lapsen tietojen uudelleenalustus (kts alla), ja uudelleenalustuksen ajo vardaan.

Varda-virheet

Virheiden kuvaus löytyy rajapintakuvauksesta: https://virkailija.testiopintopolku.fi/varda/julkinen/koodistot/vardavirheviestit.

Yleisimmät virheet:

• MA003. Evakan lähettämässä varhaiskasvatusmaksussa on mukana tämän hetken huoltajat. Varda validoi että huoltajat ovat VTJn mukaiset huoltajat. Vardalla kestää 24-48 tuntia ensimmäisestä lähetysyrityksestä hakea lapsen huoltajatiedot. Tästä johtuen pitää operaatiota yrittää uudelleen kunnes Vardan päässä on haettu VTJ tiedot ja validointi onnistuu. Huom eVaka ei lähetä maksun syntymisen aikaisia huoltajatietoja koska eVakassa ei niitä ole, vaan tämän hetken huoltajat.

Lapsen tietojen vieminen vardaa uudelleen

Jos lapsen tiedot halutaan jostain syystä viedä vardaan koko historian ajalta uudestaan, se onnistuu poistamalla kyseisen lapsen rivi varda_state -taulusta