Code aufrufen (Invoke Code)

UiPath.Core.Activities.InvokeCode

Beschreibung

Ruft VB.NET- oder C#-Code synchron auf und übergibt optional eine Liste von Eingabeargumenten. Diese Aktivität kann auch Argumente an den aufrufenden Workflow zurückgeben.

Hinweis: Die „Invoke Code“-Aktivität aus Paket UiPath.System.Activities Version 21.10 ist nur mit UiPath Studio 21.10 oder neueren Versionen kompatibel.

Hinweis: Um zu funktionieren, müssen die von Ihrem Code referenzierten Assemblys im Importe-Bereich hinzugefügt werden. Weitere Informationen finden Sie hier.

Hinweis: Aufgrund interner Änderungen wird diese Aktivität nach dem Upgrade auf v20.4 oder neuere Versionen nicht mehr in der Favoritenliste angezeigt, wenn sie mit v19.4 oder einer älteren Version von UiPath.System.Activities zur Favoritenliste hinzugefügt wurde.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Plattformübergreifende Konfiguration

• Code – Der Code, der aufgerufen werden soll. Dieses Feld unterstützt nur Strings und String-Variablen.
• Sprache – Ein Dropdownmenü, mit dem angegeben wird, in welcher Sprache der aufgerufene Code geschrieben ist. Die verfügbaren Optionen sind VBNet und CSharp.
• Argumente (Arguments) - Die Parameter, die dem aufgerufenen Code übergeben werden können.

Windows – Legacy, Windows-Konfiguration

Eigenschaften-Panel

Allgemein

• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld also leer ist und ein Fehler auftritt, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts unabhängig von einem Fehler fortgesetzt.
  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf True gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• Argumente (Arguments) - Die Parameter, die dem aufgerufenen Code übergeben werden können.
• Code – Der Code, der aufgerufen werden soll. Dieses Feld unterstützt nur Strings und String-Variablen.
• Sprache – Ein Dropdownmenü, mit dem angegeben wird, in welcher Sprache der aufgerufene Code geschrieben ist. Die verfügbaren Optionen sind VBNet und CSharp.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Verwendungsbeispiel der „Invoke Code“-Aktivität

Die Invoke Code-Aktivität wird verwendet, um vb.net-Code direkt von der UiPath-Plattform abzurufen. Mit dieser Aktivität können Sie genau angeben, welcher Code ausgeführt werden soll und welche Argumente an die Aktivität und von ihr übertragen werden sollen.

So kann der Automatisierungsprozess erstellt werden:

1. Öffnen Sie Studio und erstellen Sie einen neuen Prozess.

2. Ziehen Sie eine Sequence in den Workflow-Designer.

   • Erstellen Sie die folgenden Variablen:

     Variablenname	Variablentyp	Standardwert
     ExampleInArgument	String
     OutValue	Int32

3. Ziehen Sie eine Assign-Aktivität in den Sequence-Container.

   • Fügen Sie die Variable ExampleInArgument in das Feld An ein und den Ausdruck "Example for In Arguments" in das Feld Wert.

4. Fügen Sie eine Invoke Code-Aktivität unter die Assign-Aktivität ein.

   • Wählen Sie die Schaltfläche Code bearbeiten aus, um den gewünschten Code einzubauen.

   • Geben Sie den Code in das Code-Editor-Fenster ein. Für dieses Beispiel haben wir einen einfachen Code hinzugefügt, der einen String auf den Bildschirm schreibt. Hier ist der Code, den wir verwendet haben:

     Dim TextToWrite As String
     TextToWrite = "Example"
     Console.WriteLine(TextToWrite)

   • Wählen Sie die Schaltfläche OK aus, um das Code-Editor-Fenster zu schließen.

   • Wählen Sie die Schaltfläche Argumente bearbeiten aus und erstellen Sie die folgenden Argumente:

     Argument name	Argumentrichtung	Argumenttyp	Argumentwert
     ExampleInArgument	in	String	ExampleInArgument
     ExampleOutArgument	Aus	Int32	OutValue

   • Wählen Sie die Schaltfläche OK aus, um das Fenster Aufgerufene Code-Argumente zu schließen.

5. Setzen Sie eine Write Line-Aktivität unter die Invoke Code-Aktivität.

   • Fügen Sie den Ausdruck OutValue.ToString in das Feld Text ein.
6. Führen Sie den Prozess aus. Der Roboter zeigt im Ausgabe-Bereich den Code und die Argumente an, die Sie in der Invoke Code-Aktivität angegeben haben.

Beispiel herunterladen