Gérer les package d’activités

Studio utilise les flux NuGet pour installer des paquets d'activités. Vous pouvez gérer ces flux de deux manières dans Studio :

• au niveau de l'application : les flux sont configurés depuis l'onglet Paramètres (Settings) > Gérer des sources (Manage Sources) ;
• au niveau du projet : les flux sont configurés depuis le bouton Gérer les paquets (Manage Packages) dans le ruban.

Pour désactiver un flux d'activité, vous devez décocher la case correspondante. L'activation ou la désactivation des flux est applicable au niveau du projet et de l'application.

Les flux d'activité suivants sont configurés par défaut dans Studio :

• Locataire Orchestrator et Hôte Orchestrator : Ces flux d’activités sont ajoutés par défaut si votre Robot est connecté à Orchestrator et qu’ils ne peuvent pas être désactivés. L’option Locataire d’Orchestrator n’est disponible que si le flux de bibliothèques locataire est activé dans Orchestrator. Ces flux ont la source suivante : https://[Orchestrator_host]/nuget/activities.
• Local : le flux pour les packages installés localement avec Studio. Le flux a la source suivante : %ProgramFiles%\UiPath\Studio\Packages pour les installations par la machine ou %localappdata%\Programs\UiPath\Studio\Packages pour les installations par l'utilisateur.
  Remarque : la date de publication affichée dans la fenêtre « Gérer les packages » (Manage Packages) pour les packages du flux local est la date à laquelle le programme d'installation de Studio a été créé, et non la date à laquelle les packages ont été publiés.
• Officiel : le flux UiPath en ligne officiel, où vous pouvez trouver les packages d'activités qui sont officiellement pris en charge par nous. Ce flux a la source suivante : https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
• Place de marché : ce flux public contient toutes les activités publiées sur la Place de marché UiPath. Veuillez noter que le fait que les packages sont construits et officiellement pris en charge par UiPath ou non est spécifiquement indiqué dans la fenêtre Gérer les packages, dans l’onglet Informations sur les packages. Ce flux a la source suivante : https://gallery.uipath.com/api/v3/index.json.

  Sachez que UiPath n’a aucun contrôle sur le retrait de la liste des packages créés par les partenaires ou la communauté de la Place de marché. Cependant, UiPath maintient les packages non listés actifs pour assurer la rétrocompatibilité à des fins d’exécution.

  
  

  

  
  
  Remarque : la configuration du flux reste lors de la mise à niveau vers une version Studio ultérieure.

La gestion et la configuration des flux sont disponibles dans la fenêtre Gérer les packages (Manage Packages) si une politique de gouvernance n'a pas été appliquée. Si une telle politique est appliquée et contient des droits restreints concernant la gestion des flux, un message s'affiche dans la fenêtre. En savoir plus sur Gouvernance.

Ajout de flux personnalisés

Remarque : dans le cadre d'une installation de type Entreprise, un flux d'activité personnalisé ne peut être utilisé avec un workflow que si celui-ci a été démarré sous le même profil utilisateur dans Studio. Si une tâche est lancée dans Orchestrator ou dans l'Assistant sur la même machine, le Robot ne pourra alors pas accéder au package nécessaire. Dans ce contexte, n'utilisez pas la méthode présentée ci-dessous : choisissez à la place d'ajouter le flux personnalisé au fichier UiPath.settings, sous la propriété ActivitiesFeed.

1. Dans la fenêtre Gérer des paquets (Manage Packages), cliquez sur Paramètres (Settings). Les sources de paquets s'affichent.
   
   

   

   
   
2. Cliquez sur le bouton pour ajouter un flux à la catégorie Sources de paquet définies par l'utilisateur (User defined package sources).
3. Renseignez le nom de la source de paquet ou le nom du flux NuGet.
4. Dans le champ Source (Source), saisissez au choix le répertoire du lecteur local, le répertoire du dossier partagé sur le réseau ou l'URL du flux NuGet.
5. Cliquez sur Ajouter (Add). Le nouveau flux est automatiquement ajouté parmi les Sources de paquet définies par l'utilisateur (User defined package sources) et dans la catégorie Tous les paquets (All Packages) de la fenêtre Gérer des paquets (Manage Packages). Par défaut, le flux est activé.
6. Cliquez sur Enregistrer (Save) pour appliquer toutes les modifications.

