Using the Activity Creator

Les activités sont les éléments constitutifs de l'automatisation des processus. Chacun d’entre eux contient une action atomique qui, empilée avec d’autres activités, compose un workflow.

UiPath Studio comprend un certain nombre d' activités prédéfinies que vous pouvez installer via le gestionnaire des packages.

De plus, vous pouvez créer vos propres activités personnalisées spécifiques à vos besoins à l'aide de l'extension Activity Creator d'UiPath pour Visual Studio. Les étapes ci-dessous vous donneront les bases pour créer des activités personnalisées en 5 minutes. Dans cette section, nous allons créer un package d'activités et, dans la prochaine section, le remplir avec des activités fonctionnelles.

Éléments requis

• Visual Studio Community/ProProduction/Enterprise 2022 avec le développement d'applications de bureau *.NET
• charge de travail installée
• Le flux de la Marketplace UiPath (https:// Exauthentification.uipath.com/api/v3/index.json) comme source du package dans Visual Studio. Voir ici pour les instructions sur l’ajout de sources de package.
• .NET 6
• UiPath Studio

Important :

Notez que la version 4.0 du Créateur d’activités ne fonctionne qu’avec Visual Studio 2022. De même, les activités produites ciblent les projets Windows .NET 6. Pour créer des activités compatibles avec les anciennes versions de Visual Studio ou .NET, veuillez utiliser la version 3 de l’extension.

De plus, les activités créées par cette extension reposent sur des bibliothèques créées par UiPath actuellement disponibles sur le flux de la Marketplace (https:// Exauthentification.uipath.com/api/v3/index.json). Ce flux doit être disponible dans Visual Studio pendant le développement, sinon les activités ne seront pas générées avec succès.

Étape 1 : Ajouter l’extension UiPath Activity Creator à Visual Studio

Ouvrez Visual Studio et cliquez sur Extensions > Gérer les extensions.

Dans l'assistant qui apparaît, cliquez sur En ligne, puis sur Rechercher (Ctrl+E) pour UiPath. Téléchargez l'extension UiPath Activity Creator.

Fermez Studio et, une fois que VS et Visual Installer apparaît, terminez l'installation.

Étape 2 : créer un projet UiPath

Rouvrez Visual Studio et double-cliquez sur Créer un nouveau projet sur l’écran d’accueil.

Sur l’écran Créer un nouveau projet , tapez « uipath » dans la barre de recherche, sélectionnez Projet d’activité standard UiPath) et cliquez sur Suivant.

Donnez un nom à votre projet. La convention UiPath est <Your company's name>.<Your product's name> (par exemple UiPath Orchestrator). Cliquez ensuite sur Créer.

Accédez à l' explorateur de solutions et notez que 3 projets, un dossier partagé et de nombreux fichiers ont maintenant été ajoutés à la solution. Il s'agit de la base de chaque package d'activités.L’activité simple pour ajouter votre première activité.

L'activité de base

Maintenant que votre package est créé, ajoutons-y une activité ! Dans cet exemple, vous allez créer l'activité indiquée ci-dessus : une activité simple qui additionne deux nombres.

Ce dont vous aurez besoin

• Visual Studio Community/ProProduction/Enterprise (2019 requis)
• UiPath Studio
• Utilisation de l'Activity Creator

Étape 1 : ouvrir le Créateur d'activités

Commencez par ouvrir la solution Visual Studio créée dans la section précédente et sélectionnez l'un des projets principaux dans l' Explorateur de solutions. Accédez ensuite à Extensions > UiPath > Ajouter des activités dans la barre d'outils. Notez que ce menu sera désactivé jusqu'à ce qu'un des projets soit sélectionné.

Étape 2 : créer une activité

Cela ouvrira une nouvelle fenêtre Créateur d’activité. Le premier écran vous offre deux options :

1. Créer: créez une ou plusieurs activités à partir de zéro.
2. Importer: permet d’importer une liste d’activités prédéfinies qui ont été enregistrées dans un format standard.

Pour l’instant, sélectionnez Create.

Étape 3 : définir l’activité

Cliquez sur le bouton Ajouter et remplissez chaque champ comme indiqué ci-dessous. Cela préparera le créateur à créer une activité nommée Add. Lorsque vous êtes prêt, cliquez sur le bouton Modifier pour ajouter des propriétés à l'activité d'ajout.

Étape 4 : Ajouter des propriétés

Cela ouvrira une nouvelle fenêtre Définir les propriétés . Utilisez le bouton Ajouter pour créer 3 propriétés, comme indiqué ci-dessous.

Assurez-vous que les deux premiers sont des entrées et le dernier est une sortie. Ces propriétés représenteront deux nombres et leur somme.

Étape 5 : Générer l’activité

Cliquez sur OK dans la fenêtre Propriétés et sur Terminer dans la fenêtre des activités. Vous verrez alors de nouveaux fichiers ajoutés à vos projets.

Étape 6 : Ajouter une fonctionnalité

Ouvrez le fichier Addition.cs qui vient d'être créé et développez la région Protected Methods qu'il contient pour faire apparaître la méthode ExecuteAsync de l'activité. Il s'agit de la méthode qui est appelée chaque fois que l'activité est exécutée dans UiPath Studio.

Notez que les deux entrées créées à l’étape 4 (First Number et Second Number) ainsi que la sortie (Sum) ont déjà été ajoutées à cette méthode. La dernière étape consiste à combler l’écart entre eux en remplaçant le bloc de commentaires par du code qui ajoute les deux entrées, puis définit le résultat sur Somme (Sum). Voir ci-dessous :

Étape 7 : créer le package

Dans l’ explorateur de solutions, cliquez avec le bouton droit sur votre projet Design et sélectionnez Publier. Cette option permet de créer vos projets, de les packager et d'envoyer le package là où vous le souhaitez.

À l'écran suivant, saisissez le dossier dans lequel vous souhaitez enregistrer votre package d'activités. Il est judicieux de choisir l'une de vos sources de packages sur UiPath Studio (vous pouvez les trouver dans Paramètres > Gérer les sources sur la page d'accueil de Studio) afin de pouvoir publier directement depuis Visual Studio dans UiPath Studio.

