Beta verzia novej dokumentácie CDESK-u.

Typy flows a základné vytvorenie flow

Po úspešnom vytvorení a otestovaní vlastného Custom Connectora je možné jeho operácie (Actions) použiť priamo v Power Automate flowoch. Tieto operácie sa správajú rovnako ako akcie natívnych konektorov Microsoftu.

Power Automate ponúka dva hlavné spôsoby, ako vytvárať flowy:

  • My flows – táto sekcia je vhodná najmä pre:
    • rýchle testovanie
    • osobné alebo dočasné automatizácie
    • overenie funkcionality custom connectora

Flowy vytvorené v tejto sekcii sú viazané na konkrétneho používateľa a nie sú určené priamo na tímové nasadenie. 

  • Solutions – sekcia solutions je odporúčaný spôsob pre:
    • produkčné nasadenie
    • správu životného cyklu riešenia

V Solutions je možné custom connector zahrnúť ako súčasť riešenia spolu s flowmi, environment premennými a ďalšími komponentmi. Z dlhodobého hľadiska je tento prístup prehľadnejší a udržateľnejší.

Odporúčanie:
Pre produkčné nasadenie a zdieľanie konektora sa odporúča používať sekciu Solutions. Flowy vytvorené v sekcii My flows je možné následne jednoducho importovať do Solution spolu s ich kompletnou konfiguráciou.

Sekcia Solutions navyše oproti My flows umožňuje používať tzv. Child Flows, kde je možné vzájomne prepájať viacero flowov. Na základe definovanej logiky je tak možné z jedného flow spúšťať ďalšie akcie alebo podriadené flowy. Tento prístup je vhodný najmä na oddelenie jednotlivých funkcií alebo triggerov, keďže jeden flow štandardne nemôže obsahovať viacero triggerov.

Fair Play Policy

Pri používaní Power Automate flowov a API volaní Vás chceme poprosiť o ohľaduplné nastavenie automatizácií, aby systém fungoval spoľahlivo.

Ak používate triggery typu Recurrence, skúste zvážiť, či je naozaj potrebné, aby flow bežal veľmi často. Príliš krátke intervaly spúšťania môžu zbytočne zaťažovať backendové systémy.

Rovnako niektoré API endpointy spracovávajú väčšie množstvo dát alebo vykonávajú náročnejšie operácie. V takýchto prípadoch odporúčame nevolať ich zbytočne často a radšej si dobre premyslieť, kedy a ako majú byť použité.

Pri návrhu flowov je ideálne:

  • volať API len vtedy, keď je to skutočne potrebné
  • používať podmienky a filtre
  • vyhnúť sa zbytočným opakovaniam rovnakých volaní

Cieľom nie je nikoho obmedzovať, ale zabezpečiť, aby automatizácie fungovali.

Pri nadmernom volaní API môže byť Váš účet pozastavený.

Ďakujeme, že na to myslíte.

Obrázok 18: Vytvorenie Flow v My flows

Pre vytvorenie nového flow v sekcii My flows, teda pod vlastným používateľským kontom, je potrebné v ľavom menu zvoliť možnosť Create.

Následne sa zobrazí obrazovka s možnosťami vytvorenia flow, kde je možné začať „od nuly“ výberom jedného z nasledujúcich typov:

  • Automated cloud flow – flow spúšťaný na základe udalosti
  • Instant cloud flow – flow spúšťaný manuálne
  • Scheduled cloud flow – flow spúšťaný podľa časového plánu

Výber konkrétneho typu flow v tomto kroku nie je finálny. Slúži najmä na rýchle vytvorenie základnej štruktúry flow a úvodného triggera. Zvolený trigger je možné kedykoľvek neskôr zmeniť, upraviť alebo úplne nahradiť iným typom spúšťača podľa potreby.

Obrázok 19: Výber Trigger a vytvorenie Flow

Po výbere jedného z typov flow (Automated, Instant alebo Scheduled) sa zobrazí dialógové okno pre vytvorenie flow.

V tomto kroku je možné:

  • zadať názov flow
  • vybrať spôsob jeho spúšťania, teda trigger

Výber Triggera

V pravej časti obrazovky je zobrazený zoznam dostupných triggerov. V tomto prípade je zvolený trigger Manually trigger a flow, ktorý umožňuje manuálne spustenie flow používateľom.

Výber triggera v tomto kroku nie je povinný. Kliknutím na tlačidlo Skip je možné tento krok preskočiť a prejsť priamo do Flow buildera, kde je možné trigger nastaviť alebo zmeniť neskôr.

Vytvorenie Flow

Po nastavení názvu a výbere triggera je možné pokračovať kliknutím na tlačidlo Create, čím sa otvorí editor flow a je možné začať s definovaním jednotlivých krokov.

Flow editor

