Common principles on implementing integrations

Palvelun liittymät voidaan ottaa käyttöön palvelun käyttöliittymässä. Liittymällä joko viedään tai tuodaan tietoa. Liittymätapoja ovat API:n hyödyntäminen tai tiedostopohjainen SFTP-siirto.

 

Tiedostopohjaisia SFTP-siirtoja voidaan toteuttaa suoraan käyttöliittymästä. API-sovellusliittymää ei toteuteta käyttöliittymässä vaan vastajärjestelmästä kutsutaan Nepton APIa halutun tiedon saamiseksi. Nämä eri Neptonissa API-sovellusliittymässä käytettävissä olevat mahdollisuudet on kuvattu seuraavissa artikkeleissa:

 

 

Tiedostopohjainen SFTP-siirto on luonteltaan ajastetumpi ja siinä usein siirretään suurempi määrä tietoa kerralla (esim. henkilötuonnissa uudet henkilöt ja henkilötietojen muutokset) kun taas API-sovellusliittymää hyödynnetään tilanteessa, jossa tiedon siirto tulee olla nopeampaa ja käytössä Neptonissa välittömästi  (esim. projektitiedon tuonti tai vienti vastajärjestelmään tai vastajärjestelmästä).

 

Ongelmien havaitseminen ja ratkaisu

Mikäli liittymän määrittelyssä ei voida antaa kellonaikaa ajetaan ne automaattisesti jokaisena yönä. Tietojen viennit ajetaan keskiyön jälkeen ja tiedon tuonnit aamuyöllä. Poikkeuksena on lähes reaaliaikaiset liittymät, jotka ajetaan kerran minuutissa. Tällaisia ovat esimerkiksi liittymät puhelinvaihde- ja läsnäolojärjestelmiin.

 

Henkilölle voidaan asettaa henkilönumero, jota käytetään kaikissa siirroissa. Mikäli käytössä on useampi tunnisteita, voidaan järjestelmäkohtainen tunniste asettaa henkilölle  tämän tiedoissa Työsuhde-osiossa, jolloin tätä tunnistetta käytetään kyseisen järjestelmän siirroissa. Koodi '0' (nolla) on erikoiskoodi, jolla voidaan ohittaa kyseisen henkilön tiedon siirto. Tätä koodia tulee käyttää henkilön tunnisteena vain silloin kun kyseisen henkilön tietoja tai tapahtumia ei haluta siirtää.