Työpajan sisältö 9.00 Koodistoeditorin tavoitteet ja tilannekatsaus (Petri Roponen) 9.30 KaPA-koodistopalvelu ja REST-rajapinnat: lähtökohdat ja ratkaisumalli (Antti Tohmo) 10.15 Kansallinen koodistojen siirtoformaatti (Miika Alonen) 11.00 Koodistoinventarion toteutus (ehdotus) 11.15-11.30 Keskustelua ja jatkotoimenpiteet
Koodistoeditorin tavoitteet ja tilannekatsaus Yhteinen tiedon hallinta (YTI) -hanke Petri Roponen petri.roponen@vrk.fi Kansallinen koodistoeditori -työpaja 6.9.2017 Väestörekisterikeskus, Lintulahdenkuja 4, Helsinki
Visio
Visio Koodistoeditorista saat kaikki keskeiset Suomessa käytettävät koodistot. Kansallisessa koodistorekisterissä voit: Hakea koodistoja ja koodeja Lukea koodistoja sovelluksiin tai hyödyntää niitä tietojärjestelmissä modernien REST-rajapintojen kautta Ladata koodiston manuaalisesti eri tiedostomuodoissa (JSON, RDF/XML, CSV, Excel) Ylläpitää ja muokata olemassa olevia koodistoja, koodeja ja näiden metatietoja Tuoda palveluun kokonaan uuden koodiston CSV-muodossa
Palvelun ominaisuudet (jatkoa) Integrointi Y-välineisiin: koodistoeditori käyttää yhteisiä termejä ja koodistoja käytetään tietomalleissa. Versiointi ja historiointi Palvelu on toteutettu suomeksi, ruotsiksi ja englanniksi Koodistot ovat saatavilla suomeksi, ruotsiksi ja englanniksi. Tuetaan myös useampia kieliä (kielikoodi). Käyttäjähallinta. Organisaation pääkäyttäjä voi antaa muokkausoikeuksia oman organisaationsa muille jäsenille (Y-välineiden yhteinen käyttäjähallinta)
Yhden luukun periaate Kaikki keskeiset koodistot ovat löydettävissä ja saatavissa yhdestä paikasta. Koodistoeditori toimii keskitettynä rekisterinä. Yhteinen julkishallinnon koodistopalvelu. Kaikista koodistoista on ainakin metatiedot saatavissa, useimmista myös itse koodisto. Et tarvitse välttämättä mitään muuta koodistopalvelua. Koodistojen koko hallinta voi olla koodistorekisterissä. Voimme kuitenkin toteuttaa koodistopalvelun oman organisaation käyttöön (avoin lähdekoodi)
Palvelun toteutus Tavoite: Julkaista alfa-versio vuoden 2018 alussa Koodistoja tulee olemaan palvelussa useita satoja Jokaisella koodistolla on vastuutaho (omistajaorganisaatio), joka vastaa koodiston ylläpidosta ja ajantasaisuudesta.
Mikä koodisto on? Koodisto on lista ennalta määrättyjä (tekstimuotoisia) arvoja ja niitä vastaavia koodeja, jotka näkyvät käyttöliittymässä esim. alasvetovalikossa tiedon vaihtoehtoisina arvoina. Koodistoja kutsutaan usein myös listoiksi tai luetteloiksi (enumeration) luokituksiksi (classification) arvojoukoiksi (value domain) avain-arvo pareiksi (Key-value pair) koodiavaimiksi (conversion key codes) Koodistot ovat listoja, arvojoukkoja jne. jotka muuttuvat suhteellisen harvoin ja joita käytetään esim. muiden tietojen luokitteluun. vrt. codelist, reference data. Reference data are data that define the set of permissible values to be used by other data fields. Reference data usually consist only of a list of permissible values and attached textual descriptions.
Koodistoeditori www.yhteentoimivuus.fi Tietomallieditori Sanastoeditori Koodistoeditori Kenelle tarkoitettu? Organisaatioille, jotka käyttävät tai ylläpitävät julkishallinnon koodistoja Järjestelmäntoimittajille, joiden järjestelmissä on julkishallinnon koodistoja Mitä sillä tehdään? Jaetaan koodistoja RESTrajapintojen kautta ja tiedostomuodoissa Ylläpidetään koodistoja, jotka ovat julkishallinnolle yhteisiä Koodiston koko hallinta voi olla koodistoeditorissa Koodistoeditorin sisältöä voi selata ja ottaa omaan käyttöön tarvittavia koodistoja Sovellus poistaa Excelien ja muiden työkalujen tarpeen Mitä hyötyä siitä on? Yksi paikka, josta kaikki löytävät koodistot kieliversioineen Oman koodiston ylläpitäminen tapahtuu koodistoeditorissa esim. Excelin sijaan Julkishallinnossa tunnistetut koodistot ovat yhteisesti saatavilla Tilastointi on muiden toimijoiden kanssa samanlainen ja vertailtavissa Koodistojen käyttö on luotettavaa, kun koodistot ovat ajantasaisia
Koodistot julkisen hallinnon kokonaisarkkitehtuurissa Lähde: Kallela, Jari (2017) Julkisen hallinnon kokonaisarkkitehtuuri versio 2.0. Palautetilaisuus 27.3.2017.
Koodistopalvelut Suomessa, nykytila? Luokitukset
Tavoitetila? koodistopalvelu kks kks kks + uusi koodistojen siirtoformaatti (kks) tekninen JHS-suositus? kks kks Luokitukset
Tilannekatsaus
Roadmap Kehittämisen aikataulu Q2/2017 Q3/2017 Q4/2017 Q1/2018 Q2/2018 Q3/2018 Q4/2018 2 Yhteentoimivuuden menetelmät ja välineet / Koodistoeditori KaPakoodistoeditorin koodipohja käyttöön Koodistoeditori kehitystyö / Sprint 1 (21.8 1.9.2017) - Sprint 30 ( 18.12-29.12.2018) Koodistoeditori alpha Versionhallinta ja historiointi REST-rajapinnat Koodistoeditori beta Hakutoiminnot Koodistoeditorin esiselvitys Tietomalli Arkkitehtuuri Tallentaminen tiedostomuotoihin esim. CSV, Excel Sanastoeditorin integrointi koodistoeditoriin Y-välineiden yhteiset CSV-import Käyttöliittymät Käyttövaltuuksien- ja ryhmien hallinta Koodistoeditorin integrointi tietomallieditoriin yhteentoimivuus.fi Y-välineistö Suomi.fi- Palveluhallintaan
Tutustuttu olemassa oleviin koodistopalveluihin Ulkomailta 1. Linked Data Registry http://ukgovld.github.io/ukgovldwg/guides/registry.html ja sen toteutus Environment Registry UK http://environment.data.gov.uk/registry/ 2. Norjan tilastoviranomaisen koodistopalvelu http://www.ssb.no/en/klass/#!/ 3. Re3gistry http://inspire.ec.europa.eu/codelist/ 4. ListPoint Reference data service platform http://www.listpoint.co.uk/contextbrowsebycommunity.aspx Kotimaasta 1. THL & Kela http://91.202.112.142/codeserver/pages/classification-list-page.xhtml 2. Tilastokeskus / Luokitukset-sivu http://www.stat.fi/meta/luokitukset/ 3. KaPA-koodistopalvelu (dokumentoitu VRK:n sisäisesti) 4. OPH:n koodistopalvelu (tutustuttu dokumentaatioon https://confluence.csc.fi/display/ophpalv/koodistopalvelun+tekninen+dokumentaatio )
Keskeistä sisältöä Koodistosprint 1. (21.8 1.9.2017) - Selvityksiä: arkkitehtuuri, tietomalli, toteutusalusta, kehitysvälineet, käyttäjähallinnan toteutus - CSV-koodistojen tuonti (import) - Tietomalli ja metatietojen tarkennus - Hakuominaisuuden toteutus (Elastic Search) osia
Tiedottaminen Slack Palaute esim. koodiston metatiedot-määrittelystä Dokumentit (myös luonnoksia) Tiedottaminen tapahtumista Keskustelu Confluence Dokumentointi JulkiICT-sivusto
Koodistoinventaario
Koodistoinventaario (ehdotus) Tehdään yhdessä koodistoinventaario. Tavoite: Mitä keskeisiä koodistoja organisaatiossasi on käytössä? -- Kuvataan mitä omia koodistoja, suppeat metatiedot ja tiedot koodistosta Suppeat metatiedot Koodistopalvelun pitäjä ja koodistopalvelu Keskeiset koodistot a) omat b) käytössä olevat Koodiston perustietoja ja luokittelu: hierarkkinen vai ei, päivitystiheys Täyttö yhteisesti Google Spreadsheet -tiedostoon
Kiitos! yhteentoimivuus@vrk.fi yhteentoimivuus.slack.com