TPR-PERHE. Käsikirja. Ohje Huhtikuu 2019

Transkriptio

1 TPR-PERHE Käsikirja Ohje Huhtikuu 2019

2 Käsikirjan tarkoitus Käsikirja on tarkoitettu ohjeeksi ja tueksi TPRperheen ylläpitäjille ja TPR-perheen hyvinvoinnista kiinnostuneille. Käsikirja sisältää yleistä tietoa TPR-perheen kokonaisuudesta, tietojen siirroista ja rajapinnoista sekä yksittäisiä ohjeita eri toiminnoista.

3 Sisältö täytyy päivittää lopuksi Yleistä, dia 5 Palvelurekisteri, dia 9 Toimipisterekisteri, dia 14 Esteettömyyssovellus, dia 24 Organisaatiorekisteri, dia 32 Rajapinnat, dia 35 Tekniset kuvaukset, dia 40 PTV ja TPR, dia 46 Lähdejärjestelmistä tulevien kenttien käsittelysäännöt toimipisterekisterissä, dia 59

4 Termistöä Asiasana Toimipisteille valitaan toimipisterekisterissä asiasana, eli palvelu, mitä toimipiste tarjoaa. Asiointipalvelu Asiointipalvelu on palvelua, jota annetaan joko henkilökohtaisesti, verkkopalveluna, puhelimitse tai sähköpostilla. Ontologia Konepäättelyä tukevassa muodossa esitetty sanasto, jossa määritellään sovellus- tai aihealueen käsitteiden hierarkkiset suhteet Ontologiatyö on tehty TPR-perheen pellin alla. Palvelu Palveluita ovat kaikki julkiset (ei pelkästään kunnan), palvelut. Palvelut kuvataan palvelurekisterissä. Palvelukartta Palvelut kartalla, Kertoo palvelujen saavutettavuuden pääkaupunkiseudulla. Palvelutietovaranto (lakisääteinen) (PTV) Valtion palvelutietovaranto kerää yhteen tietokantaan kaikki Suomen palvelut ja tarjoaa niitä rajapinnan kautta eri palveluihin. REST-rajapinta REST (Representational State Transfer) on HTTP-protokollaan perustuva arkkitehtuurimalli ohjelmointirajapintojen toteuttamiseen. Toimipisteiden, palveluiden ja palvelukartan tiedot ovat käytettävissä avoimena datana REST-rajapinnalla. Toimipiste Toimipiste on fyysinen piste, joka tarjoaa palvelua. Tarjonta voi olla lääkärin vastaanotto, veistos, koirapuisto, kirjasto, jne. Toimipisteet ovat toimipisterekisterissä. Toimipiste ei ole paras sana kuvaamaan rekisteriä, mutta koska sitä käytetään niin laajalti, ei sanaa toistaiseksi kannata vaihtaa. Toimipisterekisteriperhe vs toimipisterekisteri Toimipisterekisterin rinnalle on tullut palvelurekisteri, esteettömyyssovellus ja organisaatiosovellus. Nämä yhdessä muodostavat TPR-perheen

5 TPR-perhe yleistä Toimipisterekisteri-perhe on keskitetty Pääkaupunkiseutu-tasoinen (PKS) tietovarasto, jonka tietoja ylläpidetään toimialoilla. Toimipisterekisteri-perhe (TPR-perhe) koostuu seuraavista tietokokonaisuuksista, rajapinnoista ja sovelluksista: Toimipisterekisterissä on toimipisteiden yhteystiedot sekä palveluiden asiasanat. Palvelurekisterissä on kuvaukset palveluista ja niiden kanavista. Esteettömyyssovelluksessa on toimipisteiden esteettömyystiedot. TPR-organisaatiosovelluksessa on TPR-perheen organisaatiot. Tietokokonaisuuksiin liittyvät ylläpitosovellukset. Tietokokonaisuuksiin liittyvät avoimet rajapinnat. Pääkaupunkiseudun palvelukartalla esitetään palveluiden saavutettavuus-tieto

6 TPR-perheen tietojen hyödyntäminen TPR-perheen tiedot ovat avointen rajapintojen kautta käytössä mm.: Hel.fi sivujen toimipisteiden tiedot (Esimerkki) Kirjaston sivut, esteettömyystiedot, myös PKS tiedot (Esimerkki) Helsingin kaupungin palveluhakemisto Helsingin kaupungin Paikkatieto Vipunen (Intranet-versio) Valtion Suomi.fi -sivusto, myös PKS tiedot Vantaan karttapalvelu Espoo.fi toimipisteiden yhteydessä palvelukarttaupotus Palvelukartta, myös PKS tiedot Palvelukartalla näkyvät toimipisteen perustietojen, esteettömyyden, lisätietojen, ja palautteen lisäksi myös tiedot mahdollisesta tapahtumista tapahtumarajapinnan kautta, sekä tilanvarausjärjestelmässä olevat tiedot tilanvarausjärjestelmän rajapinnan kautta. Helsinki Region Infoshare (HRI) sivusto (avoindata)

7 TPR-perheen tietojen tuottaminen TPR-perheen tietokokonaisuuksiin tietoja tuottavat Helsingin kaupungin toimialat Espoo, Vantaa, Kauniainen HSY HUS Aalto-yliopisto Yksityiset- ja sopimuskoulut Toimipisterekisteriin luetaan tietoja rajapintojen kautta (tarkemmat tiedot dioissa ) CodeServer (Helsinki Sote-tiedot) Efecte (Helsinki henkilöstö- ja oppilas-, opiskelija ja päiväkotiruokalat) Lipas (valtakunnallinen liikuntarekisteri) JLY:n (Jätelaitosyhdistys ry) Helmet / Kirkanta (kirjasto) Nobil-api (sähköautojen latauspisteet) Suomi.fi PKS Osoitemaster Visit Helsinki

8 TPR-perheen tietojen ylläpito TPR-perheen tietoja ylläpidetään ylläpitosovelluksissa tai luetaan rajapintojen kautta lähdejärjestelmistä. Rajapintojen kautta tulleita tietoja voidaan myös rikastuttaa TPR-perheen ylläpitosovellusten kautta. Tiedot tuotetaan rajapintoihin kolmella eri kielellä: suomi, ruotsi ja englanti. TPR-perheen ylläpito tapahtuu osoitteessa joka vie TPR -perheen aloitussivulle. Tunnukset ylläpitoon saa ylläpitäjiltä TPR-perheessä on nimettyjä tietojen ylläpitäjiä Helsingin kaupungin toimialoilla, PK-seudulla sekä sidosryhmissä

