Récupérer la variable d'environnement (Get Environment Variable)

UiPath.Core.Activities.GetEnvironmentVariable

Utilisez cette activité pour récupérer la valeur d'une variable d'environnement en fournissant son nom. Il est essentiel de bien comprendre le comportement de récupération spécifique à la plate-forme afin de créer des workflows d’automatisation multiplate-formes fiables.

Remarque :

Sous Windows, cette activité récupère les variables des Variables d'environnement utilisateur avec une secours pour les Variables d'environnement de processus. Sur les projets multiplate-forme, il récupère uniquement les Variables d'environnement de processus . Savoir comment les variables d'environnement sont chargées depuis les niveaux Machine et Utilisateur dans l'étendue Processus est essentiel pour comprendre les différences de comportement Windows et multiplate-forme des activités Obtenir la variable d'environnement et Définir la variable d'environnement .

Propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité. Ce champ ne prend en charge que les variables Strings ou String.

Entrée

• Variable (Variable) - Nom de la variable d'environnement dont la valeur doit être récupérée. Ce champ ne prend en charge que les variables Strings ou String.

Sortie

• Valeur de variable (VariableValue) - Valeur de la variable d'environnement sélectionnée.

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 d'une exécution sous Windows (configuration par défaut) :

• L'activité tente d'abord de récupérer la variable au niveau de l'utilisateur (EnvironmentVariableTarget.User).
• S’il n’est pas trouvé au niveau de l’utilisateur, il s’agit de variables d’environnement au niveau du processus.
• Ce mécanisme de secours garantit l’accès aux variables spécifiques à l’utilisateur et aux processus.
• OSVersion UserName système exposées via System.Environment sont toujours vérifiées en premier MachineName quelle que soit leur étendue.

Environnement multiplateforme

Lors de l'exécution sur des systèmes multiplateformes (Linux, macOS) :

• L'activité récupère des variables uniquement au niveau du processus (EnvironmentVariableTarget.Process).
• Cela inclut les variables héritées du processus parent et celles définies lors de l'exécution du processus en cours.
• Aucun mécanisme de secours n’est utilisé, car les variables au niveau de l’utilisateur sont spécifiques à Windows.
• Les propriétés système exposées via System.Environment sont toujours hiérarchisées et accessibles.

Priorité de récupération

L'activité suit cet ordre de récupération :

1. Propriétés System.Environment (toutes les plates-formes)

• Vérifie d'abord si le nom de la variable demandée correspond à une propriété .NET intégrée (par exemple, CurrentDirectory, MachineName, ProcessorCount).
• En cas de correspondance, renvoie directement la valeur de la propriété.

2. Variables d'environnement

• Windows: vérifie d'abord le niveau de l'utilisateur, puis restaure au niveau du processus.
• Multiplate-forme: vérifie uniquement le niveau de processus.

Détails techniques

L'activité utilise une propriété TargetFramework interne pour déterminer le contexte d'exécution :

• « windows » : utilise EnvironmentVariableTarget.User avec une solution de secours au niveau du processus.
• "portable" - Utilise EnvironmentVariableTarget.Process uniquement.

Ce comportement est déterminé automatiquement par le runtime UiPath en fonction de l’environnement d’exécution et ne peut pas être configuré manuellement via les propriétés de l’activité.

Différences de comportement

Persistance de variable

• Windows: peut récupérer les variables persistantes au niveau de l’utilisateur définies via les paramètres système Windows ou par l’activité Définir la variable d’environnement.
• Multiplateforme: récupère uniquement les variables disponibles dans l'étendue du processus en cours.

Étendue de variable

• Windows: a accès à une plus grande étendue de variables (utilisateur + processus).
• Multiplate-forme: a accès à une étendue plus réduite (processus uniquement).

Meilleures pratiques

• Pour les workflows Windows, vous pouvez vous appuyer sur des variables d'environnement au niveau de l'utilisateur pour la configuration. La solution de secours automatique garantit que les variables au niveau du processus sont toujours accessibles.
• Pour les workflows multiplateformes, reposent uniquement sur les variables d'environnement transmises au processus ou définies lors de l'exécution. Ne dépendez pas des variables au niveau de l'utilisateur, car elles ne seront pas disponibles. Pensez à transmettre la configuration requise via des arguments de processus ou des fichiers de configuration.
• Pour les workflows portables, les workflows de conception supposent uniquement l’étendue au niveau du processus, afin de garantir un comportement cohérent sur toutes les plates-formes. Vérifiez que toutes les variables requises sont disponibles au démarrage du processus et documentez clairement les prérequis de l'environnement.
• Propriétés système: préférez utiliser les propriétés System.Environment intégrées de .NET (comme MachineName, UserName) lorsqu’elles sont disponibles, car elles fonctionnent de façon cohérente sur toutes les plates-formes.

RetournerValeur

• Renvoie la valeur de la variable d'environnement sous la forme d'une chaîne.
• Renvoie une chaîne vide ou une valeur null si la variable est introuvable (le comportement peut varier selon la version de la plateforme et .NET).
• Les valeurs des propriétés système sont renvoyées sous forme de chaînes à l'aide de .ToString().

Exemples de scénarios

Scénario 1 : lire la variable PATH

• Windows : récupère avec succès à partir de l’étendue de l’utilisateur ou du processus.
• Linux/macOS : récupère avec succès à partir de l’étendue du processus.

Scénario 2 : lire une variable personnalisée spécifique à l'utilisateur définie via les propriétés système de Windows

• Windows : récupère correctement la valeur.
• Linux/macOS : renvoie vide/null (les variables au niveau de l'utilisateur n'existent pas).

Scénario 3 : lire NomMachine

• Toutes les plates-formes : récupéré avec succès à partir de la propriété System.Environment.MachineName .