Schnellstartanleitung

Diese Schnellstartanleitung hilft Ihnen bei der Arbeit mit codierten Automatisierungen. In einem Tutorial erfahren Sie, wie Sie codierte Automatisierungen erstellen. Es zeigt, wie Sie einen codierten Workflow erstellen, der Zufallszahlen zwischen 1 und 100 generiert und Addition oder Subtraktion durchführt, je nachdem, ob die Zahlen gerade oder ungerade sind.

Was sind codierte Automatisierungen?

Codierte Automatisierungen werden mithilfe von Code und nicht per Drag-and-Drop-Aktivitäten erstellt. Bei der Entwicklung codierter Automatisierungen können Sie UiPath-Dienste (entsprechend den Aktivitätspaketen), codierte Automatisierungs-APIs (ähnlich wie Aktivitäten), externe .NET NuGet-Pakete und Ihre benutzerdefinierten C#-Klassen in UiPath Studio verwenden.Dadurch ist die Integration in externen Systeme, Datenbanken, APIs und andere Dienste. Es gibt drei typen an codierten Automatisierungen:

1. Codierte Workflows – Zum Entwerfen von Workflows in Code.
2. Codierte Testfälle – Zum Entwerfen von Testfällen.
3. Codequelldateien– Zum Erstellen von Code, den Sie später in anderen codierten Dateitypen aufrufen können.

Weitere Informationen finden Sie in der Einführung für codierte Automatisierungen.

Szenario

In diesem Tutorial generieren wir mithilfe der codierten Automatisierungs-API RandomNumber zufällige Dezimalzahlen innerhalb des angegebenen Bereichs. Wir überprüfen dann mit einer benutzerdefinierten Methode mit dem Namen IsEven, ob die generierten Zahlen gerade sind, und führen basierend auf dieser Bedingung Addition oder Subtraktion durch.

Erstellen des codierten Workflows

Erstellen Sie den codierten Workflow in Ihrem Studio-Projekt und installieren Sie die erforderlichen Abhängigkeiten.

1. Installieren Sie Testing.Activities 23.10, da das Szenario die Verwendung der codierten Automatisierungs-API RandomNumber aus dem Testing-Dienst beinhaltet.
2. Erstellen Sie einen codierten Workflow, indem Sie Neu und dann Codierter Workflow in der Gruppe Datei auswählen.
   Codierte Automatisierungen sind mit Namespaces, Hilfsklassen und Einstiegspunktmethoden strukturiert. Die Basisklasse CodedWorkflow wird sowohl für codierte Workflows als auch für Testfälle verwendet und bietet Zugriff auf die erforderlichen Schnittstellen und Dienste. Die Einstiegspunktmethode namens Execute() ist für die Ausführung dieser Automatisierungen entscheidend und kann mit Eingabe- und Ausgabeargumenten angepasst werden.
   
   

   

   
   

Entwerfen des codierten Workflows

Schreiben Sie den Code in der Studio IDE, die aus einem eigenen Code-Editor, Dateiregisterkarten und Breadcrumbs für die einfache Navigation besteht.

1. Erstellen Sie im codierten Workflow, aber außerhalb der Execute()-Methode, eine benutzerdefinierte Methode namens IsEven.
   Diese Methode gibt einen boolean-Wert zurück, der angibt, ob die eingegebene decimal-Variable eine gerade Zahl ist oder nicht.
   Sehen Sie sich das Code-Beispiel unten an:

   private bool IsEven(decimal number)
           {
              // Check if a decimal number is even
           return (number % 2 == 0);
           }

   Tipp: Wenn Sie keine benutzerdefinierte Methode in einer separaten Codequelldatei erstellen möchten, können Sie sie innerhalb des codierten Workflows oder codierten Testfalls erstellen, jedoch außerhalb der Execute()-Methode.
