Suomi.fi kehittäjille
Siirry suoraan sisältöön.
Hyvät käytännöt kehittäjille
Ohjelmointirajapintojen suunnittelu julkisessa hallinnossa

Etsi tai luo avoin tietomalli

Perehdy sääntelyyn

Usein sääntely määrittelee tarkasti,

  • mitä tietoja julkisen sektorin organisaatio saa kerätä ja käsitellä
  • mihin tarkoitukseen niitä saa käyttää.

Esimerkiksi henkilötietojen keräämistä ja käsittelyä säännellään yksityiskohtaisesti. Tietomallin suunnittelussa kannattaa siksi aloittaa säätelyyn perehtymisellä eli sääntelyn yhteentoimivuudella.

Päivitetty: 6.5.2026

Suunnittele tietomalli

Ideaalitilanteessa tietomallisuunnittelua, eli semanttista yhteentoimivuutta, on tehty jo ennen hankintaa. Käytännössä hankinta voidaan aloittaa sillä, että hankinnan kohteena olevan tietojärjestelmän tietomalli, sanastot ja koodistot suunnitellaan

  • joko koko hankinnan osalta
  • tai siltä osin, kun hankinnan kohde vaihtaa tietoa muiden tietojärjestelmien kanssa.

Tietomallissa kuvataan sanastojen ja koodistojen väliset suhteet. Siihen voi myös sisältyä sanastot ja koodistot. Avoimesti tehty tietomalli on vapaasti uudelleenkäytettävissä.

Tietomalli yhdistää sanastot, koodistot ja tietueet hierarkkiseksi rakenteeksi.

Päivitetty: 6.5.2026

Suunnittele tietokanta

Jokaisen tietojärjestelmän sisällä on tietokanta. Tietokannan suunnittelussa määritellään datatyypit, kuten teksti, numerot tai päivämäärät.

Kenttien nimet eivät kuitenkaan aina kerro tiedon merkitystä yksiselitteisesti ja siksi sen lisäksi tarvitaan semanttinen yhteentoimivuus. Käytännössä esimerkiksi tietokannan sisältämä kenttä "nimi" voi tarkoittaa eri asioita, esimerkiksi ihmisen, eläimen tai esineen nimeä.

Päivitetty: 6.5.2026

Ymmärrä tiedon mallinnus ja tunne tietotarpeet

Huomioi, että tietomallien, koodistojen ja sanastojen luominen vie aikaa. Niiden luominen on suositeltavaa järjestää siten, että julkaisevalla organisaatiolla on vahva ymmärrys julkaisemansa tiedon mallinnuksesta. Hyvä esimerkki tästä on ympäristöministeriön Ryhti-hanke, jossa on luotu avoimia ja uudelleenkäytettäviä tietomalleja.

Mitä paremmin tietotarpeet tunnetaan, sitä tehokkaampaa ja paremmin kohdennettua kehittäminen on. Jos vaatimukset ovat selvillä, ohjelmointirajapintojen luonnokset voidaan tehdä jo ennen kilpailutusta.

Hyvin määritellyt tietomallit

  • vähentävät työtä
  • yksinkertaistavat toteutuksia
  • pienentävät tiedon käyttöön liittyviä riskejä.
Päivitetty: 6.5.2026

Kehitä tietomallia vaiheittain

Tietomallin määrittely ei aina ole mahdollista ennen ohjelmistokehityksen tai hankinnan aloittamista, ja tarve sen kehittämiselle voi tulla yllätyksenä.

Ketterässä kehittämisessä tietomallia voidaan kehittää vaiheittain. Aluksi voidaan keskittyä arkkitehtuurin suunnitteluun, mikä nopeuttaa kehitystä ja vähentää myöhempää työtä.

Päivitetty: 6.5.2026

Oletko tyytyväinen tämän sivun sisältöön?

Sanasto