9 Palvelurekisteri

10 Yleiskuvaus Palvelurekisteriin kuvataan yhtenäisellä tavalla julkiset palvelut, niin fyysiset kuin sähköisetkin. Tarkoituksena on, että palvelukuvauksesta saa yhdellä silmäyksellä yleiskatsauksen palvelun sisältöön ja sen, mistä palvelua saa. Palvelut kuvataan rekisteriin ja tiedot välittyvät yhdellä tallennuksella automaattisesti tietoja hyödyntäviin sovelluksiin rajapintoja pitkin. Palvelurekisteriin kuvataan vain palvelut, ei organisaatiota, päätöksentekoa tai muuta yleistietoa. Palvelurekisterissä ei myöskään kuvata toimipistettä, joka palvelua tuottaa. Se tieto kuvataan toimipisterekisterissä

11 Palvelurekisterin tietojen hyödyntäminen Palvelurekisteriin tallennetut tiedot ovat kaikkien, myös kaupungin ulkopuolisten kehittäjien käytettävissä avoimen REST-rajapinnan kautta, Helsingin kaupungissa Palvelurekisteristä tiedot nostetaan automaattisesti Hel.fi -sivuille, kohtaan Kaupungin palvelut, lisäksi eri kohderyhmien sivuille sekä toimialojen sivuille, esim. Valtion Suomi.fi -sivustolla näkyvät kaikki PKS tiedot

12 Palvelurekisterin tietosisältö Palvelurekisterissä kuvataan: 1. palvelut, pääkuvaus (esim. ohjattu liikunta) 2. alipalvelut, joilla halutaan tarkentaa pääkuvausta, jotta pääkuvauksesta ei tule liian pitkä hahmotettavaksi ja ymmärrettäväksi (esim. ohjattu liikunta erityisryhmille, lapsille tai vanhuksille) 3. pääkuvaukseen liittyvät asiointipalvelut (esim. ilmoittautuminen ohjatun liikunnan järjestämille liikuntakursseille) 4. asiointipalvelun eri palvelukanavat kuten sähköinen asiointi (esim. sähköinen kurssiilmoittautuminen liikuntakursseille), puhelinpalvelu (esim. kurssi-ilmoittautuminen puhelimitse), palveluun mahdollisesti liittyvä tulostettava lomake, sähköposti tai henkilökohtainen palvelu. Lisäksi kuvataan kunkin palvelukanavan käytön ehdot (esim. sähköisen lomakkeen käyttö vaatii tunnistautumista, puhelinpalvelun aukioloaika). Toimipisteen yhteystiedot kuvataan toimipisterekisterissä. Toimipisteet ja palvelut tulee kuvata erikseen, sillä yhdessä toimipisteessä voidaan antaa useita palveluja, tai sama palvelu voi olla saatavilla useassa eri toimipisteessä

13 Liittyvät ohjeet ja raportit Palvelurekisterin käyttöohje Laadunvalvonta raportit (valmistuu maaliskuun 2019 aikana) Toimitetaan ylläpitäjille kerran kuukaudessa. Raportteja jaa myös pyydettäessä

14 Toimipisterekisteri

15 Yleiskuvaus Toimipisterekisterissä kuvataan yhdenmukaisesti toimipisteiden perustiedot, aukioloajat, yhteystiedot ja lisähakusanat. Toimipiste liitetään palvelun asiasanoihin. Toimipiste liitetään organisaatioon. Toimipisteelle voidaan määritellä näkyvyys, esimerkiksi joulukuusen myyntipaikat ovat näkyvissä vain joulukuussa. Toimipisterekisterin Palvelutietovarantoon vientiä varten asiasanat on valmiiksi yhdistetty valtion KOKO-ontologiaan ja JUPO-palveluluokkiin. Toimipiste voi olla esimerkiksi kirjasto, päiväkoti, koirapuisto, mattolaituri, jalkapallokenttä, veistos tai pysäköintilippuautomaatti. Toimipisterekisterisovellus itsessään sisältää käyttäjää auttavaa kenttäkohtaista ohjeistusta

16 Selitteet Toimipisterekisterissä kenttien yhteydessä on punaisia, oransseja tai vihreitä lukkoja. Tieto tulee tietolähteestä, eikä sitä voi muokata toimipisterekisterissä. Nämä kentät ovat harmaina, eikä niitä pääse muokkaamaan. Tieto tulee tietolähteestä, mutta sitä voi rikastaa toimipisterekisterissä. Esim. Voi valita organisaation, joka on tietolähteestä tullutta organisaatiota syvemmällä tasolla Tietoa voi päivittää ja muokata vapaasti 16

17 Toimipisterekisteri tietojen hyödyntäminen Toimipisterekisteriin tallennetut tiedot ovat kaikkien, myös kaupungin ulkopuolisten kehittäjien käytettävissä avoimen REST-rajapinnan kautta, Helsingin kaupungissa Toimipisterekisteristä tiedot nostetaan automaattisesti Hel.fi -sivuille, kohtaan Ota yhteyttä, Toimipisteiden tiedot näytetään palvelukartalla palvelukartta.hel.fi Toimipisteiden tiedot näytetään Hel.fi-sivuston palveluhakemiston palvelukuvauksen yhteydessä Valtion Suomi.fi -sivustolla näkyvät kaikki PKS tiedot

18 Toimipisterekisterin tietosisältö 1/2 Toimipisteen perustiedot: - Toimipisteen nimi ja kuvaus - Jos toimipisteellä ei ole toimipisteen kuvausta, muodostetaan TPR-perheen pellin alla automaattilause. Palvelutietovaranto vaatii kuvauksen. Puuttuva kuvaus korvataan automaattilauseella, mikäli toimipisteen lyhyt tai pitkä kuvaus kenttiä ei ole täytetty. Automaattilause ei näy missään muualla kuin Suomi.fi-sivustolla. - Osoitetiedot. Toimipisteen sijaintia on mahdollista tarkentaa kartalla. - Yhteystiedot ja kotisivut. - Julkisuus ja näkyvyys. - Toimipisteen liittäminen organisaatioon. Toimipisteen palveluiden asiasanat: - osaan voidaan tarvittaessa liittää lukuvuositieto ja tarkenne