Vous pouvez activer ou désactiver les sources de paquets définies par l'utilisateur et par défaut depuis la fenêtre Gérer des paquets (Manage Packages).

Notez que les flux sont ajoutés immédiatement. Un clic sur le bouton Fermer (Close) ou sur Annuler (Cancel) après l'ajout d'un flux ne rétablit pas les modifications.

Remarque : si le flux personnalisé contient un paquet endommagé ou en cours de modification dans un éditeur, le Gestionnaire de paquets (Package Manager) ne peut pas charger de paquets dans le flux.

Ajout de flux personnalisés

Pour ajouter un flux NuGet personnalisé qui requiert l'authentification, vous pouvez suivre les étapes expliquées ici.

Vous devez ajouter les valeurs flux NuGet, nom d'utilisateur et mot de passe dans le fichier NuGet.config, se trouvant au chemin suivant : %AppData%\NuGet. Une fois l'opération terminée, le flux doit être visible dans la fenêtre Gérer des paquets (Manage Packages).

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  <add key="FeedName" value="https://FeedSource" />
  </packageSources>
  
 <packageSourceCredentials>
  <FeedName>
    <add key="Username" value="YourUsername" />
    <add key="Password" value="YourPassword" />
  </FeedName>
</packageSourceCredentials>

Notez que key="ClearTextPassword" doit remplacer key="Password" lorsque vous utilisez des mots de passe non chiffrés.

Suppression de flux personnalisés

Remarque : seules les Sources de paquet définies par l'utilisateur (User defined package sources) peuvent être supprimées de la fenêtre Gérer des paquets (Manage Packages).

1. Dans la catégorie Paramètres (Settings), cliquez sur l'un des flux sous la section Sources de paquet définies par l'utilisateur.
2. Appuyez sur le bouton Supprimer (Remove) . Le flux est supprimé de la catégorie Tous les paquets (All Packages) et de la section Sources de paquet définies par l'utilisateur (User defined package sources).
3. Cliquez sur Enregistrer (Save) pour appliquer les modifications.

Notez que les flux sont supprimés immédiatement. Un clic sur le bouton Fermer (Close) ou sur Annuler (Cancel) après la suppression des flux par défaut ou personnalisés ne rétablit pas les modifications.

Connexion aux flux via un serveur proxy

Si votre ordinateur se trouve derrière un serveur proxy, vous devez configurer les paramètres de proxy NuGet pour avoir accès aux flux situés en dehors de votre réseau :

1. Téléchargez nuget.exe depuis https://www.nuget.org/downloads.
2. Ouvrez une fenêtre d'invite de commande dans le dossier dans lequel nuget.exe a été téléchargé et exécutez les commandes suivantes pour configurer l'adresse, le nom d'utilisateur et le mot de passe du serveur proxy :

   nuget.exe config -set http_proxy=<http://proxy.server.address:port>

   nuget.exe config -set http_proxy.user=<mydomain\myUserName>

   nuget.exe config -set http_proxy.password=<myPassword>

3. Vérifiez que le fichier NuGet.config situé dans %AppData%\NuGet a bien reçu la dernière mise à jour :

   <config>
       <add key="http_proxy" value="http://proxy.server.address:port" />
       <add key="http_proxy.user" value="mydomain\myUserName" />
       <add key="http_proxy.password" value="myEncryptedPassword" />
   </config>

4. Redémarrez Studio.

Gestion des paquets

La fonctionnalité de gestionnaire de paquets permet de télécharger des paquets d'activités, des bibliothèques, des infrastructures, des wrappers, etc. Il permet d'afficher et de mettre à jour les éléments qui sont déjà installés sur votre ordinateur, mais également d'ajouter et de supprimer vos propres éléments. Elle affiche la liste de paquets disponibles par flux et la liste de dépendances par projet actuel. La fenêtre Gérer des paquets (Manage Packages) s'ouvre toujours avec la liste Dépendances du projet (Project Dependencies).

Un paquet d'activités est un ensemble d'activités pouvant vous aider à automatiser une application (UiPath.Excel.Activities, UiPath.Word.Activities) ou une catégorie d'applications (UiPath.Mail.Activities, UiPath.Terminal.Activities), ou encore à employer certaines technologies dans vos projets d'automatisation (UiPath.OCR.Activities, UiPath.FTP.Activities) .

