Tietomallin yleiskuvaus PTV-datan hyödyntäjälle
Beta - sisältö on keskenTämä sivu on alustava ja täydentyy kevään 2026 aikana V12-kehitystyön edetessä
Tämä ohje antaa kokonaiskuvan Palvelutietovarannon (PTV) keskeisistä käsitteistä ja niiden välisistä yhteyksistä. Ohjeen tavoitteena on auttaa sinua hyödyntämään PTV:n tietoja rajapinnan kautta ymmärtämällä:
- Mitä ylätason käsitteitä (sisältötyyppejä) PTV:ssä on
- Miten käsitteet liittyvät toisiinsa
- Mitä tietokonaisuuksia kuhunkin sisältötyyppiin kuuluu
Ohje on tarkoitettu
- PTV:n API-rajapinnan käyttäjille (kehittäjät, integraation suunnittelijat ja toteuttajat)
- PTV-tietoja hyödyntävien verkkosivujen suunnittelijoille
Miten käsitteet ja yhteydet on kuvattu?
Käsitteet ja niiden väliset yhteydet (suhteet) on esitetty kaaviona, jossa:
- Käsitteet on esitetty suorakulmioina.
- Käsitteiden väliset yhteydet on kuvattu viivoina. Viivassa voi olla yhteyden selittävä teksti (esim. "tarjoaa", "kuuluu") sekä kardinaliteetit.
Kardinaliteetit ilmaisevat kuinka monta esiintymää käsitteeseen voi liittyä:
1 = yksi
0..1 = nolla tai yksi
1..* = yksi tai useampi
0..* = nollasta useaan (nolla, yksi tai useampi)
Lisätietoa
- Palvelutietovarannon sanasto yhteentoimivuusalustallaAvautuu uuteen ikkunaan.
- PTV:n looginen tietomalli yhteentoimivuusalustalla (ehdotusversio)Avautuu uuteen ikkunaan. Huomaa! Tietomalliin voi tulla muutoksia kehitystyön edetessä
- Asiakastestiympäristön (koulutusympäristö) PTV API -dokumentaatio (versio 12) Avautuu uuteen ikkunaan.Huomaa! V12 rajapinnan kehitystyö on kesken ja API-dokumentaatio täydentyy kehitystyön edetessä.
PTV:n ylätason käsitemalli
- Palvelu: kuvaa tarjottavan palvelun tiedot
- Asiointikanavat: kuvaa, mistä asiakas voi saada palvelun. Asiointikanavatyypit ovat verkkoasiointi, verkkosivu, palvelupaikka, tulostettava lomake ja puhelinasiointi
- Liitos: yhdistää palvelun ja asiointikanavan, voi sisältää lisätietoja
- Organisaatio: voi olla palvelun tuottaja ja/tai vastuuorganisaatio. Omistaa pohjakuvauksen ja palvelukokonaisuuden.
- Pohjakuvaus: on mallipohja palvelun kuvaamiseen
- Palvelukokonaisuus: ryhmittelee palveluita ja asiointikanavia
Yhteydet käsitteiden välillä
- Palvelu voi olla saatavilla yhdessä tai useammassa asiointikanavassa ja asiointikanava voi tarjota yhtä tai useampaa palvelua. Palvelu yhdistyy asiointikanavaan liitoksen kautta.
- Palvelulla on yksi päävastuuorganisaatio, nollasta useampaan muuta vastuullista organisaatiota ja yksi tai useampi tuottajaorganisaatio
- Asiointikanavalla on yksi omistajaorganisaatio
- Palvelun kuvaamisessa voi hyödyntää nollasta yhteen pohjakuvausta
- Pohjakuvauksella on yksi omistajaorganisaatio (DVV)
- Pohjakuvauksella voi olla nollasta useaan ehdotusta asiointikanavista
- Palvelukokonaisuudella on yksi omistajaorganisaatio
- Palvelukokonaisuus sisältää nollasta useaan palvelua ja asiointikanavaa
Rajapinnan hyödyntämisessä huomioi
- Palvelu voi olla saatavilla useammassa asiointikanavassa (vähintään yhdessä)
- Asiointikanava voi tarjota useita eri palveluita (vähintään yhtä)
- Asiointikanavalla voi olla tiedot palveluajoista ja yhteystiedot
- Jos liitoksen lisätietoja on annettu, ne korvaavat liitetylle asiointikanavalle annetut vastaavat tiedot
- Palveluun mahdollisesti liitetetyn pohjakuvauksen tiedot täydentävät palvelun tietoja
- Palvelukokonaisuudet mahdollistavat ryhmittelyn ja hakemisen rajapinnasta yhtenä kokonaisuutena. Huom. palveluista ja asiointikanavista palautuu tunnisteet, ja näiden sisältö on haettava erikseen.
Tarkentavat käsitemallit
Päivitetty: 4.5.2026