Stroomcontrole (preview)

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

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

Regels worden via oplossingscontrole in het Power Platform-beheercentrum gedefinieerd en beheerd. Beheerders kunnen:

• Schakel regels in- of uit.
• Configureer ernstniveaus (fout, waarschuwing, info).
• Pas regels op specifieke omgevingen of omgevingsgroepen toe (alleen Beheerde omgevingen).

Configuratie in het beheercentrum

Statische analyseregels configureren:

1. Ga naar het Power Platform-beheercentrum.
2. Selecteer Beheren>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.

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 muisaanwijzer over de Oplossingscontrole.

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 de bureaubladstroom 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 schuifbalk in de kop van de regel om te navigeren tussen instanties 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 ook inline in de werkruimte van de ontwerper weergegeven, net als fouten. 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

• Ernst: Waarschuwing
• Type: Beveiliging
• Foutdetails: Wachtwoorden worden onveilig beheerd in de stroom.
• 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

• Ernst: 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.

Lengte variabele overschreden

• Ernst: Waarschuwing
• Type: Onderhoud
• 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

• Ernst: Waarschuwing
• Type: Onderhoud
• 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

• Ernst: Waarschuwing
• Type: Onderhoud
• 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.

Lege actie Blok met fout

• Standaardernst: Waarschuwing
• Type: ontwerp
• Foutdetails: Actie "Blok met fout" is leeg en er worden geen fouten afgehandeld.
• Beschrijving: Met deze regel wordt gecontroleerd of de acties 'Blok met fout' in uw stroom correct zijn ingesteld om fouten af te handelen. Zo wordt ervoor gezorgd dat fouten zoals verwacht worden gegenereerd en beheerd.
• Voorgestelde oplossing: Stel de acties Blok met fout in de stroom in om mogelijke fouten te beheren.

Geneste If-clausules

• Ernst: Waarschuwing
• Type: Onderhoud
• 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.

Onvolledige If

• Ernst: Waarschuwing
• Type: ontwerp
• Foutdetails: Onvoltooide If-actie gedetecteerd doordat inhoud ontbreekt of alleen de vertakking Else acties bevat.
• 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 stroom en controleer elke 'If'-voorwaarde om er zeker van te zijn dat deze betekenisvolle acties bevat in zowel de vertakkingen 'If', 'Else if' als 'Else'.

Oneindige lus

• Ernst: Waarschuwing
• Type: ontwerp
• Foutdetails: Er is een oneindige lus gedetecteerd in de stroom, waardoor deze mogelijk permanent kan worden uitgevoerd.
• 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

• Ernst: 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

• Ernst: 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

• Ernst: Waarschuwing
• Type: Onderhoud
• 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 de stroom schoon en efficiënt te houden.

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