Organisaationne lähettää ja vastaanottaa Suomi.fi-viestejä REST-rajapinnan kautta. Digi- ja väestötietovirasto ei tarjoa organisaatiollenne käyttöliittymää. Organisaationne voi toteuttaa integraation itse tai hyödyntää järjestelmätoimittajien valmisratkaisuja. Usein Suomi.fi-viestit voidaan integroida jo käytössä olevaan järjestelmään, jolloin työntekijänne voivat jatkaa työskentelyä tutussa käyttöliittymässä.
Käytettävissä olevat toiminnallisuudet ja viestien käsittelytavat voivat vaihdella eri järjestelmissä ja ratkaisuissa. Tarkistakaa aina järjestelmätoimittajalta, mitä ominaisuuksia integraatio tukee ja miten.
Missä tietoa syntyy ja missä sitä käsitellään?
Ennen teknisen ratkaisun valintaa organisaatiollanne on oltava käsitys tiedonhallinnasta, järjestelmäkokonaisuuksista ja asian käsittelyyn liittyvistä vaiheista:
missä järjestelmissä tietoa syntyy,
missä järjestelmissä päätökset tehdään tai asiakirjat muodostuvat,
missä vaiheissa loppukäyttäjälle täytyy tai halutaan lähettää sähköisiä viestejä?
Suomi.fi-viestien integraatio tehdään aina järjestelmään. Usein liityntä tehdään siihen järjestelmään, jossa:
päätös, ilmoitus tai muu asiakirja muodostuu, tai
viestin lähettäminen on osa normaalia työprosessia, esimerkiksi asian käsittelyyn liittyvä vaihe.
Voitte aloittaa käyttöönoton, kun olette selvittäneet mihin järjestelmiin Suomi.fi-viestit kannattaa liittää. Jos rakennatte integraation itse, edetkää hallinnollinen ja tekninen käyttöönotto -ohjeiden mukaan. Jos toteutatte integraation järjestelmätoimittajan valmisratkaisuna, sopikaa käyttöönoton aloittamisesta järjestelmätoimittajanne kanssa ja edetkää hallinnollinen käyttöönotto -ohjeiden mukaan.
Organisaationne voi toteuttaa liitynnän suoraan käyttämästänne järjestelmästä Suomi.fi-viestien REST-rajapintaan. Liityntä voidaan tehdä yhteen järjestelmään tai useampaan erilliseen järjestelmään.
Ratkaisu sopii erityisesti tilanteisiin, joissa:
viestintä loppukäyttäjälle tapahtuu pääosin yhdestä keskeisestä järjestelmästä
asian käsittely ja päätöksenteko tapahtuvat järjestelmässä, jolloin kaikki asiakasviestintään kuuluva sisältö syntyy luonnollisesti osana prosessia
halutaan mahdollisimman suoraviivainen tekninen kokonaisuus.
Kuva: 1. Järjestelmästä tehty liityntä Suomi.fi-viestien REST-rajapinnalla.
Kuva: 2. Useista järjestelmistä tehty liityntä Suomi.fi-viestien REST-rajapintaan.
Järjestelmätunnukset ja palvelutunnukset
Jos organisaatiolla on useita itsenäisiä järjestelmiä
kullekin järjestelmälle määritellään oma järjestelmätunnus (systemID)
järjestelmätunnuksen alle luodaan yksi tai useampi palvelutunnus (serviceID) sen mukaan, minkä palvelun nimissä viestejä lähetetään.
Esimerkiksi: Asianhallintajärjestelmällä (systemID XX) lähetetään viestejä useiden eri palveluiden nimissä (serviceID xx_aa, serviceID xx_bb, serviceID xx_cc).
Kuva: 3. Järjestelmätunnuksen alle voidaan lisätä useita palvelutunnuksia.
Organisaationne voi ottaa Suomi.fi-viestit käyttöönsä hyödyntämällä erillistä valmisohjelmistoa, joka on suunniteltu organisaatioille Suomi.fi-viestien lähettämiseen ja vastaanottamiseen. Järjestelmätoimittajia, joiden tuotteissa on integraatio Suomi.fi-viesteihin -sivulta löydätte sähköisen viestinnän mahdollistavia valmisohjelmistoja organisaatioille.
Erillinen valmisohjelmisto toimii:
organisaation käyttöliittymänä viestien lähettämiseen ja vastaanottamiseen
Suomi.fi-viestejä ei välttämättä tarvitse integroida kaikkiin ydinjärjestelmiin.
Valmisohjelmistolle määritellään järjestelmätunnus (systemID), jonka alle voidaan luoda yksi tai useampi palvelutunnus (serviceID) eri palveluiden viestintää varten.
Milloin valmisohjelmisto on sopiva ratkaisu?
Valmisohjelmiston käyttö voi olla hyvä vaihtoehto, jos:
organisaationne ei halua tehdä teknistä integraatiota kaikkiin ydinjärjestelmiin
viestejä syntyy useissa eri palveluprosesseissa tai palveluissa, joita ei ole kannattavaa tai mahdollista integroida suoraan Suomi.fi-viestien REST-rajapintaan
sähköinen viestintä halutaan keskittää yhden käyttöliittymän alle
ydinjärjestelmien tueksi tarvitaan ratkaisu, jolla voidaan hoitaa yleistä asiakasviestintää ja pienempien tai harvemmin käytettyjen palveluiden viestintää
henkilöstö tarvitsee selkeän ja helppokäyttöisen käyttöliittymän viestien lähettämiseen ja hallintaan ilman erillistä kehitystyötä
etsitään korvaavaa ratkaisua poistuvan SMTP-rajapinnan (sähköpostiliitynnän) tilalle.
Miten valmisohjelmistoa käytetään?
Valmisohjelmisto toimii tyypillisesti itsenäisenä hallintakäyttöliittymänä, johon organisaationne työntekijä tai palvelun vastuuhenkilö kirjautuu. Käyttöliittymän kautta voidaan esimerkiksi:
luoda ja lähettää viestejä loppukäyttäjille Suomi.fi-viestien kautta
hallita viestien sisältöjä ja liitteitä
seurata lähetettyjä ja saapuneita viestejä.
Tämä vähentää tarvetta rakentaa viestitoiminnallisuuksia useisiin eri järjestelmiin ja yksinkertaistaa viestintäprosessia organisaation sisällä.
Usein tällaisiin valmisohjelmistoihin on mahdollista toteuttaa integraatioita myös organisaation taustajärjestelmiin, jolloin tarvittavan tiedonsiirto onnistuu vaivattomasti. Näin vältetään myös tarpeetonta tietojen siirtämistä järjestelmästä toiseen, esimerkiksi henkilötietojen siirtäminen.
Kuva: 4. Suomi.fi-viestejä voi käyttää organisaatiossa erillisen valmisohjelmiston kautta.
Organisaationne käytössä voi olla sähköinen asiointipalvelu, joka on ensisijainen paikka, jonne loppukäyttäjä ohjataan asioimaan.
Suomi.fi-viestien kautta organisaationne lähettää loppukäyttäjälle:
luotettavan tiedon asian etenemisestä tai valmistuneesta päätöksestä
turvallisen linkin asiointipalveluun, jossa varsinainen sisältö on nähtävissä tai jatkotoimenpiteet tehtävissä.
Asiointipalvelussa loppukäyttäjä:
lukee häntä koskevan päätöksen tai ilmoituksen
tarkastelee asian tilaa tai siihen liittyviä asiakirjoja
tekee jatkotoimenpiteitä, kuten antaa lisätietoja, vastaa pyyntöön tai siirtyy uuteen palveluvaiheeseen.
Asiointipalvelulle määritellään järjestelmätunnus (systemID) ja tarvittavat palvelutunnukset (serviceID) sen mukaan, minkä palveluiden nimissä viestejä lähetetään.
Kuva: 5. Suomi.fi-viestit voi liittää sähköiseen asiointipalveluun.
Erillisen integraation toteuttaminen jokaiseen järjestelmään voi olla työlästä, jos organisaatiollanne on useita järjestelmiä, joista kaikista täytyy lähettää viestejä Suomi.fi-viestien kautta. Vaihtoehtona on välityspalvelun rakentaminen, joka toimii välikerroksena organisaation järjestelmien ja Suomi.fi-viestien REST-rajapinnan välillä. Välityspalvelu voidaan toteuttaa organisaation omana ratkaisuna tai hankkia järjestelmätoimittajalta.
Välityspalvelun avulla:
rajapintaliityntä toteutetaan vain kerran
useat järjestelmät voivat hyödyntää samaa liityntää keskitetysti.
Ratkaisu sopii erityisesti tilanteisiin, joissa:
viestejä lähtee useista eri järjestelmistä
integraatioiden ja tunnusten hallinta halutaan keskittää
viestiliikennettä halutaan hallita yhtenä kokonaisuutena.
Välityspalvelua käytettäessä organisaatiolle määritellään yleensä:
yksi järjestelmätunnus (systemID)
jonka alle lisätään tarvittava määrä palvelutunnuksia (serviceID).
Esimerkiksi: Kunnan eri toimialojen käyttämät järjestelmät lähettävät viestejä välityspalvelun kautta. Viestit näkyvät loppukäyttäjälle eri palveluiden nimissä.
Kuva: 6. Järjestelmät voidaan liittää Suomi.fi-viestien REST-rajapintaan välityspalvelun kautta.
Järjestelmätunnusten, palvelutunnusten ja salasanojen hallinta
Kullekin järjestelmätunnukselle (systemID) määritellään oma salasana. Salasanan vaihto kannattaa automatisoida.
Jos organisaationne käyttää välityspalvelua, salasanan vaihdon tulee:
päivittyä samanaikaisesti kaikkiin välityspalvelua käyttäviin järjestelmiin
tapahtua siten, ettei viestien lähetys keskeydy.
Tunnusten määrää suunniteltaessa on hyvä tasapainottaa:
