Paquages et bibliothèques

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 locataire est activé dans Orchestrator. Ces flux ont la source suivante : https://[Orchestrator_host]/nuget/activities.
• Local : le flux des packages installés localement avec Studio. Le flux contient la source : %ProgramFiles%\UiPath\Studio\Packages pour les installations par machine ou %localappdata%\Programs\UiPath\Studio\Package pour les installations par utilisateur.
  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. La source de ce flux est la suivante : https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
• Marketplace : ce flux public contient toutes les activités publiées sur le Marketplace UiPath. Notez bien que la construction et la prise en charge officielle par UiPath ou non des packages est spécifiquement indiquée dans la fenêtre Gérer les Packages, à l'onglet Informations sur les packages. La source de ce flux est la suivante : https://gallery.uipath.com/api/v3/index.json.

Flux personnalisés

Dans les installations Enterprise, une activité personnalisée ne peut être utilisée que dans les workflows lancés à partir de Studio pour cet utilisateur. Le démarrage d'une tâche sur la même machine à partir d'Orchestrator ou de l'Assistant empêche le robot de récupérer le package approprié. Pour éviter cette situation, ajoutez le flux personnalisé

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 minimum applicable, 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" />

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

• Si vous choisissez d'installer le flux local, le dossier %ProgramFiles%\UiPath\Studio\Packages est créé. Il contient les paquets d'activités officiellement pris en charge par UiPath lors de l'installation. Le flux est activé par défaut.
• Si vous choisissez de ne pas installer le flux local, le dossier %ProgramFiles%\UiPath\Studio\Packages est créé, mais il ne contient que les packages qui sont ajoutés en tant que dépendances par défaut à un nouveau projet :

  • UiPath.UIAutomation.Activities

  • UiPath.System.Activities

  • UiPath.Excel.Activities

  • UiPath.Mail.Activities

Lorsque vous connectez le robot à Orchestrator, ce dernier fournit un flux NuGet. Il contient les packages 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 ne trouve pas les activités requises dans le flux local, il utilise le flux suivant : https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/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.