Set Environment Variable

UiPath.Core.Activities.SetEnvironmentVariable

Verwenden Sie diese Aktivität, um eine Umgebungsvariable festzulegen und den Namen und den Wert dafür bereitzustellen. Wenn die Variable nicht bereits vorhanden ist, wird sie automatisch erstellt.

Hinweis:

Unter Windows legt diese Aktivität Benutzerumgebungsvariablen fest. Bei plattformübergreifenden Projekten werden Prozessumgebungsvariablen festgelegt. Es ist wichtig zu verstehen, wie Umgebungsvariablen von Maschinen- und Benutzerebene in den Prozess-Scope geladen werden, um die Windows- und plattformübergreifenden Verhaltensunterschiede der Aktivitäten Get Environment Variable und Set Environment Variable zu interpretieren.

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings oder String-Variablen.

Eingabe

• Name – Der Name der neuen Umgebungsvariable Dieses Feld unterstützt nur Strings oder String-Variablen.
• Wert – Der Wert der neuen Umgebungsvariable. Dieses Feld unterstützt nur Strings oder String-Variablen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Plattformspezifisches Verhalten

Windows-Umgebung

Bei der Ausführung unter Windows (Standardkonfiguration):

• Umgebungsvariablen werden auf der Benutzerebene festgelegt (EnvironmentVariableTarget.User).
• Änderungen bleiben über den aktuellen Prozess hinaus bestehen und werden in der Windows-Registrierung gespeichert.
• Die Variable wird für neue Prozesse verfügbar, die vom aktuellen Benutzer gestartet werden.
• Erfordert entsprechende Berechtigungen zum Ändern von Umgebungsvariablen auf Benutzerebene.

Plattformübergreifende Umgebung

Bei der Ausführung auf plattformübergreifenden Systemen (Linux, macOS):

• Umgebungsvariablen werden auf Prozessebene festgelegt (EnvironmentVariableTarget.Process).
• Änderungen sind temporär und betreffen nur den aktuellen Prozess und seine untergeordneten Prozesse.
• Variablen werden nach dem Beenden des Prozesses nicht beibehalten.
• Es sind keine speziellen Berechtigungen erforderlich, da Änderungen auf den aktuellen Prozess beschränkt sind.

Technische Details

Die Aktivität verwendet eine interne TargetFramework -Eigenschaft, um den Ausführungskontext zu bestimmen. Dieses Verhalten wird automatisch von der UiPath-Runtime basierend auf dem Projekttyp bestimmt und kann nicht über die Aktivitätseigenschaften konfiguriert werden.

Best Practices

• Bei Windows-Workflows verwenden Sie diese Aktivität, wenn Variablen nach Prozessneustarts beibehalten oder für andere Anwendungen verfügbar sein müssen.
• Planen Sie bei plattformübergreifenden Workflows den Scope auf Prozessebene und verwenden Sie bei Bedarf eine alternative Persistenz (Konfigurationsdateien, Datenbanken).
• Bei portierbaren Workflows geht die Entwicklung von einem Scope auf Prozessebene aus, um ein konsistentes Verhalten plattformübergreifend sicherzustellen.

Validierung

Die Aktivität überprüft, ob der Parameter Name nicht NULL oder leer ist und dass alle erforderlichen Argumente angegeben werden. Ungültige Vorgänge lösen eine InvalidOperationException mit einer beschreibenden Fehlermeldung aus.