Überprüfen der Ergebnisse der Code-Analyse

Als Bot Creator (RPA-Entwickler) oder Citizen Developer können Sie Ihre Automatisierungsdateien (TaskBot oder API-Aufgabe) mithilfe der Code-Analyse auf Programmierfehler überprüfen und diese beheben. Sie können die Automatisierung auf der Grundlage von für die Code-Analyse konfigurierten Richtlinien und vordefinierten Regeln entwickeln.

Mit der Code-Analyse können Sie die Zuverlässigkeit Ihrer Automatisierungen verbessern, indem Sie empfohlene Vorgehensweisen für die Kodierung einführen, wie z. B. Namenskonventionen für Variablen, Erfassung von Kommentaren und Fehlerbehandlung. Das Erstellen von Automatisierungen nach den vordefinierten Richtlinien oder Regeln hilft Ihnen, mögliche Fehler während der Entwicklung der Automatisierungen zu erkennen. Dadurch werden Automatisierungsfehler in der Produktionsumgebung reduziert. Sie können die Code-Analyse sowohl in Ihrem privaten als auch in Ihrem öffentlichen Arbeitsbereich durchführen und die Ergebnisse anzeigen.

Mit der Code-Analyse (verfügbar über Bot Editor) erhalten Sie folgende Vorteile:
  • Sie können bei Bedarf eine Code-Analyse durchführen.
  • Quickinfos erleichtern die Einhaltung von Regeln.
  • Integration in den Assistenten für Haftung und Anleitung.

Ergebnisse der Code-Analyse

Wenn Sie die Ergebnisse der Code-Analyse anzeigen möchten, navigieren Sie zu der Seite Automatisierung und überprüfen Sie die Ergebnisse der Code-Analyse. In dieser Spalte wird eine Zusammenfassung der Ergebnisse der Code-Analyse der einzelnen Automatisierungsdateien (TaskBot oder API-Aufgabe) angezeigt. Folgende Details sind zu jedem Status verfügbar:
  • n. v. Sie erhalten den Status „nicht verfügbar“ aus einem der folgenden Gründe:
    • Die Code-Analyse wird nicht auf das Objekt angewendet, da es sich nicht um eine TaskBot- oder API-Aufgabe-Datei handelt.
    • Der Datei oder dem Ordner des TaskBots oder der API-Aufgabe ist keine Richtlinie zugewiesen. Wenn sich eine TaskBot- oder API-Aufgabe-Datei oder ein Ordner im Status n. v. befindet, werden Aktionen auf Zeilenebene für die Option „Code-Analyse ausführen“ nicht angezeigt. Die Code-Analyse wird für Automatisierungen mit dem Status n. v. nicht automatisch durchgeführt.
  • Nicht gescannt: Die Code-Analyse wurde für den TaskBot oder die API-Aufgabe nicht durchgeführt.
  • Kritisch: TaskBot oder API-Aufgabe hat einen kritischen Schweregrad überschritten.
  • Hoher Schweregrad: Der TaskBot oder die API-Aufgabe weist mindestens einen schwerwiegenden Verstoß auf.
  • Geringer Schweregrad: Der TaskBot oder die API-Aufgabe weist mindestens einen Verstoß mit niedrigem Schweregrad, aber keinen Verstoß mit hohem Schweregrad auf.
  • Keine Verstöße: Bei diesem TaskBot oder dieser API-Aufgabe liegen laut Code-Analyse keine Verstöße vor.

Das folgende Bild zeigt ein Beispiel für das Ergebnis der Code-Analyse:


Spalte mit den Ergebnissen der Code-Analyse

Anmerkung: Der Status der TaskBots oder API-Aufgaben in der Spalte mit den Ergebnissen der Code-Analyse wird bei den folgenden Szenarien auf „Nicht gescannt“ gesetzt:
  • Die Automatisierungsdatei ist im privaten Arbeitsbereich bearbeitet und noch nicht gespeichert worden.
  • Die Code-Analyse wurde vor Kurzem vom Administrator aktiviert oder es wurde eine Regelkonfiguration in der entsprechenden Richtlinie für die Automatisierungsdatei geändert, und die Datei wartet darauf, gescannt zu werden.

Überprüfung der Ergebnisse in Bot Editor

Wenn Sie eine Automatisierungsdatei (TaskBot oder API-Aufgabe) erstellen oder eine existierende Automatisierungsdatei ändern und dann im Bot Editor speichern, wird die Code-Analyse im Hintergrund gestartet und die Ergebnisse werden im Assistenten angezeigt. Im Header der Code-Analyse wird die Gesamtzahl der Verstöße in der Automatisierungsdatei angezeigt. Sie können die Option „Code-Analyse“ erweitern, ein bestimmtes Objekt auswählen und die folgenden Attribute anzeigen:
  • Anwendbares Objekt: Zeigt die Automatisierungsdatei, die Variable, die Aktion und das Attribut „Aktion“ an.
  • Regel-Code: Eindeutige RULE_CODE ID.
  • Schweregrad: Hoch oder niedrig.
  • Regel-Text: Beschreibung, welche auf die Art der Beurteilung hinweist, die am Code durchzuführenden ist.

