Yleistilanne

Kuvassa on esitetty yleistilanne 07/22 mukaisena, jossa näkyy mitä kautta päivityksiä Velhoon lähitulevaisuudessa on tulossa. Suurin osa kohdeluokista päivittyy Operaattoripalvelun välityksellä, tulevaisuudessa näitä prosesseja on tarkoitus automatisoida.

Tiestötietoa päivitetään Velhossa eri tavoin tietokokonaisuudesta ja kohdeluokasta riippuen. 

Yleisimmät tavat päivittää tietoa ovat:

  • ulkoisista järjestelmistä Velhon tarjoaminen rajapintojen kautta (APIt)
  • eräajoina lähetyspalvelun kautta

Ulkoiset järjestelmät (APIt)

Osaa Velhon kohdeluokista ylläpidetään muissa järjestelmissä ja tieto luetaan Velhoon rajapintojen kautta.

Rajapinnassa tarjotaan kunkin rekisteripalvelun toteuttamat päivitystoiminnallisuudet REST-toteutuksina:

  • uuden kohteen luomiselle
  • olemassaolevan kohteen muokkaamiselle
    • siten, että kohteen historia säilyy (tilanne, jossa kohteen ominaisuudet ovat muuttuneet “oikeasti”)
    • siten, että muokataan kohteen historiaa (tilanne, jossa kohteen tiedot ovat olleet virheelliset)
  • kohteen lakkauttamiselle, sen historia kuitenkin säilyttäen
  • kohteen poistolle, historia mukaanlukien. (ei yleensä sallittu)

Ulkoisten rajapintojen käyttöohje (Väyläpilvi)

Lähetyspalvelu

Velhon lähetyspalvelun kautta on tarkoitus päivittää suuria datamassoja sekä aineistoja, joita luonteensa vuoksi päivitetään esimerkiksi muutamia kertoja vuodessa. 

Velhon lähetyspalvelun toimintaperiaate on seuraava:

  1. Ulkoinen järjestelmä tekee REST-rajapintaan pyynnön haluavansa tuoda kohteita Velhoon. Se saa vastauksena osoitteen, johon data voidaan lähettää HTTP:llä, sekä eräajotunnisteen.
  2. Ulkoinen järjestelmä lähettää datan annettuun osoitteeseen NDJSON-muotoisena siirtotiedostona (soveltuvin osin sama kuin Latauspalvelun tarjoama muoto).
  3. Lähetyspalvelu validoi lähetetyn datan ja vie sen Velhon rajapintoja käyttäen oikeisiin rekistereihin.
  4. Ulkoinen järjestelmä voi 1-kohdassa saamansa eräajotunnisteen avulla tiedustella, miten lähetetyn datan käsittely etenee, ja onko esim. datan validoinnissa ilmennyt virheitä.

Siirtotiedostossa voidaan ilmaista uusien kohteiden luonti (kohteen tiedot ilman OID:ia), kohteen päivitys (kohteen OID ja sen tiedot) sekä kohteiden lakkauttaminen tai poisto (kohteen OID sekä tieto lakkautuksesta/poistosta). Näiden operaatioiden semantiikka on sama kuin REST-rajapintojen kohdalla.

Tarkemmat käyttöohjeet lähetyspalvelun dokumentaatiossa.