Suomi.fi kehittäjille
Siirry suoraan sisältöön.

Miten toteutan PTV-integraation?

PTV:ssä on käynnissä arkkitehtuuriuudistus, jonka osana julkaistaan rajapintaversio 12. Uusi versio on huomattavan erilainen verrattuna versioon 11, joka ajetaan alas siirtymäajan jälkeen. Otathan muutoksen huomioon suunnitellessasi uutta integraatiota!

Tietojen tuominen Palvelutietovarannosta organisaatiosi digitaalisiin palveluihin vaatii organisaatiosi tietojärjestelmän ja PTV:n yhteen liittämistä tietojärjestelmäintegraation avulla. Tähän tarvitaan IT-toimittajan osaamista.

Integraation suunnittelussa ja toteutuksessa huomioitavat asiat

Ennakoi ja sitouta avaintahot

PTV-integraation voi toteuttaa milloin vain, mutta luontevin ajankohta on tehdä se verkkopalvelu-uudistuksen yhteydessä. Jos mahdollista, asiasta kannattaa tehdä päätös hyvissä ajoin. Näin ehditte orientoitua asiaan ja saada mukaan kaikki tarvittavat tahot – esimerkiksi johdon, tietohallinnon, viestinnän, sisällön substanssiosaajat ja yhteistyökumppanit – sekä suunnitella ajan kanssa kilpailutuksen ja integraation toteutuksen.

On tärkeää, että integraatioprojektilla sekä integraation hyödyntämisellä tuotantovaiheessa on organisaation johdon tuki.

Opi muilta ja tee yhteistyötä

Tutustu hyvissä ajoin muiden tekemiin integraatiototeutuksiin ja kysy yhteistyöorganisaatioiltasi kokemuksia esimerkiksi julkaisualustoista, tarjouspyynnön tekemisestä tai kiinnostavista IT-toimittajista.

Tule PTV-datan hyödyntämisen klinikalle jakamaan vinkkejä ja kuulemaan muiden kokemuksia.

Selvitä myös, mikä on yhteistyöorganisaatioidesi PTV-tilanne. Onko joku toteuttanut tai parhaillaan suunnittelemassa integraatiota? Voisitteko tehdä yhteistyötä tarjouspyynnön tekemisessä tai jopa kilpailuttaa yhteisen julkaisualustan?

Kilpailuta fiksusti

On erittäin tärkeää, että organisaatiollasi on jo ennen tarjouspyynnön laatimista hyvä ymmärrys PTV:stä ja omista tarpeistanne integraatioon liittyen, jotta teillä on valmiudet hankkia laadukas PTV-integraatio ja ohjata IT-toimittajaa sen toteuttamisessa.

Markkinoilla on runsaasti IT-toimittajia, jotka ovat aiemmin toteuttaneet PTV-integraation yleisesti käytössä oleville julkaisualustoille. Tarjouspyynnössä voi edellyttää toimittajalta julkaisualustaa valmiilla PTV-integraatiolla, kokemusta PTV-integraatiototeutuksista tai kokemusta vastaavan kaltaisista integraatioista. Toimittajalta kannattaa edellyttää vähintään kokemusta tietojen integroimisesta json-rajapintojen kautta. Myös referenssejä on hyvä pyytää toimittajan osaamisen varmistamiseksi.

Sisällöt kuntoon hyvissä ajoin

Käykää läpi ja päivittäkää organisaationne PTV-sisällöt hyvissä ajoin, jotta vanhentuneet tai huonolaatuiset sisällöt eivät muodostu esteeksi integraation käyttöön ottamiselle.

Mikäli suunnittelette jonkun toisen organisaation PTV-tietojen hyödyntämistä, myös niitä kannattaa tarkastella hyvissä ajoin ja tarvittaessa pyytää organisaatiota päivittämään tietoja.

Lisätietoa sisällöntuotannon organisoinnista datan hyödyntämisen näkökulmasta

Sisällöntuotantokoulutus rajapintahyödyntäjille (Digi- ja väestötietovirasto) (PDF, 1,21 Mt)Avautuu uuteen ikkunaan.

Vaiheista toteutusta

PTV-integraation voi toteuttaa myös vaiheittain, esimerkiksi ensimmäisessä vaiheessa tuoda pelkät palvelupaikkojen tiedot ja myöhemmin palveluiden tiedot.

Toteutus kannattaa tehdä iteroiden, eli varautua kehittämään integraatiota hankitun kokemuksen ja asiakaspalautteen perusteella. Tähän on hyvä varata myös resursseja.

Lisätietoa

Ilmoita integraatiosta

Palvelutietovarannossa olevaa dataa voi hakea tunnistautumatta, siksi Digi- ja väestötietovirasto saa tietoonsa vain pienen osan integraatioista. Jos organisaatiollasi on suunnitteilla tai tuotannossa PTV-integraatio, ilmoittakaa asiasta DVV:lle osoitteeseen ptv-tuki@dvv.fi. Siten DVV voi viestiä teille häiriötilanteista ja rajapinnan muutoksista ja pysyy selvillä siitä, ketkä dataa hyödyntävät.


Päivitetty: 18.11.2025

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