19 Toimipisterekisterin tietosisältö 2/2 Aukiolotiedot, aukiolotieto voi olla tyypiltään Kalenteri Teksti Linkki Lisätiedot: Lisätiedoissa voidaan lisätä lisätieto linkki, yhteystieto tai yhteyshenkilö Lisätiedoissa voidaan käyttää järjestysnumerointia, jolla voidaan vaikuttaa siihen missä järjestyksessä lisätietotyypin sisällä tieto näkyy palvelukartalla, esimerkkinä Itäkeskuksen uimahalli Valokuva: toimipisteelle voidaan lisätä linkki valokuvaan ja kuvateksti. TPR-perheessä ei ole mahdollisuutta tallentaa valokuvia. Kuvatekstissä tulee kertoa saavutettavuusdirektiivin mukaisesti, mitä kuvassa tapahtuu. Pelkkä kuvan nimi tai kuvaaja ei riitä. Lisähakusanat: toimipisteelle voidaan lisätä lisähakusanoja, jotka helpottavat toimipisteen löytymistä hakukoneilla

20 Tietojen ylläpito Toimipisterekisterin tietoja ylläpidetään ylläpitokäyttöliittymässä tai luetaan rajapintojen kautta lähdejärjestelmistä. Rajapintojen kautta tulleita tietoja voidaan myös rikastuttaa toimipisterekisterin ylläpitokäyttöliittymän kautta. Katso säännöt dioista 59- Toimipisterekisterissä on joukkopäivitysmahdollisuus, jolla voidaan päivittää useiden toimipisteiden tietoja kerrallaan. Superoikeuksilla on mahdollisuus toimipisterekisterin ylläpitokäyttöliittymän kautta luoda uusia asiasanoja sekä liittää ne palvelupuuhun sekä valtion KOKO-ontologiaan sekä JUPOpalveluluokitukseen

21 Tietojen muokkaus ja lukitut tiedot 1/2 Kenttiä, joissa on punainen, kiinni oleva lukko, ei voi muokata. Tieto tulee tietolähteestä. Kentät on lukittu. Kenttiä, joissa on vihreä, auki oleva lukko, voi päivittää ja muokata. Kenttiä, joissa on oranssi lukko, voi muokata tietyin rajauksin: Nimi-kentässä tietoa saa lisätä. Lähdejärjestelmästä tuleva nimi pitää olla kentässä, mutta sen lisäksi saa tietoa kenttään lisätä Asiasana-välilehti: Lähdejärjestelmästä tulevat asiasanat on lukittu ja merkitty punaisella kiinni olevalla lukolla Uusien asiasanojen listassa näkyvät vain ne asiasanat, joita voi lisätä kyseiselle toimipisteelle HUOM! Ohjetta kirjoitettaessa lukkoja ei vielä ole, mutta ne tulevat huhtikuun 2019 aikana. Nyt kiinni olevat kentät voi katsoa dioista

22 Tietojen muokkaus ja lukitut tiedot 2/2 Aukioloajat Jos kentässä on punainen kiinni oleva lukko, aukioloaika tulee lähdejärjestelmästä ja sitä ei voi muokata. Et voi myöskään lisätä uutta aukioloaikatietoa. Yhteystiedot Jos kentässä on punainen kiinni oleva lukko, yhteystieto tulee aina lähdejärjestelmästä. Uusia yhteystietoja lisätään lähdejärjestelmään, ei toimipisterekisteriin Lisätiedot ja linkit Jos tieto tulee lähdejärjestelmästä, kentän kohdalla on punainen kiinni oleva lukko. Tietoa ei voi muokata, eikä järjestystä voi järjestää. Tiedot, joita ei voi lisätä, eivät näy valikossa. Valokuva

23 Liittyvät ohjeet ja raportit TPR järjestysnumerointi TPR-joukkopäivitys Laadunvalvonta raportit (valmistuu maaliskuun 2019 aikana)

24 Esteettömyyssovellus Etunimi Sukunimi 24

25 Mitä on esteettömyys? Esteettömyydessä on kyse ihmisten moninaisuuden huomioonottamisesta muun muassa rakennetun ympäristön ja julkisen liikenteen suunnittelussa ja toteuttamisessa. Se merkitsee palvelujen saavutettavuutta, välineiden käytettävyyttä, tiedon ymmärrettävyyttä ja mahdollisuutta osallistua itseä koskevaan päätöksentekoon. Lähde: Invalidiliitto ry

26 Yleiskuvaus Esteettömyyssovelluksen tarkoituksena on kerätä toimipisteiden saavutettavuudesta perustietoa yhdenmukaisin kysymyksin ja kriteerein. Vastausten perusteella muodostetaan toimipisteiden esteettömyyslauseet ja esteettömyyden puutelauseet, jotka julkaistaan avoimen rajapinnan kautta. Esteettömyystietoa esitetään toimipisteiden tietojen yhteydessä mm. Suomi.fi ja pääkaupunkiseudun palvelukartta palveluissa Esimerkkejä esteettömyyslauseista: Liikkumisesteisten 3 autopaikkaa sijaitsevat katoksessa alle 10 m sisäänkäynnistä. Pysäköintiruudun leveys on vähintään 3,6 m. Kulkureitti sisäänkäynnille on tasainen ja riittävän leveä sekä valaistu. Esimerkkejä puutelauseista: Profiili: Käytän kuulolaitetta Toimipisteessä ei ole kiinteää, eikä siirrettävää induktiosilmukkaa Profiili: Olen näkövammainen Sisätilojen kulkureiteillä ei ole liikkumista ohjaavaa pintamateriaalia (tummuus- tai tuntokontrasti) Sisätiloissa ei ole opasteita eri tiloihin (esim. asiakaspalvelutiskille, wc:hen) Esteettömyystieto tuotetaan esimerkiksi päiväkodeissa, kouluissa ja muissa toimipisteissä. Tallentaja on toimipisteen oma työntekijä. Hän voi helposti tarkistaa esim. portaiden määrän sisäänkäynnissä tai esteettömän wc:n opasteen sijainnin

