Ajankohtaista Ilmoitin.fi:stä Verohallinnon ohjelmistotalotapaaminen 13.5.2016 Markus Virolainen Tieto, Tietokarhu Oy markus.virolainen@tieto.com
Kolme asiaa 1. Ilmoitin.fi ja kansallinen palveluarkkitehtuuriohjelma Suomi.fi-asiointivaltuuksien käyttöönotto Suomi.fi-tunnistamisen käyttöönotto 2. Web Services -rajapintojen uudistus 3. Taustakäsittelytoiminnallisuus ApiTaMoon 2
Ilmoitin.fi ja Suomi.fi-asiointivaltuudet Kesäkuun versiossa otetaan rajoitetusti käyttöön Suomi.fiasiointivaltuudet -palvelun YPA eli Yritysten Puolesta Asiointi. YPA ei ole vielä tuotantokäytössä eikä päästä päähän testausta ole suoritettu, joten käyttöönottopäivä voi vielä muuttua. Asiointivaltuudet-palvelussa määritellään Ilmoitin.fi:lle säännöstö, jolla määritellään mitä kaupparekisterin rooleja välitetään. Näitä voidaan muuttaa dynaamisesti. Ensimmäisessä vaiheessa Ilmoitin.fi:lle välitetään roolit toimitusjohtaja ja isännöitsijä, joilla voi lähettää kaikkia ilmoituksia. Myöhemmin palveluun tulee mm. YTJ:n yksityiset elinkeinonharjoittajat. 3
Ilmoitin.fi ja Suomi.fi-asiointivaltuudet toiminta lyhyesti Konkreettisesti se näkyy etusivulla kolmantena kirjautumislinkkinä, joka voidaan tarvittaessa kytkeä pois näkyvistä. Tunnistautumisen jälkeen tehdään kansallisen palveluväylän kautta kysely asiointivaltuudet-palveluun, joka palauttaa henkilötunnistetun käyttäjän edustamisoikeudet kaupparekisteristä. Jos käyttäjällä on edustamisoikeus vähintään kahteen organisaatioon, käyttäjä valitsee minkä organisaation asioita hän hoitaa. Organisaation voi vaihtaa vaihda organisaatio - toiminnolla. 4
Ilmoitin.fi ja Suomi.fi-tunnistaminen Alustavan suunnitelman mukaan syyskuun versiossa otetaan käyttöön Suomi.fi-tunnistaminen, joten Tunnistus.fi:n käyttö loppuu. Käyttöönoton ratkaisee palvelun tuotantokelpoisuus, joka selviää viimeistään viikolla 23. Käyttäjän näkökulmasta Ilmoitin.fi:n toiminta ei muutu, mutta tunnistamisen käyttöliittymä on erilainen. Esimerkkinä välisivu, jossa näytetään Ilmoitin.fi:hin palautettavat henkilön tiedot. Lisäksi uutena henkilötunnistusmenetelmänä käyttöön tulee mobiilivarmenne. Web Services -rajapintojen tunnistaminen ei muutu. 5
Web Services -rajapintojen uudistus Syksyn aikana valmistuu Web Services -rajapinnat toteuttava sovellus, joka korvaa nykyiset sovellukset. Kysymyksessä on tässä vaiheessa pääosin tekninen migraatio uuteen toteutusteknologiaan ja arkkitehtuuriin. Jatkossa on tarkoitus tuoda myös muutoksia rajapintoihin (REST/JSON), jos Katso-palvelun kehitys menee tähän suuntaan. Jos haluat osallistua testaamiseen, lähetä viesti osoitteeseen tamo.tk@vero.fi. 6
Web Services -rajapintojen uudistus muutoksista lyhyesti Rajapinnat säilyvät nykyisen mukaisena, mutta ApiTaMon vastauksesta poistetaan käyttämättömiksi jääneitä elementtejä. Uutena piirteenä ApiTaMoon tulee mahdollisuus pidempään istuntoon (nyt 10 min). Tätä ei ole pakko ottaa käyttöön, eikä siten riko nykyisiä toteutuksia. ApiTaMon osoite ei muutu, mutta Tunnelin ja tarkastusrajapinnan osoite muuttuu. Rajapinnat on kuvattu WSDL:llä (Web Services Description Language), joka helpottaa käyttöönottoa. Muutoksista tiedotetaan rajapintojen käyttäjille vielä erikseen. 7
Taustakäsittelytoiminnallisuus ApiTaMoon Syyskuun versiossa isot aineistot on mahdollista jättää taustakäsittelyyn myös ApiTaMon kautta. Tällä hetkellä Ilmoitin.fi-selainpalvelussa tarjotaan aineistojen taustakäsittelymahdollisuutta, jos aineiston fyysinen koko on yli 10 Mt (testiympäristöissä 1 Mt). ApiTamossa ei tule olemaan vastaavaa raja-arvoa, vaan valinnan taustakäsittelyyn vai ei, tekee lähettävä ohjelmisto pyytämällä sitä lähetyskohtaisesti. 8
Taustakäsittelytoiminnallisuus ApiTaMoon toiminta lyhyesti Vastaanottaessa aineistoa ApiTaMon kautta, tutkitaan onko lähettävä ohjelmisto pyytänyt taustakäsittelyä. Jos on, siirretään aineisto taustakäsittelyyn ja lähettävälle ohjelmistolle kuitataan, että aineisto on otettu taustakäsittelyyn ja sen tuloksista ilmoitetaan annettuun sähköpostiin (yksi tai useampi). Vastaussanomassa on noutotunniste, jolla tuloksen voi noutaa ApiTaMon noutorajapinnasta vastauksen koneellista käsittelyä ajatellen. Ilmoitin.fi käsittelee aikanaan aineiston ja lähettää tuloksen annettuun sähköpostiosoitteeseen ja laittaa tuloksen (XML-dokumentti) odottamaan koneellista noutoa. Lähettävä ohjelmisto voi halutessaan noutaa tuloksen ja sen perusteella esimerkiksi päivittää aineistojen tilan (odottaa vastaanottoa/vastaanotettu). 9
Markus Virolainen Tieto, Tietokarhu Oy markus.virolainen@tieto.com