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 ?

Les automatisations codées sont des automatisations créées à l'aide de code, plutôt que par des activités de glisser-déposer. Lorsque vous développez des automatisations codées, vous pouvez utiliser des services UiPath (semblables aux packages d'activités), des API d'automatisation codée (semblables aux activités), des packages .NET NuGet externes et vos classes C# personnalisées dans UiPath Studio. Cela facilite l'intégration avec des systèmes externes, des bases de données, des API et d'autres services. Les automatisations codées peuvent être de trois 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 didacticiel, nous utilisons l'API d'automatisation codée RandomNumber pour générer des nombres décimaux aléatoires dans la plage spécifié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 nous effectuons des additions ou des soustractions 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 d'utiliser l'API d'automatisation codée RandomNumber du service Testing (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 une méthode personnalisée dans un fichier source de code distinct, vous pouvez alors la créer dans le workflow codé ou l'incident de test codé, mais en dehors de la méthode Execute().

2. À l'intérieur de la méthode Execute, utilisez l'API d'automatisation codée 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 écriviez du code, à l'aide d'API d'automatisation codées disponibles via les services UiPath et d'autres classes C# personnalisées ou bibliothèques de classes nuget.org.NET disponibles dans le flux.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 d'automatisation codées 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#.

   

Consultez la page À propos de l'analyseur de workflow pour en savoir plus sur l'analyseur de workflow. 2. Dans le ruban Debug, cliquez sur Debug le fichier pour déboguer le fichier de workflow codé et rechercher les incohérences au moment du Runtime.

3. Dans le ruban Débogage (Debug) ou Conception (Design), cliquez sur Débogage (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 dans le ruban Conception. La boîte de dialogue Publier le processus apparaît. 5. Dans l'onglet Options de publication, sélectionnez l'emplacement de publication du projet. Les options disponibles dépendent du type de projet que vous publiez.

Pour Processus :

• Flux des Processes du locataire d'Orchestrator, Flux de l'espace de travail personnel d'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