Flow-Checker (Vorschauversion)

[Dieser Artikel ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Verbessern Sie Ihren Entwicklungs-Workflow mit der statischen Analysefunktion in Lösungsprüfung. Dieses Tool unterstützt Best-Practice-Verfahren in robotergesteuerte-Prozessautomatisierung (RPA) und erfüllt kritische Flow-Anforderungen, indem es Ihre Flows automatisch auswertet, um eine optimale Leistung sicherzustellen. Die statische Analyse ist im Abschnitt Flow-Checker des Designers verfügbar. Es setzt wichtige Richtlinien durch und bietet Echtzeit-Feedback und eine frühzeitige Code-Inspektion. Es lässt sich direkt in Ihren Workflow integrieren, verbessert die Codequalität und legt den Grundstein für eine effizientere und produktivere Entwicklungserfahrung.

Regelverwaltung

Regeln werden über Lösungsprüfung im Power Platform Admin Center definiert und verwaltet. Administratoren können:

• Aktivieren oder Deaktivieren von Abgleichsregeln.
• Konfigurieren Sie Schweregrade (Fehler, Warnung, Info).
• Regeln auf bestimmte Umgebungen oder Umgebungsgruppen anwenden (nur verwaltete Umgebungen).

Konfiguration im Admin Center

So konfigurieren Sie statische Analyseregeln:

1. Navigieren Sie zum Power Platform Admin Center.
2. Wählen Sie verwalten> Umgebungen aus, um fortzufahren.
3. Verwaltete Umgebungen auswählen.
4. Konfigurieren Sie im Abschnitt Lösungsprüfungs-Erzwingung, welche Regeln für die ausgewählte Umgebung ausgeschlossen werden sollen.

Statische Analyse im Portal ausführen

So lösen Sie die statische Analyse manuell aus:

1. Gehen Sie zur Seite Lösungen im Power Automate Poral.

2. Öffnen Sie das Kontextmenü (⋯) neben einer Lösung.

3. Schieberegler für Lösungsprüfung.

4. Wählen Sie eine der folgenden Optionen aus:

   • Ausführen: Initiiert die statische Analyse.
   • Ergebnisse anzeigen: Öffnet den neuesten Analysebericht.
   • Ergebnisse herunterladen: Exportiert den Bericht zur Offline-Überprüfung.

Statische Analyse im Designer

Die statische Analyse wird automatisch ausgeführt und prüft Ihren Code kontinuierlich, ohne dass ein manuelles Eingreifen erforderlich ist. Wenn Sie Aktionen in Ihrem Flow hinzufügen, entfernen oder ändern, wird diese Funktion aktiviert, um die Änderungen zu bewerten und die Analyse zu aktualisieren. Dieser Prozess macht die Entwicklung nahtlos und effizient. Auf der rechten Seite des Designers sehen Sie eine spezielle Schaltfläche für den Flow-Checker. Die Zahl auf der Schaltfläche zeigt die Gesamtzahl der Verstöße im Desktop-Flow an. Wählen Sie die Schaltfläche aus, um den Bereich Flow Checker zu öffnen und detaillierte Einblicke in die spezifischen Regeln anzuzeigen, gegen die verstoßen wird.

Jede Analyse generiert einen Prozentwert, der den Anteil der erfolgreich befolgten Regeln angibt. Eine höhere Punktzahl bedeutet weniger Verstöße und eine bessere Codequalität.

Diese Bewertung wird jedes Mal neu berechnet, wenn eine Änderung am Flow vorgenommen wird, um sofortiges Feedback zu geben und gute Entwicklungspraktiken zu fördern.

Bei Regelverstößen gibt es im statischen Analysebericht eine übersichtliche Zusammenfassung. Sie listet die Regelnamen und die Anzahl der Aktionen oder Variablen in Ihrem Flow auf, die gegen die einzelnen Regeln verstoßen. Wenn Sie eine Regel auswählen, wird die entsprechende Aktion hervorgehoben und eine detaillierte Fehlererklärung bereitgestellt. Bei variablenbezogenen Verstößen navigiert das System zum Variablenbereich, wodurch Korrekturen einfach vorgenommen werden können. Der Bereich „Flow-Checker“ enthält Suchfunktionen und ermöglicht das Filtern nach Subflows, damit Sie bestimmte Probleme schnell finden können.

Für jeden Verstoß wird eine Kachel mit Details angezeigt, einschließlich der Art des Fehlers, empfohlene Korrekturen und eines Links zur Dokumentation. Verwenden Sie den Schieberegler in der Kopfzeile der Regel, um zwischen Vorkommnissen desselben Verstoßes zu navigieren. Diese Anleitung hilft Entwicklern, Probleme schnell und effektiv zu beheben. Bei Fehlern, die von der Flowprüfung erkannt werden, werden ein Inline-Indikator und ein Popup-Fenster mit weiteren Details angezeigt. Warnungen werden auch inline im Designerarbeitsbereich angezeigt, z. B. Fehler. Der Designer zeigt Diagnosestatus wie Warnungen und Fehler auf Subflow-Registerkarten an und enthält eine Schaltfläche, mit der Sie zu der Komponente wechseln können, die Aufmerksamkeit erfordert.

Legende

1. Vorkommnisse des spezifischen Regelverstoßes
2. Navigieren Sie zu der Aktion, die gegen die Regel verstößt
3. Link zur Dokumentation

Statische Analyseregeln

Regeln für statische Analysen sind vordefinierte Richtlinien, mit denen sichergestellt werden kann, dass Ihre Flows sicher, verwaltbar und leistungsfähig sind. Jede Regel zielt auf bestimmte Aspekte des Flowdesigns ab, z. B. Sicherheit, Leistung und Verwaltbarkeit, und bietet umsetzbares Feedback, um die Qualität Ihres Flows zu verbessern. Nachfolgend finden Sie eine Liste der Regeln, ihrer Beschreibungen und vorgeschlagenen Lösungen.

Nicht sichere Kennwortsicherheit

• Schweregrad: Warnung
• Typ: Sicherheit
• Fehlerdetails: Kennwörter werden unsicher im Flow verwaltet.
• Beschreibung: Diese Regel überprüft, ob Kennwörter in einem Desktop-Flow auf unsichere Weise ausgeführt werden. Dies stellt sicher, dass sie während der Ausführung nicht offengelegt oder falsch behandelt werden.
• Vorgeschlagene Lösung: Stellen Sie sicher, dass alle kennwortbezogenen Eingaben ordnungsgemäß behandelt werden, indem Sie die Kennwortfunktionen von Power Automate für Desktop verwenden. Nutzen Sie „Direkte verschlüsselte Texteingabe“ für maximale Sicherheit durch maschinelle Verschlüsselung. Wählen Sie für Flows, die auf verschiedenen Computern verwendet werden, „Kennworteingabe als Variable“ aus, und markieren Sie die entsprechende Variable als vertraulich, um die Sicherheit zu erhöhen. Verwenden Sie außerdem Funktionen zur sicheren Verwaltung von Anmeldeinformationen wie die Aktion Anmeldeinformationen abrufen, die in CyberArk Anmeldeinformationen integriert ist.

Rekursion zwischen zwei Subflows

• Schweregrad: Warnung
• Typ: Design
• Fehlerdetails: Es wurden rekursive Aufrufe zwischen Subflows erkannt, was zu einer Endlosschleife führen kann.
• Beschreibung: Diese Regel prüft auf rekursive Aufrufe zwischen zwei oder mehr Subflows, um sicherzustellen, dass der Flow nicht in eine Endlosschleife eintritt.
• Vorgeschlagene Problemlösung: Beseitigen Sie alle rekursiven Aufrufe zwischen den Subflows.

Variablenlänge überschritten

• Schweregrad: Warnung
• Typ: Verwaltbarkeit
• Fehlerdetails: Der Name der Variablen überschreitet das Limit von 40 Zeichen.
• Beschreibung: Diese Regel überprüft, ob der Name einer Variablen, die im Flow definiert ist, eine bestimmte Zahl von Zeichen überschreitet. Die Standardgenze beträgt 40 Zeichen.
• Vorgeschlagene Problemlösung: Benennen Sie alle Variablen um, die das angegebene Zeichenlimit überschreiten, um sicherzustellen, dass ihre Namen maximal 40 Zeichen enthalten.

Standardwerte für Eingabevariablen

• Schweregrad: Warnung
• Typ: Verwaltbarkeit
• Fehlerdetails: Die Eingabe-/Ausgabevariablen verwenden keine Standardwerte.
• Beschreibung: Diese Regel überprüft, ob Eingabevariablen Standardwerte verwenden. Dies stellt sicher, dass sie ordnungsgemäß für den Flow konfiguriert sind.
• Vorgeschlagene Problemlösung: Weisen Sie allen Eingabe- und Ausgabevariablen Standardwerte zu.

Schwellenwert für die Anzahl der Eingabe- und Ausgabevariablen

• Schweregrad: Warnung
• Typ: Verwaltbarkeit
• Fehlerdetails Die Gesamtzahl der Eingabe-/Ausgabevariablen überschreitet das Limit von 25 Variablen.
• Beschreibung: Diese Regel überprüft, ob die Gesamtzahl der Eingabe-/Ausgabevariablen im Flow einen bestimmten Schwellenwert überschreiten. Der Grenzwert ist 25 Variablen.
• Vorgeschlagene Problemlösung: Stellen Sie sicher, dass die Anzahl der Eingabe- und Ausgabevariablen im Flow die Zahl 25 nicht überschreitet.

Leere Aktion des Typs „Auf-Block-Fehler“

• Standardschweregrad: Warnung
• Typ: Design
• Fehlerdetails: Die Aktion „Auf-Block-Fehler“ ist leer und verarbeitet keine Fehler.
• Beschreibung : Diese Regel überprüft, ob die Aktionen Bei Blockfehler in Ihrem Flow ordnungsgemäß eingerichtet sind, um Fehler zu behandeln, und stellt sicher, dass Fehler wie erwartet ausgelöst und verwaltet werden.
• Vorgeschlagene Problemlösung: Um mögliche Feherl zu verwalten, richten Sie die Aktion Auf-Block-Fehler im Flow ein.

Verschachtelte Wenn-Klauseln

• Schweregrad: Warnung
• Typ: Verwaltbarkeit
• Fehlerdetails: Verschachtelte Wenn-Klauseln überschreiten fünf Ebenen.
• Beschreibung: Diese Regel überprüft, ob es verschachtelte Wenn-Anweisungen mit mehr als 5 Ebenen gibt, um sicherzustellen, dass der Flow verwaltbar und lesbar bleibt.
• Vorgeschlagene Problemlösung: Gestalten Sie den Flow um, um die Verschachtelung von wenn-Anweisungen auf maximal 5 Ebenen zu reduzieren.

Unvollständige Wenn-Klausel

• Schweregrad: Warnung
• Typ: Design
• Fehlerdetails: Unvollständige Wenn-Aktion erkannt, fehlende Inhalte oder nur die Else-Verzweigung enthält Aktionen.
• Beschreibung: Diese Regel überprüft den Flow, um wenn-Aktionen zu erkennen, denen Inhalte fehlen oder die nur Aktionen in der Else-Verzweigung enthalten, um sicherzustellen, dass bedingte Anweisungen effektiv implementiert werden.
• Vorgeschlagene Fehlerbehebung: Untersuchen Sie den Flow, und überprüfen Sie jede Wenn-Bedingung, um sicherzustellen, dass er relevante Aktionen in den If-, Else if- und Else-Verzweigungen enthält.

Endlosschleife

• Schweregrad: Warnung
• Typ: Design
• Fehlerdetails: Es wurde eine Endlosschleife im Flow erkannt, was dazu führen kann, dass sie endlos ausgeführt wird.
• Beschreibung: Diese Regel überprüft, ob es Endlosschleifen im Flow gibt. Dies hilft, Szenarien zu identifizieren und zu verhindern, in denen der Flow möglicherweise endlos ausgeführt wird.
• Vorgeschlagene Lösung: Stellen Sie sicher, dass jede Schleife eine klar definierte und erreichbare Beendigungsbedingung hat. Die Bedingung kann auf einem Zähler, einem bestimmten Wert oder dem Abschluss einer Aufgabe basieren. Fügen Sie Überprüfungen oder Ausfallsicherungsbedingungen hinzu, um die Schleife zu unterbrechen, wenn sie länger als erwartet ausgeführt wird. Legen Sie beispielsweise eine maximale Iterationsanzahl fest oder fügen Sie ein Timeout hinzu.

Falsche Verwendung von Warteaktionen

• Schweregrad: Warnung
• Typ: Leistung
• Fehlerdetails: Missbräuchliche Verwendung von Warteaktionen mit mehr als 10 Warteaktionen erkannt, was potenzielle Engpässe verursacht.
• Beschreibung: Diese Regel prüft, ob der Flow eine übermäßige Anzahl von Warteaktionen (mehr als 10) enthält, um potenzielle Engpässe durch längere Verzögerungen zu identifizieren und zu minimieren.
• Vorgeschlagene Lösung: Überprüfen Sie den Flow, um alle Warteaktionen zu identifizieren und zu prüfen, ob sie für die Logik des Flows unerlässlich sind. Entfernen Sie unnötige Wartezeiten oder kombinieren Sie sie, wenn möglich.

Erhebliche Wartezeit

• Schweregrad: Warnung
• Typ: Leistung
• Fehlerdetails: Erhebliche Wartezeit erkannt, die das Limit von 600 Sekunden für hartkodierte Warteaktionen überschreitet.
• Beschreibung: Diese Regel überprüft, ob die hartkodierten Warteaktionen im Flow einen bestimmten Zeitraum überschreiten. Das Standardlimit ist auf 600 Sekunden festgelegt.
• Vorgeschlagene Lösung: Überprüfen Sie den Flow, um Warteaktionen zu finden, die das 600-Sekunden-Limit überschreiten. Prüfen Sie, ob diese langen Wartezeiten erforderlich sind, und passen Sie ihre Dauer auf die kürzeste Zeit an, die erforderlich ist, damit der Flow ordnungsgemäß funktioniert. Wenn eine lange Wartezeit erforderlich ist, teilen Sie sie in kürzere Intervalle auf, und fügen Sie dazwischen Prüfungen oder Bedingungen hinzu. Ersetzen Sie nach Möglichkeit Warteaktionen durch ereignisgesteuerte Trigger.

Unerreichte Aktionen

• Schweregrad: Warnung
• Typ: Verwaltbarkeit
• Fehlerdetails: Mindestens eine Aktion im Flow ist nicht erreichbar und wird unter keinen Umständen ausgeführt.
• Beschreibung: Diese Regel sucht nach Aktionen im Flow, die logisch nicht erreichbar sind. Nicht erreichbare Aktionen können aus falschen Verzweigungen, falsch platzierten Bedingungen oder getrennten Segmenten resultieren und auf Fehler in der Logik oder Struktur des Flows hinweisen.
• Vorgeschlagene Lösung: Überprüfen Sie den Flow, um Aktionen zu finden, die nicht mit einem Ausführungspfad verbunden sind. Stellen Sie sicher, dass jede Aktion über eine gültige Logikverzweigung oder Schleife erreichbar ist. Entfernen oder verschieben Sie nicht erreichbare Aktionen, um den Flow sauber und effizient zu halten.

Bekannte Einschränkungen

• Nur für verwaltete Umgebungen verfügbar.
• Die Regelanpassung beschränkt sich auf das Aktivieren oder Deaktivieren von Regeln und das Konfigurieren des Schweregrads.

Bekannte Probleme

• Das Löschen kopierter Aktionen nach dem Anzeigen eines Regelverstoßdetails kann unbehandelte Fehler auslösen.
• Die Verwendung einer nicht vertraulichen Kennwortvariablen in den folgenden Aktionen führt dazu, dass die statische Analyse während der Regelauswertung fehlschlägt.
  • Eingabedialogfeld anzeigen
  • Dialogfeld „Ordner auswählen“ anzeigen
  • Benutzerdefiniertes Formular anzeigen