Ablaufprüfer

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

Definieren und verwalten Sie Regeln über die Lösungsprüfung im Power Platform Admin Center und die Ablaufprüferkonfiguration im Power Automate-Portal.

Administratoren und Benutzer mit den entsprechenden Berechtigungen können:

• Regeln aktivieren oder deaktivieren.
• Konfigurieren Sie Schweregrade (Fehler, Warnung, Info).
• Konfigurieren Sie benutzerdefinierte Werte für Regeln, die Parameter unterstützen, z. B. Schwellenwerte und Grenzwerte (nur Power Automate Portal).
• Regeln auf bestimmte Umgebungen oder Umgebungsgruppen anwenden (nur verwaltete Umgebungen, Power Platform Admin Center).

Die Ablaufprüferkonfiguration gilt auf Umgebungsebene und wirkt sich auf alle Desktopflüsse innerhalb der ausgewählten Umgebung aus.

Einstellungen für die Erzwingung der Lösungsprüfung, die Sie im Power Platform Admin Center konfigurieren, haben Vorrang vor den Konfigurationseinstellungen der Flussprüfung im Power Automate-Portal. Regeln, die aufgrund der Erzwingung durch die Lösungsprüfung im Power Automate-Portal eingeschränkt sind, können nicht geändert werden.

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 bearbeiten auswählen.
4. Konfigurieren Sie im Abschnitt Lösungsprüfungs-Erzwingung, welche Regeln für die ausgewählte Umgebung ausgeschlossen werden sollen.

Konfiguration im Power Automate-Portal

So konfigurieren Sie Ablaufprüfregeln für eine Umgebung:

1. Wechseln Sie zur Seite "Desktopflüsse" im Power Automate-Portal.

2. Wählen Sie Flow checker aus.

3. Konfigurieren Sie im Konfigurationsbereich der Flussprüfung die gewünschten Regeln. Für jede Regel können Sie:

   • Aktivieren oder deaktivieren Sie die Regel.
   • Wählen Sie einen Schweregrad aus.
   • Geben Sie einen benutzerdefinierten Wert für Regeln an, die Parameter unterstützen.

4. Klicken Sie auf Speichern.

Konfigurationsänderungen werden auf Umgebungsebene angewendet und wirken sich auf alle Desktopflüsse in der ausgewählten Umgebung aus. Öffnen Sie für Desktopflüsse, die bereits im Designer geöffnet sind, den Fluss erneut, damit Konfigurationsänderungen wirksam werden.

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. Bewegen Sie den Mauszeiger über Solution checker.

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 wechselt das System zum Variablenfenster, sodass Korrekturen leicht 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 Vorkommen desselben Verstoßes zu navigieren. Diese Anleitung hilft Entwicklern, Probleme schnell und effektiv zu beheben. Bei vom Flow Checker erkannten Fehlern werden ein Inline-Indikator und ein Popup mit weiteren Details angezeigt. Warnungen werden ebenso wie Fehler direkt im Arbeitsbereich des Designers angezeigt. Der Designer zeigt Diagnosestatus wie Warnungen und Fehler auf den Registerkarten von Subflows an und enthält außerdem eine Schaltfläche, mit der Sie zu der Komponente springen können, die Ihre 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 Teilflüssen

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

Maximale 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 Standardgrenze 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 bei Blockfehler

• Standardmäßiger Schweregrad: Warnung
• Typ: Entwurf
• Fehlerdetails: Die Aktion „Bei Blockfehler“ ist leer und behandelt keine Fehler.
• Beschreibung: Diese Regel überprüft, ob die Aktionen „On block error“ in Ihrem Flow korrekt konfiguriert sind, um Fehler zu behandeln, und stellt sicher, dass Fehler wie erwartet ausgelöst und behandelt werden.
• Vorgeschlagene Lösung: Um mit möglichen Fehlern umzugehen, richten Sie im Ablauf die Aktionen für On block error 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 Korrektur: Überarbeiten Sie den Ablauf, um die Verschachtelung von if-Anweisungen auf höchstens fünf Ebenen zu reduzieren.

Unvollständig, wenn

• Schweregrad: Warnung
• Typ: Entwurf
• Fehlerdetails: Unvollständige Wenn-Aktion erkannt: ohne Inhalt oder mit Aktionen nur im Else-Zweig.
• Beschreibung: Diese Regel erkennt If-Aktionen, denen Inhalt fehlt oder die nur Aktionen im Else-Zweig enthalten, und stellt so sicher, dass bedingte Anweisungen effektiv implementiert werden.
• Empfohlene Korrektur: Gehen Sie den Flow durch und überprüfen Sie jede „If“-Bedingung, um sicherzustellen, dass sie sowohl in den Verzweigungen „If“, „Else if“ als auch „Else“ aussagekräftige Aktionen 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 Prüfungen oder Sicherheitsbedingungen hinzu, um die Schleife abzubrechen, wenn sie länger als erwartet läuft. 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.

Nicht erforderlicher Unterfluss

• Schweregrad: Warnung
• Typ: Verwaltbarkeit
• Fehlerdetails: Die Regel hat einen Unterfluss erkannt, der keine Aktionen enthält, nur deaktivierte Aktionen oder zu wenige Aktionen enthält, um die Trennung zu rechtfertigen. Solche Unterflüsse tragen möglicherweise nicht sinnvoll zur Ausführung des Flusses bei und können die Übersichtlichkeit beeinträchtigen.
• Beschreibung: Diese Regel sucht nach Unterflüssen, die entweder leer oder übermäßig minimal sind – in der Regel mit weniger als 5 Aktionen. Während Subflows für Modularität und Wiederverwendung nützlich sind, können solche, die keinen aussagekräftigen Inhalt oder eine Abstraktion haben, unvollständige Entwicklung, unnötige Fragmentierung oder Fehlkonfigurationen zeigen. Diese Muster können zu Verwirrung führen und die Verhaltbarkeit behindern.
• Vorgeschlagene Lösung: Überprüfen Sie den identifizierten Unterfluss, um zu bestimmen, ob er einem klaren und wertvollen Zweck dient. Wenn dies nicht der Fall ist, sollten Sie es entfernen oder in einen zugehörigen Logikblock zusammenführen. Wenn der Unterfluss für die zukünftige Verwendung vorgesehen ist, fügen Sie eine Platzhalteraktion hinzu, um ihre Rolle zu verdeutlichen und Fehlinterpretation zu verhindern.

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