Stroomcontrole

Verbeter uw ontwikkelingswerkstroom met de functie voor statische analyse in Oplossingscontrole. Deze tool ondersteunt best practices in robotgestuurde procesautomatisering (RPA) en voldoet aan kritieke stroomvereisten door uw stromen automatisch te evalueren om optimale prestaties te garanderen. Statische analyse is beschikbaar in het gedeelte Stroomchecker van de ontwerper. Het handhaaft belangrijke richtlijnen en biedt realtime feedback en vroege code-inspectie. Het integreert direct in uw workflow, verbetert de codekwaliteit en legt de basis voor een efficiëntere en productievere ontwikkelervaring.

Regelbeheer

Definieer en beheer regels via oplossingscontrole in het Power Platform-beheercentrum en flowcontroleconfiguratie in de Power Automate-portal.

Beheerders en gebruikers met de juiste machtigingen kunnen:

• Schakel regels in- of uit.
• Configureer ernstniveaus (fout, waarschuwing, info).
• Configureer aangepaste waarden voor regels die parameters ondersteunen, zoals drempelwaarden en limieten (alleen Power Automate portal).
• Regels toepassen op specifieke omgevingen of omgevingsgroepen (alleen beheerde omgevingen, Power Platform-beheercentrum).

De configuratie van stroomcontrole is van toepassing op omgevingsniveau en is van invloed op alle bureaubladstromen in de geselecteerde omgeving.

Afdwingingsinstellingen voor oplossingscontrole die u in het Power Platform-beheercentrum configureert, hebben voorrang op configuratie-instellingen voor Flow-controle in de Power Automate-portal. U kunt geen regels wijzigen die door afdwinging via Solution checker zijn beperkt in de Power Automate-portal.

Configuratie in het beheercentrum

Statische analyseregels configureren:

1. Ga naar het Power Platform-beheercentrum.
2. Selecteer Beheer>Omgevingen om door te gaan.
3. Selecteer Beheerde omgevingen bewerken.
4. Configureer in de sectie Oplossingscontrole afdwingen welke regels er moeten worden uitgesloten voor de geselecteerde omgeving.

Configuratie in de Power Automate-portal

Stroomcontroleregels configureren voor een omgeving:

1. Ga naar de pagina Bureaubladstromen in de Power Automate-portal.

2. Selecteer Flow checker.

3. Configureer de gewenste regels in het configuratievenster stroomcontrole . Voor elke regel kunt u het volgende doen:

   • Schakel de regel in of uit.
   • Selecteer een ernstniveau.
   • Geef een aangepaste waarde op voor regels die parameters ondersteunen.

4. Kies Opslaan.

Configuratiewijzigingen worden toegepast op omgevingsniveau en zijn van invloed op alle bureaubladstromen in de geselecteerde omgeving. Voor bureaubladstromen die al in de ontwerper zijn geopend, opent u de stroom opnieuw zodat configuratiewijzigingen van kracht worden.

Statische analyse uitvoeren in de portal

Om handmatig een statische analyse te activeren:

1. Ga naar de pagina Oplossingen in de Power Automate-portal.

2. Open het contextmenu (⋯) naast een oplossing.

3. Beweeg de aanwijzer over Solution checker.

4. Kies een van de volgende opties:

   • Uitvoeren: Hiermee start u de statische analyse.
   • Resultaten bekijken: Hiermee opent u het laatste analyserapport.
   • Resultaten downloaden: Hiermee wordt het rapport voor offline beoordeling geëxporteerd.

Statische analyse in de ontwerper

Statische analyse wordt automatisch uitgevoerd en inspecteert voortdurend uw code zonder dat handmatige tussenkomst nodig is. Wanneer u acties aan uw stroom toevoegt, verwijdert of wijzigt, wordt deze functie geactiveerd om de wijzigingen te beoordelen en de analyse te vernieuwen. Dit proces zorgt ervoor dat de ontwikkeling soepel en efficiënt verloopt. Aan de rechterkant van de ontwerper ziet u een speciale Flow Checker-knop. Het getal op de knop geeft het totale aantal overtredingen in het desktopproces weer. Selecteer de knop om het deelvenster Stroomcontrole te openen en gedetailleerde inzichten te bekijken over de specifieke regels die zijn overtreden.

Elke analyse genereert een percentagescore die aangeeft hoeveel regels succesvol zijn gevolgd. Een hogere score betekent minder overtredingen en een betere codekwaliteit.

