Varda kehitysohjeet

Varda kehitysohjeet

Varda integraation toteutus on VardaUpdateService ja VardaResetService -luokissa vardan rajapintaa vasten.

Vaadittavat käyttöönoton esitoimet jos vanhaa varda-dataa ei ole

Vardaan vietävät lapset on ensin resetoitava (kts alla). Ajastettu päivittäinen VardaReset -palvelu alustaa maksimissaan 1000 vielä vardasta puuttuvaa lasta vardaan. Tämän jälkeen VardaUpdate -ajastuspalvelu vie näiden lapsien muuttuneet tiedot vardaan.

Vaadittavat käyttöönoton esitoimet jos vanhaa varda-dataa on

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

Vardassa mahdollisesti olevat olemassaolevat yksikkötiedot lisätään varda_unit -tauluun. Mahdollisesti vardassa olemassaolevat lapsi -tietueet lisätään varda_organizer_child -tauluun.

Vardaan vietävät lapset resetoidaan (kts alla). Ajastettu päivittäinen varda sync job vie muuttuneet tiedot vardaan.

Varda reset

Varda reset on toiminto jolla lapsi otetaan varda-päivityksen piiriin. Se poistaa lapsen kaiken vanhan varda-datan vardasta, ja vie lapsen koko vardahistorian sinne uudelleen.

Lapsen varda reset tehdään lisäämällä lapsi varda_reset_child tauluun, ja kutsumalla endpointtia

curl -vv -X POST http://evaka-srv.internal.espoon-voltti.fi/varda-dev/reset-children?addNewChildren=false

tai ajamalla ajastettu operaatio joka kutsuu samaa endpointtia, tai käynnistämällä reset varda-virheet -raportista löytyvällä Käynnistä lasten resetointi-napilla. Jos reset onnistuu, taulun reset_timestamp kenttään tulee kyseinen ajankohta. Jos operaatio ei onnistunut, kyseinen kenttä on tyhjä, ja seuraavalla ajolla lapsen resetointia yritetään uudelleen.

Varda sync

Kun esitiedot on asetettu ja lapset resetoitu, varsinainen päivittäinen vardan tietojen päivitys tapahtuu ajastetulla VardaUpdateService.startVardaUpdate -operaatiolla. Päivityksen piirissä on ne lapset, jotka löytyvät onnistuneesti resetoituina varda_reset_child -taulusta (kts yllä).

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.

Lapsen tietojen vieminen vardaa uudelleen

Jos lapsen tiedot halutaan jostain syystä viedä vardaan koko historian ajalta uudestaan, se onnistuu nollaamalla varda_reset_child -taulun reset_timestamp -kenttä.