Integrációs szolgáltatások beállításához szükséges felület létrehozása

Integrációs felület készítése

Az integrációs felület akkor jó, ha a különböző rendszerek tényleg átadják egymásnak az adatokat, nem csak papíron kapcsolódnak össze. Az integrációs felület készítése legtöbbször akkor kerül elő, amikor egy webshop, számlázó, ügyfélkezelő vagy belső nyilvántartás már együtt kell hogy működjön, de a folyamatok akadoznak. A magyar találatokban gyakran visszatér az összekapcsolás, az API adatok megadása, a jogosultságkezelés és a hibák naplózása, az ангol nyelvű oldalak pedig sokszor külön kiemelik az adatfolyam ellenőrzését, a hitelesítést és a későbbi bővíthetőséget. Szerintem egy jó összekötő felület nem attól értékes, hogy bonyolult, hanem attól, hogy átlátható és terhelés alatt is kiszámítható marad.

Sokan ott hibáznak, hogy túl korán a képernyőre figyelnek, és túl későn az adatok szerkezetére. Pedig előbb azt kell tisztázni, milyen esemény indít átadást, mi számít sikeres műveletnek, mi történik hiba esetén, és ki látja a visszajelzést. Egy fejlesztő vagy integrációs szakember akkor tud jól dolgozni, ha nem csak a gombok helyét kapja meg, hanem a teljes folyamatot is. Ezen a ponton a megrendelőnek is érdemes végiggondolni, mely adatok élnek az egyik rendszerben, melyek a másikban, és hol van az egyetlen biztos forrás.

Kapcsolódó rendszerek és adatáramlás

Az összekapcsolt felület tervezésénél az első kérdés mindig az, mely rendszereket kell egy láncba kötni. Ez lehet webáruház és számlázás, ügyfélkezelő és levelezés, foglalási rendszer és naptár, vagy akár belső admin felület és külső partneri adatforrás. A lényeg az, hogy az adat ne kézzel vándoroljon egyik helyről a másikra. Egy jól felépített csatlakozási felület csökkenti a másolást, visszafogja a hibát, és később könnyebb rajta módosítani.

Az is fontos, hogy az adatáramlás ne legyen egyirányú, ha az élethelyzet nem ezt kívánja. Volt már olyan eset, amikor egy ügyfél azt hitte, elég lesz a rendeléseket áthúzni a másik rendszerbe. De később kiderült, hogy a státuszváltozásnak is vissza kell mennie, különben az ügyfélszolgálat régi állapotot lát. Ilyenkor rögtön látszik, mennyire nem mindegy, hogy a feladatot csak egyszerű bekötésként kezelik, vagy valódi rendszerkapcsolatként. Személy szerint én jobban szeretem azt a megoldást, ahol minden átadott adatnak van egy világos útja és egy látható ellenőrzési pontja.

Hibák és biztonság az integrációban

Az integrációs felület sokszor nem a sikeres átadásoknál bukik meg, hanem a ritka hibáknál. Ha nincs normális visszajelzés arról, hogy egy rekord miért nem ment át, a hiba napokig láthatatlan marad. A magyar és nemzetközi találatok alapján is gyakori téma a jogosultság, az API kulcs, a hitelesítés, valamint a hibák naplózása. Ezek nem díszítő elemek. Ezek nélkül a rendszerkapcsolat csak ideiglenesen tűnik stabilnak.

Sokan elkövetik azt a hibát, hogy ugyan kérnek hibalistát, de nem kérik mellé az értelmezhető magyarázatot. Ettől a felület lehet, hogy technikailag kész, csak használni nehéz. Egy tapasztalt fejlesztő ilyenkor nem csak naplóz, hanem rangsorolja is a hibát. Más a jelentősége egy pillanatnyi kapcsolatkimaradásnak, és más annak, ha rossz mezőbe kerül ügyféladat. Én különösen figyelek arra, hogy a fontos hibáknál legyen emberi nyelven érthető jelzés, mert a megrendelő nem programkódokat akar böngészni.

Integrációs felület árak

Az ár általában attól függ, hány rendszert kell összekötni, van-e kész dokumentáció, mennyi egyedi logika kell, és szükséges-e utólagos tesztelés valós adatokkal. Olcsóbb lehet egy egyszerű adatküldés, de jóval többe kerülhet, ha kétirányú szinkron, jogosultságkezelés és részletes hibakezelés is kell. A csatlakozási felület díja gyakran azért szóródik nagy tartományban, mert a megrendelés elején még nem egyértelmű, mennyi kivételes eset jelenik meg munka közben.

Az én tapasztalatom az, hogy a túl olcsó ajánlatoknál gyakran hiányzik valami fontos rész. Például nincs benne teszt, nincs benne naplózás, vagy nincs benne az átadás utáni javítás. Olcsóbban 45.000 alatt néha lehet találni kisebb munkát, de tartós és jól követhető megoldást ritkán. Sok ügyfél csak utólag érzi meg, hogy a kezdeti spórolás később dupla munka lett. És ez különösen igaz akkor, ha a kapcsolat üzleti adatokat mozgat.

