Flowkontrolværktøj

Gør din udviklingsarbejdsgang bedre med funktionen til statisk analyse i Løsningskontrol. Dette værktøj understøtter bedste praksis i procesautomatisering med robotteknologi (RPA) og opfylder kritiske flowkrav ved automatisk at evaluere dine flows for at sikre optimal ydeevne. Statisk analyse er tilgængelig i sektionen Flowkontrol i designeren. Den håndhæver vigtige retningslinjer og giver feedback i realtid og tidlig kodeinspektion. Det integreres direkte i din arbejdsgang, forbedrer kodekvaliteten og lægger grundlaget for en mere effektiv og produktiv udviklingsoplevelse.

Regelstyring

Definer og administrer regler via Løsningskontrol i konfigurationen af Power Platform Administration og Flow-kontrol på Power Automate-portalen.

Administratorer og brugere med de relevante tilladelser kan:

  • Aktivere eller deaktivere regler.
  • Konfigurer alvorsgrader (fejl, advarsel, oplysninger).
  • Konfigurer brugerdefinerede værdier for regler, der understøtter parametre, f.eks. tærskler og grænser (kun Power Automate portal).
  • Anvend regler på bestemte miljøer eller miljøgrupper (administrerede miljøer, kun Power Platform Administration).

Konfigurationen af Flowkontrol gælder på miljøniveau og påvirker alle skrivebordsflows i det valgte miljø.

Indstillinger for håndhævelse af løsningskontrol, som du konfigurerer i Power Platform Administration, har forrang frem for konfigurationsindstillinger for Flowkontrol på Power Automate portalen. Du kan ikke ændre regler, der er begrænset via håndhævelse af Løsningskontrol på Power Automate-portalen.

Konfiguration i Administration

Sådan konfigureres regler for statisk analyse:

  1. Gå til Power Platform Administration.
  2. Vælg Administrer>miljøer for at fortsætte.
  3. Vælg rediger administreret miljø.
  4. I afsnittet Håndhævelse af løsningskontrol skal du konfigurere, hvilke regler der skal udelades for det valgte miljø.

Konfiguration på Power Automate-portalen

Sådan konfigurerer du regler for flowkontrol for et miljø:

  1. Gå til siden Skrivebordsflow på Power Automate-portalen.

  2. Vælg Flowkontrolværktøj.

  3. I ruden Flow checker-konfiguration skal du konfigurere de ønskede regler. For hver regel kan du:

    • Aktivér eller deaktiver reglen.
    • Vælg et alvorsgradsniveau.
    • Angiv en brugerdefineret værdi for regler, der understøtter parametre.
  4. Vælg Save.

Skærmbillede af konfigurationen af statiske analyseregler på Power Automate-portalen.

Konfigurationsændringer anvendes på miljøniveau og påvirker alle skrivebordsflow i det valgte miljø. Åbn flowet igen for de skrivebordsflows, der allerede er åbne i designeren, for at konfigurationsændringerne kan træde i kraft.

Bemærk

  • Håndhævelsesindstillinger for løsningskontrol i Power Platform Administration har forrang frem for konfigurationsindstillinger for Flowkontrol på Power Automate-portalen.
  • Hvis miljøet er en del af en miljøgruppe med en defineret konfiguration, nedarves regelindstillingerne og kan ikke redigeres enkeltvis. Få mere at vide om Løsningskontrol i Løsningskontrol og Håndhævelse af Løsningskontrol i Administrerede miljøer.
  • Det er kun regler, der understøtter parameterisering, der viser konfigurerbare værdier. Afhængigt af reglen kan den konfigurerede værdi repræsentere enten en minimum- eller maksimumgrænse, der bruges under analysen.
  • Administratorer af Power Platform skal tildele de relevante rettigheder til analysetilsidesættelse til alle roller, der kræver adgang til funktionen:
    • prvReadmsdyn_analysisoverride (Tilsidesættelse af analyse – læs) for at få vist den aktuelle konfiguration.
    • prvWritemsdyn_analysisoverride (Analysis Override – Write) for at ændre regelindstillinger, herunder alvorsgradsniveauer, parameterværdier og regelaktivering.
    • prvCreatemsdyn_analysisoverride (Analysis Override – Create) for at oprette nye tilsidesættelser af regler.

Kør statisk analyse på portalen

Sådan udløser du statisk analyse manuelt:

  1. Gå til Løsninger-siden i Power Automate portal.

  2. Åbn genvejsmenuen (⋯) ud for en løsning.

  3. Placer markøren over Løsningskontrol.

  4. Vælg en af følgende indstillinger:

    • Kør: Starter den statiske analyse.
    • Vis resultater: Åbner den seneste analyserapport.
    • Download resultater: Eksporterer rapporten til offlinegennemgang.