Das folgende Bild zeigt ein Beispiel für eine Code-Analyse, die im Assistenten angezeigt wird:


Ergebnisse der Code-Analyse im Assistenten

Die Ergebnisse der Code-Analyse werden in der folgenden Reihenfolge angezeigt:
Attribut Regelverstöße
Bot
  • Obligatorischer Header-Kommentar
  • Erfassung von Kommentaren
  • Aktionsmaximum
Variable
  • Muster für Variablennamen
  • Länge von Variablennamen
  • Keine ungenutzten Variablen
Aktion
  • Keine hartcodierte Verzögerung
  • Kein hartcodierter Dateipfad
  • Keine hartcodierte E-Mail-Adresse
  • Keine leere Erfassung
  • Obligatorische Protokollierung der Erfassungen
  • Obligatorische Erfassung per Bildschirmaufzeichnung

Im Header der Code-Analyse wird die Anzahl der Objekte angezeigt, die einen Verstoß innerhalb der Automatisierungsdatei aufweisen. Jedes Objekt kann entweder einen niedrigen oder hohen Schweregrad haben. Der Verstoß wird mit dem Attribut angezeigt, gefolgt von der Zeilennummer und dem Schweregrad. Alle Fehler mit hohem Schweregrad werden zuerst angezeigt. Navigieren Sie zu der entsprechenden Zeile in der Automatisierungsdatei, die den Verstoß aufweist, beheben Sie den Verstoß und speichern Sie die Automatisierung.

Sie müssen die Automatisierungsdatei speichern, um die neuesten Ergebnisse der Code-Analyse im Assistenten anzuzeigen.

Verstöße gegen die Code-Analyse und Details zur Richtlinie im Bot Editor

Professionelle Entwickler und Citizen Developer können Verstöße gegen die Code-Analyse in Aktionen auf der Bildschirmebene einsehen. Für Ablauf- und Listenansichten ist ein Verstoßindikator verfügbar, der es professionellen Entwicklern und Citizen Developern ermöglicht, schnell alle Aktionen in ihren Automatisierungen zu erkennen und zu korrigieren, die Verstöße der Code-Analyse aufweisen. Die Codequalität wird verbessert, wenn Entwickler bei der Entwicklung von Automatisierungen Verstöße leicht feststellen und sich an bewährte Verfahren halten können.

Professionelle Entwickler und Citizen Developer müssen nicht mehr zur Seite mit den Richtlinien navigieren, um die angewandte Richtlinie und die in der Richtlinie enthaltenen Regeln anzuzeigen. Sie können die aktuelle Code-Analyse-Richtlinie und ihre Regeln direkt im Bot Editor über das Dropdown-Menü einsehen (Zugriff über die drei vertikalen Ellipsen oben rechts im Bot Editor). Dies hilft den Nutzern, die nicht über die Berechtigung Richtlinien anzeigen und Richtlinien verwalten verfügen, die aktuelle Richtlinie und ihre Regeln einzusehen, während sie die Automatisierung im Bot Editor selbst bearbeiten, anstatt nur den Verstoß zu sehen.

Option für Code-Analyse-Richtlinien im Bot-Editor

Vom System erstellte Variablen

Vom System erstellte Variablen wie Eingabe- oder Ausgabevariablen, vom Paket vorgeschlagene Variablen oder automatisch generierte Variablen (Fenstervariablen) verwenden die standardmäßige Namenskonvention für die Groß-/Kleinschreibung von Variablen aus der Code-Analyse oder Camel Case (Pascal case, Binnenmajuskel), wenn in den Regeln der Code-Analyse kein Format definiert ist.

Auditprotokoll

Wenn eine Code-Analyse entweder durch Speichern einer Automatisierungsdatei oder durch Ausführen einer Code-Analyse im Bot Editor initiiert wird, werden die Informationen im Auditprotokoll erfasst. Die folgenden Details werden erfasst:
  • Bot-Name
  • Informationen zum Nutzer
  • die Methode, durch welche die Code-Analyse eingeleitet wird (Option „Speichern“ oder Option „Code-Analyse ausführen“)
  • die Zeit, die für die Durchführung der Code-Analyse benötigt wurde, einschließlich Details wie die Anzahl von Codezeilen, wenn diese in der Code-Analyse erfasst wurde
  • Gesamtanzahl der Verstöße
  • Einzelheiten zu den Verstößen