Aptarti projektą

Sistemos ir integracijos4 min. skaitymo

Kas atsako už integraciją, kai ji jau veikia?

Integracijos dažniausiai nelūžta iš karto. Jos lūžta po pusmečio, kai kita sistema kažką pakeičia, o atsakymo į klausimą „kas tai pastebės“ niekada nebuvo. Ką reikia susitarti prieš, o ne po.

Autorius
Devnora komanda
Paskelbta
Atnaujinta
Skaitymo laikas
4 min. skaitymo
Kalba
Skaityti angliškai
Šiame straipsnyje
  1. Trumpai
  2. Kodėl integracijos lūžta praėjus mėnesiams
  3. Penki susitarimai, kuriuos verta pasirašyti prieš
  4. Kaip atrodo tikras perdavimas
  5. Ką reiškia „stebėjimas“, kai jį parduoda
  6. Iliustracinis scenarijus, ne kliento projekto aprašymas
  7. Ką padaryti, jei integracija jau veikia

Integracijos pasiūlymuose beveik visada aprašomas darbas: kokios sistemos, kokie duomenys, kiek laiko. Labai retai aprašoma tai, kas vyksta po to. O būtent po to ir kyla beveik visos problemos, nes integracija skiriasi nuo kitų projektų vienu dalyku: ji gyvena tarp dviejų sistemų, kurių bent viena keisis be jūsų sutikimo.

Trumpai

  • Integracija nėra objektas, kurį galima pastatyti ir pamiršti. Tai santykis tarp dviejų sistemų, kurios abi keičiasi.
  • Didžiausia rizika nėra klaida kode – tai neatsakytas klausimas, kas pastebės, kad perdavimas nebeveikia.
  • Perdavimas įvyko ne tada, kai atiduotas kodas, o tada, kai jūsų pusėje kažkas žino, ką daryti, kai nutinka blogai.
  • Būtina susitarti prieš darbą: kas turi prieigas, kas gali keisti taisykles, kas gauna signalą apie sutrikimą.
  • Susitarimas dėl pakeitimų kitoje pusėje yra atskiras dalykas, ir jo dažniausiai nėra.

Kodėl integracijos lūžta praėjus mėnesiams

Naujai padaryta integracija paprastai veikia. Jos tikrinamos, paleidžiamos ir kurį laiką visi mato, kad duomenys keliauja. Problema atsiranda vėliau ir dažniausiai ne dėl jūsų: kita sistema atnaujinama, pasikeičia lauko formatas, pridedamas naujas privalomas laukas arba sugriežtinamos užklausų ribos. Jūsų integracija apie tai nebuvo informuota.

Toliau viskas priklauso nuo vieno dalyko: ar kas nors tai pastebi. Gerai suprojektuota integracija tokiu atveju sustoja garsiai – atsiranda klaida, susikuria eilė, kažkas gauna signalą. Blogai suprojektuota tęsia darbą su daline informacija, ir tai pastebima po dviejų savaičių, kai kažkas pasigenda dalies užsakymų.

Penki susitarimai, kuriuos verta pasirašyti prieš

  • Kas turi prieigas prie abiejų pusių ir ką daryti, kai prieigos raktas nustoja veikti. Tai dažniausia priežastis, dėl kurios integracija sustoja, ir dažniausiai lengviausiai išvengiama.
  • Kas gauna signalą apie sutrikimą. Ne „yra žurnalas“, o konkretus žmogus ar pašto adresas, kuriam atkeliauja pranešimas.
  • Kas gali keisti laukų taisykles. Jei tai gali tik tiekėjas, kiekvienas smulkus pakeitimas tampa užsakymu.
  • Kaip elgtis, kai kita pusė paskelbia pakeitimą. Kas skaito jų pranešimus? Dažniausiai atsakymas yra „niekas“.
  • Kiek laiko duomenys gali būti nesutapę, kol tai laikoma problema. Be šio skaičiaus neįmanoma nei stebėti, nei ginčytis.

Kaip atrodo tikras perdavimas

Kodo atidavimas nėra perdavimas. Perdavimas įvyko tada, kai jūsų komandoje kas nors be tiekėjo atsako į keturis klausimus. Kur pasižiūrėti, ar perdavimas veikia. Ką reiškia klaidos pranešimas. Kaip pakartoti nepavykusį perdavimą. Ir ką daryti, kai reikia pridėti naują lauką.

Praktinis patikrinimas prieš pasirašant priėmimą: paprašykite tiekėjo sąmoningai sugriauti perdavimą bandymo aplinkoje ir parodyti, kaip tai atrodo iš jūsų pusės. Jei niekas nieko nepamato – integracija dar neperduota, nesvarbu, ką rašo dokumentai.