Les informations détaillées des paquets et des bibliothèques sont affichées dans le module à droite de la fenêtre Gestion des paquets (Manage Packages), comme indiqué dans l'illustration précédente.

Remarque : les notes de publication des paquets d'activités ne s'affichent pas dans la fenêtre Gérer des paquets (Manage Packages), en raison d'une restriction de NuGet v3.

La case Inclure la version préliminaire (Include Prerelease) en regard de la barre de recherche, affiche les versions bêta des paquets de la bibliothèque, si disponibles, lorsqu'elles sont sélectionnées.

Cochez la case Inclure la version préliminaire si les descriptions des dépendances du projet ne sont pas visibles dans la fenêtre Gérer les packages.

Remarque : Les paquets UiPath.UIAutomation.Activities et UiPath.System.Activities sont compatibles avec Studio v2018.3 et versions ultérieures.

Installation de paquets

Remarque : une connexion Internet est nécessaire pour le téléchargement et l'installation des paquets d'activités.

Remarque : si votre organisation utilise la signature de package appliquée, vous devez ajouter des certificats approuvés à UiPath afin de pouvoir installer les packages officiels. Vous pouvez en savoir plus ici. Vous pouvez en savoir plus à leur sujet ici.

1. Dans la fenêtre Gérer les paquets (Manage Packages), sélectionnez la catégorie Tous les paquets (All Packages). Cela ouvre une liste de tous les paquets collectés à partir de vos flux.
   
   

   

   
   
