Paquages et bibliothèques

Packages NuGet utilisés par le Robot UiPath: flux par défaut, flux locaux et Orchestrator, comportement de mise en cache des packages et configuration des flux dans Studio.

Un package est un ensemble comprenant tous les éléments d'automatisation tels que les activités, les workflows, les fichiers et les sources de données. Lorsque vous créez un projet dans Studio, vous le publiez sous forme de package dans un emplacement ou un flux spécifique. À partir de là, le robot peut le télécharger et l'utiliser pour exécuter l'automatisation.

Important :

Utilisez des chemins absolus pour indiquer l'emplacement des packages.

Flux par défaut

Les emplacements et flux 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 de locataires est activé dans Orchestrator. Ces flux ont la source suivante : https://[Orchestrator_host]/nuget/activities.

• Local - The feed for the packages installed locally with Studio. When Studio of the same version is installed side by side with the Robot, the feed is the Packages folder of Studio, %ProgramFiles%\UiPathPlatform\Studio\<version>\Packages for per-machine installations or %LocalAppData%\Programs\UiPathPlatform\Studio\<version>\Packages for per-user installations. Otherwise, it's the Packages folder in the Robot installation folder, which might not exist.

  Remarque :

  La date de publication affichée dans la fenêtre Gérer les Packages pour les packages du flux local correspond à 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 officiel UiPath en ligne. Vous y trouverez les packages d'activités que nous prenons officiellement en charge. Ce flux a la source suivante : https://pkgs.uipath.com/official/index.json.

• Marketplace - Ce flux public contient toutes les activités publiées sur UiPath Marketplace.

  Remarque :

  La création et la prise en charge officielle des packages par UiPath sont spécifiquement indiquées dans la fenêtre Gérer les packages, onglet Informations sur les packages.

  Ce flux a la source suivante : https://gallery.uipath.com/api/v3/index.json.

Flux personnalisés

In Enterprise installations, a custom activity feed can only be used in workflows started from Studio on that user. Starting a job on the same machine from Orchestrator or the Assistant results in the Robot not being able to retrieve the appropriate package. To avoid such scenarios, add the custom feed to the NuGet.config file of the Robot. For the steps, refer to Configuring activity feeds.

Important :

Pour utiliser des flux personnalisés, vérifiez que le robot a accès à l'emplacement personnalisé.

Flux d'activités

Lorsque plusieurs flux sont utilisés, NuGet sélectionne celui qui répond le plus rapidement. Dans la mesure où les packages d'activités peuvent avoir plusieurs versions, le robot recherche une version selon les règles d'exécution dans Studio, comme suit :

• Pour la règle de runtime Stricte, le robot ne recherche que la version du package spécifiée. Par exemple, si vous sélectionnez la version 2.5.0 et que vous définissez la Règle de runtime sur Stricte, le robot recherche uniquement la version 2.5.0. Si elle est introuvable, une erreur est générée.
• Pour la règle de Runtime Version applicable la plus basse, le robot recherche la version du package spécifiée ou une version ultérieure.Par exemple, si vous sélectionnez la version 2.5.0 et que vous définissez la Règle de runtime sur Version minimum applicable, le Robot recherche les versions à partir de 2.5.0 (2.5.0, 2.5.1, 2.5.2, etc.). Si elle est introuvable, une erreur est générée.

Si les packages et dépendances du flux ne sont pas signés, l'automatisation peut échouer. En effet, le robot s'attend à ce que tous les paquets et dépendances soient signés. Pour éviter cette situation, vérifiez que tous les flux configurés contiennent uniquement des packages et des dépendances signées.

Important :

• Chaque fois que vous modifiez des fichiers de configuration, vous devez redémarrer le service de robot UiPath pour que les modifications soient appliquées.

• Pour ignorer les flux HTTPS de NuGet.config, ajoutez la ligne suivante dans UiPath.config, sous <packageSettings> :

  <add key="skipHttpConfigurationSources" value="true" />
  

The UiPath Platform Installer adds two feeds to the NuGet.config file in the Robot installation folder: the Local feed, and the Executors feed, which holds the executor packages for agents, functions, and API workflows. Both are enabled by default.

Lorsque vous connectez le robot à Orchestrator, ce dernier fournit un flux NuGet. Il contient les paquets d’activités officiellement pris en charge par UiPath. Ce flux est activé par défaut et dépend de vos paramètres de stockage.

La liste suivante résume les flux utilisés par le robot, selon la connexion du robot à Orchestrator :

• Robot connecté à Orchestrator
  • Si NuGet.Repository.Type est défini sur Legacy, les activités sont enregistrées dans l'emplacement ~/NuGetPackages/Activities par défaut. Cette valeur est personnalisable et est conservée sur la machine Orchestrator dans le paramètre NuGet.Activities.Path du fichier web.config.
  • Si la valeur NuGet.Repository.Type est définie sur Composite, les activités sont enregistrées à l'emplacement spécifié dans les paramètres Storage.Type et Storage.Location.
    Important :

    L'option Composite limite l'utilisation des commandes de copier-coller dans le répertoire des packages.

• Robot non connecté à Orchestrator Lorsque le robot n'est pas connecté à Orchestrator ou qu'il ne trouve pas les activités requises dans le flux local, il utilise le flux suivant :

  https://pkgs.uipath.com/official/index.json
  

Il s'agit du flux UiPath officiel en ligne, la source à partir de laquelle le gestionnaire des packages dans Studio récupère ses activités. Par défaut, ce flux n'est pas actif. Pour l'activer, dans Studio, accédez à Paramètres > Gérer les sources, puis sélectionnez l'option correspondante.

Dossiers des packages de secours

En cas d'échec de la source principale, le dossier de packages de secours est un dossier de sauvegarde à partir duquel le robot peut récupérer les paquages nécessaires.

Pour configurer ce dossier, ajoutez la variable d'environnement NUGET_FALLBACK_PACKAGES sur la machine robot.Cette variable doit contenir la liste des chemins d'accès complets vers ces dossiers de sauvegarde, séparés par un point-virgule. Si la variable d'environnement n'existe pas, le robot tente de lire les dossiers de secours des packages NuGet à partir du fichier Nuget.config.

Important :

Vous ne pouvez pas utiliser de dossiers de secours pour stocker et exécuter des automatisations ou des workflows entiers.

Les processus déployés dans des dossiers de secours ne sont pas pris en charge, mais uniquement les dépendances.