Guide de démarrage rapide

Ce guide de démarrage rapide vous aide à vous lancer dans l'utilisation d'automatisations codées. Vous apprendrez à créer des automatisations codées en suivant un tutoriel qui vous montrera comment créer un workflow codé qui génère des nombres aléatoires entre 1 et 100 et effectue des opérations d'ajout ou de soustraction selon que les nombres sont pairs ou impairs.

Que sont les automatisations codées ?

Coded automations are automations created using code, instead of drag-and-drop activities. When developing coded automations, you can use UiPath^® services (equal to activity packages), APIs (similar to activities), external .NET NuGet packages, and your custom C# classes in UiPath Studio. This makes it easy to integrate with external systems, databases, APIs, and other services. Coded automations can be of three types:

1. Workflows codés : utilisés pour concevoir des workflows dans le code.
2. Cas de test codés : utilisés pour concevoir des cas de test.
3. Fichiers source du code : utilisés pour créer du code que vous pouvez appeler ultérieurement dans d'autres types de fichiers codés.

Visitez la page Introduction aux automatisations codées pour en savoir plus.

Scénario

Dans ce tutoriel, nous utilisons l’API NombreAléatoire (RandomNumber) pour générer des nombres décimaux aléatoires dans la plage indiquée. Nous vérifions ensuite si les nombres générés sont pairs, à l’aide d’une méthode personnalisée nommée IsEven, et effectuons une addition ou une soustraction en fonction de cette condition.

Créer un workflow codé

Créez le workflow codé dans votre projet Studio et installez les dépendances nécessaires.

1. Installez Testing.Activities 23.10, car le scénario implique l'utilisation de l'API RandomNumber du service de test.
2. Créez un workflow codé en sélectionnant Nouveau (New), puis Workflow codé (Coded Workflow) à partir du groupe Fichier (File).
   Les automatisations codées sont structurées avec des espaces de noms, des classes d'aide et des méthodes de point d'entrée. La classe de base, CodedWorkflow, est utilisée à la fois pour les workflows codés et les cas de test, et elle fournit l'accès aux interfaces et services nécessaires. La méthode du point d'entrée, nommée Execute(), est cruciale pour l'exécution de ces automatisations et peut être personnalisée avec des arguments d'entrée et de sortie.
   
   

   

   
   

Concevoir le workflow codé

Écrivez le code dans Studio IDE qui se compose d'un éditeur de code dédié, d'onglets de fichiers et de barres de navigation pour une navigation facile.

1. Dans le workflow codé, mais en dehors de la méthode Execute(), créez une méthode personnalisée nommée IsEven.
   Cette méthode renvoie une valeur boolean, qui indique si la variable decimal saisie est un nombre pair ou non.
   Consultez l'exemple de code ci-dessous :

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

   Astuce : si vous ne souhaitez pas créer de méthode personnalisée dans un fichier de source de code distinct, vous pouvez alors la créer dans le workflow codé ou le cas de test codé, mais en dehors de la méthode Execute().
2. À l'intérieur de la méthode Execute, utilisez l'API RandomNumber pour créer deux variables decimal avec une valeur aléatoire et imprimez-les dans la console à l'aide de Console.WriteLine.
   Consultez l'exemple de code ci-dessous :

   // 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}");

   Remarque : vous écrivez des automatisations codées comme vous le feriez pour écrire du code, en utilisant les API disponibles via les services UiPath et d'autres classes C# personnalisées ou des bibliothèques de classes .NET disponibles à partir du flux nuget.org. Dans les automatisations codées, les services sont équivalents aux packages d'activités utilisés dans les automatisations low-code. Ces services, tels que System.Activities, UiAutomation.Activities et Testing.Activities, sont fournis avec des API que vous pouvez utiliser pour créer des automatisations codées.
3. Créez une instruction If, avec la condition que si les deux nombres sont pairs, l'automatisation doit les ajouter. La clause Else doit soustraire les nombres, si au moins l'un d'entre eux est impair. Les deux résultats doivent être imprimés dans la console à l'aide de Console.WriteLine.
   Consultez l'exemple de code ci-dessous :

   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}");
           }

Gérer le processus de workflow codé

Après avoir créé et conçu un workflow codé, vous pouvez le valider à l'aide de l' analyseur de workflow, le déboguer, l'exécuter, puis le publier dans Orchestrator.

1. Dans le ruban Design, cliquez sur Analyser le fichier (Analyze File), puis sur Valider le fichier (Validate File) pour vérifier le fichier de workflow codé pour les erreurs du compilateur C#.
   
   

   

   
   
   Visitez la page À propos de l'analyseur de workflow pour en savoir plus sur l'analyseur de workflow.
2. Dans le ruban Déboguer (Debug), cliquez sur Déboguer le fichier (Debug File) pour déboguer le fichier de workflow codé et vérifier les incohérences au moment de l'exécution.
   
   

   

   
   
3. Dans le ruban Déboguer ou Design, cliquez sur Déboguer le fichier (Debug File), puis sur Exécuter le fichier (Run File) pour exécuter le fichier de workflow codé que vous avez créé.
4. Sélectionnez Publier (Publish) dans le ruban Design.
   La boîte de dialogue Publier le processus (Publish Process) s'affiche.
5. Dans l'onglet Options de publication, sélectionnez où publier le projet. Les options disponibles dépendent du type de projet que vous publiez.
   Pour Processus :

   • Flux de processus de locataire Orchestrator, Flux d'espace de travail personnel Orchestrator
   • Assistant (Valeurs par défaut du Robot) : l’emplacement du package par défaut du Robot et l’Assistant, C:\ProgramData\UiPath\Packages. Les projets publiés ici apparaissent automatiquement dans l’Assistant. L’option n’est pas disponible si Studio est connecté à Orchestrator. Ces options ne sont pas disponibles si Studio est connecté à Orchestrator.
   • Personnaliser (Custom) - soit une URL de flux NuGet personnalisée, soit un dossier local. L’ajout d’une Clé API (API Key) est facultatif.
6. Cliquez sur Publier.
   Un fichier NUPKG est créé et téléchargé vers Orchestrator, vers le flux NuGet personnalisé ou enregistré dans le répertoire local.

Exemple de projet

Pour suivre les étapes de ce tutoriel et l'essayer vous-même, vous pouvez télécharger l'exemple de projet suivant : Premier workflow codé (First Coded Workflow).

Prochaines étapes

Visitez les ressources ci-dessous pour améliorer vos connaissances sur les automatisations codées :

• Studio IDE
• Utilisation d'arguments d'entrée et de sortie
• Meilleures pratiques
• Utilisation des automatisations codées
• Didacticiels