Avoimen ja yhteisen rajapinnan hallintasuunnitelma v.1.4

Avoimen ja yhteisen rajapinnan hallintasuunnitelma v.1.4

Tämän esityksen sisältö tausta avoimet toimittajakohtaiset rajapinnat (toimittajan hallitsemat rajapinnat) avoimet yhteiset rajapinnat (tilaajan hallitsemat rajapinnat) mikä on avointen ja yhteisten rajapintojen hallintasuunnitelma miksi avoimen rajapinnan hallintasuunnitelma on tärkeä mitä eroa on rajapintojen määrittelydokumentilla ja rajapintojen hallintasuunnitelmalla ohjelmiston avoimet sekä avoimet ja yhteiset rajapinnat avoimen rajapinnan hallinnanelinkaaren kuvaus hallintasuunnitelman hyödyntämisen nykytila 2

Avoimen ja yhteisen rajapinnan hallintasuunnitelma TAUSTA 18.1.2016

Tausta Nykyisin järjestelmätoimittajat tekevät avoimia rajapintoja omiin järjestelmiinsä. Rajapinnat ovat usein teknologisesti standardin mukaisia, mutta rajapinnan kautta siirtyvä tietosisältö ja rajapinnan elinkaari on toimittajan vapaasti päätettävissä Tulevaisuudessa määritellään enemmän avoimia rajapintoja eri järjestelmiin siten, että jokaiseen järjestelmätoimittajan järjestelmään on teknologisesti ja tietosisällöllisesti samanlainen rajapinta Muuttunut tilanne aiheuttaa seuraavat kaksi asiaa: 1. rajapintojen määrittelyt tulevaisuudessa omistaa joku muu kuin ohjelmiston omistaja. 2. rajapinnan määrittelyiden omistajan tehtävänä on suorittaa itse tai järjestää rajapinnan hallinta (em. rajapinnan kehittämisen ja ylläpidon rahoitus sekä kehittämisen käytänteet)

Avoimet toimittajakohtaiset rajapinnat samalla toimialalla - Nykyinen tilanne Järjestelmä 1 Järjestelmä 1 Järjestelmä 3 Rajapinnan dokumen taatio Rajapinnan dokumen taatio Rajapinnan dokumen taatio Toimiala järjestelmä x Kaupunki xx x Rajapinnan omistaja Toimiala järjestelmä y Kaupunki yy x Rajapinnan omistaja Toimiala Järjestelmä z Kaupunki zzx Rajapinnan omistaja

Nykyisen tilanteen piirteet Rajapinnan omistajuus Ominaisuus Kuvaus Rajapinnan ja sen määrittelyt omistaa ohjelmiston omistaja Rajapinnan määrittely (teknologia ja tietosisältö) Rajapinnan suunnittelu ja toteutus Rajapinnan ylläpito Ohjelmiston omistaja voi vapaasti määritellä rajapinnan teknologian tai tietosisällön Ohjelmiston omistaja voi vapaasti suunnitella ja toteuttaa rajapinnan. rajapinnan ylläpidosta vastaa ohjelmiston omistaja omien resurssien ja aikataulujen puitteissa Rajapinnan käyttöönotto Rajapinnan kehittämisen ja ylläpidon kustannukset Rajapinnan dokumentaatio Rajapinnan elinkaari Ohjelmiston omistaja saa vapaasti päättää miten rajapintaa voidaan käyttää tai liittyykö sen käyttämiseen hinnoittelua tai sopimuksia Kustannuksista vastaa ohjelmiston omistaja, joka voi vapaasti päättää miten kustannukset asiakkailta veloitetaan vai veloitetaanko ollenkaan Toimittaja voi vapaasti määritellä millainen dokumentaatio tuotetaan rajapinnasta Toimittaja voi vapaasti päättää rajapinnan elinkaaresta

Avoimet yhteiset rajapinnat samalla toimialalla - Tulevaisuuden tilanne Järjestelmä 1 Järjestelmä 1 Järjestelmä 3 Avoimet ja yhteiset rajapinnat Rajapinnan omistaja Rajapinnan hallintasuunnitelma Rajapinnan dokumentaatio Toimiala järjestelmä x Toimiala järjestelmä z Toimiala järjestelmä y Kaupunki x x Kaupunki y x Kaupunki z x

