Suomi.fi kehittäjille
Siirry suoraan sisältöön.
Hyvät käytännöt kehittäjille
Kokonaisarkkitehtuuri toiminnan kehittämisessä

Kokonaisarkkitehtuurin kuvaaminen ja dokumentointi

Keskeistä on kuvaus arkkitehtuurista

Kokonaisarkkitehtuurityön yksi keskeinen tuotos on kuvaus arkkitehtuurin nykytilasta ja tavoitetilasta.

Kuvauksia voidaan esimerkiksi

  • käyttää kommunikoinnin välineenä ja raportoinnissa.
  • sisällyttää tiedonhallintamalliin, jonka avulla viranomainen määrittää ja ohjaa tiedonhallintaansa.

Kuvausten perusteella voi myös

  • analysoida arkkitehtuuria, kuten muutosvaikutuksia.
  • tuottaa vaihtoehtoisia rakenteita, joiden avulla minimoidaan riippuvuuksia järjestelmien tai prosessien välillä.
Päivitetty: 8.4.2025

Arkkitehtuurin peruskuvaukset

Arkkitehtuurit tulee kuvata selkeästi erottamalla kokonaisarkkitehtuurin ja ratkaisuarkkitehtuurin tasot.

Arkkitehtuurin peruskuvausten keskeiset osa-alueet ovat

  • toiminnan periaatteet , jotka ohjaavat toiminta-arkkitehtuuria, tietoarkkitehtuuria, sovellusarkkitehtuuria ja teknologia-arkkitehtuuria
  • digitaalinen turvallisuus
  • yhteentoimivuus
  • tiedonhallintalain velvoitteet.

Arkkitehtuurin peruskuvausten keskeiset osa-alueet

Kuvausten laajuus ja tarkkuus on optimoitava

  • organisaation johdon tahtotilan ja asiantuntijoiden tahtotilan mukaisesti
  • kuvausten laatimiseen ja niiden ylläpitoon käytettävissä olevien resurssien mahdollistamalla tasolla.
Organisaatiosi on määriteltävä, mihin tarkkuuteen resurssit ja tahtotila riittävät.
Päivitetty: 9.4.2025

Arkkitehtuurin kuvausten vähimmäistaso

Arkkitehtuurin kuvausten tulee vähintään sisältää organisaation toiminnan ja tiedonhallinnan kannalta

  • välttämättömät vaatimukset
  • vaatimuksia tukevat ohjeistukset.

Turvallisuuteen ja tietosuojaan liittyvä toimialakohtainen, kansallinen ja Euroopan Unionin laajuinen sääntely tulee myös huomioida kokonaisarkkitehtuurin kuvauksissa ja dokumentoinnissa.

Päivitetty: 4.4.2025

Kuvausten dokumentointi ja käsittely

Arkkitehtuurikuvaukset tulee esittää helposti saatavilla olevassa muodossa, kuten

  • taulukkoina
  • matriiseina
  • diagrammeina
  • tekstinä.

Hyödynnä kuvauksissa tarpeen mukaan eri notaatioita (esimerkiksi BPMN, UML, ArchiMate). Lue notaatioista tarkemmin sivulta Kokonaisarkkitehtuurin viitekehykset ja menetelmät.

Päivitetty: 8.4.2025

Kokonaisarkkitehtuurityöhön perehtyminen

Näin perehdyt käytännön kokonaisarkkitehtuurityöhön:

  1. Tutustu organisaatiosi toimintaympäristöön, strategiaan, arkkitehtuuriperiaatteisiin ja olemassa olevaan dokumentaatioon, esimerkiksi tiedonhallintamalliin.
  2. Tutustu myös muihin kuin organisaation käytössä oleviin kokonaisarkkitehtuurin viitekehyksiin, oman alan viitekehyksiin ja -malleihin sekä viitearkkitehtuureihin. Hahmota näiden suhde toisiinsa ja etsi parhaita käytäntöjä.
  3. Perehdy organisaation liiketoiminta-, tieto-, sovellus- ja teknologia-arkkitehtuurien käytäntöihin.

Päivitetty: 12.5.2026

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