Vmesnik prečka več kot mejo omrežja
Znotraj ene ekipe je mogoče neformalno popraviti manjkajoči kontekst. Razvijalec vpraša lastnika procesa, operator prizna izjemo, ali pa je konvencija podatkovne baze splošno razumljiva. Po organizacijah te bližnjice izginejo. Vsaka stranka ima svoj besednjak, cikel izdaje, avtoriteto, kontrole in interpretacijo uspeha.
Specifikacija API-ja ali datoteke je lahko veljavna, poslovna interakcija pa še vedno dvoumna. Odgovor »sprejeto« lahko pomeni strukturno prejeto, uvrščeno v pregled, poslovno odobreno ali zaključeno. Če ta pomen ni pogodbeno opredeljen, se lahko oba sistema vedeta natanko po zasnovi in kljub temu ustvarita sporen izid.
Načrtujte pet plasti integracijske pogodbe
Celovita integracijska pogodba zajema interakcijo, semantiko, vedenje, delovanje in spremembe. Interakcija določi pobudnika, zaporedje in prehod odgovornosti. Semantika opredeli poslovne objekte, polja, enote in stanja. Vedenje opredeli preverjanje, odzive, napake, ponovne poskuse in idempotentnost. Delovanje opredeli opazljivost, podporo, usklajevanje in okrevanje. Spremembe opredelijo združljivost, različičenje, obveščanje in opustitev.
Ni vsak vmesnik potrebuje dolg formalni dokument. Globina mora slediti posledicam in organizacijski razdalji. Pomemben korak je, da vsaka plast premišljeno odločitev. OpenAPI, prireditve sheme ali razporedi datotek lahko nosijo dele pogodbe, vendar nobena samodejno določa odgovornost in operativni pomen.
Identiteto in korelacijo ohranite neodvisno od prenosa
Transakcija lahko med premikanjem pridobi lokalne ključe podatkovne zbirke, identifikatorje sporočil in reference serije. Sistem še vedno potrebuje stabilen način za odgovor, ali se dva zapisa nanašata na isti poslovni dogodek. Korelacija mora biti izrecna, trajna in na voljo podpornim skupinam, ne pa skrita v internih dnevnikih integracijske komponente.
Identiteta določa tudi podvojeno obnašanje. Če se pošiljatelj vrne po negotovem premoru, mora prejemnik priznati, ali zahteva predstavlja enak predvideni učinek. Ključ za idempotence je uporaben le, ko se dogovori o obsegu, življenjski dobi in poslovnem pomenu. V nasprotnem primeru premakne nejasnost v novo polje.
Stanje je poslovna obljuba, ne oznaka zaslona
Vsako zunanje vidno stanje mora imeti en pomen, avtoritativen lastnik, dovoljene prehode in pričakovano naslednje dejanje. Sprejeto, validirano, sprejeto, v teku, dokončano in zavrnjeno ni zamenljivo. Če je notranje stanje bolj podrobno, mora biti kartiranje do partnerske pogodbe premišljeno in reverzibilno dovolj za podporo.
Koristen odziv na stanje nosi korelacijo, čas, stanje, razum in odgovornost. Razlikuje terminalsko zavrnitev od začasnega stanja in nakazuje, ali je ponovno poskus dovoljen. Brez tega vedenja pošiljatelji izumijo lastne domneve in skriti procesi ročne podpore postanejo del integracije.
Napake in okrevanje načrtujte pred idealnim tokom
Delna odpoved je običajna, kadar komunicirajo neodvisni sistemi. Prejemnik lahko delo dokonča, njegov odziv pa se izgubi. Nadaljnji korak lahko odpove po prejetem potrdilu. Paket lahko vsebuje veljavne in neveljavne elemente. Pogodba mora za pomembne primere pojasniti atomskost, ponovne poskuse, vrstni red, ponovno predvajanje, izravnalne ukrepe in usklajevanje.
Okrevanje je tako tehnično kot organizacijsko. Nekdo potrebuje avtoriteto za ponovno predvajanje ali korektivne podatke; prizadete strani potrebujejo dokaze; podpora mora vedeti, kdaj se je avtomatsko ponovno testiranje ustavilo; in podjetje potrebuje pot za rezultate, ki jih ni mogoče obrniti. Te odgovornosti bi morale biti preizkušene v sprejemnih scenarijih.
Vključevanje partnerjev naj bo rezultat arhitekture
Če vsak novi partner potrebuje zasebno znanje, organizacija še nima integracijske zmogljivosti. Ponovljiv vzorec vključuje poslovno interakcijo, primere pogodb, teste skladnosti, pravila preverjanja podatkov, proces poverilnic, okoljsko pot, operativne stike, merila pripravljenosti in politiko različic.
Standardizacija bi se morala osredotočiti na stabilne dele, hkrati pa omogočati utemeljeno variacijo. Z oblikovanjem vsakega partnerja v eno fizično obliko lahko ustvarimo krhko kartiranje na robu. Kanonični semantični model ali pogodbeni besednjak je dragocen, ko zmanjšuje dvoumnost, ne pa takrat, ko postane drug osrednji model, ki ga nima nihče v lasti.
Mejo upravljajte z dokazi
Upravljanje med organizacijami mora biti vidno v operativnih artefaktih: imenovani lastniki, zapisi različic, pričakovanja glede storitev, kategorije napak, dokazi o sprejetju in skupni koledar sprememb, kjer je to potrebno. Srečanja brez pogodbenih dokazov ne morejo nadomestiti neopredeljenega ravnanja.
Začnite majhno z izbiro ene pomembne transakcije in hojo od poslovnih namenov skozi obe organizaciji, vključno z negotovim odzivom in spremembo pravila. Luknje, ki so bile ugotovljene v tem sprehod skozi pogosto pojasnjuje več kot širok popis tehnologij vključevanja.