Po vytvorení flow sa zobrazí Flow editor, ktorý slúži na návrh a konfiguráciu logiky automatizácie.

V hornej časti editora sa nachádza zvolený trigger, ktorý určuje spôsob spustenia flow. V tomto prípade ide o trigger Manually trigger a flow, ktorý umožňuje manuálne spustenie flow používateľom.

Pod triggerom sa nachádza tlačidlo +, pomocou ktorého je možné pridávať ďalšie kroky do flow.

Obrázok 20: Základný pohľad na Flow Editor
Obrázok 21: Typy akcií a pridanie bloku akcie

V hornej časti panelu (1.) sa nachádzajú základné nástroje, ktoré slúžia na riadenie celej logiky automatizácie. Ide najmä o:

  • Control – podmienky, cykly, vetvenie logiky
  • Data operations – práca s dátami, premennými a výrazmi
  • Date Time – operácie s dátumom a časom
  • HTTP – manuálne HTTP volania

V spodnej časti panelu (2.) je možné filtrovať akcie podľa typu konektora:

  • Built-in – vstavané systémové akcie
  • Standard / Premium – preddefinované a verejné konektory Microsoftu
  • Custom – vlastné konektory vytvorené používateľom

V sekcii Custom je dostupný vytvorený Custom Connector, v ktorom sa nachádzajú jednotlivé operácie (Actions) definované v predchádzajúcich krokoch. Tieto akcie je možné pridať do flow rovnako ako akcie natívnych konektorov.

Obrázok 22: Obsah blokov Custom Konektora, pridanie bloku

Po otvorení kategórie Custom v zozname dostupných konektorov sa zobrazí vytvorený Custom Connector.

Po kliknutí na názov konektora sa zobrazí zoznam všetkých preddefinovaných operácií (Actions), ktoré boli vytvorené v rámci konektora. Každá operácia reprezentuje samostatný funkčný blok, ktorý vykonáva konkrétne API volanie.

Kliknutím na vybranú operáciu (napr. Profile information) sa tento blok automaticky pridá do flow ako ďalší krok, nadväzujúci na predchádzajúcu akciu alebo trigger. Keďže tento blok nemá žiadne premenné, stačí overiť že položka Connection v bloku sedí s predošlým vytvoreným spojením v konektore.

Obrázok 23: Overenie pridaného bloku, uloženie a spustenie Flow

Po pridaní požadovaného bloku z Custom Connectora je potrebné flow uložiť kliknutím na tlačidlo Save v hornej časti obrazovky.

Následne je možné spustiť testovanie flow kliknutím na tlačidlo Test.

Po kliknutí na Test si používateľ zvolí spôsob spustenia flow. V tomto prípade sa vyberá manuálne spustenie. Po potvrdení sa flow vykoná a systém zobrazí odkaz na Flow runs page, kde je možné sledovať priebeh testu v reálnom čase.

História spúšťania flowov

Obrázok 24: Flow history

V tabe Flow history je možné sledovať čas, trvanie a výsledok spustených Flows. Po kliknutí na daný flow run je možné sledovať jeho podrobný priebeh, trvanie samostatných blokov, API volania a ich výsledky, prípadne dáta ktoré daný blok spracoval.

Obrázok 25: Detaily Flow run

Kliknutím na blok je možné zobraziť jeho inputs a outputs, v tomto prípade to je blok Custom connectora, ktorý volá profile API endpoint, kliknutím na Show raw outputs je možné vidieť samotný body ktorý daný endpoint vrátil.

Obrázok 26: Raw output API volania

Importovanie flow do Solutions

Flow vytvorené v sekcii My flows je možné jednoducho presunúť do sekcie Solutions, čo umožňuje ich ďalšie zdieľanie, verzovanie a produkčné nasadenie.

Postup importovania flow

  1. Prejdite do sekcie Solutions v Power Automate.
  2. Otvorte existujúcu Solution alebo vytvorte novú.
  3. Vyplňte informácie o Solution
  4. Kliknite na tlačidlo Create
Obrázok 27: Vytvorenie nového Solution

Následne v záložke Solutions zvoľte možnosť Add existing → Automation → Cloud flow a vyberte požadovaný flow. Po importe sa do Solution prenesie aj jeho pripojenie na konektor.

Obrázok 28: Výber flow na záložke Solutions

Po úspešnom importe sa flow stane súčasťou Solution vrátane:

  • jeho kompletnej konfigurácie
  • použitých konektorov
  • triggerov a akcií

Dôležité poznámky

  • Importovaný flow je možné v Solution ďalej upravovať bez vplyvu na pôvodnú logiku.
  • Odporúča sa overiť connections a environment premenné po importe.
  • Ak flow používa Custom Connector, musí byť tento konektor dostupný aj v danej Solution.