Bemærk

Statisk analyse kører for alle skrivebordsflow, der er inkluderet i en løsning. Identificer, hvilket skrivebordsflow der udløser en bestemt regelovertrædelse, ved at markere kolonnen Objektnavn i resultaterne. I denne kolonne vises navnet på det tilsvarende skrivebordsflow.

Skærmbillede af resultaterne af statisk analyse af en løsning i portalen Power Automate.

Statisk analyse i designeren

Statisk analyse kører automatisk og inspicerer løbende din kode uden at kræve manuel indgriben. Når du tilføjer, fjerner eller ændrer handlinger i flowet, aktiveres denne funktion for at vurdere ændringerne og opdatere analysen. Denne proces gør udviklingen problemfri og effektiv. I højre side af designeren kan du se en dedikeret knap til flowkontrol. Tallet på knappen viser det samlede antal overtrædelser i skrivebordsflowet. Vælg knappen for at åbne ruden Flowkontrol og få vist detaljeret indsigt i de specifikke regler, der er overtrådt.

Skærmbillede af knappen i Power Automate til skrivebordsdesigner, der åbner ruden med statisk analyse.

Hver analyse genererer en procentvis score, der viser andelen af regler, der er fulgt korrekt. En højere score betyder færre overtrædelser og bedre kodekvalitet.

Denne score genberegnes, hver gang der foretages en ændring af flowet, hvilket giver øjeblikkelig feedback og fremmer god udviklingspraksis.

Skærmbillede, der viser den statiske analysescore og en oversigt over eventuelle overtrådte regler.

Hvis regler overtrædes, viser den statiske analyserapport en klar oversigt. Den indeholder regelnavne og antallet af handlinger eller variabler i flowet, der overtræder de enkelte regler. Hvis du vælger en regel, fremhæves den tilsvarende handling, og der gives en detaljeret fejlforklaring. Ved variabelrelaterede overtrædelser navigerer systemet til variabelruden, hvilket gør det nemt at foretage rettelser. Flowkontrolruden indeholder søgefunktionalitet og lader dig filtrere efter underforløb, så du hurtigt kan finde specifikke problemer.

Hver overtrædelse viser en rude med oplysninger, herunder fejlens art, anbefalede rettelser og et link til dokumentation. Brug skyderen i reglens header til at navigere mellem forekomster af den samme overtrædelse. Denne vejledning hjælper udviklere med at løse problemer hurtigt og effektivt. Overtrædelser af flowkontrolfejl viser en indbygget indikator og et pop op-vindue med flere detaljer. Advarsler vises også indbygget i designerarbejdsområdet, f.eks. fejl. Designeren viser diagnosticeringsstatusser, f.eks. advarsler og fejl på underflowfaner, og indeholder en knap, der giver dig mulighed for at gå til den komponent, der kræver opmærksomhed.

Skærmbillede, der viser detaljerne i en statisk analyseregel.

Forklaring

  1. Forekomster af den specifikke regelovertrædelse
  2. Gå til den handling, der overtræder reglen
  3. Link til dokumentation

Statiske analyseregler

Regler for statisk analyse er foruddefinerede retningslinjer, der er med til at sikre, at dine flows er sikre, kan vedligeholdes og er effektive. Hver regel er rettet mod specifikke aspekter af flowdesign, f.eks. sikkerhed, ydeevne og vedligeholdelse, og giver handlingsrettet feedback for at forbedre flowets kvalitet. Nedenfor er en liste over reglerne, deres beskrivelser og foreslåede rettelser.

Usikker adgangskodesikkerhed

  • Alvorlighedsgrad: Advarsel
  • Type: Sikkerhed
  • Fejldetaljer: Adgangskoder administreres usikkert i flowet.
  • Beskrivelse: Denne regel kontrollerer, om adgangskoder administreres usikkert i et skrivebordsflow, og sikrer, at de ikke vises eller håndteres forkert under udførelsen.
  • Foreslået løsning: Sørg for, at alle adgangskoderelaterede input håndteres korrekt ved hjælp af adgangskodefunktionerne i Power Automate til skrivebord. Brug "Direkte krypteret tekstinput" for maksimal sikkerhed gennem maskinbaseret kryptering. For flows, der bruges på forskellige maskiner, skal du vælge "Adgangskodeinput som variabel" og markere den tilsvarende variabel som følsom for at øge sikkerheden. Brug også sikre funktioner til administration af legitimationsoplysninger som handlingen "Få legitimationsoplysninger", der integreres med CyberArk legitimationsoplysninger.

