Sprawdzanie przepływu (wersja zapoznawcza)

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Usprawnij przepływ pracy deweloperów dzięki funkcji analizy statycznej w funkcji sprawdzania rozwiązań. To narzędzie obsługuje najlepsze praktyki w zakresie zrobotyzowanej automatyzacji procesów (RPA) i spełnia krytyczne wymagania dotyczące przepływów, automatycznie oceniając przepływy w celu zapewnienia optymalnej wydajności. Analiza statyczna jest dostępna w sekcji sprawdzania przepływu projektanta. Egzekwuje kluczowe wytyczne i zapewnia informacje zwrotne w czasie rzeczywistym oraz wczesną inspekcję kodu. Integruje się bezpośrednio z przepływem pracy, poprawia jakość kodu i kładzie podwaliny pod bardziej wydajne i produktywne środowisko programistyczne.

Zarządzanie regułami

Reguły są definiowane i zarządzane za pomocą narzędzia do sprawdzania rozwiązań w centrum administracyjnym Power Platform. Administratorzy mogą:

• Włączać lub wyłączać reguły.
• Konfigurować poziomy ważności (błąd, ostrzeżenie, informacje).
• Stosować reguły do określonych środowisk lub grup środowisk (tylko środowiska zarządzane).

Konfiguracja w centrum administracyjnym

Aby skonfigurować reguły analizy statycznej:

1. Przejdź do centrum administracyjnego Power Platform.
2. Wybierz Zarządzaj>Środowiska, aby kontynuować.
3. Wybierz pozycję Edytuj środowisko zarządzane.
4. W sekcji Wymuszanie sprawdzania rozwiązań skonfiguruj, które reguły powinny zostać wykluczone dla wybranego środowiska.

Uruchamianie analizy statycznej w portalu

Aby ręcznie uruchomić analizę statyczną:

1. Przejdź do strony Rozwiązania w portalu Power Automate.

2. Otwórz menu kontekstowe (⋯) obok rozwiązania.

3. Ustaw kursor na narzędziu do sprawdzania rozwiązań.

4. Wybierz jedną z następujących opcji:

   • Uruchom: inicjuje analizę statyczną.
   • Wyświetl wyniki: otwiera najnowszy raport z analizy.
   • Pobierz wyniki: eksportuje raport do przeglądu w trybie offline.

Analiza statyczna w projektancie

Analiza statyczna jest uruchamiana automatycznie, stale sprawdzając kod bez konieczności ręcznej interwencji. Gdy dodasz, usuniesz lub zmodyfikujesz akcje w przepływie, ta funkcja zostanie aktywowana w celu oceny zmian i odświeżenia analizy. Ten proces sprawia, że rozwój jest bezproblemowy i wydajny. Po prawej stronie projektanta znajduje się dedykowany przycisk Flow Checker. Liczba na przycisku pokazuje łączną liczbę naruszeń w przepływie pulpitu. Wybierz przycisk, aby otworzyć okienko Kontroler przepływu i wyświetlić szczegółowe informacje na temat konkretnych zasad, które zostały naruszone.

Każda analiza generuje wynik procentowy, który pokazuje odsetek reguł, które zostały pomyślnie zastosowane. Wyższy wynik oznacza mniej naruszeń i lepszą jakość kodu.

Ten wynik jest przeliczany za każdym razem, gdy wprowadzana jest zmiana w przepływie, zapewniając natychmiastową informację zwrotną i promując dobre praktyki programistyczne.

W przypadku naruszenia reguł raport z analizy statycznej zawiera przejrzyste podsumowanie. Zawiera listę nazw reguł oraz liczbę akcji lub zmiennych w przepływie, które naruszają każdą regułę. Wybranie reguły powoduje wyróżnienie odpowiedniej akcji i szczegółowe wyjaśnienie błędu. W przypadku naruszeń związanych ze zmiennymi system przechodzi do okienka zmiennych, co ułatwia wprowadzanie poprawek. Okienko Flow checker zawiera funkcję wyszukiwania i umożliwia filtrowanie według podprzepływów, dzięki czemu można szybko znaleźć konkretne problemy.

