Kontrola toku (Preview)

[Tento článek představuje předběžnou dokumentaci a může se změnit.]

Zlepšete svůj vývojový pracovní postup pomocí funkce statické analýzy v nástroji kontroly řešení. Tento nástroj podporuje osvědčené postupy v robotické automatizaci procesů (RPA) a splňuje kritické požadavky na toky tím, že automaticky vyhodnocuje vaše toky, aby byl zajištěn optimální výkon. Statická analýza je k dispozici v návrháři v části Kontrola toku. Vynucuje klíčové pokyny a poskytuje zpětnou vazbu v reálném čase a včasnou kontrolu kódu. Integruje se přímo do vašeho pracovního postupu, zlepšuje kvalitu kódu a pokládá základy pro efektivnější a produktivnější vývoj.

Důležité

• Toto je funkce Preview.
• Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Tyto funkce podléhají doplňujícím podmínkám použití a jsou poskytnuty před oficiálním vydáním, aby si je zákazníci mohli co nejdříve vyzkoušet a napsat nám své názory.

Správa pravidel

Pravidla se definují a spravují pomocí kontroly řešení v centru pro správu Power Platform. Správci mohou:

• Zapínat a vypínat pravidla.
• Nakonfigurujte úrovně závažnosti (chyba, upozornění, informace).
• Používat pravidla pro konkrétní prostředí nebo skupiny prostředí (pouze spravovaná prostředí).

Konfigurace v centru pro správu

Konfigurace pravidel statické analýzy:

1. Přejděte do centra pro správu Power Platform.
2. Pokračujte výběrem možnosti Spravovat>Prostředí.
3. Vyberte Upravit spravované prostředí.
4. V části Vynucení kontroly řešení nakonfigurujte, která pravidla by měla být pro vybrané prostředí vyloučena.

Poznámka:

• Pokud je prostředí součástí skupiny prostředí s definovanou konfigurací, nastavení pravidla se dědí a nelze je upravovat jednotlivě. Další informace o kontrole řešení najdete v tématu Kontrola řešení a Vynucení kontroly řešení ve Spravovaných Prostředích.
• Správci Power Platform by měli všem rolím, které vyžadují přístup k této funkci, přiřadit následující oprávnění: prvReadmsdyn_analysisoverride (popisný název je „Přepsání analýzy (čtení)“).

Spuštění statické analýzu na portálu

Ruční spuštění statické analýzy:

1. Přejděte na stránku Řešení na portálu Power Automate.

2. Otevřete kontextovou nabídku (⋯) vedle řešení.

3. Přejeďte myší na kontrolu řešení.

4. Vyberte jednu z následujících možností:

   • Spustit: Zahájí statickou analýzu.
   • Zobrazit výsledky: Otevře nejnovější zprávu o analýze.
   • Stáhnout výsledky: Exportuje sestavu pro offline kontrolu.

Poznámka:

Statická analýza se spouští pro všechny desktopové toky zahrnuté v řešení. Identifikujte, který desktopový tok aktivuje konkrétní porušení pravidel, a to tak, že zkontrolujete sloupec Název objektu ve výsledcích. V tomto sloupci se zobrazuje název odpovídajícího desktopového toku.

Statická analýza v návrháři

Statická analýza se spouští automaticky a průběžně kontroluje kód bez nutnosti ručního zásahu. Když přidáte, odeberete nebo upravíte akce v toku, aktivuje se tato funkce, která posoudí změny a aktualizuje analýzu. Díky tomuto procesu je vývoj bezproblémový a efektivní. Na pravé straně návrháře se zobrazí vyhrazené tlačítko Flow Checker. Číslo na tlačítku ukazuje celkový počet porušení v desktopovém toku. Výběrem tlačítka otevřete podokno Kontrola toku a zobrazte podrobné přehledy o konkrétních pravidlech, která jsou porušena.

Každá analýza vygeneruje procentuální skóre, které ukazuje podíl úspěšně dodržovaných pravidel. Vyšší skóre znamená méně porušení a lepší kvalitu kódu.

Toto skóre se přepočítá pokaždé, když se v toku provede změna, což poskytuje okamžitou zpětnou vazbu a podporuje dobré praktiky vývoje.

Pokud dojde k porušení pravidel, zpráva o statické analýze zobrazí jasné shrnutí. Uvádí názvy pravidel a počet akcí nebo proměnných ve vašem toku automatizace, které jednotlivá pravidla porušují. Výběrem pravidla se zvýrazní odpovídající akce a zobrazí se podrobné vysvětlení chyby. V případě porušení pravidel souvisejících s proměnnými systém přejde do podokna proměnných, což usnadňuje opravy. Podokno Kontrola toku obsahuje funkci vyhledávání a umožňuje filtrovat podle dílčího toku, takže můžete rychle najít konkrétní problémy.

