Yhteentoimivuutta edistävien työkalujen kehittäminen - JulkICTLab pilotti Pilottiehdotuksen osapuolet: CSC – Tieteen tietotekniikan keskus Oy Aalto-yliopisto Verohallinto Yhteyshenkilö (Product Owner): Suvi Remes Tekninen yhteyshenkilö (Scrum Master): Miika Alonen

Agenda Tervetuloa projektiin & aamukaffet Keitä olemme – esittäytymiskierros Tekemisen tavoitteet ja tuotokset Mukanaolijat – ytimessä & verkostoissa Aikataulu Roolit, vastuut & työvaiheet Työskentelytavat & viestintä Riskit ja onnistumisen elementit Q & A Yhteinen lounas 2

Executive summary Pilotin sisältö lyhyesti: Pilotissa kehitetään työkaluja yhteisen tietomallinnusmenetelmän soveltamiseksi, tukemaan organisaatioiden välistä tiedonvaihtoa ja semanttista yhteentoimivuutta. Pilotilla tuetaan: organisaatioiden välisen tiedonvaihdon toteuttamista yhteismitallisesti ja tietojen merkityksen säilyttäen. yhteisesti käytettävien tietomääritysten määrittelyä ja dokumentointia toteuttamalla tarkoitukseen sopivan teknisen välineen. tietomääritysten uudelleenkäyttöä uudelleenmäärittelyn sijaan. avoimen kehittäjäyhteisön muodostumista, jossa eri organisaatioiden osaaminen voidaan hyödyntää kustannustehokkaasti Tulos: sanastoihin perustuvien tietokomponenttien määrittelymenetelmä Avoimella lähdekoodilla tietokomponenttien ylläpito- ja julkaisuympäristö tietokomponentteja hyödyntävä sovellusprofiilien määrittelymenetelmä avoimella lähdekoodilla sovellusprofiilien ylläpito- ja julkaisuympäristö ja työkalu teknisten skeemojen tuottamiseen

Nykytila tietovarasto rajapinnat korkeakoulujen tietojärjestelmät VIRTA Opintopolku rajapinnat Korkeakoulujen tietomalli (tietomalli.csc.fi) Korkeakoulujen tietomalli (tietomalli.csc.fi) esim. kirjastotoimi rajapinnat ?