2. Anhand der Methode Execute können Sie mithilfe der Automatisierungs-API RandomNumber zwei decimalVariablen mit einem Zufallswert erstellen und diese in der Konsole mithilfe von Console.WriteLine ausgeben.
   Sehen Sie sich das Code-Beispiel unten an:

   // Generate random numbers within a specified range (e.g., 1 to 100)
           decimal num1 = testing.RandomNumber(1, 100);
           decimal num2 = testing.RandomNumber(1, 100);
               
           Console.WriteLine($"Generated numbers: {num1} and {num2}");

   Hinweis: Codierte Automatisierungen wie Code werden mithilfe von codierten Automatisierungs-APIs geschrieben, die über UiPath-Dienste verfügbar sind, und andere benutzerdefinierte C#-Klassen oder .NET-Klassenbibliotheken, die im nuget.orgFeed verfügbar sind.In codierten Automatisierungen entsprechen Dienste Aktivitätspaketen, die in Low-Code-Automatisierungen verwendet werden. Diese Dienste wie System.Activities, UiAutomation.Activities und Testing.Activities verfügen über codierte Automatisierungs-APIs, die Sie zur Erstellung codierter Automatisierungen verwenden können.
3. Erstellen Sie eine If-Anweisung mit der Bedingung, dass, wenn beide Zahlen gerade sind, die Automatisierung sie zusammen addieren soll. Die Else-Klausel sollte die Zahlen subtrahieren, wenn mindestens eine von ihnen ungerade ist. Beide Ergebnisse sollten in der Konsole mit Console.WriteLine ausgegeben werden.
   Sehen Sie sich das Code-Beispiel unten an:

   if (IsEven(num1) && IsEven(num2))
           {
               // Both numbers are even, so add them together
               decimal sum = num1 + num2;
               Console.WriteLine($"Both numbers are even. Sum: {sum}");
           }
           else
           {
               // At least one number is odd, so subtract them
               decimal difference = num1 - num2;
               Console.WriteLine($"At least one number is odd. Difference: {difference}");
           }

Verwalten des codierten Workflowprozesses

Nachdem Sie einen codierten Workflow erstellt und entworfen haben, können Sie ihn mithilfe der Workflow-Analyse validieren, debuggen, ausführen und dann im Orchestrator veröffentlichen.

1. Klicken Sie im Menüband Design auf Datei analysieren und dann auf Datei validieren, um die codierte Workflowdatei auf C#-Compilerfehler zu überprüfen.
   
   

   

   
   
   Weitere Informationen über die Workflow-Analyse finden Sie unter Über die Workflow-Analyse.
2. Klicken Sie im Menüband Debuggen auf Datei debuggen, um die codierte Workflowdatei zu debuggen und zur Laufzeit auf Inkonsistenzen zu überprüfen.
   
   

   

   
   
3. Klicken Sie im Menüband Debuggen oder Design auf Datei debuggen und dann auf Datei ausführen, um die codierte und von Ihnen erstellte Workflowdatei auszuführen.
4. Wählen Sie Veröffentlichen im Menüband Design aus.
   Das Dialogfeld Prozess veröffentlichen wird angezeigt.
5. Wählen Sie auf der Registerkarte Veröffentlichungsoptionen aus, wo das Projekt veröffentlicht werden soll. Die verfügbaren Optionen hängen vom Typ des Projekts ab, das Sie veröffentlichen.
   Für Prozesse:

   • Orchestrator-Feed mit Mandantenprozessen, Orchestrator-Feed für persönlichen Arbeitsbereich
   • Assistent (Roboterstandards): der Standardpaketspeicherort für den Roboter und Assistenten, C:\ProgramData\UiPath\Packages. Die hier veröffentlichten Projekte werden automatisch im Assistenten angezeigt. Die Option ist nicht verfügbar, wenn Studio mit Orchestrator verbunden ist. Diese Optionen stehen zur Verfügung, wenn Studio mit dem Orchestrator verbunden ist.
   • Benutzerdefiniert: entweder eine benutzerdefinierte NuGet-Feed-URL oder ein lokaler Ordner. Das Hinzufügen eines API-Schlüssels ist optional.
6. Klicken Sie auf Veröffentlichen.
   Eine NUPKG-Datei wird erstellt und in den Orchestrator oder in den benutzerdefinierten NuGet-Feed hochgeladen oder im lokalen Verzeichnis gespeichert.

Beispielprojekt

Um die Schritte dieses Tutorials auszuführen und es selbst auszuprobieren, können Sie sich das folgende Beispielprojekt herunterladen: Erster codierter Workflow.

Nächste Schritte

Sehen Sie sich die folgenden Ressourcen an, um Ihr Wissen über codierte Automatisierungen zu erweitern:

• Studio IDE
• Arbeiten mit Eingabe- und Ausgabe- Argumenten
• Best Practices
• Arbeiten mit codierten Automatisierungen
• Tutorials