Rekursion mellem to underforløb

  • Alvorlighedsgrad: Advarsel
  • Type: Design
  • Fejldetaljer: Der blev registreret rekursive opkald mellem underflows, hvilket potentielt kan forårsage en uendelig løkke.
  • Beskrivelse: Denne regel kontrollerer, om der er rekursive opkald mellem to eller flere underflows, og sikrer, at flowet ikke går ind i en uendelig løkke.
  • Foreslået rettelse: Fjern eventuelle rekursive opkald mellem underflows.

Variabellængde overskredet

  • Alvorlighedsgrad: Advarsel
  • Type: Mulighed for vedligeholdelse
  • Fejldetaljer: Variabelnavnet overstiger grænsen på 40 tegn.
  • Beskrivelse: Denne regel kontrollerer, om navnet på hver variabel, der er defineret i flowet overskrider et angivet antal tegn. Standardgrænsen er 40 tegn.
  • Foreslået rettelse: Omdøb alle variabler, der overskrider den angivne tegngrænse, for at sikre, at deres navne er kortere end 40 tegn.

Standardværdier for inputvariabler

  • Alvorlighedsgrad: Advarsel
  • Type: Mulighed for vedligeholdelse
  • Fejldetaljer: Input-/outputvariabler bruger ikke standardværdier.
  • Beskrivelse: Denne regel kontrollerer, om input-/outputvariabler bruger standardværdier, og sikrer, at de er konfigureret korrekt til flowet.
  • Foreslået rettelse: Tildel standardværdier til alle input- og outputvariabler i flowet.

Tærskel for antal input- og outputvariabler

  • Alvorlighedsgrad: Advarsel
  • Type: Mulighed for vedligeholdelse
  • Fejldetaljer: De samlede input/output-variabler overskrider 25-variable-grænsen.
  • Beskrivelse: Denne regel kontrollerer, om det samlede antal input/output-variabler i flowet overskrider en angivet tærskel. Grænsen er 25 variabler.
  • Foreslået rettelse: Sørg for, at antallet af input- og outputvariabler i flowet ikke overstiger 25.

Tom fejlaktion på blokken

  • Standardalvorlighedsgrad: Advarsel
  • Type: Design
  • Fejldetaljer: Handlingen "Fejl på blok" er tom og håndterer ikke fejl.
  • Beskrivelse: Denne regel kontrollerer, om handlingerne "Fejl på blok" i dit flow er opsat korrekt til at håndtere fejl, og sikrer, at fejl udløses og administreres som forventet.
  • Foreslået rettelse: Kontroller eventuelle fejl ved at konfigurere handlingerne Fejl på blok i flowet.

Indlejrede If-klausuler

  • Alvorlighedsgrad: Advarsel
  • Type: Mulighed for vedligeholdelse
  • Fejldetaljer: Indlejrede hvis-delsætninger overstiger fem niveauer.
  • Beskrivelse: Denne regel kontrollerer, om der er indlejrede if-sætninger med mere end fem niveauer, hvilket sikrer, at flowet forbliver håndterbart og læsbart.
  • Foreslået rettelse: Omstrukturer flowet for at reducere indlejringen af if-sætninger til højst fem niveauer.

Ufuldstændig hvis

  • Alvorlighedsgrad: Advarsel
  • Type: Design
  • Fejldetaljer: Ufuldstændig Hvis der blev registreret en handling, mangler indhold eller kun indeholder handlinger i forgreningen Else.
  • Beskrivelse: Denne regel registrerer, om handlinger, der mangler indhold eller kun indeholder handlinger i forgreningen Else, hvilket sikrer, at betingede erklæringer implementeres effektivt.
  • Foreslået rettelse: Gå gennem flowet, og gennemse hver "If"-betingelse for at sikre, at den indeholder meningsfulde handlinger i både "Hvis"-, "Ellers hvis"- og "Ellers"-forgreninger.

uendelig løkke

  • Alvorlighedsgrad: Advarsel
  • Type: Design
  • Fejldetaljer: Der blev registreret en uendelig løkke i flowet, hvilket kan medføre, at det kører på ubestemt tid.
  • Beskrivelse: Denne regel kontrollerer, om der er uendelige løkker i flowet, hvilket er med til at identificere og forhindre scenarier, hvor flowet kan køre i det uendelige.
  • Foreslået løsning: Sørg for, at hver løkke har en klart defineret og opnåelig afslutningsbetingelse. Betingelsen kan være baseret på en tæller, en bestemt værdi eller fuldførelsen af en opgave. Tilføj kontroller eller fejlsikre betingelser for at bryde løkken, hvis den kører længere end forventet. Du kan f.eks. angive et maksimalt antal gentagelser eller inkludere en timeout.