U každého porušení se zobrazí dlaždice s podrobnostmi, včetně povahy chyby, doporučených oprav a odkazu na dokumentaci. Pomocí posuvníku v záhlaví pravidla můžete přecházet mezi výskyty stejného porušení. Tyto pokyny pomáhají vývojářům rychle a efektivně řešit problémy. Porušení chyb kontroly toku zobrazují vložený indikátor a vyskakovací okno s dalšími podrobnostmi. Upozornění se také zobrazují vložená v pracovním prostoru návrháře, jako jsou chyby. Návrhář zobrazuje diagnostické stavy, jako jsou upozornění a chyby na kartách dílčího toku, a obsahuje tlačítko, které vám umožní přejít na komponentu, která vyžaduje pozornost.

Legenda:

1. Výskyty konkrétního porušení pravidel
2. Přejděte na akci, která pravidlo porušuje
3. Odkaz na dokumentaci

Pravidla statické analýzy

Pravidla statické analýzy jsou předdefinované pokyny, které pomáhají zajistit, aby vaše toky byly zabezpečené, udržovatelné a výkonné. Každé pravidlo cílí na konkrétní aspekty návrhu toku, jako je zabezpečení, výkon a udržovatelnost, a poskytuje užitečné názory ke zlepšení kvality toku. Níže je uveden seznam pravidel, jejich popisy a navrhované opravy.

Nebezpečné zabezpečení heslem

• Závažnost: Upozornění
• Typ: Zabezpečení
• Informace o chybě: Hesla jsou v toku spravována nezabezpečeně.
• Popis: Toto pravidlo ověřuje, zda jsou hesla v rámci desktopového toku spravována nezabezpečeně, aby bylo zajištěno, aby nebyla během provádění odhalena nebo aby s nimi nebylo nesprávně nakládáno.
• Navrhovaná oprava: Ujistěte se, že všechny vstupy související s heslem jsou správně zpracovány pomocí funkcí hesla Power Automate pro stolní počítače. Použijte "Přímý šifrovaný textový vstup" pro maximální zabezpečení prostřednictvím strojového šifrování. U toků používaných na různých počítačích zvolte "Zadání hesla jako proměnné" a označte odpovídající proměnnou jako citlivou, abyste zvýšili zabezpečení. Používejte také funkce zabezpečené správy přihlašovacích údajů, jako je akce „Získat přihlašovací údaje“, která se integruje s přihlašovacími údaji CyberArk.

Rekurze mezi dvěma dílčími toky

• Závažnost: Upozornění
• Typ: Design
• Informace o chybě: Zjištěna rekurzivní volání mezi dílčími toky, což může způsobit nekonečnou smyčku.
• Popis: Toto pravidlo kontroluje rekurzivní volání mezi dvěma nebo více dílčími toky a zajišťuje, aby tok nevstoupil do nekonečné smyčky.
• Navrhovaná oprava: Eliminujte všechna rekurzivní volání mezi dílčími toky.

Překročena délka proměnné

• Závažnost: Upozornění
• Typ: Udržovatelnost
• Informace o chybě: Název proměnné překračuje limit 40 znaků.
• Popis: Toto pravidlo ověřuje, zda název každé proměnné definované v toku přesahuje zadaný počet znaků. Výchozí limit je 40 znaků.
• Navrhovaná oprava: Přejmenujte všechny proměnné, které přesahují zadaný limit znaků, aby jejich názvy byly kratší než 40 znaků.

Výchozí hodnoty vstupní proměnné

• Závažnost: Upozornění
• Typ: Udržovatelnost
• Informace o chybě: Vstupní/výstupní proměnné nepoužívají výchozí hodnoty.
• Popis: Toto pravidlo ověřuje, zda vstupní/výstupní proměnné používají výchozí hodnoty, a zajišťuje, že jsou správně nakonfigurovány pro daný tok.
• Navrhovaná oprava: Přiřaďte výchozí hodnoty všem vstupním a výstupním proměnným v toku.

Prahová hodnota počtu vstupních a výstupních proměnných

• Závažnost: Upozornění
• Typ: Udržovatelnost
• Informace o chybě: Celkový počet vstupních/výstupních proměnných překračuje limit 25 proměnných.
• Popis: Toto pravidlo ověřuje, zda celkový počet vstupních/výstupních proměnných v toku přesahuje zadanou prahovou hodnotu. Limit je 25 proměnných.
• Navrhovaná oprava: Ujistěte se, že počet vstupních a výstupních proměnných v toku nepřesahuje 25.

Prázdná akce chyby bloku

• Výchozí závažnost: Upozornění
• Typ: Design
• Informace o chybě: Akce „Při chybě bloku“ je prázdná a nezpracovává chyby.
• Popis: Toto pravidlo kontroluje, jestli jsou akce „Při chybě bloku“ ve vašem toku správně nastaveny tak, aby zpracovávaly chyby, a zajišťuje, aby byly chyby vyvolány a spravovány podle očekávání.
• Navrhovaná oprava: Ke správě potenciálních chyb nastavte akce Chyba bloku v toku.

Vnořené klauzule If