Deze score wordt telkens opnieuw berekend als er een wijziging in de flow wordt doorgevoerd. Zo krijgt u direct feedback en worden goede ontwikkelpraktijken bevorderd.

Als er regels worden overtreden, geeft het statische analyserapport een duidelijk overzicht. Hier worden de namen van de regels en het aantal acties of variabelen in uw stroom die elke regel overtreden, weergegeven. Wanneer u een regel selecteert, wordt de bijbehorende actie gemarkeerd en krijgt u een gedetailleerde uitleg over de fout. Bij overtredingen die verband houden met variabelen navigeert het systeem naar het variabelenvenster, waardoor correcties eenvoudig zijn. Het deelvenster Stroomcontrole bevat een zoekfunctie en u kunt ermee filteren op substroom, zodat u snel specifieke problemen kunt vinden.

Bij elke overtreding wordt een tegel met details weergegeven, inclusief de aard van de fout, aanbevolen oplossingen en een koppeling naar documentatie. Gebruik de schuifregelaar in de regelkop om te navigeren naar de verschillende voorkomens van dezelfde overtreding. Met deze richtlijnen kunnen ontwikkelaars problemen snel en effectief aanpakken. Bij fouten in de stroomcontrole worden een inline-indicator en een pop-up met meer details weergegeven. Waarschuwingen worden, net als fouten, ook inline weergegeven in de werkruimte van de ontwerper. De ontwerper geeft diagnostische statussen, zoals waarschuwingen en fouten, weer op substroomtabbladen en bevat een knop waarmee u naar het onderdeel kunt gaan dat aandacht nodig heeft.

Legenda

1. Aantal keren dat de specifieke regelovertreding heeft plaatsgevonden
2. Navigeer naar de actie die de regel overtreedt
3. Koppeling naar documentatie

Regels voor statische analyse

Statische analyseregels zijn vooraf gedefinieerde richtlijnen waarmee u ervoor kunt zorgen dat uw stromen veilig, onderhoudbaar en performant zijn. Elke regel is gericht op specifieke aspecten van het stroomontwerp, zoals beveiliging, prestaties en onderhoudbaarheid, en biedt bruikbare feedback om de kwaliteit van uw stroom te verbeteren. Hieronder vindt u een lijst met de regels, hun beschrijvingen en voorgestelde oplossingen.

Onveilige wachtwoordbeveiliging

• Ernstniveau: Waarschuwing
• Type: Beveiliging
• Foutdetails: Wachtwoorden worden onveilig beheerd in de werkstroom.
• Beschrijving: Deze regel controleert of wachtwoorden onveilig worden beheerd in een bureaubladstroom, zodat ze niet zichtbaar zijn of op onjuiste wijze worden gebruikt tijdens de uitvoering.
• Voorgestelde oplossing: Zorg ervoor dat alle wachtwoordgerelateerde invoer correct wordt verwerkt door de wachtwoordfuncties van Power Automate voor desktop te gebruiken. Gebruik "Direct versleutelde tekstinvoer" voor maximale beveiliging via machinegebaseerde versleuteling. Voor stromen die op verschillende machines worden gebruikt, kiest u 'Wachtwoordinvoer als variabele' en markeert u de overeenkomstige variabele als gevoelig om de beveiliging te verbeteren. Maak ook gebruik van veilige functies voor het beheer van referenties, zoals de actie 'Inloggegevens ophalen', die is geïntegreerd met CyberArk-inloggegevens.

Recursie tussen twee substromen

• Ernstniveau: Waarschuwing
• Type: ontwerp
• Foutdetails: Recursieve aanroepen gedetecteerd tussen substromen, wat mogelijk een oneindige lus veroorzaakt.
• Beschrijving: Met deze regel wordt gecontroleerd op recursieve aanroepen tussen twee of meer substromen, zodat de stroom niet in een oneindige lus terechtkomt.
• Voorgestelde oplossing: Verwijder recursieve aanroepen tussen de substromen.

Maximale lengte van de variabele overschreden