Forkert brug af ventehandlinger

  • Alvorlighedsgrad: Advarsel
  • Type: Ydeevne
  • Fejldetaljer: Der blev registreret misbrug af ventehandlinger, hvor mere end 10 ventehandlinger forårsager potentielle flaskehalse.
  • Beskrivelse: Denne regel kontrollerer, om flowet indeholder et stort antal vent-handlinger – mere end 10 – for at hjælpe med at identificere og minimere potentielle flaskehalse, der skyldes langvarige forsinkelser.
  • Foreslået løsning: Gennemse flowet for at identificere alle vent-handlinger og kontrollere, om de er vigtige for flowets logik. Fjern unødvendige ventetider, eller kombiner dem, hvor det er muligt.

Enorm ventetid

  • Alvorlighedsgrad: Advarsel
  • Type: Ydeevne
  • Fejldetaljer: Der blev registreret en enorm ventetid, der overskrider 600-sekunders grænsen for ventehandlinger i hardcode.
  • Fejldetaljer: Denne regel kontrollerer, om de hårdkodede ventehandlinger i flowet overskrider et angivet tidsrum, med standardgrænsen angivet til 600 sekunder.
  • Foreslået løsning: Gennemse flowet for at finde ventehandlinger, der overskrider grænsen på 600 sekunder. Kontrollér, om disse lange ventetider er nødvendige, og juster varigheden til den korteste tid, det tager for flowet at fungere korrekt. Hvis der kræves lang ventetid, skal du opdele den i kortere intervaller og tilføje kontroller eller betingelser mellem dem. Når det er muligt, skal du erstatte handlinger med lang ventetid med hændelsesdrevne udløsere.

Ikke-udførte handlinger

  • Alvorlighedsgrad: Advarsel
  • Type: Mulighed for vedligeholdelse
  • Fejldetaljer: En eller flere handlinger i flowet kan ikke nås og udføres under nogen omstændigheder.
  • Beskrivelse: Denne regel undersøger, om der er handlinger i flowet, som logisk set ikke kan udføres. Handlinger, der ikke kan nås, kan skyldes forkert forgrening, forkert placerede betingelser eller afbrudte segmenter og kan indikere fejl i flowets logik eller struktur.
  • Foreslået løsning: Gennemse flowet for at finde handlinger, der ikke er knyttet til en udførelsessti. Sørg for, at hver enkelt handling er tilgængelig via en gyldig logikgren eller løkke. Fjern eller flyt handlinger, der ikke kan nås, for at holde flowet rent og effektivt.

Ikke nødvendigt underflow

  • Alvorlighedsgrad: Advarsel
  • Type: Mulighed for vedligeholdelse
  • Oplysninger om fejl: Reglen registrerede et underflow, der enten ikke indeholder nogen handlinger, kun deaktiverede handlinger eller indeholder for få handlinger til at retfærdiggøre adskillelsen. Sådanne underflow bidrager muligvis ikke meningsfuldt til udførelsen af flowet og kan reducere klarheden.
  • Beskrivelse: Denne regel søger efter underflow, der enten er tomme eller alt for minimale – typisk indeholder færre end 5 handlinger. Underflow er nyttige til modularitet og genbrug, men dem, der mangler meningsfuldt indhold eller abstraktion, kan indikere ufuldstændig udvikling, unødvendig fragmentering eller forkert konfiguration. Disse mønstre kan føre til forvirring og hindrer vedligeholdelse.
  • Foreslået løsning: Gennemse den identificerede underflow for at finde ud af, om det tjener et klart og værdifuldt formål. Hvis den ikke gør det, kan du overveje at fjerne den eller flette den til en relateret logikblok. Hvis delflowet er tiltænkt fremtidig brug, skal du tilføje en pladsholderhandling for at tydeliggøre dets rolle og forhindre fejltolkning.

Kendte begrænsninger

  • Kun tilgængelig for administrerede miljøer.
  • Regeltilpasning er begrænset til aktivering eller deaktivering af regler og konfiguration af alvorsgrad.

Kendte problemer

  • Hvis du sletter kopierede handlinger efter at have set detaljer om en regelovertrædelse, kan det udløse ikke-håndterede fejl.
  • Hvis du bruger en ufølsom adgangskodevariabel i følgende handlinger, mislykkes statisk analyse under regelevaluering.
    • Vis inputdialog
    • Vis den valgte mappe-dialogboks
    • Vise brugerdefineret formular