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

Activité Obtenir le dossier d'environnement qui utilise cette activité pour récupérer le chemin vers les dossiers spéciaux du système (tels que Bureau, Documents, AppData, etc.).

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