Palvelutietovaranto eli PTV on Digi- ja väestötietoviraston tuottama keskitetty tietovaranto, johon organisaatiot voivat kuvata asiakaslähtöisesti, yhdenmukaisen mallin mukaan palvelunsa ja niiden asiointikanavat.
Järjestöt ovat tervetulleita kuvaamaan palvelunsa Palvelutietovarantoon. Palvelun käyttö on maksutonta.
Palvelutietovarantoon kuvattuja tietoja voi hakea vapaasti avoimen rajapinnan kautta ja hyödyntää erilaisissa digitaalisissa palveluissa. PTV:hen kuvattuja tietoja näytetään esimerkiksi Suomi.fi-verkkopalvelussa sekä kuntien ja hyvinvointialueiden verkkosivuilla ja palvelutarjottimilla.
Jos edustamasi järjestö on pieni, riittää, että yhteys- tai vastuuhenkilöitä on vain yksi. Tarvittaessa samankin henkilön voi nimetä molempiin rooleihin.
Kysymys käyttövelvoitteesta viittaa siihen, onko organisaatiollasi lakisääteinen velvoite käyttää Palvelutietovarantoa. Voit vastata kysymykseen ”ei.”
Kysymykseen IN-rajapinnasta voi vastata, ettette ota sitä käyttöön.
Jokaisen PTV:hen sisältöä tuottavan tulee suorittaa PTV-ajokortti -verkkokoulu. Koulutus on toteutettu sekä suomeksi että ruotsiksi ja sen suorittaminen kestää noin 1,5 tuntia.
Kun DVV on hyväksynyt käyttölupahakemuksen, ja tarvittavat henkilöt järjestössänne ovat saaneet PTV-käyttöoikeudet, voitte kuvata PTV:hen
palvelut
asiointikanavat, joiden kautta asiakas voi hyödyntää palveluja sekä
organisaation perustiedot.
Kuvatut palvelut ja asiointikanavat pitää yhdistää toisiinsa liitoksilla.
Voitte tallentaa tietoja keskeneräisenä eli luonnoksena, jos ette ehdi täyttää kaikkea kerralla. Voitte myös kerätä palveluidenne tiedot jo etukäteen valmiiksi esim. word-dokumenttiin, jolloin tietojen syöttäminen PTV:n käyttöliittymässä on nopeampaa.
Kun sisällöt on kuvattu, järjestönne täytyy varmistaa, että palvelujen ja asiointikanavien tietoja ylläpidetään, kun niihin tulee muutoksia. Korjatkaa tiedot PTV:hen, jos esimerkiksi
aukioloajat muuttuvat
yhteystiedot muuttuvat palveluja ja asiointikanavia lakkautetaan
uusia palveluja ja asiointikanavia perustetaan.
Kouluttakaa kaikki PTV:hen sisältöä tuottavat henkilöt. Huolehtikaa myös osaamisen siirtämisestä henkilövaihdosten yhteydessä.
Entä jos järjestö käyttää toimintansa kuvaamiseen Lähellä.fi-verkkopalvelua?
Toinen tapa saada palvelut PTV:hen on kuvata ne Lähellä.fihin. Sieltä tiedot tuodaan joka yö Palvelutietovarantoon.
Lähellä.fi vastaa integraation teknisestä toteutuksesta ja ylläpidosta. Integraatioon liittyvistä ongelmista voi olla yhteydessä osoitteeseen info@lahella.fi
Mikä on Lähellä.fi?
Lähellä.fi on valtakunnallinen järjestötietopalvelu, josta kansalaiset löytävät tietoa järjestöistä ja niiden tarjoamista palveluista. Palvelun toteutuksesta vastaa 17 alueellista järjestötoimijaa.
Integraatio Lähellä.fistä PTV:hen
Lähellä.fistä tuodaan rajapinnan kautta tiedot PTV:hen kerran vuorokaudessa. PTV:stä ei kulje tietoa Lähellä.fin suuntaan. Kun tiedot on tuotu Lähellä.fistä PTV:hen, ne ovat kenen tahansa hyödynnettävissä PTV:n avoimen rajapinnan kautta. Ensimmäisessä vaiheessa Lähellä.fistä siirtyy vain suomenkielistä tietoa.
Miksi Lähellä.fistä tuodaan tietoja PTV:hen?
Integraation tavoitteena on tarjota etenkin pienille järjestöille matalan kynnyksen väylä tuottaa sisältöjä PTV:hen, jotta niitä voidaan hyödyntää esimerkiksi hyvinvointialueiden palvelutarjottimilla. Lähellä.fihin rekisteröitymisprosessi on kevyempi kuin PTV-käyttöönotto ja tietojen syöttäminen on hieman kevyempää.
Mitä tietoja Lähellä.fistä tuodaan?
Lähellä.fi:stä PTV:hen tuodaan
organisaatiot. Niistä tulee PTV:ssä Lähellä.fi-organisaation alaorganisaatioita.
”Tukea ja apua” sekä ”Harrastukset ja vapaa-aika” -kategorioiden sisältämät palvelut. ”Vapaaehtoistoiminta”-kategorian sisältöjä ei tuoda PTV:hen.
pitkäkestoiset ja useita kertoja toistuvat palvelut, ei yksittäisiä tapahtumia.
Miten tiedot muodostetaan?
Lähellä.fi-tietomalli vastaa suurelta osin PTV-tietomallia, eli molemmista järjestelmistä löytyy samat tietokentät ja siksi tietojen siirtäminen järjestelmästä toiseen on mahdollista. Lähellä.fi on myös tehnyt omaan järjestelmäänsä, luokituksiinsa ja ohjeisiinsa useita muutoksia datan yhdenmukaisuuden ja laadun varmistamiseksi.
Lähellä.fissä kuvataan toimintailmoituksia, PTV:hen kuvataan palveluita ja asiointikanavia. Integraatiossa Lähellä.fi-toimintailmoituksesta muodostetaan PTV:hen palvelu ja toimintailmoitukselle annetuista yhteystiedoista muodostetaan PTV:hen asiointikanavia. Tämän jälkeen luodut palvelut ja asiointikanavat liitetään yhteen.
Lähellä.fistä puuttuu osa PTV:ssä pakollisista kentistä, joten osa tiedoista muodostetaan koneellisesti.
Esimerkkejä:
PTV:ssä on pakollisena tietona alue, jolla organisaatio pääsääntöisesti tarjoaa palveluja. Tietoa ei ole Lähellä.fissä, joten tieto muodostetaan organisaation toimipaikan osoitteen perusteella.
PTV:ssä on pakollisena tietona organisaation tiivistelmä. Tiivistelmä muodostetaan koneellisesti käyttämällä organisaation nimeä, toimialatietoja sekä tietoja kategorioista, joihin se on kuvannut palveluita: Esimerkiksi ”[yhdistyksen nimi] on [toimialan x] yhdistys, joka tarjoaa [tukea ja apua], [vapaa-ajan toimintaa] ja [vapaaehtoistoimintaa].”
Lähellä.fi-teemojen ja PTV-palveluluokkien vastaavuudet
Osana integraation toteutusta on tunnistettu vastaavuudet Lähellä.fin teemojen ja PTV:ssä käytettävien palveluluokkien välillä. Lähellä.fi-toimintailmoituksista muodostettaville PTV-palveluille annetaan vastaavuuksien mukaiset palveluluokat. Joissain tapauksissa vastaavuuksien luomisessa on käytetty myös Lähellä.fin ”Toiminnan muodot” -luokkaa.
Lähellä.fissä ei ole mahdollista antaa toimintailmoitukselle asiasanoja. Siksi kullekin Lähellä.fi-teemalle on valittu kaksi asiasanaa, jotka annetaan automaattisesti toimintailmoituksesta muodostettavalle palvelulle. Ratkaisu on väliaikainen ja Lähellä.fi suunnittelee PTV:ssä käytössä olevan asiasanaston käyttöönottoa. Tarkemmat tiedot metatietojen vastaavuuksista löytyvät integraation määrittelydokumentista, johon on linkki tämän sivun lopussa.
Lähellä.fistä uusia hyödyllisiä tietoja PTV:hen
Lähellä.fi-integraation kautta PTV:hen saadaan myös uusia, palvelutiedon loppukäyttäjälle hyödyllisiä tietoja, joita ei muuten ole PTV:ssä. Esimerkiksi:
Jokaiselle palvelulle annetaan tieto siitä, pitääkö palveluun ilmoittautua. Tieto tuodaan sanallisesti Toimintaohje-kenttään. Lisäksi tarkemmat ilmoittautumisohjeet tuodaan liitoksen lisätietoihin.
Ehdot ja kriteerit -kenttään tuodaan tieto siitä, minkä ikäisille ja mille sukupuolille palvelu on tarkoitettu.
Lähellä.fi-toimintailmoituksissa on myös kattavasti tieto palvelun maksullisuudesta. PTV:ssä tämä ei ole pakollinen tieto.
Haluan, että järjestöni tiedot siirtyvät Lähellä.fistä PTV:hen. Miten toimin?
Jos järjestösi on ottanut käyttöön Lähellä.fin, mutta ei PTV:tä, sinun ei tarvitse tehdä mitään muuta kuin kuvata toimintailmoitukset Lähellä.fihin ja pitää ne ajan tasalla. Tiedot siirtyvät automaattisesti Lähellä.fistä PTV:hen joka yö integraation mukana.
Yhdistykseni on ottanut PTV:n käyttöön, mutta haluaa poistua PTV:stä ja siirtyä käyttämään Lähellä.fitä. Miten toimin?
Riittää, että lähetät asiasta pyynnön osoitteeseen ptv-tuki@dvv.fi sitten kun poiston saa tehdä. PTV-tuki arkistoi tällöin organisaation palveluineen ja asiointikanavineen PTV:stä. Kun tämä on tehty, järjestösi palvelut alkavat siirtyä integraation mukana Lähellä.fistä PTV:hen joka yö.
Olen kuvannut samoja tietoja sekä Lähellä.fihin että PTV:hen. Miten estetään, ettei PTV:hen siirry päällekkäistä tietoa?
Lähellä.fi tarkistaa PTV:ssä olevien organisaatioiden Y-tunnukset ja vertaa niitä Lähellä.fissä oleviin Y-tunnuksiin. Jos jokin Y-tunnus löytyy molemmista järjestelmistä, tietojen siirtyminen estetään koneellisesti, ettei PTV:hen tulisi päällekkäisiä tietoja. Jos järjestösi siis on ottanut käyttöön sekä Lähellä.fin että PTV:n ja syöttänyt PTV:ssä organisaation Y-tunnuksen, Lähellä.fihin kuvatut sisällöt eivät siirry PTV:hen. Jos Y-tunnusta ei ole annettu, PTV:hen muodostuu tuplaorganisaatio, joten, huolehdithan, että organisaatiollasi on PTV:ssä Y-tunnus.
Haluan lopettaa Lähellä.fin käytön ja siirtyä ylläpitämään tietoja PTV:ssä. Miten toimin?
Hae PTV:n käyttölupaa.
Kun käyttölupa on myönnetty, käy Lähellä.fissä muuttamassa organisaatiosi nimen ja Y-tunnuksen kirjoitusasua siten, että ne poikkeavat hieman PTV-hakemuksessa olevista. Sen jälkeen odota seuraavan vuorokauden puolelle, että muuttunut data on siirtynyt Lähellä.fistä PTV:hen. (Data siirtyy Lähellä.fistä PTV:hen joka aamuyö).
Kirjaudu PTV-pääkäyttäjätunnuksilla PTV-käyttöliittymään, jolloin sinne muodostuu oikealla nimellä ja Y-tunnuksella järjestösi organisaatiotieto. PTV:ssä on kuitenkin edelleen myös Lähellä.fistä siirtynyt vanha organisaatio sisältöineen.
Seuraavaksi kopioi vanhan organisaation alta palvelut ja asiointikanavat uuden organisaatiosi alle, muokkaa ne julkaisuvalmiiksi ja jätä ne luonnostilaan.
vaihtoehto 1: Mikäli järjestösi haluaa jatkossa ylläpitää tietoja vain PTV:ssä, käy kopioimisen jälkeen poistamassa organisaatiosi ja sen sisällöt Lähellä.fistä, arkistoi Lähellä.fistä tullut organisaatio (organisaation arkistoiminen arkistoi myös sen alla olevat sisällöt) ja julkaise sitten uuden organisaation alle kopioimasi luonnostilaiset uudet sisällöt.
vaihtoehto 2: Mikäli järjestösi haluaa jatkossa ylläpitää tietoja sekä Lähellä.fissä että PTV:ssä, älä poista lähellä.fissä olevia tietoja,vaan käy muuttamassa Lähellä.fihin Y-tunnus ja järjestön nimi PTV:ssä olevien tietojen kanssa identtiseen muotoon, jotta palvelut eivät jatkossa enää tule PTV:hen.
Voinko ylläpitää tietoja sekä Lähellä.fissä että PTV:ssä?
Järjestö voi itse valita, kuvaako palvelunsa Suomi.fi-palvelutietovarantoon vai Lähellä.fi:hin. Samojen palveluiden kuvaamista sekä Lähellä.fi:hin että PTV:hen ei suositella. Järjestö voi sen kuitenkin perustelluista syistä halutessaan tehdä (jos esimerkiksi järjestöavustus edellyttää Lähellä.fi:hin kuvaamista).
Haluan, että järjestöni tiedot siirtyvät PTV:stä Lähellä.fihin. Miten toimin?
Tämä ei ole mahdollista. Lähellä.fin ja PTV:n välillä toimiva integraatio on yhdensuuntainen, eli tiedot siirtyvät Lähellä.fistä PTV:hen, mutta mitään tietoja ei siirry PTV:stä Lähellä.fihin. Jos haluat, että palvelusi näkyvät sekä Lähellä.fissä että PTV:ssä, sinun tulee kuvata ne Lähellä.fihin.
