Propojení aplikací přes programová rozhraní
Publikováno · Aktualizováno
Programové rozhraní umožňuje aplikaci předávat informace jiné službě podle stanovených pravidel. Začněte konkrétním pracovním výsledkem, popište převod údajů a ověřte celý postup před použitím se skutečnými zákaznickými žádostmi.
Určete výsledek propojení
Vyberte ověřitelný výsledek, například převod dotazu z webu na záznam zpracovatelný zaměstnancem. Určete zdroj, cíl a počáteční událost. Rozhodněte, zda aplikace čte informace, vytváří novou položku nebo mění existující záznam. Jasný účel umožňuje propojení kontrolovat a brání tomu, aby technicky působivé spojení přineslo málo užitečné práce. Zaměstnanec musí rozumět, co vznikne a jak podle výsledku pokračovat, jinak samotný přenos údajů nestačí.
Popište očekávaný konečný stav v obou systémech. Dotaz může potřebovat místní označení, vnější označení a potvrzení dosažené fáze. Rozhodněte o jednom nebo obou směrech přenosu. Když oba systémy umožňují úpravy, určete rozhodující zdroj každého pole před synchronizací. Jinak další změna může bez upozornění přepsat správné informace. Ujasněte také odpovědnost za rozporné úpravy a způsob, jak tým pozná údaj, který má při dalším zpracování použít.
- Ověřitelný pracovní výsledek
- Známý zdroj a cíl
- Určený konečný stav
Přečtěte dokumentaci a přiřaďte pole
Použijte dokumentaci skutečné služby a zamýšlené verze. Najděte povinná pole, přípustné formáty a význam vrácených hodnot. Připravte přiřazení vlastních údajů těmto polím. Jméno, adresa nebo čas mohou vyžadovat určité vyjádření. Podobně pojmenovaná pole nemusí znamenat totéž. Převod popište tak, aby zaměstnanci později rozuměli rozdílu mezi původním záznamem a tím, který vidí v cílovém systému. Nepřebírejte cizí příklad bez kontroly skutečného účelu.
Zjistěte, zda dostupné vývojové nástroje spojení usnadní, nebo zda jsou vhodnější přímé požadavky. Pomocné funkce nenahrazují porozumění prováděné operaci. Zapište pravidla dat, měn, volitelných polí a chybějících hodnot. Uchovejte několik schválených příkladů s očekávanými výsledky. Používejte vhodné zkušební údaje místo zbytečných skutečných zákaznických informací v ukázce nebo společném zadání. Malý známý příklad se dá snáze zopakovat i ověřit při pozdější změně propojení.
- Povinná a volitelná pole
- Pravidla data a měny
- Příklady se známými výsledky
Připravte přístup a první zkoušku
Určete způsob povolení přístupu a potřebné operace. Používejte přístupové údaje určeného prostředí. Tajné hodnoty pro vnitřní zpracování nepatří do veřejných stránek ani stažitelných souborů. Zapište názvy nastavení a jejich správce bez kopírování důvěrných hodnot do sdílených instrukcí. Zjistěte také, jak se nastaví náhradní údaje při změně účtu nebo přístupu. Tým má vědět, kdo tuto změnu provede a jak ověří následnou funkčnost služby.
Cíl propojení můžete popsat službě Infera Agent a požádat o pomoc s postupem údajů a plánem zkoušek. Ověřte možnosti dostupné v účtu, než na nich založíte práci. Začněte malým kontrolovaným požadavkem a prohlédněte odpověď i cílový záznam. Stav připojeno neprokazuje správné doručení ani dokončení další obchodní činnosti. Zkontrolujte tedy také, co zaměstnanec skutečně dostal, jak může pokračovat a jakou zprávu nakonec obdrží původní uživatel.
- Přístup správného prostředí
- Neveřejné tajné hodnoty
- Kontrola cílového záznamu
Vědomě řešte chyby a opakované události
Testujte chybějící vstup, nepřípustné hodnoty, odmítnutý přístup a dočasně nedostupný cíl. Určete zobrazení pro uživatele i informace pro zaměstnance. Rozlišujte určitý neúspěch od žádosti s nejistým výsledkem, protože nepřišla odpověď. Opakování druhého případu bez kontroly může vytvořit duplicitu, i když první pokus už uspěl. Nejistotu zapište do stavu a vysvětlete, co je třeba zkontrolovat před novým odesláním, aby se nepokračovalo pouze podle domněnky.
Zachovejte stálé odkazy pro rozpoznání opakovaného odeslání. Ověřte dokumentovaný způsob prevence duplicit, který skutečná služba podporuje. U příchozích oznámení kontrolujte původ podle pokynů poskytovatele a zkoušejte opakované nebo opožděné doručení. Sledujte fáze zpracování pro rozumné pokračování bez opakování již hotové činnosti. Jedna žádost nemá vytvářet další stejné zprávy jen kvůli novému doručení události nebo tomu, že uživatel při nejistotě znovu stiskl tlačítko.
- Viditelné srozumitelné chyby
- Stálé odkazy žádostí
- Zkoušky opakovaného a opožděného doručení
Ověřte postup a udržujte spojení
Projděte celou cestu od činnosti aplikace k vnějšímu výsledku a zpět k potvrzení uživatele. Porovnejte uložené hodnoty se schválenými příklady a ověřte další změny. Testujte prostředí, které bude spojení provozovat, protože místní úspěch se tam nemusí opakovat. Odpovědný personál má potvrdit použitelnost vzniklého záznamu, jeho správný cíl a přítomnost údajů potřebných k pokračování. Tím ověřujete pracovní výsledek, ne pouze samotné technické navázání spojení.
Dokumentujte verzi, převod polí, nastavení a obnovu po chybě. Sledujte nevyřešené přenosy s dostatkem informací pro hledání problému, bez zbytečných osobních údajů v provozních přehledech. Znovu testujte při změně polí, přístupů nebo vnějšího chování. Před velkou úpravou uchovejte obnovitelnou konfiguraci. Ověřte, že existující označení stále umožňují najít starší žádosti, aby změna nepřerušila vztah mezi již vytvořenými údaji a prací, kterou zaměstnanci ještě potřebují dokončit.
- Ověření celé cesty
- Popsaná verze a převod
- Zkoušky po změně nastavení
Otázky
Jaký je rozdíl mezi rozhraním a vývojovými nástroji?
Rozhraní určuje výměnu informací. Nástroje dodávají pomocný kód a funkce pro použití. Obojí potřebuje správný převod údajů a praktické zkoušky.
Lze automaticky připojit libovolnou službu?
Potřebujete vhodné rozhraní, přístup a podporované operace. Ověřte podmínky místo předpokladu, že všechny služby nabízejí stejné možnosti.
Proč zkoušet opakované žádosti?
Událost může přijít vícekrát. Bez stanoveného zacházení vytvoří jediná činnost zákazníka několik záznamů nebo oznámení.
Jak poznám funkční propojení?
Kontrolujte konečné záznamy a pracovní výsledek, ne jen ukazatel spojení. Ověřte hodnoty, odpovědnost a potvrzení, které uživatel obdržel.