Typy toků a základní vytvoření toku
Po úspěšném vytvoření a otestování vlastního Custom Connectora je možné jeho operace (Actions) použít přímo v Power Automate flow. Tyto operace se chovají stejně jako akce nativních konektorů Microsoftu.
Power Automate nabízí dva hlavní způsoby vytváření toků:
- My flows – tato sekce je vhodná zejména pro:
- rychlé testování
- osobní nebo dočasné automatizace
- ověření funkčnosti vlastního konektoru
Toky vytvořené v této sekci jsou vázány na konkrétního uživatele a nejsou určeny přímo pro nasazení v týmu.
- Solutions – sekce solutions je doporučený způsob pro:
- nasazení do produkčního prostředí
- správu životního cyklu řešení
V Solutions je možné custom connector zahrnout jako součást řešení spolu s flowmi, environment proměnnými a dalšími komponenty. Z dlouhodobého hlediska je tento přístup přehlednější a udržitelnější.
Doporučení:
Pro nasazení do produkčního prostředí a sdílení konektoru se doporučuje používat sekci Solutions. Flowy vytvořené v sekci My flows lze následně snadno importovat do Solution spolu s jejich kompletní konfigurací.
Sekce Solutions navíc oproti sekci My flows umožňuje používat tzv. Child Flows, kde je možné vzájemně propojovat více flowů. Na základě definované logiky je tak možné z jednoho toku spustit další akce nebo podřízené toky. Tento přístup je vhodný zejména pro oddělení jednotlivých funkcí nebo spouštěčů, protože jeden tok standardně nemůže obsahovat více spouštěčů.
Zásady fair play
Při používání toků Power Automate a volání API bychom vás na rádi požádali o ohleduplné nastavení automatizací, aby systém fungoval spolehlivě.
Pokud používáte spouštěče typu Recurrence, zvažte, zda je skutečně nutné, aby tok běžel velmi často. Příliš krátké intervaly spouštění mohou zbytečně zatěžovat backendové systémy.
Stejně tak některé API endpoints zpracovávají větší množství dat nebo provádějí náročnější operace. V takových případech doporučujeme je nevolat zbytečně často a raději si dobře promyslet, kdy a jak mají být použity.
Při návrhu toků je ideální:
- volat API pouze tehdy, když je to skutečně nutné
- používat podmínky a filtry
- vyhnout se zbytečným opakováním stejných volání
Cílem není nikoho omezovat, ale zajistit, aby automatizace fungovaly.
Při nadměrném volání API může být váš účet pozastaven.
Děkujeme, že na to myslíte.
Chcete-li vytvořit nový tok v sekci My flows, tedy ve svém vlastním uživatelském účtu, je třeba v levém menu vybrat možnost Create.
Následně se zobrazí obrazovka s možnostmi vytvoření toku, kde je možné začít „od nuly“ výběrem jednoho z následujících typů:
- Automated cloud flow – tok spouštěný na základě události
- Instant cloud flow – tok spouštěný ručně
- Scheduled cloud flow – tok spouštěný podle plánu
Výběr konkrétního typu toku v tomto kroku není konečný. Slouží především k rychlému vytvoření základní struktury toku a úvodního spouštěče. Zvolený spouštěč je možné kdykoli později změnit, upravit nebo zcela nahradit jiným typem spouštěče podle potřeby.
Po výběru jednoho z typů toku (Automated, Instant nebo Scheduled) se zobrazí dialogové okno pro vytvoření toku.
V tomto kroku je možné:
- zadat název toku
- vybrat způsob jeho spuštění, tedy spouštěč
Výběr spouštěče
V pravé části obrazovky se zobrazuje seznam dostupných spouštěčů. V tomto případě je vybrán spouštěč Manually trigger a flow, který umožňuje ruční spuštění toku uživatelem.
Výběr spouštěče v tomto kroku není povinný. Kliknutím na tlačítko Skip lze tento krok přeskočit a přejít přímo do Flow builderu, kde je možné spouštěč nastavit nebo změnit později.
Vytvoření toku
Po zadání názvu a výběru spouštěče můžete pokračovat kliknutím na tlačítko Vytvořit, čímž se otevře editor toku a můžete začít definovat jednotlivé kroky.
Editor toku
Po vytvoření toku se zobrazí Flow editor, který slouží k návrhu a konfiguraci logiky automatizace.
V horní části editoru se nachází zvolený spouštěč, který určuje způsob spuštění toku. V tomto případě se jedná o spouštěč Ruční spuštění toku, který umožňuje ruční spuštění toku uživatelem.
Pod spouštěčem se nachází tlačítko +, pomocí kterého je možné přidávat další kroky do toku.
V horní části panelu (1.) se nacházejí základní nástroje, které slouží k řízení celé logiky automatizace. Jedná se zejména o:
- Control – podmínky, cykly, větvení logiky
- Data operations – práce s daty, proměnnými a výrazy
- Date Time – operace s datem a časem
- HTTP – ruční HTTP volání
Ve spodní části panelu (2.) lze akce filtrovat podle typu konektoru:
- Built-in – vestavěné systémové akce
- Standard / Premium – předdefinované a veřejné konektory společnosti Microsoft
- Custom – vlastní konektory vytvořené uživatelem
V sekci Custom je dostupný vytvořený Custom Connector, ve kterém se nacházejí jednotlivé operace (Actions) definované v předchozích krocích. Tyto akce lze přidat do flow stejně jako akce nativních konektorů.
Po otevření kategorie Custom v seznamu dostupných konektorů se zobrazí vytvořený Custom Connector.
Po kliknutí na název konektoru se zobrazí seznam všech předdefinovaných operací (Actions), které byly vytvořeny v rámci konektoru. Každá operace reprezentuje samostatný funkční blok, který provádí konkrétní API volání.
Kliknutím na vybranou operaci (např. Profile information) se tento blok automaticky přidá do flow jako další krok, navazující na předchozí akci nebo trigger. Vzhledem k tomu, že tento blok nemá žádné proměnné, stačí ověřit, že položka Connection v bloku odpovídá dříve vytvořenému spojení v konektoru.
Po přidání požadovaného bloku z Custom Connectoru je nutné tok uložit kliknutím na tlačítko Save v horní části obrazovky.
Následně je možné spustit testování toku kliknutím na tlačítko Test.
Po kliknutí na Test si uživatel zvolí způsob spuštění toku. V tomto případě se volí ruční spuštění. Po potvrzení se tok provede a systém zobrazí odkaz na stránku Flow runs page, kde je možné sledovat průběh testu v reálném čase.
Historie spuštění toků
Na kartě Flow history lze sledovat čas, trvání a výsledek spuštěných toků. Po kliknutí na konkrétní spuštění toku lze sledovat jeho podrobný průběh, trvání jednotlivých bloků, volání API a jejich výsledky, případně data, která daný blok zpracoval.
Kliknutím na blok lze zobrazit jeho vstupy a výstupy; v tomto případě se jedná o blok Custom connector, který volá API endpoint profile. Kliknutím na Show raw outputs lze zobrazit samotná data, která daný endpoint vrátil.
Import toku do Solutions
Flow vytvořené v sekci My flows lze snadno přesunout do sekce Solutions, což umožňuje jejich další sdílení, správu verzí a nasazení do produkčního prostředí.
Postup importu flow
- Přejděte do sekce Solutions v Power Automate.
- Otevřete existující Solution nebo vytvořte novou.
- Vyplňte informace o Solution
- Klikněte na tlačítko Create
Následně v záložce Solutions zvolte možnost Add existing → Automation → Cloud flow a vyberte požadovaný flow. Po importu se do Solution přenese také jeho připojení ke konektoru.
Po úspěšném importu se flow stane součástí řešení, včetně:
- jeho kompletní konfigurace
- použitých konektorů
- spouštěčů a akcí
Důležité poznámky
- Importovaný tok lze v řešení dále upravovat, aniž by to mělo vliv na původní logiku.
- Doporučuje se po importu ověřit connections a proměnné prostředí.
- Pokud tok používá vlastní konektor, musí být tento konektor dostupný i v daném řešení.