2. Recherchez le package à installer. Veuillez noter que les packages d'activités et les versions disponibles dépendent de la compatibilité sélectionnée pour le projet.

   Vous pouvez :

   • Faire défiler la liste pour trouver le package.
   • Rechercher le package en tapant une partie de son nom ou de sa description dans la barre de recherche.

   • Filtrez la liste en cliquant sur l'icône Filtre à côté de la barre de recherche, puis en sélectionnant uniquement les options que vous souhaitez afficher :

     • Inclure la version préliminaire (Include Prerelease) - Inclut les versions bêta des packages, le cas échéant.
     • StudioX uniquement - Répertorie uniquement les packages conçus pour StudioX. (cette option n'est disponible que dans le profil StudioX)
     • UiPath uniquement (UiPath Only) - Liste uniquement les packages publiés par UiPath.
     • Activités uniquement (Activities Only) - Liste uniquement les packages d’activités.
     • Bibliothèques uniquement : répertorie uniquement les bibliothèques.
     • Bibliothèques d’interface utilisateur uniquement (UI Libraries Only) - Liste uniquement les bibliothèques d’IU publiées depuis le Référentiel d’objets.
     • Compatible uniquement (Compatible Only) : répertorie uniquement les packages dont la dernière version est compatible avec la compatibilité du projet. Ne sélectionnez pas cette option si vous souhaitez voir les packages avec des versions plus anciennes qui sont compatibles avec la compatibilité du projet.
3. Sélectionnez un paquet d'activités pour afficher sa description, sa version, ses dépendances, l'URL du projet et sa date de publication.
4. Cliquez sur la liste déroulante en regard de Version pour choisir une version du package, puis définissez une Règle Runtime. Pour en savoir plus sur les Règles Runtime pour les dépendances du projet, consultez la page Définir les règles de dépendance.
5. Cliquez sur le bouton Installer (Install). Sinon, cliquez sur l'icône en regard du nom de paquet pour le marquer avec l'icône , le préparant ainsi pour l'installation.
6. La fenêtre Acceptation de la licence affiche les termes du contrat de licence pour chaque package tiers que vous souhaitez installer. Cliquez sur Afficher la licence pour lire les termes du contrat de licence.
   • Cliquez sur J'accepte (I Accept) pour accepter les conditions de licence et installer les paquets.

   • Cliquez sur Je refuse (I Decline) pour annuler l'installation et revenir à la fenêtre Gérer les paquets (Manage Packages).

     Remarque : les modalités des packages UiPath et de leurs dépendances sont implicitement acceptées lors de l’installation de Studio. Lisez les conditions d'utilisation et la politique de confidentialité d’UiPath.
7. Cliquez sur Enregistrer pour installer les packages ou mettre à jour les versions.
   Remarque : si, lors de l'installation d'un package d'activités, le chemin d'accès est corrompu, l'installation ne se termine pas. Il est recommandé de sauvegarder puis d'effacer le contenu des dossiers locaux suivants %userprofile%\.nuget\packages et %userprofile%\AppData\Local\UiPath\.cache.

Désinstallation de paquets

Pour désinstaller des packages, accédez à la catégorie Dépendances du projet (Project Dependencies) et cliquez sur le bouton Désinstaller (Uninstall) en regard du package que vous ne souhaitez plus utiliser. Le package n’est supprimé qu’après avoir cliqué sur Enregistrer (Save).

Lors de l'exécution d'un projet d'automatisation, le bouton Gérer des paquets (Manage Packages) est désactivé. Cela implique que les paquets d'activités ne peuvent être ni installés ni supprimés, tant que l'exécution ne s'est pas arrêtée.

Rétrogradation des packages

La rétrogradation des packages d’activités n’est pas recommandée, notamment à cause des effets négatifs qu’elle peut avoir sur les dépendances. Les dépendances entre les différents packages d’activités sont gérées avec soin dans chaque version. Par conséquent, une rétrogradation peut entraîner des incohérences, voire des dysfonctionnements des workflows. De plus, les nouveaux packages d’activités offrent des fonctions et fonctionnalités améliorées qui pourraient ne pas être disponibles dans les anciennes versions. Ainsi, afin de garantir des performances optimales et d’éviter de potentielles erreurs, il est conseillé de conserver les packages d’activités dans leur version actuelle ou de les mettre à niveau vers les dernières versions.

Modification du dossier de téléchargement des packages

Par défaut, les packages d’activités sont téléchargés et installés dans le dossier %userprofile%\.nuget\packages. Vous pouvez définir un dossier différent de l’une des façons suivantes :

• Lors de l’installation, à l'aide de la ligne de commande avec l’option PACKAGES_FOLDER.
• Après l’installation, en modifiant manuellement le fichier uipath.config :
  1. Ouvrez le fichier uipath.config dans un éditeur de texte. Par défaut, le fichier est accessible via C:\Program Files\UiPath\Studio.
  2. Dans le nœud packageSettings, ajoutez la clé packagesInstallationFolder, le chemin vers le nouveau dossier étant sa valeur.

  3. Enregistrez les modifications et, si le robot est installé en tant que service, redémarrez le service.

     Par exemple, ajoutez ce qui suit à uipath.config pour remplacer l’emplacement de téléchargement par C:\nuget.

     <packageSettings>
       <add key="packagesInstallationFolder" value="C:\Nuget" />
     </packageSettings>

Remarque : la suppression du contenu du dossier .nuget provoque des conflits de dépendance lors de l’ouverture d’un projet dans Studio.

Gestion des packages dans des environnements hors ligne

Lorsque vous utilisez Studio sur un ordinateur qui n'est pas connecté à Internet, vous pouvez télécharger des packages sur un autre ordinateur et les transférer manuellement vers l'ordinateur sur lequel Studio est installé. Cela n'est requis que si la connectivité Orchestrator n'est pas disponible. Lorsque Studio est connecté à Orchestrator, les packages peuvent être installés à partir des flux Orchestrator.

Remarque : pour empêcher Studio de tenter de télécharger des packages à partir de flux en ligne, désactivez tous les flux en ligne sur les machines hors ligne.

Pour installer un package sur une machine Studio hors ligne :

1. Sur un ordinateur avec accès à Internet, téléchargez et installez NuGet Package Explorer.
2. Ouvrez NuGet Package Explorer et sélectionnez Ouvrir un package à partir d'un flux en ligne (Open a package from an online feed).
3. Dans le champ Source du package (Package source), saisissez l'URL du flux à partir duquel télécharger le package. Le flux de packages UiPath officiel est https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
4. Localisez le package dans le flux et téléchargez-le.
5. Transférez le fichier NUPKG vers l'ordinateur Studio dans un dossier défini comme source du package dans Studio. Pour ajouter le package au flux local par défaut, copiez le fichier dans %ProgramFiles%\UiPath\Studio\Packages pour les installations par la machine ou %localappdata%\Programs\UiPath\Studio\Packages pour les installations par l'utilisateur.