Pred schválením prepojenia objednávkového, skladového alebo účtovného systému sa opýtajte, čo sa stane, keď tá istá aktualizácia príde dvakrát. Doručenie môže byť potrebné zopakovať. Faktúra, požiadavka na expedíciu alebo správa zákazníkovi už však môžu existovať.
Chýbajúca odpoveď necháva otázku otvorenú
Predstavte si, že jeden systém odošle aktualizáciu a prijímajúci systém dokončí prácu. Odpoveď potvrdzujúca úspech sa cestou späť stratí. Odosielateľ čaká, vyprší mu časový limit a skúsi to znova.
Časový limit vysvetľuje, prečo došlo k ďalšiemu doručeniu. Nehovorí vám, či sa prvý pokus dokončil. Vypnutie opakovaných pokusov môže nechať prácu nedokončenú; opakovanie každej obchodnej akcie môže vytvoriť prácu navyše.
Malcolm Featonby opisuje túto neistotu v článku Amazon Builders’ Library o bezpečnom opakovaní požiadaviek pomocou idempotentných API. Stripe a Shopify tiež dokumentujú opakované doručenia webhookov. Webhook je automatická aktualizácia odoslaná z jedného systému do druhého. O tomto správaní sa oplatí hovoriť pred uvedením prepojenia do prevádzky.
Ktorá akcia sa má vykonať iba raz?
Predstavte si internetový obchod, v ktorom má aktualizácia o zaplatenej objednávke vytvoriť jednu požiadavku na vybavenie. Tieto tri situácie si vyžadujú odlišný prístup:
Tá istá aktualizácia príde znova
Požiadavka na vybavenie už môže existovať. Ďalšie doručenie by nemalo vytvoriť ďalšiu požiadavku pre tú istú zamýšľanú akciu v dohodnutých medziach.
Iná aktualizácia sa týka tej istej objednávky
Zmena adresy alebo zrušenie môže vyžadovať inú prácu. Rovnaké číslo objednávky neznamená, že každá aktualizácia je nadbytočná.
Zákazník zadá druhú objednávku
Nová objednávka sa musí spracovať, aj keď zákazník, položky a celková suma vyzerajú rovnako. Podobné údaje nedokazujú, že ide o opakovanie.
Opýtajte sa dodávateľa, čo určuje zamýšľanú akciu a ako sa jej identita zachová pri ďalšom doručení. Nemusíte si vybrať technický mechanizmus. Potrebujete však vysvetlenie, prečo systém rozpozná opakovanie a zároveň umožní skutočne novú prácu.
Podrobnosti sa líšia podľa poskytovateľa. Dokumentácia Stripe opisuje opakované udalosti aj samostatné udalosti týkajúce sa toho istého objektu. Shopify rozlišuje jednotlivé doručenie od činnosti obchodníka, ktorá za ním stojí. Identifikátor užitočný na jeden účel nie je automaticky správnym pravidlom pre každú obchodnú akciu.
Príklady nájdete v dokumentácii webhookov Stripe a v sprievodcovi Shopify na overovanie doručení. Dodávateľ by mal overiť aktuálne správanie systémov, ktoré skutočne prepájate.
Zistite, čo sa stane, keď sa dokončí iba časť práce
Predpokladajme, že požiadavka na vybavenie vznikne, ale prepojenie sa preruší skôr, než zaznamená jej dokončenie. Ako pri ďalšom pokuse nájde existujúcu požiadavku? Čo ak prídu dve kópie naraz? Samotný zoznam predtým zaznamenaných aktualizácií neodpovedá ani na jednu otázku.
Požiadajte dodávateľa, aby vám ukázal tri veci osobitne: dôkaz, že aktualizácia prišla, stav jej spracovania v prepojení a dôkaz o výslednej akcii v prijímajúcom systéme. Potvrdenie doručenia samo osebe nemusí dokazovať, že požiadavka na zásielku alebo faktúra existuje.
Ak výsledok zostane neistý, vopred sa dohodnite, kto ho preverí a čo skontroluje pred povolením ďalšieho pokusu. Dajte zamestnancom jasné hranice: ktoré akcie môžu obnoviť, ktoré si vyžadujú pomoc dodávateľa a kedy majú zastaviť, aby neriskovali vytvorenie ďalšej obchodnej akcie. Niektoré problémy si vyžadujú porovnanie záznamov medzi systémami a rozhodnutie človeka o ďalšom postupe.
„Skúste to znova“ pomáha iba vtedy, keď viete, čo ďalší pokus smie vykonať a kto prevezme riešenie, ak výsledok nie je jasný.
Požiadajte o bezpečnú ukážku
Použite podporované testovacie prostredie s vymyslenými záznamami a vypnutými externými obchodnými akciami. Ukážka má pokryť dvojité doručenie tej istej aktualizácie, skutočne druhú objednávku a zlyhanie po úspešnom dokončení jedného kroku. Skontrolujte výsledné záznamy aj protokol doručenia. Nikdy neopakujte živú platbu ani objednávku len preto, aby ste zistili, čo sa stane.
Požiadajte o krátky písomný opis spúšťača, zamýšľanej akcie, spôsobu rozpoznania opakovania a miesta, kde zamestnanci uvidia výsledok. Uveďte, ako dlho si prepojenie pamätá predchádzajúcu prácu, čo sa stane s oneskoreným doručením a kto rieši neistú alebo čiastočne dokončenú akciu.
Ak systémy neumožňujú bezpečne predviesť konkrétne zlyhanie, zaznamenajte túto medzeru a dohodnite si s dodávateľom užšiu kontrolu. Úspešný test potvrdzuje správanie za daných podmienok. Nezaručuje presne jedno vykonanie naprieč všetkými prepojenými službami ani nedokazuje, že sa celá postupnosť dokončí ako jediná nedeliteľná operácia.
Vytvárame integrácie a zákazkový firemný softvér. Ak plánujete prepojenie, prineste zoznam zapojených systémov, akciu, ktorú chcete spustiť, a správanie pri opakovaní, ktoré ešte potrebujete vysvetliť. Môžeme sa porozprávať o práci potrebnej na toto prepojenie.
Otázky pred schválením prepojenia
Znamená časový limit, že prvý pokus zlyhal?
Nie. Práca sa mohla dokončiť, zatiaľ čo odpoveď sa stratila. Pred rozhodnutím, čo má ďalší pokus vykonať, skontrolujte výsledok spracovania aj prijímajúci systém.
Môžu byť dve objednávky, ktoré vyzerajú rovnako, obe platné?
Áno. Zákazník môže zámerne zadať druhú objednávku s rovnakými položkami a sumou. Prepojenie musí rozlíšiť nový zámer od opakovaného doručenia; samotná zhoda údajov o tom nerozhodne.
Ako bezpečne otestujeme správanie pri opakovaní?
Požiadajte o podporované testovacie prostredie s vymyslenými záznamami a vypnutými externými obchodnými akciami. Zahrňte opakovanie, skutočne novú akciu a zlyhanie po dokončení časti práce. Medzery v testovaní zaznamenajte namiesto experimentovania na živých objednávkach alebo platbách.
Kto má vyriešiť čiastočne dokončenú akciu?
Pred spustením určite konkrétnu osobu alebo zodpovedný tím. Zamestnanci musia vedieť, čo môžu sami skontrolovať alebo obnoviť a kedy musí dodávateľ situáciu preveriť, kým sa povolí ďalšia akcia.
