Set Environment Variable

UiPath.Core.Activities.SetEnvironmentVariable

Utilisez cette activité pour définir une variable d'environnement, en fournissant son nom et sa valeur. Si la variable n'existe pas déjà, elle sera créée automatiquement.

Remarque :

Sous Windows, cette activité définit Variables d'environnement utilisateur. Pour les projets multiplate-forme, il définit 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 important pour interpréter 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

• Nom (Name) : le nom de la nouvelle variable d'environnement Ce champ ne prend en charge que les variables Strings ou String.
• Valeur (Value) : la valeur de la nouvelle variable d'environnement Ce champ ne prend en charge que les variables Strings ou String.

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) :

• Les variables d'environnement sont définies au niveau de l'utilisateur (EnvironmentVariableTarget.User).
• Les modifications sont conservées au-delà du processus actuel et sont stockées dans le registre Windows.
• La variable devient disponible pour les nouveaux processus lancés par l'utilisateur actuel.
• Nécessite des autorisations appropriées pour modifier les variables d’environnement au niveau de l’utilisateur.

Environnement multiplateforme

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

• Les variables d'environnement sont définies au niveau du processus (EnvironmentVariableTarget.Process).
• Les modifications sont temporaires et n'affectent que le processus en cours et ses processus enfants.
• Les variables ne sont pas conservées après la fin du processus.
• Aucune autorisation spéciale n'est requise, car les modifications sont limitées au processus actuel.

Détails techniques

L'activité utilise une propriété TargetFramework interne pour déterminer le contexte d'exécution. Ce comportement est déterminé automatiquement par le runtime UiPath en fonction du type de projet et ne peut pas être configuré via les propriétés de l’activité.

Meilleures pratiques

• Pour les workflows Windows, utilisez cette activité lorsque les variables doivent être persistantes entre les redémarrages de processus ou être disponibles pour d'autres applications.
• Pour les workflows multiplate-formes, planifiez une étendue au niveau du processus et utilisez une persistance alternative (fichiers de configuration, bases de données) lorsque cela est nécessaire.
• Pour les workflows portables, les conceptions supposent l’étendue au niveau du processus afin de garantir la cohérence entre toutes les plateformes.

Validation

L'activité vérifie que le paramètre Nom n'est pas nul ou vide et que tous les arguments requis ont bien été fournis. Les opérations non valides génèrent une InvalidOperationException avec un message d'erreur avec une description.