Esimerkki { Palveluntuottaja: { ”tunnus”:”abc”, ”Nimi”:”Esimerkki” } Yritys + koodi + nimi { ”title”: ”Palveluntuottaja”, ”type”: ”object”, ”properties”: { ”tunnus”: { ”type”: ”String” }, ”Nimi”: { ”type”: ”String”} } Ongelma Yksi tietosisältö 1001 tapaa mallintaa RDB XML JSON RDF … Nimi, koodi Esimerkki; abc CREATE TABLE Yritys ( koodi int, Nimi varchar(255), ); ?

Tavoitetila tietovarasto rajapinnat korkeakoulujen tietojärjestelmät VIRTA Opintopolku rajapinnat esim. kirjastotoimi rajapinnat Sanastoihin perustuvat rajapinnat

Yhteentoimivuusmalli Opintojakso Koodi X Nimi Laajuus X Rajapintakuvaukset … Opintojakso Koodi X Nimi Laajuus X Opintojakso Määr..Pakolli... Koodi X Nimi Laajuus X Sanasto Yhteiset määritykset eri käyttökohteisiin Tietoelementit määritellään sanastossa ja linkitetään standardeihin Luokkia ja ominaisuuksia tarkennetaan käyttötarpeen mukaan Standardit Tietomallit

Yhteentoimivuusmallin tavoitteet korkeakoulutuksen ja tutkimuksen yhteiset tietomääritykset – myös laajemmin eri toimijoiden yhteiset tietomääritykset yhteensopivuus kansainvälisten standardien kanssa –tietomallinnuksen menetelmät –linkitys kansainvälisiin tietomäärityksiin (formaalisti ja semanttisesti) tietojärjestelmien yhteentoimivuus –modulaariset tietomääritykset: viestinvälitys – (eri toimialojen) rajapintaratkaisut tietokantarakenteet – (eri toimialojen) tietovarannot sovelluskehitys – (eri toimialojen operatiiviset) tietojärjestelmät implementaatiokohtainen dokumentaatio (sovellusprofiili)

Yhteentoimivuusmallin hyödyt Muodostaa eri käyttötarpeisiin soveltuvia tietomalleja, jotka perustuvat yhteisiin käsitteisiin. Voidaan kehittää yhteentoimivia tietomalleja eri käyttötarkoituksiin Lisätä kenttiä ja assosiaatiosuhteita tietomalleihin ”sotkematta” tietovarastomallia tai rajapintakuvauksia. Versionhallinta/tiedon jäljitettävyys on hallittavissa. Linkitys kansainvälisiin standardeihin Tukee tietomallinnusta eri mallinnustasoilla.

Yhteentoimivuusmalli – menetelmänä Yhteiskäyttöisissä palveluissa ja prosesseissa käytettävät käsitteet on määriteltävä asianmukaisesti ja koneluettavassa muodossa Yhteisten tietomäärityksien tulee perustua sanastossa määriteltäviin käsitteisiin Tietomääritykset ovat uudelleenkäytettäviä tietokomponentteja (luokka, ominaisuus ja assosiaatio) Tietojärjestelmien väliset rajapinnat kuvataan sovellusprofiilissa uudelleenkäyttämällä tietomäärityksiä Sovellusprofiili muodostuu toimialueella kuvatuista uudelleenkäytettävistä tietomäärityksistä, eli luokista, ominaisuuksista ja niille asetetuista rajoituksista

Sanastot käsitteet määritelmät luokitukset Tietokomponentit luokat ominaisuudet assosiaatiot Sovellusprofiilit käyttötarkoitus rajoitukset laajennokset Yhteentoimivuusmallin viitekehys Yhteinen tietoarkkitehtuuri käsitteiden ja tietorakenteiden mallintamiseen Yhteentoimivat sanastot Yhteentoimivat tietorakenteet Yhdenmukainen dokumentaatio

Yhteentoimivuusmalli = Yhteinen metatietoarkkitehtuuri

Pilotin toteutuksen esittely XSD JSON Schema Koodisto palvelu Finto -sanasto- ja ontologiapalvelu (Kansalliskirjasto) Käyttää koodistoja Käyttää sanastoja Tuottaa visualisointeja Tuottaa skeemoja TEPA-termipankki (TSK Sanastokeskus) JHS julkisen hallinnon yhteinen sanasto, OKSA- opetus- ja koulusanasto Tietokomponentit Sovellusprofiilit JulkICTLab pilotti Rajapinta RDF Tietosisältö kuvattu profiilissa ”voi hyödyntää esim. base-skeemoina tai siirtoformaattina” Rajapinnan skeema

Hyödyntäminen Potentiaaliset käyttäjät: tietomallintajat ja sovelluskehittäjät sisällönasiantuntijat tietoaineistojen kuvailijat välillisesti kuvailueditorien kautta Onnistunut käyttöönotto: Tavoitepilotin toimialueen tietomääritykset mallinnettu tietojärjestelmällä Tavoitepilotti käyttää tietojärjestelmällä tuotettua tietomallia tiedonsiirrossa

Mitä projektissa ei tehdä? Varsinaiset tietokomponentit (sisältö) tuotetaan kehitysprojektin ulkopuolella, tehtävään kootuissa tai muutoin muodostetuissa ryhmissä ja/tai verkostoissa. Tiivis yhteys sisältötyöhön ja sitä tekeviin ryhmiin on projektin kannalta kuitenkin keskeistä. OPI-tietokomponentit: nIKHJ2wIE/edit?pli=1#gid= nIKHJ2wIE/edit?pli=1#gid= JHS-tietokomponentit: 98npxV4o/edit?pli=1#gid=0 98npxV4o/edit?pli=1#gid=0 Projektin tavoitteena ei ole vakioida olemassa olevien tietovarantojen/tietojärjestelmien tietorakenteita.

Projektikumppanit CSC – Tieteen tietotekniikan keskus Oy projektikoordinaatio määrittely ja tekninen toteutus Aalto-yliopisto käyttötapaukset; määrittely Verohallinto / Katre-hanke käyttötapaukset; määrittely VM / JulkICTLab -kehitysympäristö Gofore Oy toimittajayhteistyö laaja sidosryhmäverkosto (korkeakoulut, ATT-hanke, julkisen hallinnon toimijat) ”PoC-lähestyminen ja testaus”, jalkautus osissa, poikkihallinnollinen yhteistyö Metatietopalvelun ekosysteemi – kansalliset tavoitteet

Ohjausrakenteet OKM CSC-sopimuksen kautta Korkeakoulujen tietohallinto- ja ICT-ohjausryhmä ministeriön korkeakouluille ostama arkkitehtuurityö kokoavan arkkitehtuurikuvauksen (Yhteentoimivuusmalli) omistajuus CSC:llä koordinointi Metatietopalveluissa (Koulutuksen ja tutkimuksen yhteentoimivuuden palvelut) kansallisella tasolla laajemmin VM, Tietoarkkitehtuuriryhmä VM, Metatietopalvelut-ryhmä

Toiminta Tieto Tietojärjestelmät Teknologia /infra Tieteellisen laskennan kokonaisark- kitehtuuri Tutkimuksen kokonaisark- kitehtuuri (ATT) Tutkimuksen tuen ja hallinnon viitearkkiteh- tuuri Arkkitehtuureissa kuvattavat ulottuvuudet (painotus) Korkeakoulutuksen ja tutkimuksen yhteiset arkkitehtuurit Kokoavat kuvauskokonaisuudet Korkeakoulujen ICT-palveluiden nykytila ja tavoitetilakuvaus Korkeakoulujen yhteentoimivuusmalli (tietomallit ja määritykset) Viranomaistietovirtojen VIRTAistamisen kehittämispolku Korkeakoulu- jen opiskelun ja opetuksen tuen ja hallinnon viitearkkiteh- tuuri

Aikataulu koko vuosi 2014 valmistelua työkalutoteutuksen tarkempi suunnitteluvaihe 01/ /20015 työkalukehityksen toteutusvaihe JulkICTLabissa 04/ /2015 projektiryhmän täydennys 06/2015 aloituskokous syksy jaettu yhdeksään (9) kahden viikon sprintiin – alkaen ja päättyen suunnittelukokoukset maanantaisin klo katselmoinnit/retro perjantaisin klo avoin esittelytilaisuus 3.9. Tieteiden talolla Korkeakoulujen valtakunnalliset IT-päivät Helsingissä Alustava varaus: Closing-tilaisuus

Aikataulutus

Projektiryhmä Suvi Remes, CSC Miika Alonen, CSC Olli-Pekka Kotilainen, CSC (Pinja Koskinen, CSC; Lab) Petri Mustajoki, Aalto (Antti Hämäläinen, Aalto) Mikael af Hallström, Vero Jarmo Korhonen, Gofore Oy Lauri Hahne, Gofore Oy

JulkICTLab-kehitysympäristö kehitysideoiden pilotointiin tarkoitettu, keskitetysti koordinoitu palvelukehitysympäristö tarjoaa teknisen kehitysympäristön lisäksi tukea hallintamallin ja palveluiden muotoiluun suositaan avoimen lähdekoodin ohjelmistoja ja lisenssejä VM/JulkICT-toiminto ylläpitää projektilla yhteistyösopimus vuoden 2015 loppuun

Käyttötapaukset Tietokomponenttikirjastot Selaus Muokkaus Sovellusprofiilit Selaus Muokkaus Käyttäjähallinta

Pääkäyttötapaukset Käyttäjäroolit: Pääkäyttäjät Tietomallintajat Rekisteröimätön käyttäjä

Käyttäjähallinta (User management) Pääkäyttäjä Tietomallintaja Rekisteröitynyt käyttäjä (Ei toteuteta toistaiseksi) Rekisteröinti ja käyttäjähallinta toteutetaan EDUUNI-palvelun avulla: Muokkausnäkymät ohjataan EDUUNI:n SAML 2.0 kirjautumiseen

Tietomallien selaus (View models) Kaikkien tietomallien listaus Tietomallin selaus Haku kaikista tietomalleista Tietomallien visualisointi Tietomallien lataus

Tietomallien muokkaus (Manage models) Luonnoksen tallennus Muutosten peruutus Luonnoksen korvaus vanhemmalla versiolla Luonnoksen julkaisu Valmiin tietomallin tuonti Luo uusi malli Luo uusi luokka Luo uusi ominaisuus Muokkaa resurssia Näytä muokkaushistoria Näytä kommentit

Sovellusprofiilien selaus Resurssien haku Profiilien vienti

Sovellusprofiilien muokkaus Importoi valmis profiili Luo uusi profiili Lisää käytetyt nimiavaruudet Lisää tietomallieditorista Lisää ”tuntematon” nimiavaruus Luo uusi luokan käyttö Ehdota tietokomponenttikirjastosta Ehdota resolvoidusta nimiavaruudesta Luo uusi ominaisuuden käyttö Luonnoksen muokkaus Luonnoksen tallennus Julkaisu Generoi skeema (Erillinen palvelu?)

Pilotin tekninen arkkitehtuuri Tarkempi dokumentaatio

JSON-LD/AngularJS UI POC testit Tietokomponenttikirjasto: Sovellusprofiili: Edumeta

Kehitysympäristö CSC:n omat virtuaalit (Pouta) iow.csc.fi Kehitys Githubissa: iow-ui (alustava runko) iow-ui iow-api Master branchit synkronisoidaan virtuaalin kanssa kerran tunnissa Automaattinen mvn install paketonti iow-api:lle Käyttöliittymälle sovittava automatisointi grunt jne. yms. testit Käyttöoikeudet Github Virtuaalit

SPRINT 1 Taustamateriaaliin tutustuminen Käyttötapausten tarkennus Työkalut ja käyttöoikeudet kehittäjille Käyttöliittymän arkkitehtuuri Nykyisen toteutuksen arviointi iow-ui Arkkitehtuurin kehittäminen ja dokumentointi Valitut komponentit (Javascript kirjastot) Tyylikirjastot (CSS ja Angular moduulit) Käyttöliittymän automaattinen paketointi ja testaus virtuaalille

Tietokomponenttinäkymän kehittäminen Tietomallien listaus Tietomallin selaus Alustava näkymä Ennen retroa asiakaskatselmointi Kommentit yleisesti ulkoasusta Tietokomponenttikirjaston tietosisällöstä SPRINT 2

SPRINTIT 3-9 (Alustava suunnitelma) SPRINT 3 Tietokomponenttinäkymän kehittäminen katselmoinnin ja retron pohjalta SPRINT 4 Käyttäjänhallinta (Kirjautuminen, Ryhmien luonti, Upload-näkymä) Muokkausnäkymän suunnittelu SPRINT 5 Muokkausnäkymän toteutus Käsitehaku SPRINT 6 Sovellusprofiili näkymä, selaus, muokkaus SPRINT 7 Kehittämin katselmoinnin ja retron pohjalta SPRINT 8 Visualisointi SPRINT 9 Viimeistely

Projektin työkulttuuri ketteryys tässä projektissa “valmiin” määritelmän täyttävä, käyttökelpoinen ja potentiaalisesti julkaisukelpoinen tuoteversio tapaamiset ja kokouskäytänteet suunnittelupalaverit katselmoinnit retro päiväpalaveri etäosallistuminen tiedossa olevat poissaolot hyvät keinot pitää yhteyttä

Dokumentointi ja viestintä tekemisen dokumentointi projekti, kokoukset: +ja+tutkimuksen+tietomalli +ja+tutkimuksen+tietomalli tekninen määrittely, toteutus: Science/iow-uihttps://github.com/CSC-IT-Center-for- Science/iow-ui sisällöt työkalun testaukseen: Google Docs sähköpostilistat tavoittaa projektiryhmän

Raportointi Projektiryhmä raportoi toteutusjaksoittain (2 viikon välein) toteutuneet tehtävät ja muut ilmenneet asiat. Projektin operatiivinen ohjausryhmä kokoontuu säännöllisesti, mielellään kuukausittain, ja varmistaa projektin etenemisen käytännön tasolla. Kehitysympäristön käytöstä raportoidaan JulkICTLab-ohjausryhmälle kahden kuukauden välein. Projektin ohjausryhmä (TICT) kokoontuu kuusi kertaa vuodessa ja varmistaa projektin etenemisen sovittujen linjausten mukaisesti. Etenemisestä tiedotetaan valtiovarainministeriön tietoarkkitehtuuriryhmiä, esimerkiksi katsauksin kokouksissa. Projekti on osa OKM:n CSC:ltä ostamia palveluja, joiden laatua seurataan sisäisissä laatupalavereissa neljä kertaa vuodessa.

pp.kk.vvvv Osasto JulkICT-toiminto Tuotokset osana laajempaa ekosysteemiä Metatietopalvelu K 39 Liittymä- rekisteri Palvelun tarjoaja Koodisto- palvelu Rajapinta Viesti URN Tunnuspalvelu MDM Sanaston hallinta Yhteentoimivuus-mallin hallinta Sovellusprofiilin hallinta Ontologian hallinta Koodistojen hallinta Toimipaikka-tiedon hallinta Käyttö- liittymä Palvelutieto- varanto Palvelujen hallinta Rakentamaton ympäristö Tunnista- minen Rooli ja Valtuutus Rakennettu ympäristö Organisaatio Rekisteri Palvelun käyttäjä Nimipalvelu OPH KaPA THL CSC FINTO OPH KaPA JHS183

Riskianalyysi yhteinen pohdinta projektisuunnitelman pohjalta (luku 6.3.) riskitekijä seuraus projektille riskin suuruus - riskin todennäköisyys/vakavuus (1-3) hallintatoimenpide vastuu

Q & A

Tervetuloa mukaan!