Kansallinen Palvelutietovaranto (PTV) PTV-arkkitehtuurikyselytunti 23.5.2016
Miten palvelutietovaranto asemoituu suhteessa muihin tietovarantoihin tai rekistereihin? Julkisen hallinnon tietoarkkitehtuurissa PTV on luokiteltu yleiseksi informaatiovarannoksi PTV on julkisen hallinnon palvelukuvaustietojen ydintietovaranto Oheisessa kuvassa PTV näkyy termillä "Palvelukuvausten tietovaranto Katso tarkemmin https://www.avoindata.fi/data/fi/dataset/ perusta-perustietovarantojenviitearkkitehtuuri-1-0 Lähde: Perustietovarantojen viitearkkitehtuuri v1.0
Mitä yhteistä on PTV:llä ja Aluehallintoviraston yhteisten asiakaspalvelupisteiden tietojärjestelmien uudistamisprojektilla? Yhteisten asiakaspalvelupisteiden tietojärjestelmien uudistamisprojektissa huomioidaan kansallinen palvelutietovaranto Tavoitteena on että palvelujen ja asiointikanavien tiedot ylläpidetään vain palvelutietovarannossa, josta niitä hyödynnetään asiakaspalvelupisteissä (esim. intranet, raportointi, tiketöinti) mahdollisuuksien mukaan. Tämä tarkentuu suunnitteluvaiheen aikana jossa myös VRK:n KaPA-edustus on mukana. Päällekkäisiä yhteisiä järjestelmiä ei ole tarpeen rakentaa Mahdollisesti uudistamisprojektissa voidaan hyödyntää myös tulossa olevaa virkamiehen näkymää, joka voisi sisältää nykyisen yhteispalvelu.fi sivuston sijaan opastavat sisällöt asiakaspalvelupisteiden neuvojille.
Mitä yhteistä palvelusalkkukuvauksilla ja määrittelyillä on PTV-palvelukuvaustyön kanssa? Kysymyksellä tarkoitettaneen julkishallinnon yhteistä palvelusalkkua, joka on kuvattu QPR-välineellä JulkICT-arkkitehtuuripankissa sekä näiden kuvausten yhteentoimivuutta ja korrelaatiota julkishallinnon toimijan palvelukuvaustyön kanssa kyseisten palvelujen tulee nivoutua yhteen JHKA-työssä (julkishallinnon kokonaisarkkitehtuuri) ns. isossa kuvassa näkyy palvelut, joista päästään porautumaan alemmille tasoille (käsitteellinen, looginen, fyysinen) kuvaukset tehdään Tietohallintolain mukaisesti PTV-palvelukuvaustyössä kuvataan julkiset palvelut yhdenmukaisesti loppukäyttäjän näkökulmasta.
Mikä on PTV:n kehittämisen aikataulu? Milloin rajapinnat ovat hyödynnettävissä ja milloin rajapintojen kuvaukset on saatavilla ja missä? PTV:tä kehitetään hankkeessa KaPA-ohjelmakauden loppuun ja sen jälkeen ylläpidetään VRK:n palveluna PTV:n kehittämisen RoadMapiin (Product Backlog) on koottu ominaisuuslista KaPA-hankejohdon linjausten mukaisesti Out-rajapinta Out Apin scheman ensimmäinen luonnosversio on jo saatavilla swaggerissa osoitteessa http://ptvenv.cloudapp.net:1494/swagger/ui/index.html#/ Out Api otetaan tuotantokäyttöön PTV:n ensimmäisen version yhteydessä kesällä 2016 rajapinnalla on tunnistettu tähän mennessä kolme hyödyntäjää (Palvelunäkymät, Asiointivaltuudet ja Julkaisujärjestelmät) In-rajapinta In Apin kuvaukset löytyvät esuomi.fistä https://esuomi.fi/aineisto/suomi-fi-palvelutietovaranto/?mdocscat=mdocs-cat-19&att=suomi.fi-palvelutietovaranto In Api otetaan tuotantokäyttöön syksyn 2016 versioiden yhteydessä
PTV:n kehittämisen ja käyttöönottojen aikataulu Q1/2016 Q2/2016 Q3/2016 Q4/2016 Q1/2017 Q2/2017 Q3/2017 KEHITTÄMINEN Rajapintojen kuvaukset valmiit. OUT-rajapinta valmis. PTV V1.0 valmis IN-rajapinta valmis Jatkokehitys ja uusien PTV-versioiden julkaisut PTV-KÄYTTÖÖNOTOT PTV-yhteyshenkilöt nimetty KaPA-laki voimaan. Tullee velvoittamaan PTV-tietojen tuottamiseen ja PTV:n käyttöön jollakin aikavälillä Minimitiedot tulee olla tuotettu PTV:hen Ensimmäiset pilotit, toimintamallin testaus, linjausten tekeminen. Tietojen tallennus rajattua PTV:n käyttöönotot alkavat Toimintamallien vakiinnuttaminen PTV-koulutukset alkavat PTV-käyttöönottojen tuki Jatkuva viestintä käyttöönottaville tahoille (yhteyshenkilöiden kautta/esuomi.fi/muut kanavat) Tietojen tuottamis- ja hyödyntämisvaihtoehtojen selvitys ja suunnittelu PTV-julkaisujärjestelmä-integraatio valmis. Beta.suomi.fi (julkaistu 15.12.2015) Beta.yrityssuomi.fi Viranomaisen näkymä (beta) Viranomaisen näkymä (tuotanto) Suomi.fi (tuotanto) Yrityssuomi.fi (tuotanto) PALVELUNÄKYMÄT Hallinnon karttapalvelu valmis
Mistä löydän PTV:n rajapintakuvaukset? PTV-rajapintojen kuvaukset löytyvät esuomi.fistä, PTV-arkkitehtuuri -sivulta: https://esuomi.fi/palveluntarjoajille/palvelutietovaranto/ptv-arkkitehtuuri/
Miten kunta/virasto voi olla mukana määrittelemässä tarpeita in-rajapinnan toiminnallisuudesta ja käsittelysäännöistä? Kunta tai virasto, joka aikoo tuottaa tietoa PTV:n rajapinnan kautta, voi toimittaa tiedot omista toiminnallisuustarpeistaan sähköpostilla osoitteeseen ptv-tuki@vrk.fi. Tiedot tulee toimittaa viimeistään 3.6.2016 VRK perehtyy esitettyihin tarpeisiin ja järjestää Skype-palaverin tarkennuksia ja keskustelua varten.
Mitä tarkoittaa rajapinnan hallintamalli? Entä avoimen tuotteen hallintamalli? PTV:ssä muodostetaan molemmat hallintamallit eli avoimen tuotteen sekä avoimen rajapinnan hallintamalli. Näiden mallien muodostaminen on käynnistetty ja viimeistellään syksyn 2016 aikana. Avoimen rajapinnan hallintamallilla tarkoitetaan JulkICTLabissa käyttöön otettua rajapintojen hallintasuunnitelmaa, jossa määritellään käytännöt siihen, miten avoimia rajapintoja hallitaan ja ylläpidetään. Suunnitelma selkeyttää vastuunjakoa rajapinnan kehittämiseen osallistuvien tahojen kesken, esim. kuka omistaa rajapintojen määrittelyt, miten rajapintojen kehittäminen ja ylläpito rahoitetaan, miten kehittämistä koordinoidaan ja suoritetaan. Rajapinnan hallintasuunnitelman laativat rajapintaa käyttävät sidosryhmät. https://wiki.julkict.fi/julkict/projektit/avoimen-rajapinnan-hallinta Avoimen tuotteen hallintamalli määrittelee säännöt, joilla voidaan perustaa julkisen hallinnon organisaatioille käyttäjäyhteisö avoimen lähdekoodin ohjelmistotuotteen ohjausta ja hallintaa varten. Valtion teknillisen tutkimuskeskuksen luomaa mallia on pilotoitu mm. SADe-ohjelmassa ja muutamissa muissa JulkICT:n projekteissa. Hallintamalli on tuotantokäytössä mm. valtion yhteisen julkaisujärjestelmän (YJA) yhteydessä. Tuotteenhallintaa pyritään soveltamaan kaikissa JulkICT:n projekteissa, joissa tuotetaan palveluja avoimella lähdekoodilla. Malli selkeyttää mm. omistajuutta ja vastuita sekä palvelun ylläpidon ja kehittämisen (elinkaaren) ohjausta ja hallintaa. https://wiki.julkict.fi/julkict/projektit/avoimen-tuotteen-hallinta
Mitä jos rajapinta muuttuu? Mitä muutos vaatii meiltä kunnissa/virastoissa? Rajapintojen muutoshallinta perustuu yhdessä sidosryhmien kanssa muodostettavaan avoimen rajapinnan hallintamallisuunnitelmaan Muutokset eivät välttämättä vaadi mitään, jos kunnan tai viraston käyttöönottama versio rajapinnasta on edelleen sopiva ja täyttää toiminnalliset tarpeet Mikäli uusi rajapintaversio täyttää (uudet) tarpeet paremmin, kannattaa ottaa uusi versio käyttöön kunnan tai viraston oman muutoshallinnan mukaisessa aikataulussa Kunnissa/virastoissa rajapintaan tietoa tuottavat (tai rajapinnasta tietoa vastaanottavat) tietojärjestelmät on paikallisesti ylläpidettävä vastaamaan uutta rajapintaversiota.
Voiko in-rajapinnan kautta tuoda tietoja PTV:hen valikoidusti? Millä tavalla rajaaminen tapahtuu? Rajaaminen tapahtuu teknisesti rajapinnan parametreilla Rajapinnan kautta voi tuoda esimerkiksi kaikki tiedot vain muuttuneet tiedot vain uudet palvelut tai olemassa olevien palvelujen tietosisällön muutokset vain kanavat tai osan kanavista tai näiden muutokset koko organisaation tai osan organisaatiosta tai organisaatiorakenteen muutokset Katso tarkemmin in-rajapinnan kuvauksesta: https://esuomi.fi/palveluntarjoajille/palvelutietovaranto/ptvarkkitehtuuri/
Millaisia oikeellisuustarkastuksia tiedon sisäänlukumekanismi in-rajapinnan kautta tulee tarjoamaan? Tiedon muodollisuustarkistukset ovat samoja, mitä käyttöliittymän kautta syötettäessäkin tarjotaan Esimerkiksi jos uusia palvelutietoja tuotetaan in-rajapinnan kautta, mutta tietosisällöstä puuttuu pakollinen kenttä, niin tietosisältö menee virhelistalle Esimerkkinä kunnan organisaatiotiedosta puuttuva kuntanumero
Mistä tiedostomuodoista in-rajapintaan voi lukea tietoa? Onko Excel mukana? Aluksi käyttöön tulee JSON/REST-rajapinta Jatkossa voidaan kysynnän ja aikataulusuunnitelmien mukaisesti ottaa kehityslistalle myös muita formaatteja Excel on teknisesti mahdollinen formaatti ja se on otettu mukaan jatkokehitysarviointiin
Voiko PTV:stä tulostaa tietoja Exceliin ja millaisia poimintamahdollisuuksia tähän on? Out-rajapinnan formaattimuunnos Excel-muotoon on teknisesti mahdollista ja se on otettu mukaan jatkokehitysarviointiin Out-rajapinnan poimintaehdot ovat näkyvillä swaggerissa ja poimintaehdot tulevat täydentymään rajapinnan hyödyntäjien tarpeiden myötä uusissa versioissa http://ptvenv.cloudapp.net:1494/swagger/ui/index.html#/
Minkälainen virheilmoitusten lokijärjestelmä PTV:hen tulee? Suomi.fi-palveluissa, mukaan lukien PTV:ssä, on otettu käyttöön kaikille yhteinen keskitetty lokienhallintajärjestelmä, jonne lokitetaan käyttöön liittyvät tiedot sekä virheilmoitukset Keskitettyyn lokienhallintajärjestelmään lokitetaan myös rajapinnan kautta PTV:hen saapuvien tietojen lokit Suomi.fi-palveluvastaava VRK:lla voi selata ja raportoida lokitietoja keskitetyn lokienhallintajärjestelmän käyttöliittymän kautta Lokitiedot tullaan viemään tietovarastoratkaisuun, josta voidaan koostaa näkyviin erilaisia raportteja ja analyysejä esimerkiksi useimmin toistuvia virheilmoituksia Lokitietojen raportointiväli voidaan räätälöidä kunkin organisaation tarpeiden mukaan.
Voiko PTV:stä tuoda automaattisesti tietoja kunnan tai viraston kotisivuille ja miten tämä tapahtuu? KaPA-ohjelmassa on meneillään kuntien ja virastojen verkkosivuja varten ns. PTV-julkaisujärjestelmätprojekti, jossa kehitetään rajapintaa ja integraatioita julkaisujärjestelmiä varten Indeksoitu rajapinta tarjotaan julkishallinnon toimijoiden käyttöön PTV tarjoaa tiedot myös standardin out-rajapinnan kautta Integraatioiden avulla PTV:n tietojen ja Suomi.fi-oppaiden sisällön käyttö tulee olemaan mahdollista julkishallinnon asiakasorganisaatioiden omissa julkaisujärjestelmissä ja siten www-sivuilla. Työ aloitetaan toteuttamalla integraatio Liferay-julkaisujärjestelmään portlettien avulla. Valmistumisen aikataulu tarkentuu kesäkuussa 2016. Jatkossa integraatio on tarkoitus toteuttaa myös osalle muita julkaisujärjestelmiä. Lisätietoja pilotointimahdollisuuksista organisaatioille saat Kunta-KaPAsta: http://kunnat.net/kuntakapa tai ptv-tuki@vrk.fi
Service data distribution to public sector Providing indexed service data to public sector Creation of plugins to most common open source CMS s on public sector (based on research done in January 2016) Liferay (Goverment de facto standard) Wordpress (several organisations) Drupal (Kuntien Tiera, joint service centre for several municipalities) Suomi.fi index Suomi.fi Finnish Service Catalogue Suomi.fi Service Views Suomi.fi CMS Copy of index Public API Closed API (services) Web pages of public organisations Liferay Wordpress Drupal Joomla? Integration team
Tiedot viedään PTV:hen näin Q3 2016 MANUAALISESTI PTV-KÄYTTÖLIITTYMÄN KAUTTA Selkeä ja ohjeistettu käyttöliittymä PTV-tietojen tuottamiseen Valmiita yhteiskäyttöisiä pohjakuvauksia RAJAPINTA Q4 2016 KONEELLISESTI RAJAPINNAN KAUTTA Lähdejärjestelmän laatuvaatimukset Lähde mukautuu PTV:n rajapintaan
Hyödyt heti ja tulevaisuudessa AVOIN DATA AVOIMET RAJAPINNAT NÄKYMÄ KAIKKEEN Koko Suomi kartalla Koko Suomi taskussa RAJAPINTA VERKKOSIVUT suomi.fi kunta.fi virasto.fi TIEDOLLA JOHTAMINEN PALVELU- JOHTAMINEN MUUT SOVELLUKSET JA HYÖDYT PALVELUIDEN VERTAILU JA YHTEISMITALLISUUS RAPORTTIEN RAKENTAMINEN
Missä on lisätietoa PTV-käyttöönotosta? Tämän linkin takaa löydät polkuja käyttöönoton kannalta hyödyllisiin tietoihin https://slack- files.com/t0eamqf45- F0T2Y3WP8-57752881a6
Yhteydenotot: ptv-tuki@vrk.fi Lisätietoja: http://esuomi.fi/palveluntarjoajille/palvelutietovaranto/