Récupérer le dossier d'environnement (Get Environment Folder)

UiPath.Core.Activities.GetEnvironmentFolder

Utilisez cette activité pour récupérer le chemin d'accès aux dossiers spéciaux du système ( tels que Desktop, Documents, AppData, etc.) à l'aide de l'énumération Environment.SpecialFolder de .NET. Une bonne compréhension du comportement spécifique à la plate-forme est essentielle à la création de workflows d'automatisation multiplate-formes fiables.

Remarque :

L'énumération SpecialFolder est cohérente sur toutes les plates-formes, mais les mappages de dossiers réels et la disponibilité diffèrent considérablement entre les environnements Windows et multiplate-formes. De nombreux dossiers spécifiques à Windows renvoient une chaîne vide sur Linux/macOS.

Propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• Dossier spécial - Dossier spécial dont le chemin doit être récupéré. Choisissez parmi les valeurs d’énumération Environment.SpecialFolder disponibles.

Sortie

• Chemin du dossier - Chemin d'accès complet au SpecialFolder sélectionné. Renvoie une chaîne vide si le dossier n'est pas disponible sur la plateforme actuelle.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Comportement spécifique à la plateforme

Environnement Windows

Lors de l'exécution sous Windows :

• Tous les dossiers spéciaux standard sont résolus selon les chemins d'accès Windows attendus (par exemple, Desktop, ProgramFiles, System, ApplicationData).
• Les dossiers Windows uniquement tels que ProgramFiles, ProgramFilesX86, Windows, AdminTools et CommonProgramFiles renvoient des chemins valides.
• Les dossiers sont généralement résolus à des emplacements sous C:\Users\<username> ou dans des répertoires système comme C:\Windows.

Environnement multiplateforme

Lors d'une exécution sous Linux ou macOS :

• Seul un sous-ensemble de dossiers spéciaux est résolu en chemins valides ; de nombreux dossiers spécifiques à Windows renvoient une chaîne vide.
• Les chemins de dossier suivent les spécifications du répertoire de base XDX sur Linux (utilisation de variables d’environnement comme $XDG_CONFIG_HOME, $XDG_DATA_HOME) et les conventions macOS.
• L'activité ne crée jamais de répertoires ; il ne résout que les emplacements connus en fonction du système d’exploitation.
• Si un dossier ne peut pas être résolu sur la plate-forme actuelle, l'activité renvoie une chaîne vide (not null) et ne génère pas d'exception.

Mappages de dossiers courants

Dossiers multiplate-forme

Ces dossiers sont généralement résolus dans les environnements Windows et multiplate-formes :

• ProfilUtilisateur : Windows : C:\Users\<user>, Linux/macOS : $HOME
• Bureau - Windows : C:\Users\<user>\Desktop, Linux/macOS : ~/Desktop (si présent)
• MesDocuments : Windows : C:\Users\<user>\Documents, Linux/macOS : ~/Documents (si présent)
• DonnéesApplication : Windows : %APPDATA% (Roaming), Linux/macOS : ~/.config (XDX)
• DonnéesApplicationLocal : Windows : %LOCALAPPDATA%, Linux/macOS : ~/.local/share (XDX)

Dossiers Windows uniquement

Ces dossiers renvoient des chemins d'accès valides sur Windows, mais renvoient généralement une chaîne vide sur Linux/macOS :

• ProgramFiles, ProgramFilesX86 - Répertoires d'installation du programme Windows
• Système, SystemX86, Windows - Répertoires système Windows
• DonnéesApplicationCommun : Windows : %PROGRAMDATA%, Linux/macOS : chaîne vide
• CommonProgramFiles, CommonProgramFilesX86 - Fichiers de programme partagés
• OutilsAdministrateur, Modèles, Favoris, Récent, Envoyer à, Menu Démarrer, Démarrage - Dossiers shell Windows

Considérations spécifiques à la plateforme

• Polices : Windows : %WINDIR%\Fonts, macOS : /System/Library/Fonts (système) ou /Library/Fonts (utilisateur), Linux : varie selon la distribution, renvoie souvent une chaîne vide
• Desktop, MyDocuments : peut renvoyer une chaîne vide si le répertoire n'existe pas dans le profil utilisateur, même sur les plateformes où elles sont attendues

Meilleures pratiques

• Validez toujours le résultat: vérifiez string.IsNullOrEmpty(folderPath) avant d'utiliser le chemin renvoyé, car de nombreux dossiers peuvent ne pas exister sur certaines plates-formes.
• Pour les workflows multiplateformes: préférez utiliser UserProfile, ApplicationData ou LocalApplicationData pour stocker les données de l'application, car ces derniers ont des mappages cohérents sur toutes les plates-formes.
• Évitez les dossiers Windows uniquement: ne vous contentez pas d'utiliser des dossiers tels que ProgramFiles, System ou Windows dans les workflows multiplateformes, car ils renverront des chaînes vides sur Linux/macOS.
• Gérer les répertoires manquants: l’activité ne crée pas de répertoires. Si vous devez écrire dans un dossier spécial, vérifiez qu'il existe et créez-le si nécessaire.
• Test sur les plates-formes cibles: la disponibilité des dossiers peut varier en fonction de la configuration du profil utilisateur, en particulier pour les dossiers sensibles à la présence tels que les dossiers Bureau et Documents.
• Environnements conteneurisés: sachez que les environnements conteneurisés ou restreints peuvent renvoyer des chaînes vides pour davantage de dossiers en raison de chemins manquants ou inaccessibles.

RetournerValeur

• Renvoie le chemin d'accès complet au format chaîne si le dossier spécial est disponible sur la plateforme actuelle.
• Renvoie une chaîne vide (string.Empty) si le dossier ne peut pas être résolu sur la plate-forme actuelle.
• Ne renvoie jamais la valeur null et ne génère pas d’exceptions pour les dossiers non pris en charge.

Exemples de scénarios

Scénario 1 : Récupération ProfilUtilisateur

• Windows : renvoie C:\Users\<username>
• Linux/macOS : renvoie /home/<username> ou /Users/<username>

Scénario 2 : Récupération de FichiersProgramme

• Windows : renvoie C:\Program Files
• Linux/macOS : renvoie une chaîne vide

Scénario 3 : récupérer des données d’application

• Windows : renvoie C:\Users\<username>\AppData\Roaming
• Linux/macOS : renvoie ~/.config (Spécification XGG)

Scénario 4 : récupérer Desktop lorsque le dossier n’existe pas

• Toutes les plates-formes : renvoie une chaîne vide si le dossier Desktop n’est pas présent dans le profil utilisateur