Tulevaisuuden tilanteen piirteet Rajapinnan omistajuus Ominaisuus Rajapinnan määrittely (teknologia ja tietosisältö) Kuvaus Rajapinnan määrittelyt omistaa rajapinnan omistajaksi nimetty toimija, mutta ohjelmistoon toteutetun rajapinnan omistaa ohjelmiston omistaja Valittu toimija määrittelee rajapinnan Rajapinnan suunnittelu ja toteutus Rajapinnan ylläpito Rajapinnan käyttöönotto Rajapinnan kehittämisen ja ylläpidon kustannukset Ohjelmiston omistaja voi vapaasti suunnitella ja toteuttaa rajapinnan. rajapinnan ylläpidosta vastaa ohjelmiston omistaja sovittujen aikataulujen puitteissa Valittu toimija päättää miten rajapintaa voidaan käyttää tai liittyykö siihen hinnoittelua tai sopimuksia. Ohjelmiston omistajalla on kuitenkin mahdollisuus veloittaa siitä ylläpitokustannuksia esimerkiksi kehittämiskustannuksia Kustannukset maksetaan sovitun mallin mukaisesti Rajapinnan dokumentaatio Rajapinnan elinkaari Toimittajan tarvitsee ylläpitää vain omaan käyttöön tarkoitettua dokumentaatiota Toimittaja sitoutuu ylläpitämään rajapintaa sovitun mallin mukaisesti

Avoimet yhteiset rajapinnat - yhden järjestelmäkokonaisuuden malli- Tulevaisuuden tilanne Järjestelmä 1 Järjestelmä 2 Järjestelmä 3 Järjestelmä n Palveluväylä/integraatioalusta Avoimet, mutta järjestelmän omistajan hallitsemat rajapinnat Rajapinnan omistaja Rajapinnan hallintasuunnitelma Keskitetyt ohjelmistot/järjestelmät x,y,z esim. VRK Rajapinnan dokumentaatio

Tulevaisuuden tilanteen piirteet Ominaisuus Kuvaus Rajapinnan omistajuus Rajapinnan ja sen määrittelyt omistaa ohjelmiston omistaja Rajapinnan määrittely (teknologia ja tietosisältö) Rajapinnan suunnittelu ja toteutus Rajapinnan ylläpito Rajapinnan käyttöönotto Rajapinnan kehittämisen ja ylläpidon kustannukset Rajapinnan dokumentaatio Rajapinnan elinkaari Erityipiirteitä Ohjelmiston omistaja voi vapaasti määritellä rajapinnan yhdessä ohjelmiston kehittäjien kanssa Ohjelmiston omistaja voi vapaasti suunnitella ja toteuttaa rajapinnan. ohjelmiston kehittäjien kanssa rajapinnan ylläpidosta vastaa ohjelmiston omistaja omien ja ohjelmiston kehittäjien kanssa resurssien ja aikataulujen puitteissa Ohjelmiston omistaja saa vapaasti päättää miten rajapintaa voidaan käyttää tai liittyykö sen käyttämiseen hinnoittelua tai sopimuksia Kustannuksista vastaa ohjelmiston omistaja, joka voi vapaasti päättää miten kustannukset asiakkailta veloitetaan vai veloitetaanko ollenkaan Toimittaja voi vapaasti määritellä millainen dokumentaatio tuotetaan rajapinnasta Toimittaja voi vapaasti päättää rajapinnan elinkaaresta Rajapintoja voi hyödyntää todella suuri määrä järjestelmiä/ohjelmistoja, jolloin rajapinnan tehtävät muutokset on suoritettava huolellisesti ja suunnitelmallisesti, jotta varmistetaan rajapintaa käyttävien järjestelmien toimivuus

Avoimen ja yhteisen rajapinnan hallintasuunnitelma MIKÄ SE ON? 18.1.2016

Mikä on avointen ja yhteisten rajapintojen hallintasuunnitelma Rajapintojen hallintasuunnitelma on dokumentti, jossa kuvataan miten avointen rajapintojen hallinta ja ylläpito suoritetaan Rajapintojen hallintasuunnitelmassa esitetään mm. seuraavat tärkeät asiat 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 12

Mitä eroa on rajapinnan teknisellä määrittelyllä ja rajapinnan hallintasuunnitelmalla Rajapinnan tekninen määrittelydokumentti kuvaa rajapinnan teknisen kuvauksen eli esimerkiksi millä rajapintateknologialla rajapinta on toteutettu, miten se teknisesti toimii, mitä tietoa siinä välitetään jne Rajapinnan hallintasuunnitelma dokumentti kuvaa miten rajapintaa ja siihen liittyvää dokumentaatiota hallitaan eli esimerkiksi kuka omistaa rajapintamäärittelyt, miten rajapinnan kehittäminen ja ylläpito rahoitetaan jne 13

