Asiointitilin lomakerajapinta Kansalaisen asiointitili
Miksi? Miksi? Kansalaisen asiointitili ei mahdollistanut aikaisemmin rakenteisten viestien toimittamista viranomaiselle Rakenteiset viestit viranomaisen suuntaan mahdollistavat Asiointitilin laajemman käytön ja viestien käsittelyn automatisoinnin taustajärjestelmissä Voidaan hyödyntää Asiointitilin tarjoamaa tietoturvallista yhteyttä viranomaisen järjestelmään ja mikä tahansa lomake on helposti kytkettävissä lähettämään viesti Asiointitilin kautta 2
Mitä Miten? Mitä? Asiointitili tarjoaa POST-rajapinnan, jonka kautta mikä tahansa lomake voidaan ohjata lähettämään tietonsa Asiointitilin kautta viranomaisjärjestelmään Miten? Asiointitilille on määritetty POST-rajapinta, joka kuvaa POST-kutsun, jolla voidaan kutsua Asiointitiliä siten, että Asiointitili lähettää käyttäjän viestin/lomakkeen automaattisesti halutulle viranomaiselle 3
Lomakkeen lähetys POST-rajapinnalla 2. Täyttää lomakkeen POST-kutsun mukana: Viranomaistunnus, palvelutunnus, otsikko, sisältö, liitteet, lomake liitteenä (XML) 1. Lomakkeen luominen ja julkaisu (esim. lomake-editorilla) POST / HTTPS 2. Lomakkeen täyttäminen ja lähetys o Lomake ja liitteet ohjataan Asiointitilin POST-rajapintaan Viranomaisen lomakepalvelu Lomake VETUMA Asiointitili Lähetä viesti viranomaiselle o Asiointitilillä käyttäjän tulee tunnistautua / luoda tili 3. Lomake välitetään viranomaiselle Asiointitilin paluuviestinä (lomakkeen määrämuotoiset tiedot liitteenä esim. XML) 4. Mahdollinen paluu lomakepalveluun 1. Julkaisee lomakkeen 4. Palaa Viranomaisen järjestelmä / sähköposti 3. Lomake välitetään viranomaiselle 4
Lomakepalvelu käyttäjän näkökulmasta Lähetysprosessin vaiheet ja esimerkki 5
Prosessin vaiheet Kansalainen Lomakepalvelu Lomakepalvelu Asiointitili VETUMA 4.Tunnistautuminen Asiointitili 3.Lomakkeen täyttö POST POST 5.Tilin käyttöönotto (tarvittaessa) 6.Lomakkeen lähetys 7.Lähetetyt viestit 1.Lomakkeen luonti Lomakehallinta 2.Lomakkeen julkaisu Viranomainen 8.Tiedon vastaanotto taustajärjestelmään / sähköpostiin 6
1. Lomakkeen täyttö Lomakkeen täyttö ja lähetys (tiedot välitetään asiointitilille POSTrajapintaan) 7
2. VETUMA-tunnistus (Asiointitili) 8
2.1 Tilin luonti, tarvittaessa (Asiointitili) 2. Asiointitilin luominen ja omien tietojen syöttäminen Mikäli käyttäjällä ei ole tiliä, käyttäjää pyydetään luomaan tili. (tilin luontinäkymä) 9
3. Paluu takaisin palveluun 10
Lähetetyt viestit (Asiointitili) Lähetetyt viestit jäävät käyttäjän omalle Asiointitilille talteen 11
POST-lomakerajapintamääritys Asiointitili tarjoaa POST-sivun, jonne voi POST-komennolla välittää lähetettävän viestin. POST-kutsussa annetaan seuraavat parametrit: ViranomaisTunnus = Viranomaisen viranomaistunnus PalveluTunnus = Viranomaisen palvelutunnus ViranomaisenEmail = viranomaisen sähköpostiosoite, jonne viesti välitetään (ei pakollinen, oletus palvelun tiedoista) Nimeke = Viestin otsikkotieto (ei pakollinen) KuvausTeksti = Viestin tekstisisältö (ei pakollinen) Paluuosoite = osoite, jonne asiointitili ohjaa käyttäjän viestin lähetyksen jälkeen (ei pakollinen). Asiointitili lisää paluuosoitteen parametriksi tiedon, onko käyttäjä lähettänyt viestin vai palannut jossain vaiheessa kesken lähetyksen takaisin palveluun (Toimitettu=1/0) PalaaAutomaattisesti = Automaattinen palaaminen lähetyksen jälkeen 1/0. Sivulta 6 tehdään automaattinen palaaminen palveluun, jos tämä on päällä. Liitetiedostot max 10 kpl (N 1..10) (varsinainen lomakesisältö liitteenä) TiedostoNimi_N = Liitetiedosto 1 nimi TiedostoSisalto_N = Tiedosto BASE64 -enkoodattuna TiedostoMuoto_N = Tiedoston formaatti. MimeTyyppi (esimerkiksi application/pdf ) TiedostoPiilotettu = liitetiedostoa ei näytetä asiakkaalle (esimerkiksi XML-muotoinen lomakkeen sisältö) Lomake voi lähettää lomakkeen tiedot seuraavasti kahtena liitteenä Rakenteinen liite voi olla ns. piiloliitteenä Esitysmuotoinen liite esim. Tekstitiedosto, HTML tai PDF tai ei lainkaan POST-sivu tarkistaa, että kyseisellä viranomaisella on paluukanava käytössä ja avaa käyttäjälle lähetä viesti viranomaiselle toiminnon (ja tarvittaessa ohjaa käyttäjän tunnistautumaan / luomaan tilin ennen lähetä viesti-sivun avaamista) 12