Asiakasintegraation ulkoistamisen tuki : Rajapinnan suunnittelu ja käyttöönotto

Abstract

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.

Efficient handling of an emergency call depends on the information about the caller’s identity and location being readily available. In order to handle the automatic information gathering process, the CAD-system provider must implement integrations to different ANI and ALI service providers. The subject of this thesis was to design a better integration architecture to the Insta ResponseTM product family, in order to ease the outsourcing of the integration-work.

The investigating part of the thesis consists of researching already available standards, related to similar location and identity information exchanges. For example, the European Emergency Number Association (EENA) has multiple relevant documents referenced in this thesis.

Based on the research, definitions for ALI and ANI interfaces were made, with support for both REST and gRPC. OpenAPI and Protocol Buffers were used to describe these APIs. In order to improve compatibility in different customer environments, generally known standards were used in the interface definitions.

The designed APIs are meant to be used from Response, and the server-side implementation is done by an integration partner. Using interface description languages for the definitions enabled the use of code generation with related Maven plugins. Code generation ensures consistency between implementations, which is an important factor, when an external party is taking care of the server-side implementations.

In addition to the interface definitions, this report also covers the Maven plugin configurations, which were used to generate the client implementations. Also the use of the interface was demonstrated with simple examples, using the generated Java-client implementations.