Każde naruszenie powoduje wyświetlenie kafelka ze szczegółowymi informacjami, w tym charakterem błędu, zalecanymi poprawkami i linkiem do dokumentacji. Użyj suwaka w nagłówku reguły, aby przechodzić między wystąpieniami tego samego naruszenia. Te wskazówki pomagają deweloperom szybko i skutecznie rozwiązywać problemy. Naruszenia błędów kontrolera przepływu powodują wyświetlenie wskaźnika w tekście i wyskakującego okienka z dodatkowymi szczegółami. Ostrzeżenia są również wyświetlane w tekście w obszarze roboczym projektanta, podobnie jak błędy. Projektant wyświetla statusy diagnostyczne, takie jak ostrzeżenia i błędy, na kartach podprzepływów i udostępnia przycisk, który umożliwia przejście do składnika wymagającego uwagi.

Legenda

1. Przypadki naruszenia określonej reguły
2. Przejdź do akcji, która narusza regułę.
3. Link do dokumentacji

Reguły analizy statycznej

Reguły analizy statycznej to wstępnie zdefiniowane wytyczne, które pomagają zapewnić bezpieczeństwo, łatwość konserwacji i wydajność przepływów. Każda reguła jest ukierunkowana na określone aspekty projektu przepływu, takie jak bezpieczeństwo, wydajność i łatwość konserwacji, oraz udostępnia opinię umożliwiającą podjęcie działań w celu poprawy jakości przepływu. Poniżej znajduje się lista reguł, ich opisy i sugerowane poprawki.

Niedostateczne zabezpieczenie haseł

• Ważność: Ostrzeżenie
• Typ: Ważność
• Szczegóły błędu: zarządzanie hasłami w przepływie odbywa się w sposób niebezpieczny.
• Opis: ta reguła sprawdza, czy hasła w przepływie pulpitu są zarządzane w sposób niebezpieczny, aby upewnić się, że hasła nie są ujawniane lub niewłaściwie obsługiwane podczas wykonywania przepływu.
• Sugerowana poprawka: upewnij się, że wszystkie dane wejściowe związane z hasłem są odpowiednio obsługiwane przy użyciu funkcji haseł Power Automate dla komputerów. Użyj opcji "Bezpośrednie wprowadzanie zaszyfrowanego tekstu", aby uzyskać maksymalne bezpieczeństwo dzięki szyfrowaniu maszynowemu. W przypadku przepływów używanych na różnych maszynach wybierz pozycję "Wprowadź hasło jako zmienną" i oznacz odpowiednią zmienną jako poufną, aby zwiększyć bezpieczeństwo. Korzystaj również z bezpiecznych funkcji zarządzania poświadczeniami, takich jak akcja „Pobierz poświadczenia”, która integruje się z poświadczeniami CyberArk.

Rekursja między dwoma podprzepływami

• Ważność: Ostrzeżenie
• Typ: Design
• Szczegóły błędu: między przepływami podrzędnymi wykryto wywołania cykliczne, które mogą potencjalnie powodować nieskończoną pętlę.
• Opis: ta reguła wyszukuje wywołania cykliczne między co najmniej dwoma przepływami cyklicznymi, dzięki czemu przepływ nie wejdzie w nieskończoną pętlę.
• Sugerowana poprawka: wyeliminuj wszelkie wywołania cykliczne między przepływami podrzędnymi.

Przekroczono długość zmiennej