• Ernstigheid: Waarschuwing
• Type: Onderhoudbaarheid
• Foutdetails: Naam van variabele overschrijdt de limiet van 40 tekens.
• Beschrijving: Met deze regel wordt gecontroleerd of de naam van elke variabele die is gedefinieerd in de stroom een opgegeven aantal tekens overschrijdt. De standaardlimiet is 40 tekens.
• Voorgestelde oplossing: Wijzig de naam van variabelen die de opgegeven tekenlimiet overschrijden om ervoor te zorgen dat hun namen korter zijn dan 40 tekens.

Standaardwaarden invoervariabelen

• Ernstniveau: Waarschuwing
• Type: Onderhoudbaarheid
• Foutdetails: Invoer-/uitvoervariabelen gebruiken geen standaardwaarden.
• Beschrijving: Met deze regel wordt gecontroleerd of invoer-/uitvoervariabelen standaardwaarden gebruiken en wordt ervoor gezorgd dat deze correct zijn geconfigureerd voor de stroom.
• Voorgestelde oplossing: Wijs standaardwaarden toe aan alle invoer- en uitvoervariabelen in de stroom.

Drempelwaarde voor aantal invoer- en uitvoervariabelen

• Ernstigheid: Waarschuwing
• Type: Onderhoudbaarheid
• Foutdetails: Het totale aantal invoer-/uitvoervariabelen overschrijdt de limiet van 25 variabelen.
• Beschrijving: Met deze regel wordt gecontroleerd of het totale aantal invoer-/uitvoervariabelen in de stroom een opgegeven drempelwaarde overschrijdt. Het maximumaantal is 25 variabelen.
• Voorgestelde oplossing: Zorg ervoor dat het aantal invoer- en uitvoervariabelen in de stroom niet groter is dan 25.

Foutactie van blok leegmaken

• Standaardernstniveau: Waarschuwing
• Type: ontwerp
• Foutdetails: Actie 'Bij blokfout' is leeg en fouten worden niet afgehandeld.
• Beschrijving: Deze regel controleert of de acties 'Bij blokfout' in uw stroom correct zijn geconfigureerd om fouten af te handelen, zodat fouten zoals verwacht worden gegenereerd en afgehandeld.
• Voorgestelde oplossing: Om mogelijke fouten te beheren, stelt u de acties Bij blokfout in de flow in.

Geneste If-clausules

• Ernstigheid: Waarschuwing
• Type: Onderhoudbaarheid
• Foutdetails: Geneste If-clausules overschrijden vijf niveaus.
• Beschrijving: Met deze regel wordt gecontroleerd of er geneste if-instructies met meer dan 5 niveaus zijn, zodat de stroom beheersbaar en leesbaar blijft.
• Voorgestelde oplossing: Herstructureer de stroom om genest if-instructies te beperken tot maximaal vijf niveaus.

Onvolledig indien

• Ernstniveau: Waarschuwing
• Type: ontwerp
• Foutdetails: Onvolledige If-actie gedetecteerd: zonder inhoud of met alleen acties in de Else-vertakking.
• Beschrijving: Deze regel detecteerr If-acties die geen inhoud hebben of alleen acties in de Else-vertakking bevatten, zodat voorwaardelijke instructies effectief worden geïmplementeerd.
• Voorgestelde oplossing: Doorloop de flow en controleer elke 'If'-voorwaarde om te controleren of de vertakkingen 'If', 'Else if' en 'Else' allemaal zinvolle acties bevatten.

Oneindige lus

• Ernstniveau: Waarschuwing
• Type: ontwerp
• Foutdetails: Er is een oneindige lus gedetecteerd in de werkstroom, waardoor deze mogelijk oneindig blijft doorlopen.
• Beschrijving: Deze regel controleert of er oneindige lussen in de stroom zijn, zodat scenario's kunnen worden geïdentificeerd en voorkomen waarin de stroom permanent kan worden uitgevoerd.
• Voorgestelde oplossing: Zorg ervoor dat elke lus een duidelijk gedefinieerde en haalbare beëindigingsvoorwaarde heeft. De voorwaarde kan gebaseerd zijn op een teller, een specifieke waarde of de voltooiing van een taak. Voeg controles of failsafe-voorwaarden toe om de lus te verbreken als deze langer duurt dan verwacht. Stel bijvoorbeeld een maximaal aantal iteraties in of neem een time-out op.

Misbruik van wachtacties