27 Yhteistyö Väestörekisterikeskuksen kanssa Esteettömyyssovelluksen osalta tehdään yhteistyötä Väestörekisterikeskuksen (VRK) kanssa. Helsinki on antanut esteettömyyssovelluksen ja tietokannan kansalliseen käyttöön. Tietokanta ja sovellus sijaitsevat VRK:n palvelinympäristössä. Helsinki on esteettömyyssovelluksen omistaja. Kehitys tapahtuu yhteistyössä VRK:n kanssa

28 Esteettömyyssovelluksen. tietosisältö Esteettömyyssovelluksen kysymyslomakkeessa on kuusi eri aihealuetta: 1.Liikkumisesteisten autopaikat 2.Saattoliikenne 3.Kulkureitti sisäänkäynnille 4.Sisäänkäynti 5.Sisätilat 6.Kokouskysymykset (varausjärjestelmä hakee kysymykset rajapinnan kautta) Kysymykset on laadittu seuraaville toimipistetyypeille: asiointipiste, pitempi-aikaiseen oleskeluun tarkoitettu tila(koulu, päiväkoti jne), uimahalli, maauimala, kuntosali, monitoimihalli, jäähalli, yleisövessa, kirkkosali, kappeli, uimaranta, ulkokuntoiluvälineet lähiliikuntapaikassa, kokoustilat. Vastauksestasi riippuen saadaan tarkentavia kysymyksiä liittyen tasoeroihin, hissiin, portaisiin, esteettömään wc:hen. Kysymysten kohdalla on tarvittaessa vastaamista helpottava ohje ja kuva: Ohjeet ja kysymykset voi tulostaa tarvittaessa: Aikaa kysymyksiin vastaamiseen menee minuuttia

29 Esteettömyys tietojen hyödyntäminen Pääkaupunkiseudulle tuotetaan esteettömyys-raportit ja tilastot. Näistä saadaan tietoa toimipisteiden esteettömyyden tilasta. Tietoa voidaan hyödyntää esimerkiksi toimipisteiden perusparannuksissa ja toiminnan suunnittelussa. Palvelukartalla PK-seudun toimipisteistä kerrotaan toimipisteiden esteettömyystiedot ja niitä voi tarkastella eri profiilien kautta. Profiilit ovat seuraavat: Käytän kuulolaitetta Olen näkövammainen Minun on vaikea erottaa värejä Käytän pyörätuolia Olen liikkumisesteinen Käytän rollaattoria Työnnän rattaita

30 Kaupungin hallituksen päätös saavutettavuuteen liittyen Kaupungin hallituksen päätöksen mukaan Palvelukartalla esitetään toimipisteen saavutettavuus, joka muodostuu seuraavista: 1.Toimipisteen/palvelun sijainti 2.Toimipisteen/palvelun yhteystiedot 3.Liikenneyhteydet 4.Toimipisteen esteettömyystiedot Helsingin kaupungin aineistopankki (Kaupunginhallituksen päätös ) Mirjam Heikkinen, Kaupunginkanslia, Tietotekniikka

31 Liittyvät ohjeet ja raportit Esteettömyyssovelluksen täyttöohje (sisältää kysymykset) Esteettömyysohjeet Esteettömyys raportit ja tilasto

32 Organisaatiorekisteri

33 Yleiskuvaus ja tietosisältö Organisaatiosovelluksessa ylläpidetään TPR-perheen organisaatiot ja organisaatiotasot. Organisaatiosovelluksessa määritellään TPR-perheen käyttöoikeudet organisaatiotasoittain. Organisaatiosta kuvataan Organisaation tyyppi, Y-tunnus ja kunnan numero Nimi, lyhenne ja kuvaus OID-koodi Voimassaolo ja näkyvyystietojärjestelmissä Yhteystiedot ja osoitetiedot Käyttöoikeudet Organisaatiopuuhun voidaan luoda tulevaisuuden organisaatio vanhan rinnalle ja voidaan määritellä milloin uusi organisaatio astuu voimaan. Käyttäjät osiossa organisaation pääkäyttäjä voi ylläpitää oman organisaationsa TPR-perheen käyttäjätietoja

34 Organisaatiorekisteri tietojen hyödyntäminen Tietoja hyödynnetään tällä hetkellä vain toimipisterekisterin perheen sisällä

35 Rajapinnat

36 Toimipisterekisteriperheen avoimet rajapinnat Toimipisterekisteri perheen tietoja voidaan hyödyntää avoimien rajapintojen kautta esimerkiksi palvelukartalla. Rajapinnat löytyvät: Pääkaupunkiseudun palvelurekisterin rest-rajapinta Pääkaupunkiseudun toimipisterekisterin rest-rajapinta

37 Tietosiirrot (tekninen)

38 Tekninen Arkkitehtuurikuvat Tietomalli Tietovirtakaavio TPR/ Hetaympäristö

39 Helsingin sisäverkko HKI DMZ Internet REST rajapinta Esteettömyysrajapinta Intra-käyttäjä Business Objects BO-palvelimet Palvelurekisteri Toimipisterekisteri Org.rekisteri / Käyttäjienhallinta Authentication Server Esteettömyyssovellus asiointi.hel.fi Internet-käyttäjä & HKI sisäinen käyttäjä Hallinnon karttapalvelu (MML) Sovelluspalvelin Sovelluspalvelin Ulkoiset tiedon kohteet Informatica 9 Informatica palvelin Kansallinen palvelutietovaranto PTV postgresql TPR Organisaatiorekisteri Käyttäjätiedot EnterpriseDB (postgresql) Esteettömyys Ulkoisen tiedon lähteet PTV Lipas Tiedon lähteet sisäverkossa Palvelurekisteri Suomi.fi NOBIL API CodeServer Osoitemaster LPH-Effica YPH-Effica ATJ Tietokantapalvelin Tietokantapalvelin JLY:n -rajapinta Matko Nuolen suunta: kuvaa mihin suuntaan yhteys otetaan TPR-perhe 01/2019 HelMet tietokanta