• Ważność: Ostrzeżenie
• Typ: Możliwość konserwacji
• Szczegóły błędu: długość nazwy zmiennej przekracza limit 40 znaków.
• Opis: ta reguła sprawdza dla każdej zmiennej zdefiniowanej w przepływie, czy jej nazwa nie przekracza określonej liczby znaków. Domyślny limit to 40 znaków.
• Sugerowana poprawka: zmień nazwy wszelkich zmiennych, których długość nazwy przekracza określony limit liczby znaków, aby zagwarantować, że nazwy zmiennych będą krótsze niż 40 znaków.

Wartości domyślne zmiennych wejściowych

• Ważność: Ostrzeżenie
• Typ: Możliwość konserwacji
• Szczegóły błędu: w zmiennych wejściowych/wyjściowych nie są używane wartości domyślne.
• Opis: ta reguła sprawdza, czy zmienne wejściowe/wyjściowe używają wartości domyślnych, dzięki czemu są one prawidłowo skonfigurowane dla przepływu.
• Sugerowana poprawka: przypisz wartości domyślne do wszystkich zmiennych wejściowych i wyjściowych w przepływie.

Próg liczby zmiennych wejściowych i wyjściowych

• Ważność: Ostrzeżenie
• Typ: Możliwość konserwacji
• Szczegóły błędu: łączna liczba zmiennych wejściowych/wyjściowych przekracza limit liczby zmiennych wynoszący 25.
• Opis: ta reguła sprawdza, czy łączna liczba zmiennych wejściowych/wyjściowych w przepływie przekracza określony próg. Limit to 25 zmiennych.
• Sugerowana poprawka: upewnij się, że liczba zmiennych wejściowych i wyjściowych w przepływie nie przekracza 25.

Pusta akcja Przy błędzie bloku

• Domyślna ważność: Ostrzeżenie
• Typ: Design
• Szczegóły błędu: akcja „Przy błędzie bloku” jest pusta i nie obsługuje błędów.
• Opis: ta reguła sprawdza, czy akcje „Przy błędzie bloku” w przepływie są poprawnie skonfigurowane do obsługi błędów, dzięki czemu błędy są zgłaszane i zarządzane zgodnie z oczekiwaniami.
• Sugerowana poprawka: aby zarządzać potencjalnymi błędami, skonfiguruj akcje Przy błędzie bloku w przepływie, aby zarządzać potencjalnymi błędami.

Zagnieżdżone instrukcje If

• Ważność: Ostrzeżenie
• Typ: Możliwość konserwacji
• Szczegóły błędu: zagnieżdżone klauzule If przekraczają pięć poziomów.
• Opis: ta reguła sprawdza, czy istnieją zagnieżdżone instrukcje if z więcej niż pięcioma poziomami, dzięki czemu przepływ pozostaje łatwy w zarządzaniu i czytelny.
• Sugerowana poprawka: refaktoryzuj przepływ, aby ograniczyć zagnieżdżone instrukcje If do maksymalnie pięciu poziomów.

Niekompletne odgałęzienie If

• Ważność: Ostrzeżenie
• Typ: Design
• Szczegóły błędu: wykryto niekompletną akcję „if”, w której brakuje zawartości lub która zawiera tylko akcje w odgałęzieniu „else”.
• Opis: ta reguła wykrywa przepływ, wykrywając instrukcje if, które nie mają zawartości lub zawierają tylko akcje w odgałęzieniu else, zapewniając efektywne implementowanie instrukcji warunkowych.
• Sugerowana poprawka: przejrzyj przepływ i sprawdź każdy warunek „if”, aby upewnić się, że zawiera on istotne akcje zarówno w odgałęzieniach „if”, „else if”, jak i „else”.

Nieskończona pętla

• Ważność: Ostrzeżenie
• Typ: Design
• Szczegóły błędu: w przepływie wykryto nieskończoną pętlę, która może potencjalnie powodować nieskończone działanie przepływu.
• Opis: ta reguła sprawdza, czy w przepływie występują nieskończone pętle, co pomaga identyfikować scenariusze, w których przepływ może działać bez końca, oraz zapobiegać im.
• Sugerowana poprawka: upewnij się, że każda pętla ma jasno zdefiniowany i osiągalny warunek zakończenia. Warunek może być oparty na liczniku, określonej wartości lub zakończeniu zadania. Dodaj testy lub warunki awaryjne, aby przerwać pętlę, jeśli będzie działać dłużej niż oczekiwano. Na przykład ustaw maksymalną liczbę iteracji lub uwzględnij limit czasu.

