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 – werden zum Entwerfen von Workflows im Code verwendet.
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 Codequelle erstellen möchten, können Sie sie innerhalb des codierten Workflows oder des codierten Testfalls, aber außerhalb der Execute()Methode erstellen.

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:

Write coded automations using UiPath services, custom C# classes, and .NET libraries from nuget.org. In coded automations, services function like activity packages in low-code automations. Key services include System.Activities, UiAutomation.Activities, and Testing.Activities.

3. Create an If statement that adds the numbers if both are even, or subtracts them if at least one is odd. Print both results to the console using Console.WriteLine.

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. In the Design ribbon, select Analyze File and then Validate File to check the coded workflow file for C# compiler errors.

   

Visit About Workflow Analyzer to read about the Workflow Analyzer. 2. In the Debug ribbon, select Debug File to debug the coded workflow file and check for inconsistencies at runtime.

3. Either in the Debug or Design ribbon, select Debug File then Run File, to run the coded workflow file that you created. 4. Select Publish in the Design ribbon. The Publish Process dialog appears. 5. In the Publish options tab, select where to publish the project. The available options depend on the type of project you are publishing.

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. Select Publish. A NUPKG file is created and uploaded to Orchestrator, the custom NuGet feed, or saved in the local directory.

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