Low-Code-Anzeige

Low-Code-Anzeige, die Studio-Erweiterung, die codierte C#-Workflows als visuelle Low-Code-Arbeitsfläche neben dem Quellcode rendert.

Der Low-Code-Viewer ist eine Studio-Erweiterung, die einen codierten Workflow – eine .cs -Datei, deren Klasse von CodedWorkflow abgeleitet ist – als visuellen Low-Code-Workflow neben seinem Quellcode rendert, so wie der klassische RPA-Designer einen anzeigt Automatisierung.

Sie richtet sich an Entwickler, die codierte Workflows schreiben und eine saubere, lesbare visuelle Ansicht ihrer Automatisierung möchten, ohne den C#-Code zu verlassen.

Hinweis:

Die Low-Code-Anzeige befindet sich in der Vorschau. Sie wird als Visual Studio Code-Erweiterung (VS Code) auf dem Open VSX Marketplace verteilt und erfordert die neueste Studio-Version. Sie können sie über den Bereich „Erweiterungen“ in Studio installieren.

Was der Betrachter tut

Der Viewer stellt zwei synchronisierte Ansichten eines codierten Workflows bereit, hält sie mit dem Quellcode synchronisiert und bezieht die Aktivitätenpalette aus Ihrem Projekt.

Workflow-Ansicht

Eine Struktur im Studio-Stil, die die gesamte Datei abdeckt. Jede Methode erhält einen Abschnitt mit ihren Variablen und eine Zeile pro Anweisung mit geschachtelten Containern für if, foreach, try, und ähnliche Konstrukte.

Diagrammansicht

Ein Flussdiagramm der Eingabemethode des Workflows – die markierte Methode mit [Workflow] oder Execute. Bedingungen und Schalter werden zu Entscheidungsknoten, die sich pro Verzweigung verteilen, Schleifen werden iteriert und ausgeführt, und Aufrufe Ihrer eigenen Methoden werden als einzelne Invoke-Blöcke angezeigt. Das Diagramm spiegelt die Form Ihrer Eingabemethode wider.

Der Quelle wird in beide Arten gefolgt

Durch Verschieben des Cursors im Editor wird der übereinstimmende Block ausgewählt und durch Auswählen eines Blocks wird zu seiner Zeile gesprungen. Eigenschaftsänderungen, die im Bereich vorgenommen werden, werden mit minimalen Änderungen in die C#-Datei zurückgeschrieben, sodass Kommentare und Formatierung erhalten bleiben.

Die Aktivitätspalette

Wenn der Betrachter innerhalb von Studio ausgeführt wird, wird der Satz von Aktivitäten – zusammen mit ihren Eigenschaftseditoren, Anzeigenamen und Symbolen – live aus den Paketen angezeigt, auf die Ihr Projekt verweist. In einfachem VS-Code und ohne Studio werden Dienstaufrufe immer noch als Karten gerendert, jedoch mit generischen Beschriftungen und ohne Rich-Eigenschaft-Metadaten.

Wie der Betrachter Ihren Code liest

Die Arbeitsfläche wird Anweisung für Anweisung erstellt. Jede Anweisung ist entweder einem eigenen Block zugeordnet oder greift auf einen unformatierten Codeblock zurück. Aufeinanderfolgende nicht erkannte Anweisungen werden in einer einzigen Codeblockkarte zusammengeführt, sodass eine Ausführung nicht unterstützten Codes in einem undurchsichtigen Feld zusammengefasst wird.

Der Betrachter schreibt nie Code neu, den Sie nicht bearbeitet haben: Alles, was er nicht erkennt, wird wörtlich in einer Codeblockkarte und Round Trips unverändert angezeigt. Nichts, was Sie schreiben, geht verloren, aber je mehr von Ihrem Code, der in Codeblöcke fällt, desto weniger wird auf der Arbeitsfläche angezeigt.

Konstrukte, die als Blöcke dargestellt werden

Sie schreiben	Sie erhalten
system.GetAsset(...), excel.ReadRange(...), weitere Serviceaufrufe	Aktivitätskarte mit Symbol, Anzeigename, bearbeitbaren Eigenschaften und typisierter Ausgabe
Log(...), Delay(...), throw ...	Integrierte Aktivitätskarten (Protokollmeldung, Verzögerung, Auslösen)
var x = <expr>;, int x = 0;, x = <expr>;	Karte zuweisen („Zu Variable“ und „Wert“)
count++;, count += 5;	Karte erhöhen oder verringern
if / else if / else	Verzweigungscontainer; Entscheidungs Variablen mit den Kanten „true“ und „false“ im Diagramm
foreach, for, while, do ... while	Schleifencontainer; einen Schleifenknoten mit einer iterierten hinteren Kante im Diagramm
try / catch / finally	Versuchen Sie es mit einem Fehlerpfad
switch Anweisung	Container wechseln mit einem Fallzweig pro Zweig; im Diagramm eine Entscheidung mit einer beschrifteten Edge pro Fall
using (...) { }, lock (...) { }	Scope-Frame
return <expr>;, throw <expr>;	Zeile zurückgeben oder Karte senden; im Diagramm beenden beide den Pfad
MyHelper(...) (Methode in derselben Datei)	Block aufrufen; Wählen Sie diese aus, um die Hilfe zu öffnen
Helpers.Method(...) (Klasse in einer anderen Datei)	Rufen Sie den Block mit dateiübergreifender Navigation auf
workflows.MyWorkflow(...)	Karte „Invoke Workflow“ mit Abzeichen für In- und Out-Argumente
#region Name ... #endregion	Benannte, reduzierbare Gruppe in beiden Ansichten

Konstrukte, die auf einen Codeblock zurückgreifen

Konstruktieren	Warum die Arbeitsfläche begrenzt ist
Lambdas auf Anweisungsebene (rows.ForEach(r => ...)) und Logik innerhalb von Lambdas	Der Lambda-Textkörper ist für die Arbeitsfläche unsichtbar
Lokale Funktionen (void Helper() { ... } innerhalb einer Methode)	Der gesamte Funktionstext wird in den Codeblock aufgenommen
Deklarationen ohne Initialisierung (string name;)	Wird als eine Codeblockzeile gerendert
Deklarationen mit mehreren Variablen (int a = 1, b = 2;)	Wird als eine Codeblockzeile gerendert
using var x = ...; (Erklärungsformular)	Wird als eine Codeblockzeile gerendert und Aufrufe von x verlieren die Aktivitätserkennung
arr[i] = value;, total *= 2;, msg += suffix;	Wird als eine Codeblockzeile gerendert

Informationen darüber, wie viel von Ihrem Workflow wie möglich auf der Arbeitsfläche gespeichert werden kann, finden Sie unter Schreiben von codierten Workflows für Canvas.

Zugehörige Inhalte

• Schreiben von Canvas-freundlichen codierten Workflows
• Einführung in codierte Automatisierungen
• Best Practices