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.

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

Pour plus d'informations sur le fonctionnement des flux et leur modification, consultez le document Gestion des packages d'activités, qui vous fournira de plus amples détails à 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 : seules les dépendances sont prises en charge, et non les processus déployés dans les dossiers de secours.

Modification de l’emplacement du package

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

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

Plusieurs robots peuvent utiliser un même chemin (dossier local ou dossier réseau partagé) pour télécharger et exécuter des automatisations.

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

If the same local path is used by multiple user mode robots on the same machine, you must add the NUGET_SCRATCH machine environment variable on the robot machine. The value has to be a path to a folder other than the actual NuGet installation one. The folder set for the environment variable is used as a temporary folder for 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>