Megfelelő szakember választása

Jó szakembert akkor választasz, ha nem csak azt figyeled, ki vállalja el gyorsan, hanem azt is, ki kérdez jól. Az integrációs felület készítése előtt a fejlesztőnek vagy integrációs szakembernek rá kell kérdeznie az adatok forrására, a mezők egyezésére, a hibák kezelésére és a használat napi menetére. Ha valaki ezek nélkül ad fix árat, az nekem mindig gyanús. Egy ügyfél egyszer úgy keresett megoldást, hogy már volt három korábbi próbálkozás. Mindháromnál elkészült valamilyen kapcsolat, de egyik sem kezelte rendesen a duplikált adatokat. A negyedik munka már nem a kód miatt lett drágább, hanem azért, mert előbb rendet kellett tenni.

Én személy szerint azt kedvelem, ha a szakember röviden visszamondja a feladat logikáját saját szavaival. Ebből rögtön látszik, hogy érti-e a problémát. Érdemes referenciát kérni hasonló rendszerkapcsolatról, megkérdezni, dolgozott-e már dokumentáció nélkül, tud-e hibát visszakövetni, és vállal-e utólagos finomítást. A Qjob.hu oldalon is sokat számít, ha valaki nem csak általános fejlesztést vállal, hanem tényleg látott már API bekötést, adatmező térképezést és jogosultsági hibát a gyakorlatban.

Munka helyben vagy távolról

Nem minden integrációs felület igényel személyes jelenlétet. Sok feladat távolról is biztonságosan megoldható, ha van tesztkörnyezet, hozzáférési rend és egyértelmű feladatleírás. De vannak helyzetek, amikor a helyi egyeztetés gyorsít. Ilyen például az, amikor több belső felhasználó dolgozik eltérő folyamattal, és elsőre senki sem tudja pontosan leírni, mi történik egy rendelés vagy ügyfélesemény útja során. Ilyenkor a személyes átbeszélés gyakran rövidebb, mint öt körös levelezés.

Ha nincs megadva konkrét város, akkor is érdemes tisztázni, hogy a munka teljesen távoli lesz-e, vagy szükség van induló egyeztetésre, közös képernyős ellenőrzésre, esetleg belső bemutatóra. A csatlakozási felület minőségét nem az dönti el, hogy valaki egy irodában ül-e, hanem az, hogy van-e rendes kommunikáció. De a helyszíni alkalom néha sok félreértést megspórol. Különösen akkor, ha a munkafolyamat több osztályt érint.

Gyakori félreértések a megrendelésnél

Az egyik tipikus félreértés az, hogy a megrendelő kész felületet kér, miközben valójában üzleti szabályt szeretne. Ez nagy különbség. A felület csak megjelenít valamit, de a valódi nehézség sokszor a háttérben van. Például mikor fusson a szinkron, melyik mező írhatja felül a másikat, vagy mi legyen, ha ugyanaz az ügyfél két eltérő azonosítóval szerepel. Sok vita abból lesz, hogy ezekről nem esik szó időben.

Másik gyakori hiba, amikor valaki egy régi összekötő felület javítását kéri, de nem mondja el, hogy korábban többen belenyúltak. Ilyenkor a szakember nem nulláról indul, hanem egy részben ismeretlen rendszerből. Volt olyan ügy, ahol a megrendelő csak annyit mondott, néha eltűnnek adatok. A végén kiderült, hogy nem eltűntek, hanem két eltérő szabály szerint íródtak felül. Ez kívülről ugyanannak látszott, de belül teljesen más probléma volt. Én ezért mindig jobbnak tartom a túl részletes leírást, mint a túl rövidet.

A jó átadás és a későbbi bővítés

Egy jól elkészült integrációs felület nem ott ér véget, hogy ma működik. Fontos, hogy később is lehessen bővíteni, új mezőt hozzáadni, egy új rendszert bekötni, vagy ellenőrizni, mi történt egy adott napon. Az angol nyelvű útmutatókban gyakran visszatér a skálázhatóság és a karbantarthatóság gondolata. Nem véletlenül. Ha a kapcsolat csak egyetlen helyzetre van összedrótozva, az első módosításnál már törékennyé válik.

Én a lezárásnál mindig fontosnak tartom, hogy maradjon rövid leírás az adatmezőkről, a hibakódokról és a működés logikájáról. Nem kell túlírni, de kell egy használható összefoglaló. Ez különösen hasznos, ha később másik fejlesztő veszi át a rendszert. A jó átadás nem látványos, mégis ezen múlik, hogy a megrendelő fél év múlva nyugodt marad-e. És itt dől el az is, hogy az összekötő felület valóban hasznos eszköz lesz, vagy csak egy gyorsan elkészült, nehezen fenntartható toldás.