Cliquez sur Créer un profil pour continuer.

Sur la page suivante, renommez votre source de packages en Packages UiPath (ou selon vos préférences) et modifiez la configuration en Débogage. Cliquez ensuite sur Publier.

Pour plus d'informations sur les configurations de débogage et de publication, consultez Métadonnées de package.

Votre sortie indiquera alors que les trois projets ont été créés avec succès et que le package résultant a été publié. Vous disposez à présent d’un package d’activités fonctionnel !

Étape 8 : utilisez vos activités dans UiPath Studio

Ouvrez UiPath Studio, accédez au Gestionnaire de paquets (Package Manager) et ajoutez votre ensemble d'activités au workflow.

Notez qu’une nouvelle catégorie a été ajoutée au volet Activités (Activities).

C'est tout ! Essayez votre nouvelle activité !

Métadonnées du package

En regardant le package d'activités construit dans ce tutoriel, vous verrez plusieurs espaces réservés où des informations telles que l'auteur, la licence, l'icône, etc. doivent aller. Personnalisons le package en remplaçant ces espaces réservés par des informations réelles.

Cette section porte sur le projet de conception, qui contient toutes les informations de votre package.

Éléments requis

• Visual Studio Community/ProProduction/Enterprise (2019 requis)
• UiPath Studio
• Utilisation de l'Activity Creator

Étape 1 : Ouvrir le projet de conception

Ouvrez le projet MyCompacy.MyProduct.Activities.Design en double-cliquant dessus et notez qu'il existe trois sections étiquetées :

• Métadonnées du package
• Versions du paquet
• Icône de package

Métadonnées du package

Champ	Description
PackageLicenseExpression	Un identificateur SPDX pour la licence que vous souhaitez utiliser. La valeur par défaut est Apache 2.0.
Description	Une brève description de vos activités qui apparaîtront dans le Gestionnaire de packages UiPath Studio.
Authors and Company	L'auteur et le propriétaire du paquet respectivement.
Copyright	L’avis de droit d’auteur standard.
PackageTags	Liste de termes que les utilisateurs peuvent rechercher pour trouver votre package.
PackageProjectUrl	Un lien vers la documentation de vos activités ou la page d'accueil de votre entreprise.
PackageIconUrl	Un lien vers un fichier image utilisé comme icône de package. Notez que la balise PackageIcon n'est actuellement pas prise en charge dans UiPath Studio.

<PropertyGroup>
    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
    <Description>A package used to perform simple arithmetic operations in UiPath Studio.</Description>
    <Authors>My Company</Authors>
    <Company>My Company</Company>
    <Copyright>@ 2020 My Company</Copyright>
    <PackageTags>UiPath Activity MyCompany MyProduct Math Addition Arithmetic</PackageTags>
    <PackageProjectUrl>https://docs.uipath.com/integrations/docs/how-to-create-activities</PackageProjectUrl>
    <PackageIconUrl>https://raw.githubusercontent.com/NuGet/Samples/master/PackageIconNuspecExample/icon.png</PackageIconUrl>
    ...
</PropertyGroup>

Version du package

Notez qu'il y a deux balises PackageVersion ici, qui correspondent aux deux modes dans lesquels un paquet peut être construit : Débogage et Publication.

• Le débogage est utile lors du développement. La version s'incrémente à chaque build afin que des mises à jour puissent être effectuées, puis immédiatement testées dans UiPath Studio.
• La valeur Release est utilisée pour créer un paquet final prêt à être publié. Une fois le développement terminé, vous pouvez définir ici la version souhaitée.

  <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
      <PackageVersion>0.2.0.$([System.DateTime]::UtcNow.ToString(MMddHmmss)) Version</PackageVersion>
  </PropertyGroup>
    
  <PropertyGroup Condition="'$(Configuration)' == 'Release'">
      <PackageVersion>0.2.0</PackageVersion>
  </PropertyGroup>
  

Icône de package

Utilisez la balise PackageIconUrl pour ajouter une icône à votre package d’activités. Dans cet exemple, un exemple d'icône est utilisé.

Étape 2 : Reconstruire le package

Reconstruisez le package et importez-le dans UiPath Studio comme dans la section précédente. Ouvrez le Gestionnaire des packages et notez que votre package dispose désormais d'une nouvelle icône, d'une description et de métadonnées mises à jour.