Niewłaściwe użycie akcji oczekiwania

• Ważność: Ostrzeżenie
• Typ: Wydajność
• Szczegóły błędu: wykryto nadużycie akcji oczekiwania, przy czym więcej niż 10 akcji oczekiwania może potencjalnie spowodować wystąpienie wąskich gardeł.
• Opis: ta reguła sprawdza, czy przepływ nie zawiera nadmiernej liczby akcji oczekiwania — więcej niż 10 — aby ułatwić identyfikowanie i minimalizowanie potencjalnych wąskich gardeł spowodowanych przedłużającymi się opóźnieniami.
• Sugerowana poprawka: przejrzyj przepływ, aby zidentyfikować wszystkie akcje oczekiwania i sprawdzić, czy są one niezbędne dla logiki przepływu. Usuń niepotrzebne oczekiwania lub połącz je tam, gdzie to możliwe.

Ogromnie długi czas oczekiwania

• Ważność: Ostrzeżenie
• Typ: Wydajność
• Szczegóły błędu: wykryto ogromnie długi czas oczekiwania, który przekroczył limit 600 sekund dla zapisanych na stałe akcji oczekiwania.
• Opis: ta reguła sprawdza, czy zapisane na stałe akcje oczekiwania w przepływie przekraczają określony czas (limit wynosi 600 sekund).
• Sugerowana poprawka: przejrzyj przepływ, aby znaleźć akcje oczekiwania, które przekraczają limit 600 sekund. Sprawdź, czy te długie czasy oczekiwania są konieczne i dostosuj ich czas trwania do najkrótszego czasu potrzebnego do prawidłowego działania przepływu. Jeśli wymagane jest długie oczekiwanie, podziel je na krótsze interwały i dodaj między nimi kontrole lub warunki. Jeśli to możliwe, zastąp akcje długiego oczekiwania wyzwalaczami sterowanymi zdarzeniami.

Nieosiągnięte akcje

• Ważność: Ostrzeżenie
• Typ: Możliwość konserwacji
• Szczegóły błędu: Co najmniej jedna akcja w przepływie jest nieosiągalna i nie zostanie wykonana w żadnych okolicznościach.
• Opis: Ta reguła sprawdza akcje w przepływie, które są logicznie nieosiągalne. Nieosiągalne akcje mogą wynikać z nieprawidłowego rozgałęzienia, niewłaściwie umieszczonych warunków lub odłączonych segmentów i mogą wskazywać na błędy w logice lub strukturze przepływu.
• Sugerowane rozwiązanie: Przejrzyj przepływ, aby znaleźć akcje, które nie są połączone ze ścieżką wykonywania. Upewnij się, że każda akcja jest osiągalna za pośrednictwem prawidłowej gałęzi logiki lub pętli. Usuń lub przenieś nieosiągalne akcje, aby przepływ był czysty i wydajny.

Znane ograniczenia

• Dostępne tylko w przypadku środowisk zarządzanych.
• Dostosowywanie reguł jest ograniczone do włączania lub wyłączania reguł oraz konfigurowania ważności.

Znane problemy

• Usunięcie skopiowanych akcji po wyświetleniu szczegółu naruszenia reguły może spowodować nieobsłużone błędy.
• Użycie niepoufnej zmiennej hasła w następujących akcjach powoduje niepowodzenie analizy statycznej podczas oceny reguły.
  • Wyświetl okno dialogowe wprowadzania danych
  • Wyświetl okno dialogowe wybierania folderu
  • Wyświetl formularz niestandardowy