Yleiset periaatteet liittymien toteutukseen

Tiedostopohjaisia SFTP-siirron periaatteena on, että lähdejärjestelmä muodostaa aineiston ajastetusti SFTP-palvelimelle. Kohdejärjestelmä noutaa ja käsittelee aineiston toisella ajastuksella. Tyypillisesti aineistoja siirretään yöaikaan ja muodostamisen ja noutamisen väliin jätetään riittävästi aikaa, jotta lähdejärjestelmä on varmasti muodostanut aineiston.

 

API-sovellusliittymä perustuu kutsuihin, jotka toteutetaan niin, että vastajärjestelmästä kutsutaan Nepton API:a halutun tiedon saamiseksi. Nämä Neptonin 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ä).

 

Kun liittymiä toteutetaan, tulee huomioida seuraavia toimintaperiaatteita:

Ongelmien havaitseminen ja ratkaisu

SFTP-palvelimen kautta toimivat liittymät voidaan ajastaa Neptonissa. Lue lisää näistä:

Näiden lisäksi on muutama lähes reaaliaikainen liittymä, jotka ajetaan kerran minuutissa. Tällaisia ovat 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ää.

Siirtoja varten luodaan oma käyttäjä Neptoniin, joka on vain tätä tarkoitusta varten. Käyttäjälle annetaan tarvittavat oikeudet siirtojen suorittamiseen. Henkilötietoja siirtäessä käyttäjällä pitää olla ylläpitäjän oikeudet. Työaikatietoja siirtäessä pitää olla lisäksi seuraavat työajan oikeudet (riippuen mitä tietoa siirretään):

Tiedon viemiseen:
Voi nähdä kaikkien henkilöiden tapahtumat

Tapahtumien tuomiseen:
Voi muokata ja hyväksyä kaikkien tapahtumia
Voi lukita tapahtumapäiviä
Voi poistaa tapahtumien lukituksen päiviltä
Voi asettaa ja muokata saldon arvoa
Voi muokata hyväksyttyjä tapahtumia
Voi tarkastella tapahtumien ulkoista tunnistetta
Voi muokata tapahtumien ulkoista tunnistetta

Projektitiedon siirtämiseen:
Voi hallinnoida projekteja ja projektisuhteita
Voi hallinnoida henkilöiden asetuksia ja projekteja

Jos henkilötietoihin pitää muuttaa henkilöryhmää, asetusryhmää, työajan roolia:
Voi hallinnoida työajan henkilöryhmiä
Voi hallinnoida asetusryhmiä
Voi hallinnoida työajan rooleja