Asiakasintegraation ulkoistamisen tuki : Rajapinnan suunnittelu ja käyttöönotto
Salmén, Ville (2019)
Salmén, Ville
2019
All rights reserved. This publication is copyrighted. You may download, display and print it for Your own personal use. Commercial use is prohibited.
Julkaisun pysyvä osoite on
https://urn.fi/URN:NBN:fi:amk-201904306947
https://urn.fi/URN:NBN:fi:amk-201904306947
Tiivistelmä
Paikka- ja tilaajatieto ovat hätäpuhelun tehokkaan käsittelyn kannalta tärkeitä soittajan tietoja, joiden automaattista keräämistä varten hätäkeskustietojärjestelmän on toteutettava integraatioita eri palveluihin. Työssä suunniteltiin Insta ResponseTM –tuoteperheelle entistä laajempi integraatioarkkitehtuuri, jonka myötä pystyttäisiin paremmin ulkoistamaan näiden integraatioiden toteutus jollekin muulle taholle.
Työn tutkiva vaihe koostui selvitystyöstä maailmalla käytössä olevista standardeista liittyen paikka- tai tilaajatieto –tyyppiseen tiedonsiirtoon. Tutkittavina lähteinä oli esimerkiksi Euroopan Hätänumeroyhdistyksen (EENA) dokumentteja liittyen hätäkeskustoiminnan eri osa-alueisiin.
Taustatutkimuksen perusteella työssä toteutettiin paikka- ja tilaajatiedon REST- ja gRPC-rajapintojen määritelmät, OpenAPI:lla ja Protocol Buffereilla kuvattuna. Rajapintojen sisällön suunnittelussa huomioitiin kansainvälisesti tunnettujen standardien käyttö, jotta voitaisiin parantaa rajapintojen yhteensopivuutta eri asiakasympäristöissä.
Suunniteltuja rajapintoja on tarkoitus käyttää Responsesta, ja niiden toteutuksesta huolehtii asiakkaan toimintatavat tunteva integraatiokumppani. Rajapintojen määrittely kuvauskielillä mahdollisti toteutusten generoinnin, käyttäen tarkoitukseen soveltuvia Maven-laajennuksia. Generoinnin myötä voidaan taata esimerkiksi toteutusten yhdenmukaisuutta, kun palvelinpäästä huolehtii jokin muu taho.
Tässä opinnäytetyöraportissa käydään rajapintojen määrittelytiedostojen lisäksi läpi Client-toteutusten generointiin käytettyjä Maven-laajennusten konfiguraatioita. Myös rajapintojen käyttöä generoitujen Java-toteutusten avulla esiteltiin yksinkertaistettujen esimerkkien kautta.
Työn tutkiva vaihe koostui selvitystyöstä maailmalla käytössä olevista standardeista liittyen paikka- tai tilaajatieto –tyyppiseen tiedonsiirtoon. Tutkittavina lähteinä oli esimerkiksi Euroopan Hätänumeroyhdistyksen (EENA) dokumentteja liittyen hätäkeskustoiminnan eri osa-alueisiin.
Taustatutkimuksen perusteella työssä toteutettiin paikka- ja tilaajatiedon REST- ja gRPC-rajapintojen määritelmät, OpenAPI:lla ja Protocol Buffereilla kuvattuna. Rajapintojen sisällön suunnittelussa huomioitiin kansainvälisesti tunnettujen standardien käyttö, jotta voitaisiin parantaa rajapintojen yhteensopivuutta eri asiakasympäristöissä.
Suunniteltuja rajapintoja on tarkoitus käyttää Responsesta, ja niiden toteutuksesta huolehtii asiakkaan toimintatavat tunteva integraatiokumppani. Rajapintojen määrittely kuvauskielillä mahdollisti toteutusten generoinnin, käyttäen tarkoitukseen soveltuvia Maven-laajennuksia. Generoinnin myötä voidaan taata esimerkiksi toteutusten yhdenmukaisuutta, kun palvelinpäästä huolehtii jokin muu taho.
Tässä opinnäytetyöraportissa käydään rajapintojen määrittelytiedostojen lisäksi läpi Client-toteutusten generointiin käytettyjä Maven-laajennusten konfiguraatioita. Myös rajapintojen käyttöä generoitujen Java-toteutusten avulla esiteltiin yksinkertaistettujen esimerkkien kautta.