40 Toimipisterekisterin rest-rajapinnan tietomalli Janne Pyykkö, CGI, palvelukuvaus id kieli id nimi synonyymit lyhyt kuvaus pitkä kuvaus käytön edellytykset ajallinen saatavuus lisätietoja PTV-pohjakuvaus linkit palvelukielet kohderyhmät elämäntilanteet relaatio palvelukuvausasiointipalvelu asiointipalvelu id kieli id nimi synonyymit (tulossa) lyhyt kuvaus käsittelyn eteneminen käsittelyaika voimassaoloaika maksut lisätietoja linkit palvelukielet kohderyhmät elämäntilanteet palvelukuvauksen asiasanat palvelukuvauksen paikka puussa palvelukuvauksen toimipisteet palvelukuvauksen vastaavat yksiköt asiointipalvelun kanavat asiointipalvelun vastaavat yksiköt asiasana id asiasana fi/sv/en relaatio asiasana-puu puu solmu id ylemmän solmun id solmun nimi fi/sv/en kanava id kieli id nimi käytön edellytykset lisätietoja prosessin kuvaus linkit palvelukielet ajallinen saatavuus toimipisteen asiasanat toimipiste puussa toimipisteen palvelukuvaukset toimipiste id yksikkö id sopimuslaji sopimuslajin tarkennus nimi fi/sv/en ulkoinen tietolähde kuvaus fi/sv/en koordinaatit käyntiosoite postiosoite puhelin faksi sähköposti kotisivu fi/sv/en valokuva url valokuvateksti fi/sv/en Google katunäkymä lisähakusanat fi/sv/en esteettömyyden peruslause toimipisteen peruslauseet lauserunko id lauseryhmä fi/sv/en lause fi/sv/en yksikön toimipisteet toimipisteen yhteyshenkilöt esteettömyyden puutelause profiili id puuteotsikko fi/sv/en puute fi/sv/en yksikkö toimipisteen lisätieto tai aukioloaika id ylemmän yksikön id organisaatio id tyyppi kuntanumero Y-tunnus nimi fi/sv/en lyhenne käyntiosoite postiosoite puhelin sähköposti kotisivu fi/sv/en yhteyshenkilö tehtävä tai otsikko fi/sv/en yhteyshenkilö puhelin sähköposti toimipisteen puutelauseet organisaation yksiköt profiilin puutteet toimipisteissä organisaatio id tyyppi kuntanumero Y-tunnus nimi fi/sv/en käyntiosoite postiosoite puhelin sähköposti kotisivu fi/sv/en lisätieto tai aukioloaika tyyppi teksti fi/sv/en linkki fi/sv/en esteettömyyden profiili profiili id profiilin nimi fi/sv/en

41 YLEISKUVA TPR-perheen tietovirtakaavio TIETOLÄHDE RYTMI RIVIMÄÄRÄ OSOITEMASTER joka yö ~ CODESERVER satunnaisesti ~4000 EFECTE pe-la yönä ~500 HELMET joka yö ~100 KIERRATYSINFO joka yö ~600 LIPAS joka yö ~5000 NOBIL joka yö ~300 PH-EFFICA joka yö ~600 VISITHELSINKI joka yö ~6000 LÄHDE Infa klo Infa klo 05 TPR-perhe POSTGRE tpr_prod or_prod prek_prod repo_prod in_prod 24/7 24/7 Infa klo Ylläpito VRK esteettömyys REST POSTGRE ar_prod SIIRRETTÄVÄ KOKONAISUUS RIVIMÄÄRÄ PALVELUKUVAUKSIA ~ josta Helsinki ~520 KANAVIA ~190.. josta Helsinki ~150 TOIMIPISTEITÄ ~ josta Helsinki ~6 000 PTV-vienti klo 19 PTV Suomi.fi REST ajan tasalla joka tunti Hel.fi JULKAISTAVA KOKONAISUUS RIVIMÄÄRÄ PALVELUKUVAUKSIA ~ josta Helsinki ~750 KANAVIA ~220.. josta Helsinki ~170 TOIMIPISTEITÄ ~ josta Helsinki ~7 500

42 Heta ja TPR-ympäristö SAP Hijat Helmet CodeServer Lipas Muut tietolähteet Informatica BusinessObjects Heta-tietovarasto Toimipisterekisteri tietovaranto Toimipisterekisteri sovellukset Muut tietovarastot Talousraportointi Toimipisterekisteri raportit Henkilöstöraportointi Mittaristot Helmi-intranet

43 Kansallinen palvelutietovaranto (PTV) ja TPR-perhe

44 Kansallinen palvelutietovaranto (PTV) ja TPR-perhe FINTO Arkistointi Yleistä siirroista Pakolliset kentät Yleisimmät ongelmat / virheet Pohjakuvaukset Palveluluokat Palvelukuvausten lisätietojen linkit

45 PTV ja TPR-perhe PK-seudun kuntien tiedot viedään valtion palvelutietovarantoon (PTV) keskitetysti TPRperheestä PTV:n IN-rajapinnan kautta. Helsingin kaupungin kaupunginkanslian tietohallinto vastaa teknisestä ratkaisusta ja ylläpidosta. Tietoja ei päivitetä manuaalisesti PTV:n käyttöliittymässä. Kunnilla on kullakin oma PTV pääkäyttäjä, jonka vastuulla on kunnan PTV-tunnus ja API tunnus. Kunkin kunnan tiedot viedään PTV:hen hyödyntäen kunnan omaa API-tunnusta. Kunnan pääkäyttäjällä on oikeus antaa PTV-käyttöoikeuksia kunnan sisällä

46 PTV:hen siirrettävät tiedot Toimipisteet Perustiedot: nimi, kuvaukset, osoitteet, yhteystiedot Aukioloajat: kalenterimuotoinen aukioloaikatieto Palvelukuvaukset, asiointipalvelut ja niiden kanavat Organisaatio on PTV:ssä ainoastaan kuntatasolla. Esteettömyystiedot ovat PTV:ssä, koska esteettömyyssovellus ja tiedot ovat Helsingin ja valtion yhteisessä käytössä

47 Pohjakuvaukset Palvelutietovaranto on tuottanut omat palveluiden pohjakuvaukset lakisääteisistä palveluista Suomi.fi-sivustoa varten. PTV:n pohjakuvaukset haetaan PTV:stä palvelurekisteriin. Palvelurekisterin kuvauksiin voidaan liittää palvelurekisterissä PTV:n pohjakuvaus