• Závažnost: Upozornění
• Typ: Udržovatelnost
• Informace o chybě: Vnořené klauzule If překračují pět úrovní.
• Popis: Toto pravidlo ověřuje, zda nejsou vnořené příkazy if s více než pěti úrovněmi, čímž zajišťuje, že tok zůstane přehledný a čitelný.
• Navrhovaná oprava: Přepracujte tok tak, abyste omezili vnořování příkazů if na nejvýše pět úrovní.

Neúplné If

• Závažnost: Upozornění
• Typ: Design
• Informace o chybě: Zjištěna neúplná akce If, která nemá obsah nebo obsahuje pouze akce ve větvi Else.
• Popis: Toto pravidlo odhaluje akce If, které nemají obsah nebo obsahují pouze akce ve větvi Else. Tím zajišťuje, že podmíněné příkazy jsou efektivně implementovány.
• Navrhovaná oprava: Projděte tok a zkontrolujte každou podmínku „If“, abyste se ujistili, že obsahuje smysluplné akce ve větvích „If“, „Else if“ a „Else“.

Nekonečná smyčka

• Závažnost: Upozornění
• Typ: Design
• Informace o chybě: V toku byla zjištěna nekonečná smyčka, která může způsobit jeho nekonečné spouštění.
• Popis: Toto pravidlo kontroluje, zda se v toku nevyskytují nekonečné smyčky, a pomáhá tak identifikovat a předcházet scénářům, kdy tok může běžet donekonečna.
• Navrhovaná oprava: Ujistěte se, že každá smyčka má jasně definovanou a dosažitelnou podmínku ukončení. Podmínka může být založena na čítači, konkrétní hodnotě nebo dokončení úkolu. Přidejte kontroly nebo zabezpečené podmínky, které přeruší smyčku, pokud běží déle, než se čekalo. Můžete například nastavit maximální počet iterací nebo zahrnout časový limit.

Zneužití čekacích akcí

• Závažnost: Upozornění
• Typ: Výkon
• Informace o chybě: Zjištěno nesprávné použití čekacích akcí, kdy více než 10 čekacích akcí způsobuje potenciální problémová místa.
• Popis: Toto pravidlo kontroluje, jestli tok neobsahuje nadměrný počet čekacích akcí – více než 10 – aby bylo možné identifikovat a minimalizovat potenciální úzká místa způsobená delšími zpožděními.
• Navrhovaná oprava: Zkontrolujte tok, identifikujte všechny akce čekání a zkontrolujte, jestli jsou nezbytné pro logiku toku. Odstraňte zbytečné čekání nebo je kombinujte, pokud je to možné.

Obrovská čekací doba

• Závažnost: Upozornění
• Typ: Výkon
• Informace o chybě: Byla zjištěna obrovská čekací doba, která překračuje limit 600 sekund pro pevně zakódované akce čekání.
• Popis: Toto pravidlo kontroluje, zda pevně zadané čekací akce v toku překročí zadanou dobu, přičemž limit je nastaven na 600 sekund.
• Navrhovaná oprava: Zkontrolujte tok a najděte akce čekání, které překračují limit 600 sekund. Zkontrolujte, zda jsou tyto dlouhé čekací doby nutné, a upravte jejich trvání na nejkratší dobu potřebnou pro správné fungování toku. Pokud je vyžadováno dlouhé čekání, rozdělte ho na kratší intervaly a přidejte mezi ně kontroly nebo podmínky. Kdykoli je to možné, nahraďte akce dlouhého čekání triggery řízené událostmi.

Nedosažené akce

• Závažnost: Upozornění
• Typ: Udržovatelnost
• Údaje o chybě: Jedna nebo více akcí v toku je nedosažitelná a za žádných okolností se neprovede.
• Popis: Toto pravidlo kontroluje akce v toku, které jsou logicky nedostupné. Nedosažitelné akce mohou být důsledkem nesprávného větvení, nesprávně umístěných podmínek nebo odpojených segmentů a mohou znamenat chyby v logice nebo struktuře toku.
• Navrhovaná oprava: Zkontrolujte tok a vyhledejte akce, které nejsou připojené k cestě provádění. Ujistěte se, že každá akce je dosažitelná prostřednictvím platné logické větve nebo smyčky. Odeberte nebo přesuňte nedosažitelné akce, abyste zachovali tok čistý a efektivní.

Známá omezení

• K dispozici pouze ve spravovaných prostředích.
• Vlastní nastavení pravidel je omezeno na zapnutí a vypnutí pravidel a konfiguraci závažnosti.

Známé problémy

• Odstranění zkopírovaných akcí po zobrazení podrobností o porušení pravidla může vyvolat neošetřené chyby.
• Použití nezabezpečené proměnné hesla v následujících akcích způsobí selhání statické analýzy během vyhodnocování pravidla.
  • Zobrazit dialog vstupu
  • Zobrazit dialog výběru složky
  • Zobrazení vlastního formuláře