Avointen ja yhteisten rajapintojen määrittelyt vs. rajapintojen hallintasuunnitelma Avoin ja yhteinen rajapinta 1 Avoin ja yhteinen rajapinta 2 Avoin ja yhteinen rajapinta 3 Määrittelee rajapintojen kehittämisen käytänteet ja toimintamallit Ohjelmisto x Määrittelee tekniset asiat Yhteisten rajapintojen tekniset määritykset Kuvaa rajapinnan määrittelyiden omistajuudet ja muut roolit Yhteisten rajapintojen hallinta suunnitelma xxx_rajapinnanhallin tasuunnitelma.doc Avoin ja yhteinen rajapinta 1 Avoin ja yhteinen rajapinta 2 Avoin ja yhteinen rajapinta 3 Vastaa kysymykseen: Vastaa kysymykseen: Ohjelmisto y Miten rajapinta toimii teknologisesti, mitä tietoa välittyy jne. Kuka omistaa rajapinnan määrittely, miten kehittämien ja ylläpito rahoitetaan jne. 14

Miksi rajapintojen hallintasuunnitelma on tärkeä Jos rajapintojen määrittelyt omistaa joku muu kuin ohjelmiston omistaja niin rajapintojen hallinta (määrittelyjen ylläpito, rahoitus, toteutuksen valvonta yms.) tulee olla suunniteltu Jos EI OLE rajapintojen hallintasuunnitelmaa niin rajapinnat eivät kehity muuttuvien tarpeiden mukaisesti, koska ei tiedetä miten rajapinnan kehittämistä ja ylläpitoa tehdään tai miten sitä rahoitetaan => rajapinnat eivät kehity ja tulevat käyttökelvottomiksi tai niistä tulee toimittajakohtaisia, koska toimittajat alkavat tekemään niin itse muutoksia

Ohjelmiston omat ja yhteiset rajapinnat Ohjelmistossa voi olla myös ohjelmiston omia avoimia rajapintoja, joiden määrittelyt omistaa ohjelmiston omistaja (toimittajan hallitsemat rajapinnat) Näiden rajapintojen ylläpidosta ja elinkaaresta vastaa toimittaja Näille rajapinnoille ei laadita yhteistä hallintasuunnitelmaa vaan niistä toimittaja huolehtii osana ohjelmiston elinkaaren hallintaan.

Ohjelmiston omat ja yhteiset rajapinnat Avoimet yhteiset rajapinnat/tilaajan hallitsemat rajapinnat noudattavat yhteisesti laadittuja määrityksiä Avoin ja yhteinen rajapinta 1 Avoin ja yhteinen rajapinta 2 Avoin ja yhteinen rajapinta 3 Yhteisten Yhteiset Yhteiset rajapintojen rajapinta määritykset. rajapinta määritykset. tekniset määritykset (tietosisältö (tietosisältö ja teknologia...) ja teknologia...) 2 Hallintasuunnitelmalla hallintaan ja ylläpidetään rajapintojen määrityksiä Yhteisten rajapintojen hallinta suunnitelma (rahoitus ja ylläpito...) 4 1 Ohjelmisto x Noudattaa hallintasuunnitelmaa Avoin ja yhteinen rajapinta 1 Avoin ja yhteinen rajapinta 2 Avoin ja yhteinen rajapinta 3 Avoin rajapinta 1 Avoin rajapinta 2 Ohjelmisto y Ohjelmiston omien rajapintojen määritykset Organisaatiot, jotka hyödyntävät rajapintoja 5 Tilaajan hallitsemat avoimet rajapinnat noudattavat yrityksessä laadittuja määrityksiä 3 = Tilaajan hallitsema rajapinta = Toimittajan hallitsema rajapinta 17

Avoimen ja yhteisen rajapinnan hallintamalli AVOIMEN RAJAPINNAN ELINKAARI 21.9.2015

1. Yhteinen tarve rajapinnoille Avoimen rajapinnan elinkaarikehittäminen 2. Rajapintojen hankinta konsortion muodostaminen 3. Rajapintojen toiminnallisen tarpeen kuvaus 4. Rajapintojen teknisten määrittelyiden toteutuksen toimittajan valinta 5. Rajapintojen teknisen määrittelyn toteutus valitun toimittajan kanssa 6. Rajapinnan rajapintojen hallinta suunnitelman hyväksyntä Perustietojen täyttäminen hallintasuunnitelmaan Hallintasuunnitelman täydentäminen Hallintasuunnitelman täydentäminen 2.1 Avointen rajapintojen hallintasuunnitelma dokumentin täyttäminen (Rajapintojen hallintasuunnitelma) Hallintasuunnitelman täydentäminen Ohjaa rajapintojen toteutusta Ohjaa rajapintojen ylläpitoa Valmis hallintasuunnitelma 7.Määrittelyiden mukaisten rajapintojen toteutus ohjelmistoihin 8.Määriteltyjen rajapintojen ylläpito 19

