Packages 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 en tant que package vers 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 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.
• Marketplace : ce flux public contient toutes les activités publiées sur UiPath Marketplace. Veuillez noter que le fait que les packages sont construits et officiellement pris en charge par UiPath est spécifiquement indiqué dans la fenêtre Gérer les packages (Manage Packages), dans l’onglet Informations sur les packages (Package Information). Ce flux a la source suivante :https://gallery.uipath.com/api/v3/index.json.

Flux personnalisés

Dans le cadre d'une installation de type Entreprise, un flux d'activité personnalisé ne peut être utilisé dans un workflow que si celui-ci a été démarré sous le profil de l'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. Pour éviter de tels scénarios, ajoutez le flux personnalisé

Important :

To use custom feeds, make sure the Robot has access to the custom location.

Flux d'activité

Lorsque plusieurs flux sont utilisés, NuGet sélectionne celui qui répond le plus rapidement. Étant donné que les packages d'activités peuvent avoir plusieurs versions, le Robot recherche une version basée sur les règles de runtime dans Studio, comme suit :

• Pour la règle de runtime Strict (Strict) , le Robot recherche uniquement la version de package spécifiée. Par exemple, si vous sélectionnez Version 2.5.0 et définissez la Règle de runtime sur Strict, le Robot ne recherche que la version 2.5.0. S'il n'est pas trouvé, cela génère une erreur.

• Pour la règle de runtime Version applicable la plus ancienne ( Lowest Applicable Version ) , le Robot recherche la version de package spécifiée ou ultérieure. Par exemple, si vous sélectionnez Version 2.5.0 et définissez la Règle de runtime sur Version applicable la plus ancienne ( Lowest Applicable Version), le Robot recherche les versions commençant par 2.5.0 (2.5.0, 2.5.1, 2.5.2 etc.). S'il n'est pas trouvé, cela génère une erreur.

Si un flux ne dispose pas de packages et de dépendances signés, l'automatisation peut échouer. En effet, le Robot s'attend à ce que tous les packages et dépendances soient signés. Pour éviter cela, assurez-vous que tous les flux configurés ne contiennent que des packages et des dépendances signés.

La liste suivante résume les flux utilisés par le Robot en fonction de 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 paquets 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, un flux NuGet est fourni par Orchestrator. 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 en fonction de 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 NuGet.Repository.Type est défini sur Composite, les activités sont enregistrées à l'emplacement spécifié via les paramètresStorage.Type et Storage.Location . Important : L'option Composite restreint l'utilisation des commandes 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.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json Il s’agit du flux UiPath en ligne officiel, qui est la source à partir de laquelle le Gestionnaire de paquets (Package Manager) dans Studio récupère ses activités. Par défaut, ce flux n'est pas actif. Pour l'activer, dans Studio, allez à Paramètres (Settings) > Gérer des sources ( Manage Sources) et sélectionnez l'option correspondante.

Dossiers des packages de secours

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

Pour configurer ce dossier, ajoutez la variable d'environnement NUGET_FALLBACK_PACKAGES sur la machine robot. La variable doit contenir la liste des chemins d'accès complets, chacun séparé par un point-virgule, vers ces dossiers de sauvegarde. Si la variable d'environnement n'existe pas, le robot essaie 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.