Ką reiškia „stebėjimas“, kai jį parduoda

Stebėjimas gali reikšti tris labai skirtingus dalykus, o pasiūlymuose jie rašomi vienodai. Pirma: klaidos rašomos į žurnalą, kurį kas nors gali perskaityti, jei sugalvos. Antra: sutrikus išsiunčiamas pranešimas konkrečiam žmogui. Trečia: kas nors turi pareigą sureaguoti per sutartą laiką. Trečia yra paslauga, pirmos dvi – techninė galimybė. Verta paklausti, kuri iš jų perkama.

Iliustracinis scenarijus, ne kliento projekto aprašymas

Įsivaizduokime integraciją tarp parduotuvės ir apskaitos, kuri veikia nepriekaištingai aštuonis mėnesius. Tada apskaitos tiekėjas atnaujina savo sąsają ir vienas laukas pradedamas grąžinti kita forma. Integracija to nemoka perskaityti, todėl užsakymus praleidžia – bet klaidos niekam nesiunčia, nes to niekada nebuvo susitarta. Problema pastebima po dešimties dienų iš neatitikimo apskaitoje. Techniškai integracija buvo padaryta gerai; neapibrėžta buvo tik atsakomybė. Tai pavyzdys, kaip vertiname apimtį, o ne pažadas dėl veikimo laiko.

Ką padaryti, jei integracija jau veikia

  • Sužinokite, kas šiandien pastebėtų sutrikimą. Jei atsakymo nėra, tai vienintelis svarbus darbas šią savaitę.
  • Patikrinkite, kada baigiasi prieigos raktai ir kas juos atnaujins.
  • Suraskite, kur yra žurnalas, ir perskaitykite jį kartą – dažnai jame jau yra klaidų, kurių niekas nematė.
  • Užrašykite laukų taisykles, jei jos gyvena tik tiekėjo galvoje.
  • Susitarkite, kas skaitys kitos pusės pranešimus apie pakeitimus.

Nė vienas iš šių punktų nėra techninis darbas, ir būtent todėl jie taip dažnai nepadaromi. Bet jie nulemia, ar po metų integracija bus veikianti dalis infrastruktūros, ar tyli rizika, apie kurią prisimenama tik incidento dieną.

Dažni klausimai

Ar integracija nėra vienkartinis darbas?
Techniškai ją galima padaryti vieną kartą, bet ji gyvena tarp dviejų sistemų, kurių bent viena keisis be jūsų sutikimo. Todėl integracija yra ne objektas, o santykis: kol abi sistemos naudojamos, kažkas turi reaguoti, kai viena pusė pasikeičia.
Ką reiškia, kad integracija „perduota“?
Ne tai, kad kodas atiduotas. Perdavimas įvyko tada, kai jūsų pusėje kas nors žino, kur pasižiūrėti, kai perdavimas nepavyko, kokį signalą tai duoda, kas turi prieigas ir kam skambinti, jei reikia pakeitimo. Be šito integracija perduota tik formaliai.
Ar galima integraciją prižiūrėti be tiekėjo?
Dažnai galima, jei apie tai buvo pagalvota kuriant: suprantami klaidų pranešimai, prieinamas žurnalas, dokumentuotos laukų taisyklės. Tada tiekėjo reikia tik pakeitimams, o ne kasdienei priežiūrai. Jei to nėra, priežiūra tampa priklausomybe, ir tai kainuoja tyliai.

Dalintis

Siųsti el. paštu

Kitas žingsnis

Susijusi paslauga

API ir sistemų integracijos

API ir sistemų integracijos: duomenų tiesos šaltinis, kaip išvengti dublikatų, pakartotiniai perdavimai, stebėjimas ir atsakomybė po perdavimo.

Jei straipsnis aprašo jūsų situaciją, papasakokite, kas neveikia. Atsakysime, ar ir kaip galime padėti.

Toliau verta perskaityti

  1. Sistemos ir integracijos

    API integracija: kas nutinka, kai duomenys nesutampa?

    Integracija sugenda ne tada, kai nutrūksta ryšys, o tada, kai dvi sistemos tyliai rodo skirtingus dalykus. Šis vadovas aprašo, kaip atsiranda dublikatai, kodėl kartojimas be atpažinimo ženklo yra pavojingas ir kaip iš anksto susitarti, kuri sistema laikoma tiesa.

  2. Priežiūra ir techninė kokybė

    Perrašyti ar tvarkyti: kaip nuspręsti dėl senos sistemos

    Sprendimas kurti iš naujo priimamas dažniau, nei pagrįstas. Keturios patikros, kurias galite atlikti patys, ir klausimas, kuris atskiria techninę problemą nuo organizacinės.

Daugiau šia tema: Sistemos ir integracijos