Palvelut näkyviin verkkosivuille PTV-integraation avulla

Yksi tämän kevään asiakasprojekteista oli Suomi.fi Palvelutietovaranto-integraation (PTV) toteuttaminen. PTV-integraatio toteutettiin omana lisäosana WordPress-sivustolle. Integraation kautta haetaan järjestöjen tietoja ja palveluita, joista rakennettiin palveluhakemisto helpottamaan palvelujen tietojen selaamista.

Integraatioiden suurin hyöty on tiedon keskittäminen yhteen paikkaan. Kun palvelutiedot ylläpidetään PTV:ssä, ne päivittyvät automaattisesti myös verkkosivustolle ilman erillistä käsityötä. Tämä vähentää päällekkäistä työtä, pienentää virheiden riskiä ja varmistaa, että käyttäjät löytävät ajantasaiset tiedot kaikissa kanavissa.

PTV eli palvelutietovaranto

on keskitetty tietovaranto, johon kunnat, valtio ja yksityinen sektori kuvaavat palvelunsa ja niiden asiointikanavat. PTV kokoaa yhteen tietoa palveluista, joiden kohderyhmänä voivat olla kansalaiset, yritykset, järjestöt, yhteisöt tai viranomaiset.

Palvelutietovarantoon kuvattua tietoa voidaan hyödyntää monissa eri paikoissa, esimerkiksi verkkosivuilla, karttapalveluissa ja chatboteissa. Näin tietoa ei tarvitse ylläpitää monissa eri paikoissa.

Lue lisää Suomi.fi sivuilta

Palveluiden tiedoista rakennettiin palveluhakemisto, jossa käyttäjät voivat selata, hakea ja suodattaa palveluita ja asiointikanavia mm. kohderyhmien, aiheiden ja sijainnin mukaan.

Lisäosan toiminta perustuu muutamaan keskeiseen vaiheeseen:

1. Asetusten hallinta

Lisäosa tarjoaa oman asetussivunsa WordPressin hallintapaneeliin. Täällä määritellään hakuehdot, joiden mukaan tiedot haetaan PTV:stä.

2. Tietojen haku ulkoisesta API-rajapinnasta

Lisäosa muodostaa yhteyden PTV API-rajapintaan ja hakee palvelujen tai organisaatioiden tietoja ja kuvauksia sekä asiointikanavia. Hakutulosten perusteella luodaan WordPressiin uusia sisältötyyppejä tai päivitetään olemassa olevia tietoja.

3. Automaattinen taustapäivitys

Jotta tiedonhaku ei hidastaisi sivuston käyttöä tai latausaikoja, lähetetään hakupyynnöt taustalla. Lisäosa määrittelee oman ajastetun tehtävän, joka suoritetaan kerran päivässä. Kun tehtävä käynnistyy, se hakee päivitetyt tiedot PTV:stä ja näin varmistetaan, että tiedot pysyvät ajan tasalla ilman käsin tehtäviä päivityksiä.

“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. Arkkitehtuuriuudistus ja rajapintaversion vaihdos versioon 12 vaativat toimenpiteitä kaikilta integraatioasiakkailta viimeistään keväällä 2027.”

Suomi.fi

PTV on yksi esimerkki siitä, miten ulkoisten järjestelmien tietoja voidaan hyödyntää verkkosivustolla. Rajapintojen avulla sivusto voidaan yhdistää esimerkiksi tapahtuma-, asiakkuus-, toiminnanohjaus- tai tuotetietojärjestelmiin. Hyvin suunniteltu integraatio säästää aikaa, tehostaa ylläpitoa ja mahdollistaa uusien digitaalisten palveluiden rakentamisen ilman, että samoja tietoja tarvitsee ylläpitää useassa eri järjestelmässä.