Dossiers de paquets personnalisés et chemins d'accès réseau

Un package combine toutes les parties utilisées dans une automatisation et peut inclure : des activités, des workflows, des fichiers, des sources de données et d'autres composants nécessaires à l'exécution de l'automatisation. Un projet créé dans Studio est publié en tant que package vers un emplacement/un flux à partir duquel il est ensuite téléchargé par le Robot et utilisé pour exécuter une automatisation.

Les emplacements/flux suivants sont configurés par défaut dans Studio :

• Locataire d'Orchestrator et Hôte d'Orchestrator
• Local
• Officiel
• Marketplace

Les flux personnalisés peuvent également être utilisés, mais avant de mettre en place un emplacement personnalisé pour publier un package, assurez-vous que les Robots y ont accès.

Important :

Pour l'emplacement des packages, des chemins absolus doivent être utilisés. Les chemins relatifs ne sont pas pris en charge.

Pour de plus amples informations sur le fonctionnement des flux et sur la façon de les modifier, consultez le document Gestion des packages d'activités (Managing Activities Packages), qui fournit plus de détails sur ce sujet.

Dossiers des packages de secours

Les dossiers de packages de secours peuvent être configurés en ajoutant la variable d'environnement NUGET_FALLBACK_PACKAGES sur la machine robot. Il contient les chemins d'accès absolus aux dossiers de secours séparés par un point-virgule ; . 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 .

Plus d'informations disponibles dans la documentation Dossiers de secours (Fallback folders).

Important :

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

Modification de l’emplacement du package

L'emplacement du package peut être modifié via la ligne de commande de configuration à l'aide du PACKAGES_FOLDER paramètre ou en modifiant le fichier uipath.config. Cela vous permet de modifier l'emplacement de téléchargement de vos workflows et de leurs dépendances pour Studio et/ou Robot.

Important :

Redémarrage requis !Toute mise à jour du fichier de configuration nécessite un redémarrage :

• Pour les robots en mode Service : redémarrez le service de robot UiPath.
• Pour les robots en mode Utilisateur : redémarrez le service utilisateur, soit en redémarrant l'appareil, soit en vous déconnectant de votre compte d'utilisateur et en vous reconnectant.

Si vous n'indiquez pas ce paramètre lors de l’installation du Robot via la ligne de commande, le dossier par défaut sera %userProfile%\.nuget\packages.

Il est possible d'utiliser des variables d'environnement, telles que %USERNAME% ou %USERPROFILE%. Toutefois, vous devez les échapper comme il suit :

• Lorsque la configuration est invoquée depuis l'invite de commande, utilisez UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^% ;
• Dans les scripts de commandes, utilisez % - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%.
• Dans la console ou les scripts PowerShell : aucun échappement n'est nécessaire.
• Si votre utilisateur est un compte de domaine Active Directory, il est recommandé de spécifier également le nom de domaine dans la structure de dossiers, tel que C:\packages\^%UserDomain^%.^%Username^%

Utiliser le même chemin pour plusieurs robots

Multiple robots can use the same path (local folder or shared network folder) to download and execute automations.

En fonction de l'emplacement et du type de déploiement du robot, certaines limitations peuvent exister :

Mode de service

Chemin d’accès local

• Pas de restrictions lorsqu'un chemin local est utilisé par plusieurs robots en mode service sur une même machine.

Chemin réseau

• Lorsque le Robot est déployé en Mode de service et que Secure XAML est utilisé, les chemins d'accès réseau ne sont pas pris en charge.
• Les robots en mode service installés sur des machines distinctes ne peuvent pas se connecter au même dossier sur un réseau. Chaque machine doit avoir son propre dossier.
• Seuls les chemins non mappés sont pris en charge, par exemple \\server\Packages. Les chemins d'accès réseau mappés tels que Z:\Packages ne sont pas pris en charge. Ce raisonnement repose sur la façon dont les mappages sont résolus par utilisateur. Dans le cas présent, le propriétaire des fichiers installés sera le compte d'ordinateur : par conséquent, il n'aura pas accès aux mappages réseau par utilisateur.

Mode utilisateur

Chemin d’accès local

Si le même chemin d'accès local est utilisé par plusieurs robots en mode utilisateur sur la même machine, vous devez ajouter la variable d'environnement de la machine NUGET_SCRATCHsur la machine robot. La valeur doit être un chemin d'accès à un dossier autre que celui de l'installation de NuGet. L'ensemble de dossiers pour la variable d'environnement est utilisé comme dossier temporaire pour NuGet.

Par exemple :

Lorsque le paramètre packagesInstallationFolder du fichier uipath.config est C:\UiPath\Packages, si vous souhaitez permettre à plusieurs robots en mode utilisateur d'utiliser le même chemin local pour les packages, créez un nouveau dossier (par exemple : NuGetScratch) et ajoutez la variable d'environnement machine NUGET_SCRATCH avec la valeur C:\NuGetScratch.

Remarque :

• Le dossier NuGetScratch doit uniquement être utilisé par la variable NUGET_SCRATCH en tant que dossier temporaire.
• Les comptes utilisateur sous lesquels les robots s'exécutent doivent avoir un accès en lecture et en écriture aux deux dossiers de la machine.

Chemin réseau

• Lorsque des chemins d'accès réseau sont utilisés, le chemin d'accès doit inclure le nom de la machine et le nom d'utilisateur.

Exemple :

<packageSettings>
  <add key="packagesInstallationFolder" value="\\NetworkServer\SharedFolder\UiPath\Packages\" />
</packageSettings>