• Ernstigheid: Waarschuwing
• Type: Prestaties
• Foutdetails: Misbruik van wachtacties gedetecteerd, waarbij meer dan 10 wachtacties potentiële knelpunten veroorzaken.
• Beschrijving: Deze regel controleert of de stroom een buitensporig aantal wachtacties bevat (meer dan 10), zodat mogelijke knelpunten als gevolg van langdurige vertragingen kunnen worden geïdentificeerd en geminimaliseerd.
• Voorgestelde oplossing: Controleer de stroom om alle wachtacties te identificeren en controleer of ze essentieel zijn voor de logica van de stroom. Verwijder onnodige wachttijden of combineer ze waar mogelijk.

Enorme wachttijd

• Ernstigheid: Waarschuwing
• Type: Prestaties
• Foutdetails: Er is een enorme wachttijd gedetecteerd, die de limiet van 600 seconden voor hard gecodeerde wachtacties overschrijdt.
• Beschrijving: Deze regel controleert of de hard gecodeerde wachtacties in de stroom een opgegeven tijdsduur overschrijden, waarbij de limiet is ingesteld op 600 seconden.
• Voorgestelde oplossing: Controleer de stroom om wachtacties te vinden die de limiet van 600 seconden overschrijden. Controleer of deze lange wachttijden noodzakelijk zijn en pas de duur ervan aan naar de kortst mogelijke tijd die nodig is om de stroom correct te laten verlopen. Als er lang gewacht moet worden, verdeel de wachttijd dan in kortere intervallen en voeg tussendoor controles of voorwaarden toe. Vervang indien mogelijk lange wachttijdacties door gebeurtenisgestuurde triggers.

Niet bereikte acties

• Ernstniveau: Waarschuwing
• Type: Onderhoudbaarheid
• Foutdetails: Een of meer acties in de stroom zijn onbereikbaar en worden onder geen enkele omstandigheid uitgevoerd.
• Beschrijving: Deze regel controleert op acties in de stroom die logisch onbereikbaar zijn. Onbereikbare acties kunnen het gevolg zijn van onjuiste vertakkingen, verkeerd geplaatste voorwaarden of losgekoppelde segmenten. Ze kunnen ook duiden op fouten in de logica of structuur van de stroom.
• Voorgestelde oplossing: Controleer de stroom om acties te vinden die niet zijn verbonden met een uitvoeringspad. Zorg ervoor dat elke actie bereikbaar is via een geldige logische vertakking of lus. Verwijder of verplaats onbereikbare acties om het proces overzichtelijk en efficiënt te houden.

Substroom niet nodig

• Ernstniveau: Waarschuwing
• Type: Onderhoudbaarheid
• Foutdetails: De regel heeft een substroom gedetecteerd die geen acties bevat, alleen uitgeschakelde acties of te weinig acties bevat om de scheiding te rechtvaardigen. Dergelijke substromen dragen mogelijk niet zinvol bij aan de uitvoering van de stroom en kunnen de duidelijkheid verminderen.
• Beschrijving: Deze regel controleert op subflows die leeg zijn of al te minimaal zijn en doorgaans minder dan 5 acties bevatten. Hoewel substromen nuttig zijn voor modulariteit en hergebruik, kunnen substromen die geen zinvolle inhoud of abstractie hebben, duiden op onvolledige ontwikkeling, onnodige fragmentatie of onjuiste configuratie. Deze patronen kunnen leiden tot verwarring en de onderhoudbaarheid belemmeren.
• Voorgestelde oplossing: Controleer de geïdentificeerde substroom om te bepalen of deze een duidelijk en waardevol doel heeft. Als dat niet het geval is, kunt u overwegen het te verwijderen of samen te voegen in een gerelateerd logicablok. Als de substroom bedoeld is voor toekomstig gebruik, voeg dan een plaatsaanduidingsactie toe om de rol ervan te verduidelijken en misinterpretatie te voorkomen.

Bekende beperkingen

• Alleen beschikbaar in Beheerde omgevingen.
• Het aanpassen van regels is beperkt tot het in- of uitschakelen van regels en het configureren van de ernst.

Bekende problemen

• Als u gekopieerde acties verwijdert nadat u de details van een regelovertreding hebt bekeken, kunnen er onverwerkte fouten optreden.
• Als u in de volgende acties een niet-gevoelige wachtwoordvariabele gebruikt, mislukt de statische analyse tijdens de regelevaluatie.
  • Dialoogvenster voor invoer weergeven
  • Dialoogvenster voor het selecteren van mappen weergeven
  • Aangepast formulier weergeven