Integrointi Severaan

Kun aloitat integroinnin luomisen Severaan, on tärkeää ottaa huomioon integraation toiminnallisuuden lisäksi myös tekninen puoli: missä ja miten integraatio tulee ajettavaksi, miten sitä voi testata ja miten saada tietoa siitä, mitä tapahtuu integraation ollessa käynnissä. Integraation voi rakentaa valitsemallasi teknologialla, eikä Severa anna tukea valitsemasi teknologian osalta.

Integraation ajastaminen

Integraatio Severaan on rakennettava siten, ettei se jatkuvasti kysy Severan REST API:lta, onko uutta tietoa saatavilla. Integraatio tulisi ajaa ajastetusti, ja aikataulua määritettäessä tulisi huomioida seuraavat asiat:

  1. Mitä tietoa integraatio siirtää?
  2. Tarvitseeko jokaisen tietotyypin siirtyä samalla aikataululla, vai voidaanko joitakin siirtää useammin kuin toisia?
  3. Onko tiedoilla riippuvuuksia, jotka vaikuttavat siiirrettäviin tietoihin?
  4. Mikä on integraation liiketoiminnallinen tarve, millaisia liiketoimintavaatimuksia siirrolle on? On tärkeää, että integraatio palvelee tarkoitustaan yrityksen tarvitseman tiedon aikataulussa. Esimerkiksi: Poissaolojen siirtäminen palkanlaskentajärjestelmään voidaan tehdä kerran viikossa, mutta lähetettävät laskut tulisi siirtää kerran päivässä.
  5. Jos integraation siirrot on tehtävä monta kertaa päivässä, integraation ei tulisi olla käynnissä useammin kuin kerran tunnissa.
  6. Älä rakenna integraatiota, jonka pääasiallinen logiikka on silmukka, joka toistuu välittömästi päätyttyään ilman minkäänlaista ajastusta.

Integraation testaus

Kun integraatiota kehitetään, se on testattava Severan secure-test-ympäristöä vastaan. Kun integraation on todistettu toimivan ongelmitta, se voidaan vaihtaa toimimaan tuotantoa vastaan. Lisätietoja: Kuinka päästä alkuun REST APIn kanssa?

Kun olemassa olevaan integraatioon tehdään muutoksia, ne on testattava secure-test-ympäristöä vastaan. Integraatiota ei saa koskaan julkaista suoraan tuotantoon. Tällä varmistetaan, ettei asiakkaan data vahingoitu, jos integraatiossa on ongelmia. Sisällytä integraation testaukseen seuraavat asiat:

  1. Integraation ajaminen testidatalla secure-test-ympäristöä vastaan.
  2. Manuaalisten muutosten tekeminen tietoihin sekä Severassa että muissa integroiduissa ohjelmistoissa ja varmistetaan, että siirto on oikein.
  3. Riittävä määrä testitapauksia kattamaan koko integraation toiminnallisuuden. Lisäksi testidatassa tulisi olla eroja, jotta skenaariot katetaan monipuolisesti.
  4. Koko integraation toiminnallisuuden regressiotestaus aina, kun muutokset ovat riittävän suuria vaatiakseen täydellisen regression.
  5. Harkitse myös aiempien ongelmien lisäämistä testisuunnitelmaan, jotta ne eivät toistuisi.

Integraation konfigurointi

