Übergang von C# zu JavaScript-Ausdrücken

Zweck

Auf dieser Seite können Sie vorhandene Maestro-Prozesse von C#-Ausdrücken zu JavaScript-Ausdrücken verschieben.UiPath stellt C# als Ausdruckssprache in Maestro ein, um eine einheitliche Skripterfahrung, eine moderne Syntaxhervorhebung und eine breitere Kompatibilität mit anderen Automation Cloud-Komponenten zu bieten.

Warnung:

C#-Ausdrücke sind veraltet. Maestro zeigt jetzt eine Veraltungswarnung für alle C#-Ausdrücke an, einschließlich des geplanten Entfernungsdatums.

JavaScript ist die Standard-Ausdruckssprache für alle neuen Maestro-Entwicklungen.

Was diese Änderung bedeutet

• C#-Ausdrücke funktionieren weiterhin und werden vollständig unterstützt, bis sie in einer zukünftigen Version offiziell entfernt werden.
• Neue Maestro-Projekte und Funktionen verwenden jetzt standardmäßig JavaScript-Ausdrücke.
• Wir empfehlen, vorhandene Ausdrücke zu JavaScript zu migrieren, um die Vorwärtskompatibilität zu gewährleisten.

Wenn Sie eine gelbe Warnung sehen, bedeutet dies, dass Ihr Projekt derzeit den älteren C#-Ausdrucks-Editor verwendet.Sie können weiterhin mit Ihren vorhandenen Ausdrücken arbeiten, wir empfehlen jedoch, mit der Migration zu JavaScript zu beginnen.

Die wichtigsten Unterschiede auf einen Blick

Konzept	C#-Syntax	JavaScript-Syntax	Hinweise
Zeichenfolgenverkettung	"Hello " + name	"Hello " + name	In beiden Sprachen identisch.
Groß-/Kleinschreibungskonvertierung	userName.ToUpper()	userName.toUpperCase()	Der Methodenname verwendet Kleinbuchstaben toUpperCase.
Gleichheit	amount == 100	amount === 100	Verwenden Sie === für strenge Gleichheit.
Null oder leer	string.IsNullOrEmpty(x)	!x oder x === ""	JavaScript behandelt null und undefined als falsch.
Länge der Sammlungen	items.Count	items.length	Eigenschaftsname unterscheidet sich.
Bedingter Ausdruck	amount > 5000 ? "High" : "Low"	amount > 5000 ? "High" : "Low"	Dieselbe Syntax in beiden Sprachen.
string-Interpolation	$"Hello {name}"	`Hello ${name}`	Verwenden Sie Backticks (`) für Vorlagenliterale.
Aktuelles Datum	DateTime.Now	new Date()	Verwenden Sie das JavaScript-DateObject.
Math	Math.Round(x)	Math.round(x)	Funktionsnamen werden in JavaScript in Kleinbuchstaben geschrieben.

Wie man vorhandene Ausdrücke aktualisiert

Um einen C#-Ausdruck zu JavaScript zu migrieren, öffnen Sie den Ausdruckseditor für jede betroffene Eigenschaft und passen Sie die Syntax mit den Entsprechungen in der obigen Tabelle an.

1. Öffnen Sie den Ausdrucks-Editor für jede betroffene Eigenschaft oder Gateway-Bedingung.

2. Kopieren Sie den C#-Ausdruck und passen Sie ihn mithilfe von JavaScript-Syntax an (siehe Tabelle Schlüsselunterschiede auf einen Blick).

3. Verwenden Sie „Test“ im Editor, um das Ergebnis zu bestätigen.

4. Speichern Sie Ihren Prozess und veröffentlichen Sie ihn erneut.

   Ergebnis: Die Ausdrücke werden auf JavaScript-Syntax aktualisiert und der Prozess ist ohne Veraltungswarnungen für die Veröffentlichung bereit.

Tipp:

Validieren Sie bei der Migration komplexer Formeln Variablennamen und stellen Sie sicher, dass alle String-Vergleiche verwenden===.

Beispielmigration

Vorher (C#)

vars.total = items.Sum(x => x.Price);
if (vars.total > 10000) vars.priority = "High";

Nach (JavaScript)

vars.total = items.reduce((sum, x) => sum + x.Price, 0);
if (vars.total > 10000) vars.priority = "High";

Häufig verwendete Äquivalente.

Häufige Aktion	C#	JavaScript
Aktivieren Sie mehrere Bedingungen	(a && b) || c	(a && b) || c
Parsenummer	int.Parse(x)	parseInt(x)
In string konvertieren	value.ToString()	String(value)
Auf 2 Dezimalstellen aufrunden	Math.Round(x, 2)	Number(x.toFixed(2))
Vergleichen unter Berücksichtigung der Groß- und Kleinschreibung.	name.Equals("UIPath", StringComparison.OrdinalIgnoreCase)	name.toLowerCase() === "uipath"

Tipps zum Testen

• Verwenden Sie die Schaltfläche „Testen“ im Ausdrucks-Editor, um Ausgaben zu bestätigen.
• Achten Sie auf Unterschiede bei der Null-Verarbeitung und der Typumwandlung (=== vs ==).
• Strings und Zahlen werden automatisch in JavaScript konvertiert; verwenden Sie explizite Casts, wenn die Genauigkeit kritisch ist.

Nächste Schritte

• Beginnen Sie mit dem Schreiben neuer Ausdrücke in JavaScript.
• Aktualisieren Sie vorhandene Prozesse im Laufe der Zeit mithilfe dieses Leitfadens.
• Planen Sie die Migration entweder mit Autopilot oder der manuellen Übersetzung.
• Verfolgen Sie zukünftige Versionshinweise zur eventuellen Entfernung von C#-Ausdrücken.