Avoimen rajapinnan elinkaari ylläpito Määriteltyjen rajapintojen ylläpito/elinkaaren hallinta Tarve rajapinnan muuttamiseen / kehittämiseen Rajapinta muutosten määrittely Rajapinta muutosten toteutuksenseuranta Toteutusten hyväksymistestaus Projektinhallinta Miten uudet versiot rahoitetaan? Kuka vastaa tilaan osalta ylläpitovaiheen projektin hallinnasta? Kuka vastaa hyväksymistestauksesta tilaajan osalta? Miten päätään uusista rajapinta versioista? Avointen rajapintojen hallintadokumentti ohjaa rajapintojen ylläpitoa ja vastaa yllä oleviin kysymyksiin Avointen rajapintojen hallintasuunnitelma dokumentti xyz rajapinnan hallintasuunitellma.doc 20

Avoimen ja yhteisen rajapinnan hallintamalli AVOIMEN RAJAPINNAN KEHITTÄMISEN NÄKÖKULMAT JA ELINKAARI 21.9.2015

Avoimen rajapinnan kehittämisen näkökulmat 1.Avoimen ja yhteisen rajapinnan kehittäminen ohjelmistoon, jonka omistaa toimittaja 2.Avoimen ja yhteisen rajapinnan kehittäminen ohjelmistoon, jonka omistaa tilaaja 22

1.Ohjelmisto tuotteenhallinta toimittajan omistamassa ohjelmistossa Rahoitus Toimialan avoimien rajapintojen hallintasuunnitelma Omistaja (ohjelmistotalo) Ohjelmistotuotteen versio 1.0 Päätetyt uudet ominaisuudet Uuden version kehitys Ohjelmistotuotteen versio 1.1 Uuden version kehitys Tuotepäällikkö nn. Kerää Uudet ominaisuudet Kehitysprojektin Projektipäällikkö nn Uudet ominaisuudet? Asiakastarpeet Kilpailijan tuotteen ominaisuudet Markkinointi ja myynti Teknologia muutokset Lakimuutokset Toimialan avoimien rajapintojen määritykset tai niiden muutokset 23

2.Ohjelmisto tuotteenhallinta tilaajan omistamassa ohjelmistossa Rahoitus (määritelty tuotteenhallinta suunnitelmassa) Toimialan avoimien rajapintojen hallintasuunnitelma Omistaja (Määritelty tuotteen hallinta suunnitel massa) Ohjelmistotuotteen versio 1.0 Päätetyt uudet ominaisuudet Uuden version kehitys Ohjelmistotuotteen versio 1.1 Uuden version kehitys Tuotepäällikkö (määritelty tuotteenhallinta suunnitelmassa) Kerää Uudet ominaisuudet Kehitysprojektin Projektipäällikkö (määritelty tuotteenhallinta suunnitelmassa) Uudet ominaisuudet? Asiakastarpeet Kilpailijan tuotteen ominaisuudet Markkinointi ja myynti Teknologia muutokset Lakimuutokset Toimialan avoimien rajapintojen määritykset 24

Rajapintojen kehittäminen ohjelmistoon Edellisten kuvien perusteella voidaan todeta, että käytännössä ei ole merkittävää eroa siinä tehdäänkö avoimet yhteiset rajapinnat tilaajan omistamaan ohjelmistoon vai toimittajan omistamaan ohjelmistoon. 25

Avoimen ja yhteisen rajapinnan hallintasuunnitelma PROJEKTIN LOPPUTULOKSET 21.9.2015

Projektin lopputulokset laadittu rajapintojen hallintaan liittyvää ongelmatiikka, nykytila sekä tulevaisuus Avoimen_rajapinnan hallinnan YLEISKUVAUS v1.0.doc laadittu dokumenttipohja rajapinnanhallinta suunnitelmalle xxx_rajapinnanhallintasuunnitelma MALLIPOHJA v1.0.doc laadittu yleisesittely avoimen rajapinnan hallintamallin esittelykalvot avoimen rajapinnan hallintamalli 1.2.ppt

KIITOKSIA MIELENKIINNOSTA! Kysymyksiä ja vastauksia 28