48 Siirtoon liittyviä sääntöjä 1/2 Toimipisteellä tulee olla perustiedot vähintään suomeksi. Mikäli toimipisteelle on valittuna Toimipisteellä ei ole käyntiosoitetta toimipiste ei siirry PTVhen. Mikäli toimipisteellä ei ole täytettynä kuvausta, sille luodaan PTV-siirtoa varten automaattinen kuvauslause. Toimipisteellä tulee olla vähintään yksi asiasana, joka on kuvattu tai sisältyy johonkin kuvaukseen Palvelurekisterissä. Toimipisteen pitää olla kiinnitettynä organisaatioon. Jos sopimuslaji on muu kuin itse tuotettu, tulee valita järjestävän organisaation tyyppi, nimi ja Y-tunnus. Jos on valittu sopimuslaji Ei tiedossa, toimipiste ei siirry PTV:hen. Toimipisteen tulee olla julkinen ja näkyvissä. Toimipisteen aukioloajoista PTV:hen siirtyy ainoastaan kalenterimuotoinen tieto

49 Siirtoon liittyviä sääntöjä 2/2 Palvelukuvauksella tulee olla vähintään yksi toimipiste tai yksi asiointipalvelu ja kanava. Palvelukuvauksella voi olla sekä toimipisteitä että asiointipalveluita. Palvelukuvauksen tulee olla julkaistu. Lakisääteisten palveluiden palvelukuvauksen tulee olla kiinnitetty valtion pohjakuvaukseen. Palvelukuvauksen linkeissä tulee olla valittuna tiedoston pääte. Asiointipalvelun tulee olla kuvattu vähintään suomeksi. Asiointipalvelulla tulee olla vähintään yksi kanava. Sähköpostikanava yksin ei riitä Asiointipalvelut ja kanavat tulee kuvata samoilla kielillä

50 PTV:n AreaType palvelun maantieteellinen laajuus Alla tiedonsiirtokonsultin viesti aluevalinnasta PTV-rajapinnassa. -- PTV:n rajapinnassa tuo tieto on siten, että siellä on palvelulla kenttä AreaType, johon voi laittaa jonkin seuraavista arvoista: Nationwide, NationwideExceptAlandIslands, LimitedType. Me käytämme nyt aina tuota arvoa LimitedType, ja toisessa rajapinnan tällöin vaatimassa tarkentavassa Area.Type -kenttässä arvoa Municipality. Esim. Helsingin tapauksessa: "AreaType": "LimitedType", "Areas": [ { "Type": "Municipality", "AreaCodes": [ "091" ] } ] -- Palvelurekisterissä on nykyään mahdollista valita Alue, jolla palvelu on käytettävissä kenttään arvo: Koko maa, josta muodostuu PTV:hen arvo Nationwide

51 Ontologia ja palveluluokitus TPR:n PTV-vientiä varten TPR-perheen asiasanat on yhdistetty KOKO-ontologiaan ja palvelukuvaukset JUPO-palveluluokitukseen. PTV:n sääntöjen mukaan palvelukuvauksia ei saa yhdistää JUPO-palveluluokituksen päätasoihin. Palvelulla saa on korkeintaan 4 JUPOpalveluluokkaa. FINTO: JUPO: KOKO:

52 PTV arkistointi, esimerkin kautta avattuna Meiltä siirtyy kaikki täydelliset tiedot päivittäin. Mikäli palvelun tai kanavan tiedoissa on jotain puutteita, se ei siirry seuraavan kerran ennen kuin ne korjataan/täydennetään (esim. palvelulla pitää olla vähintään yksi toimipiste tai asiointipalvelun kanava ja toimipisteen sähköpostiosoite pitää olla oikean muotoinen). Jos kuitenkin jo siirretyn palvelun tai kanavan tietoja muutetaan niin, että ne ovat puutteelliset/virheelliset eikä tilannetta korjata yli vuoteen, ei sitä myöskään voida siirtää sinä aikana PTV:oon. Tästä tulee jatkossa PTV:n käytännön mukaan seuraamaan, että sellainen palvelu/kanava arkistoituu vuoden päästä, koska sitä ei ole muokattu. Esimerkki siitä, miten tiedot käyttäytyvät normaalitilanteessa: päivällä lisätään uusi palvelu palvelurekisteriin ja liitetään siihen uusi asiointipalvelu, jolla 1 kanava (esimerkin yksinkertaisuuden vuoksi oletetaan, että ei valittuja toimipisteitä) illalla palvelu ja sen kanava siirtyvät PTV:oon illalla palvelu ja sen kanava siirtyvät PTV:oon päivällä palvelua muokataan siten, että asiointipalveluliitos poistetaan illalla palvelu ei enää siirtyy PTV:oon, koska sillä ei ole yhtään kanavaa (PTV:n asettama ohjeistus/käytäntö tiedon oikeellisuudelle). HUOM! Tässä vaiheessa PTV:ssa on siis yhä viimeisin siirretty versio eli siirretyt tiedot illalla palvelu ei enää siirtyy PTV:oon, koska sillä ei ole yhtään kanavaa (PTV:n asettama ohjeistus/käytäntö tiedon oikeellisuudelle) illalla palvelu ei enää siirtyy PTV:oon, koska sillä ei ole yhtään kanavaa (PTV:n asettama ohjeistus/käytäntö tiedon oikeellisuudelle) kuluuu vuosi tekemättä mitään HUOM! Tässä vaiheessa PTV:ssa on siis yhä viimeisin siirretty versio eli siirretyt tiedot illalla palvelu ei enää siirtyy PTV:oon, koska sillä ei ole yhtään kanavaa (PTV:n asettama ohjeistus/käytäntö tiedon oikeellisuudelle) palvelu arkistoituu PTV:ssa VRK:n toimesta, koska vuosi viimeisestä muokkauksesta PTV:n päässä tuli täyteen (emme saa tästä mitään ohjelmallista tietoa/herätettä) illalla palvelu ei enää siirtyy PTV:oon, koska sillä ei ole yhtään kanavaa (PTV:n asettama ohjeistus/käytäntö tiedon oikeellisuudelle) päivällä palvelua muokataan siten, että sillä on taas asiointipalvelu tai/ja toimipisteitä illalla palvelu ja sen kanava(t) siirtyvät PTV:oon takaisin uusina, koska vanha on arkistoitu. => tästä alkaa taas uusi vuoden kestävä lähtölaskenta arkistointiin. Oletetaan vaihtoehtoisesti, että kohdassa 8 tiedot korjataan (lisätään kanava) esim Tällöin illalla palvelu taas siirtyy PTV:oon ja kohdat 9-14 eivät päde. Sen sijaan tiedot päivittyvät taas joka ilta PTV:oon eikä arkistoitumista pitäisi tapahtua. MUTTA: Kaikkea tätä voi sotkea erilaiset pitkät ongelmatilanteet PTV:n API rajapinnan toiminnassa, jotain esim. tänä vuonna on ollut alkuvuodesta/kesällä. Olemme pyrkineet joitakin asioita ottamaan huomioon siten, että tiedot päivittyisivät sitten kun ongelmatilanne on ohi, mutta jotain jää aina tapauskohtaisesti ratkottavaksi