Yleensä integraatiot tarvitsevat erilaisia parametreja toimiakseen ongelmitta. Yleisiä parametreja ovat esimerkiksi:

  • Severa API URL: Kertoo, missä API sijaitsee. Integraation on ehkä ajettava secure-test.severa.com- tai secure.severa.com Severa -ympäristöä vastaan.
  • Asiakkaan tunnukset: Mitä asiakkaan tunnuksia ja salasanoja integraatiossa käytetään.
  • Erityyppiset parametrit, joita tarvitaan oikean tiedon saamiseksi API:sta. Esimerkiksi "käytä tätä laskun tilan nimeä saadaksesi laskut Severasta".
  • Erityyppiset oletusarvot, joita tarvitaan integraation toimimiseksi kaikissa skenaarioissa. Esimerkiksi "käytä tätä tuotekoodia, kun tuotekoodi ei ole saatavilla", tai "käytä tätä henkilöä oletusvalvojana, jos muuta käyttäjää ei ole saatavilla".
  • Viimeisimmän tiedon haun aikaleimat, joita käytetään integraation seuraavalla ajokerralla. Esimerkiksi käytettäessä "GetCasesChangedSince"-metodia, edellisen ajon aika on tallennettava jonnekin, ja konfiguraation tulisi olla muutettavissa automaattisesti integraation toimesta ja manuaalisesti käyttäjän toimesta.
  • API-version ja entiteettisheemaversion päivämäärät, jotta integraatio voi jokaisella ajokerralla verrata tallennettuja versioita ja API:n versioita ja nähdä, onko muutoksia.
  • Kirjautumiseen tarvittavat konfiguraatiot, kuten lokien sijainnit, sähköpostiosoitteet, joihin viestejä lähetetään, ja niin edelleen.


Kun integraatio käsittelee useiden asiakkaiden tietoja, jokaisella asiakkaalla tulisi olla erilliset konfiguraatiot, jotta väärän konfiguraation lukeminen ja ongelmien syntyminen integraatiossa ei olisi mahdollista.

Integraation konfiguraatioiden tulisi olla sellaisia, että niitä voi muuttaa manuaalisesti, koska joskus virhetilanteessa tallennettuja aikaleimoja on muutettava menneisyyteen.

Virheiden käsittely

Integraation virheiden käsittely on ratkaisevan tärkeää, koska integraatiot koskettavat asiakkaan tietoja, eikä niitä tietoja voi helposti palauttaa, jos integraatio on rikkonut ne. Virheenkäsittelyä tehdessä on mietittävä ja ratkaistava seuraavat korkean tason kysymykset:

  1. Millaiset virheet integraatiossa tulisi pysäyttää integraation ajon?
  2. Millaiset virheet voivat tapahtua niin, että integraatio jatkaa normaalia toimintaa?
  3. Mihin virheet kirjataan?
  4. Kuka vastaa virhelokien valvonnasta?
  5. Mitä tehdään, kun integraatiossa ilmenee virhe ja kuka sen tekee?


Integraatio-ohjelmiston itsessään on pystyttävä käsittelemään erilaisia ohjelmistossa ilmeneviä virheitä. Kaikki virheet tulisi ottaa kiinni, käsittelemättömille poikkeuksille ei tulisi olla tilaa. Tämä tarkoittaa, että tavallisen virheenkäsittelyn lisäksi ohjelmiston on pystyttävä käsittelemään myös kaikenlaisia virheitä, jotka voivat tulla Severan REST API:lta.

Lokitus

Lokitus on yksi tärkeimmistä asioista integraatiossa, koska virhetilanteessa lokista on voitava lukea, mitä integraatio on tehnyt virheen aikaan. Lokitus voidaan tehdä esimerkiksi:

  • Integraation ajavan palvelimen tapahtumalokiin
  • Sovelluksen tietokantaan
  • Lokitus sähköpostiin. Huomaa, että jos lokitus tehdään sähköpostiin, lähetetyt tiedot eivät ole turvallisia, sillä sähköposti on kuin postikortti matkatessaan internetissä. Integraatio voi myös tuottaa paljon lokidataa, jolloin sähköposti voi muuttua käyttökelvottomaksi.


Lokitus tulisi tehdä vähintään näillä tasoilla:

  • Integraation edistyminen on kirjattava
  • Virheet on kirjattava


Lokituksessa on oltava aikaleimat kaikille tärkeille toiminnoille. On parasta, jos aikaleimassa on sekunnin tarkkuus, koska minuutin tarkkuus on usein liian suuri, sillä siirrot tapahtuvat nopeasti.



Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Pahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.