Dobrá praxe a tipy z praxe
Tato doporučení vám pomohou stavět v Aiviro Editoru robustní, čitelné a udržovatelné scénáře.
1. Začněte v malém, rychle rostěte
Vytvořte mikro-scénář — několik akcí, které spustí aplikaci a kliknou na jedno tlačítko. Zvládněte základy a pak přidávejte cykly, podmínky a bloky v Pythonu.
2. Testujte často
Označte větev ve stromu Příkazy a spusťte jen ji. Oprava chyby ve scénáři o pěti akcích zabere minuty; hledání téže chyby mezi padesáti akcemi může stát hodiny.
3. Čekejte na obrazovku, nespěte
Největší jediná příčina nestabilních automatizací je pevný Spánek, který byl dostatečně dlouhý v den, kdy vznikl. Použijte Počkat na něco, co další obrazovka skutečně zobrazuje, a Počkat na zmizení na dialogy s průběhem. Spánek si nechte na vzácný případ, kdy se nic pozorovatelného nemění.
4. Ukotvěte hledání k něčemu stabilnímu
Pokud se hodnota mění při každém běhu, nehledejte tu hodnotu — hledejte popisek vedle ní pomocí pozičního vyhledávání. Dejte přednost textovým objektům před Obrázkem, který se rozbije při změně tématu a DPI.
5. Nikdy nedávejte přihlašovací údaj do akce
Každé heslo, token a URL webhooku patří do trezoru, odkud se na něj
odkážete jako {{SECRET:KLIC}}. Údaj napsaný do parametru se při dalším uložení zapíše do
souboru projektu — a odtud do historie Gitu.
6. Myslete v proměnných
Dynamická data — zkopírovaný text, cesty k souborům, přečtené hodnoty — ukládejte do proměnných
místo pevného zadrátování. Pojmenujte je popisně: id_zaznamu, ne promenna_1.
7. Strukturujte sekcemi
Související akce seskupte do bloků Sekce (Přihlášení, Export CSV, Odeslání reportu). Sekce se sbalují, lze je spouštět izolovaně a dělají zobrazení Diagram čitelným.
8. Komentujte proč
Co se děje, už říká seznam akcí. Napište to, co z něj vyčíst nelze: „tento dialog se objeví jen při prvním přihlášení dne“, „export trvá na konci měsíce asi 40 s“.
9. Vypněte, nemažte
Místo mazání rizikové akce jí nastavte Spustit akci na Vypnuto. Zůstane ve stromu, zešedlá, a jedním kliknutím ji zapnete zpátky.
10. Používejte prostředí místo duplikování scénářů
Povoleno (jen Test) a Povoleno (jen Prod) umožní jednomu scénáři chovat se v obou prostředích jinak, přepínané přepínačem Prostředí. Dvě kopie scénáře se vždy rozejdou; jeden scénář ve dvou režimech ne.
11. Řešte selhání explicitně
- Spustit při selhání na reportovací akci, aby rozbitý běh nebyl nikdy tichý.
- Spustit vždy na úklidu, například Zavřít všechna okna, aby stroj zůstal použitelný.
- Vyžadovaný úspěch vypnutý u skutečně nepovinných kroků — ale jen u nich.
12. Držte cykly konečné
Opakovat dokud se může zacyklit navždy, když se podmínka nikdy nepřeklopí. Pojistěte ho počítadlem, akcí Zastavit cyklus na limitu iterací, nebo podmínkou navázanou na to, co obrazovka zobrazuje.
13. Hlaste, co běh udělal
Přidat zprávu s ID sekce během scénáře plus jedno Odeslat jako email na konci změní černou skříňku na report, který si někdo přečte u kávy.
14. Sdílejte a verzujte
Projekty jsou uložené jako JSON — commitujte je do Gitu a větvěte jako jakýkoli kód. Protože tajemství jsou v trezoru, soubor projektu je bezpečné commitnout. Soubor → Exportovat do Pythonu dá navíc podobu vhodnou pro code review.
15. Nechte se inspirovat
Prozkoumejte playlist s návody na YouTube a ukázkové projekty — viz Odkazy a zdroje. Používejte existující vzory místo jejich vymýšlení znovu a společné rutiny natahujte akcí Importovat Scénář.
Dodržování těchto zásad udrží vaše automatizace přehledné, snadněji laditelné a pochopitelné pro kolegy.