53 Tiedonsiirrot lähdejärjestelmistä TPRperheen toimipisterekisteriin

54 Selitteet Toimipisterekisterissä kenttien yhteydessä on punaisia, oransseja tai vihreitä lukkoja. Tieto tulee tietolähteestä, eikä sitä voi muokata toimipisterekisterissä. Nämä kentät ovat harmaina, eikä niitä pääse muokkaamaan. Tieto tulee tietolähteestä, mutta sitä voi rikastaa toimipisterekisterissä. Esim. Voi valita organisaation, joka on tietolähteestä tullutta organisaatiota syvemmällä tasolla Tietoa voi päivittää ja muokata vapaasti 60

55 Visithelsinki Matkailuinfo 61

56 VisitHelsinki 1/5 - perustiedot 62

57 VisitHelsinki 2/5 - perustiedot 63

58 VisitHelsinki 3/5 - perustiedot 64

59 VisitHelsinki 4/5 - asiasanat 65

60 VisitHelsinki 5/5 - Aukioloajat 66

61 VisitHelsinki lähteestä tulevat asiasanat #ASIASANA 869 baarit ja yöelämä 138 elokuvateatterit 197 hotellit ja majoitus 864 hyvän olon palvelut 214 juhlatilat 248 kasvitieteelliset puutarhat 314 kirkot ja muut uskonnolliset tilat 326 kokouspaikat 329 konserttitilat 344 kulttuurihistorialliset museot 473 nähtävyydet 474 näyttelytilat (kulttuuri) 479 ooppera- ja balettitilat 490 ostospaikat 577 ravintolat 672 taidemuseot 686 tanssitilat (esitykset) 868 tapahtumapaikat 694 teatterit 786 viheralueet 67

62 Nobil 68

63 Nobil perustiedot 1/3 69

64 Nobil perustiedot 2/3 70

65 Nobil perustiedot 3/3 71

66 Nobil asiasanat 72

67 Nobil aukioloajat 73

68 Nobil lisätiedot 74

69 Nobil lähteestä tulevat asiasanat ASIASANA sähköautojen latauspisteet 75

70 Kierrätysinfo 76

71 Kierrätysinfo perustiedot 1/3 77

72 Kierrätysinfo perustiedot 2/3 78

73 Kierrätysinfo perustiedot 3/3 79

74 Kierrätysinfo asiasanat 80

75 Kierrätysinfo aukioloajat 81

76 Kierrätysinfo - lisätiedot 82

77 Kierrätysinfo lähteestä tulevat asiasanat #ASIASANA 45akkujen keräys 127bio- ja puutarhajätteen keräys 145energiajätteen keräys 246kartonginkeräys 369lamppujen keräys 374lasinkeräys 436metallinkeräys 454muovinkeräys 457muun jätelajin keräys 491pahvinkeräys 496paperinkeräys 497paristonkeräys 531puujätteen keräys 617sekajätteen keräys 668sähkö- ja elektroniikkaromun keräys 696tekstiilien keräys 740vaarallisen jätteen keräys 83

78 Efecte 84

79 Efecte perustiedot 1/3 85

80 Efecte perustiedot 2/3 86

81 Efecte perustiedot 3/3 87

82 Efecte - asiasanat 88

83 Efecte lähteestä tulevat asiasanat #ASIASANA 196hoitoalan ruokapalvelut 338koulu- ja opiskelijaruokailu 860päiväkotiruokailu 89

84 Kirkanta 90

85 Helmet perustiedot 1/3 91

86 Helmet - perustiedot 2/3 92

87 Helmet perustiedot 3/3 93

88 Helmet - avainsanat 94

89 Helmet - aukioloajat 95

90 Helmet - lisätiedot 96

91 Helmet - valokuva 97

92 Kirkanta lähteestä tulevat asiasanat #ASIASANA 155erikoiskirjastot 312kirjastoautopalvelut 368laitoskirjastot 813yleiset kirjastot 98

93 Codeserver Sote-tiedot 99

94 Codeserver perustiedot 1/3 100

95 Codeserver perustiedot 2/3 101

96 Codeserver perustiedot 3/3 Toimipisteen perusorganisaatio tulee tietolähteestä. Ylläpidossa voi tarkentaa alaorganisaatiota 102

97 Codeserver - asiasanat 103

98 Sote Codeserver lähteestä tulevat asiasanat 41aikuisten sosiaaliohjaus 42aikuisten sosiaalityö aikuisten terveyskeskuspäivystys ja 43päivystyspoliklinikka 46akuuttipsykiatria 49alueellinen kumppanuustyö 840ehkäisevä toimeentulotuki 167etuuskäsittely 171fysiatria 172fysioterapia 182hallinto (terveyspalvelut) 184hammashoito 206jalkaterapia kaupungin tai kunnan psykiatriset 263sairaalat 275kehitysvammahuollon asumispalvelut 276kehitysvammahuollon laitospalvelu kehitysvammahuollon loma- ja 277harrastustoiminta 278kehitysvammahuollon päivätoiminta 279kehitysvammahuollon sosiaaliohjaus 280kehitysvammahuollon sosiaalityö kehitysvammahuollon taloudellinen 281tuki kehitysvammahuollon 282työllistämispalvelut 284kehitysvammapoliklinikat 336kotisairaalat 339kouluterveydenhuolto 351kuntouttava työtoiminta 353kuntoutuksen vuodeosastopalvelut 354kuntoutuspsykiatria 371lapsiperheiden kotipalvelu 373lapsiperheiden sosiaaliohjaus 379lastenneuvolat 380lastensuojelun laitospalvelu 381lastensuojelun perhehoito 382lastensuojelun sosiaalityö lasten terveyskeskuspäivystys ja 378päivystyspoliklinikka 416lääkinnällinen kuntoutus 417lääkärin vastaanotto 420maahanmuuttajapalvelut mielenterveyskuntoutujien 857asumispalvelut 462neurologia 463neuvolat 477omahoitotarvikejakelu 863opiskeluterveydenhuolto 858palliatiivinen hoito 504perheneuvonta 505perheoikeudelliset palvelut 507perhesuunnittelu- ja ehkäisyneuvolat 520potilasasiamiehet 521psykiatrian poliklinikat 52 2psykiatrinen asumiskuntoutus 52 3psykiatrinen perhehoito 52 4psykiatriset päiväsairaalat 52 5psykologitoiminta 52 6psykoterapia 52 7puheterapia 54 3päihdehuollon asumispalvelut 54 4päihdehuollon katkaisuhoito ja kuntoutus 54 5päihdehuollon korvaushoito 54 6päihdehuollon polikliininen hoito 54 7päihdehuollon päivätoiminta 54 9päihdehuollon sosiaalityö 55 0päivystyksen vuodeosastot 55 3päiväsairaalat 57 9ravitsemusterapia 61 8selviämishoitoasemat 62 2silmätaudit 63 7sosiaalihuollon asumispalvelut 63sosiaalihuollon työhön kuntoutus- ja 67 3talous- ja velkaneuvonta 69 3tartuntataudit 70 2terveydenhoitajan vastaanotto 70 3terveysasemat 71 2toimintaterapia 72 4työkykyselvitys pitkäaikaistyöttömille 72 6työterveyshuolto 84 1täydentävä toimeentulotuki 74 5vammaispalvelulain mukainen kuljetuspalvelu 74 6vammaispalvelun asumispalvelut 74 7vammaispalvelun asunnon muutostyöt 74 8vammaispalvelun henkilökohtainen apu 74 9vammaispalvelun omaishoidon tuki 75 0vammaispalvelun päivätoiminta 75 1vammaispalvelun sosiaaliohjaus 75 2vammaispalvelun sosiaalityö 75 3vammaispalvelun tukihenkilö 75 7vanhuspalvelun itsenäinen asuminen

99 Lipas 112

100 Lipas perustiedot 1/3 113

101 Lipas perustiedot 2/3 114

102 Lipas perustiedot 2/3 Toimipisteen perusorganisaatio tulee tietolähteestä. Ylläpidossa voi tarkentaa alaorganisaatiota 115

103 Lipas - asiasanat 116

104 Lipas lähteestä tulevat asiasanat ASIASANA alamäkiluisteluradat ampumahiihdon harjoittelualueet ampumahiihtokeskukset ampumaradat ampumaurheilukeskukset beachvolleykentät curlingradat erämaa-alueet esteratsastuskentät frisbeegolf-radat golfin harjoitusalueet golfin harjoitushallit golfkentät harjoitushyppyrimäet harjoitusjäähallit hevosreitit hiihtoladut hiihtomaat hiihtosuunnistusalueet hiihtotunnelit hyppyrimäet jalkapallohallit jalkapallostadionit jokamies- ja rallicrossradat jousiammuntamaastoradat jousiammuntaradat jääkiekkokaukalot jääspeedwayradat kalastusalueet ja -paikat kamppailulajien salit Kansallispuistot kartingradat keilahallit kiihdytysradat kiipeilykalliot kilpahiihtokeskukset kilpajäähallit koirahiihtoladut koiraurheilualueet koiraurheiluhallit koripallokentät koskimelontakeskukset kuntoradat kuntosalit kylpylät kävelyreitit laavut, kodat ja kammit lasketteluhallit laskettelun suorituspaikat lentopallokentät liikuntahallit liikuntapuistot liikuntasalit luistelukentät luistelureitit lumilautatunnelit luontopolut luontotornit lähiliikuntapaikat maastopyöräilyreitit maauimalat matkailupalveluiden alueet melontareitit miekkailutilat monikäyttöalueet, joilla on virkistyspalveluita monitoimihallit ja areenat moottorikelkkareitit moottorikelkkaurat moottoripyöräilyalueet moottoriradat moottoriurheilukeskukset moottoriveneurheilualueet muut luonnonsuojelualueet, joilla on virkistyspalveluita opastuspisteet (retkeilypalvelut) pallokentät parkour-alueet parkoursalit pesäpallostadionit petanque-hallit pikaluisteluhallit pikaluisteluradat purjehdusalueet pyöräilyalueet pyöräilyradat pyöräilyreitit pyöräsuunnistusalueet pöytätennistilat rantautumispaikat (retkeilypalvelut) ratagolf ratsastuskentät ratsastusmaneesit raviradat retkeilyalueet retkeilyreitit rullakiekkokentät ruoanlaittopaikat (retkeilypalvelut) salibandyhallit Sisäampumaradat sisäkiipeilyseinät sisäkuntokeskukset skeittihallit skeitti- ja rullaluistelupaikat soudun ja melonnan sisäharjoittelutilat soutustadionit squash-hallit sulkapallohallit suunnistusalueet talviuintipaikat tanssitilat (liikuntaharrastus) tekojääkentät telinevoimistelutilat telttailu- ja leiriytymispaikat tennishallit tenniskenttäalueet tuvat (retkeilypalvelut) uima-altaat uimahallit uimapaikat uimarannat ulkoilualueet ulkoilumajat ja hiihtomajat ulkokiipeilyseinät ulkokuntoiluvälineet urheiluilmailualueet valtion retkeilyalueet venesatamat vesihiihtoalueet vesiretkeilyreitit viheralueet virkistysmetsät voimailusalit yksittäiset yleisurheilun suorituspaikat yleisurheilukentät yleisurheilun harjoitusalueet 117